Home

Siemens A31003-51730-U103-7619 User's Manual

1. Image 5 1 View of the Structure window with numerous entries 07 2010 OScAR Pro Customized Operator User Manual 5 5 The Elements of a DCO Script General structure Right underneath the root the Structure window is divided into Node Description Constants Use the node Constants to create unchanging constant ele ments These elements remain the same throughout the entire project and can be placed any number of times at any places you want in your project Their values can be adjusted centrally in the OScAR Pro Customized Operator Parameters Use the node Parameters to create parameterizable ele ments These elements can be used in the same way as Con stants with the difference that their values can be adjusted easily through the Parameter editor of the OScAR Pro TT Op erator Tool Variables Use the node Variables to create global place holders that can be used for the exchange of information between Frames Lists Use the node Lists to create lists of place holders These el ements will help you to fill the Controls Listbox and Combo box with data You can either predefine the individual list en tries in the DCO Script same as for Constants or have them filled with data via various OScAR Pro TT Operator Tool com mands Frames Use the node Frames to create the
2. Instruction Arguments Contents The Instruction SetBut Button Deflagration ton lin 1 Blink color E Blink color 2 Blink color E Background color Blink interval Blink interval 6 5 3 The User Function Leakage blink on Description Use this Function to switch on the blinking of the Button Leakage Attributes Attribute Contents Name Leakage blink on Condition Leakage blinking AND Selected message UEQ 1 Messagebox Instructions Instruction Arguments Contents The Instruction SetBut Button Leakage tonBlink 1 Blink color E Blink color 2 Blink color E Background color Blink interval Blink interval 07 2010 OScAR Pro Customized Operator User Manual 6 35 The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 4 The User Function Short circuit blink on Description Use this Function to switch on the blinking of the Button Short circuit Attributes Attribute Contents Name Short circuit blink on Condition Short circuit blinking AND Selected message UEQ 1 Messagebox Instructions Instruction Arguments Contents The Instruction SetBut Button Short circuit tonBlink 1 Blink color E Blink color 2 Blink color E Background color Blink interval Blink interval
3. 5 7 8 Edit the attributes of a Filter Follow the below instructions to edit an existing Filter No Task 1 Go to the tree structure and open the node Lists 2 Now open the child node Filters in the tree 3 In the tree view select the filter that you want to edit 4 To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value Table 5 27 Edit the attributes of Filters 5 28 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Lists 5 7 9 Add an ID range Follow the below instructions to create a new ID range in an existing Filter No Task Go to the tree structure and open the node Lists Now open the child node Filters in the tree Next select the filter to which you want to add an ID range In the tree structure select the next child node ID ranges Now go to the menu bar and select Edit gt New The DCO Designer now outputs a new ID range in the list view on the left 6 To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value Table 5 28 Add an ID range GOIN 5 7 10 Edit the attributes of an ID range Follow the below instructions to edit the ID range of an existing Filter No Task Go to the tree structure and open the node Lists Now open the child node Filters in the tree Still in t
4. Table 7 3 Initial loading of a DCO Script in the OScAR Pro TT Operator Tool Note If you create a DCO Script in the above mentioned way in theOScAR Pro TT Oper ator Tool it will automatically be loaded whenever the DCO Window is opened The project properties of the DCO Script specify the Frame with which the operation starts see Edit project properties 07 2010 OScAR Pro Customized Operator User Manual The DCO in the OScAR Pro TT Operator Tool The DCO Parameter Editor 7 4 The DCO Parameter Editor Use the Parameter Editor to make local adjustments to the parameters of the DCO Script e g to the IDs or colors Description of the window DCO parameter editor Edit field Description 01x Parameter groups Parameters EE Broadcasts x c Short circuit 1902 msg_ X canca Short circuit name 1902 Short circuit string Leakage name 1901 Leakage string Parameter group Combobox to select the parent parameter group of the parameter you want to edit Parameters Combobox listing all parameters created To edit the values of one of these parameters simply make a double click on it Summary of the fields in the window DCO parameter editor 07 2010 OScAR Pro Customized Operator User Manual 7 9 The DCO in the OScAR Pro TT Operator Tool Special registry entries for the DCO 7 5 Special registry entries for the DCO The below tabl
5. 4 3 4 2 1 The menu bar od ntte wigmetente anaana 4 4 4 2 2 TNE toolbara aea ee Ale ia Gow de aa a S a a ohn LE oa BK ole 4 4 4 2 3 Description of the menu commands and the buttons of the OScAR Pro Customized Operator naana aana 4 5 4 2 4 Functions of the MOUSCY 35 73 6525 445 aaan aaaea 4 11 A NE stat s bari snese pe Sed fare ia atts Rie Bw e E eee We Ma E e a 4 12 4 3 Setup and application of the Structure window 0000 cece eee 4 13 4 3 1 The tree structure of the Structure window 000 eee eee 4 14 4 3 2 The list view of the Structure window 0 0000 cee eee eens 4 15 4 4 Setup and application of the Layout window 00 eee eee eee 4 16 4 4 1 Toolbar and COMMONS Soi pica tiss Genie kee hace Mh ee ate dene ee 4 17 4 4 2 Mark a Frame area or a Control 0 c eee 4 18 44 3 Move Controls sr e s ee ers Geeta te te Rete Sia eS ie dia atte hie lion Minit Ree Sonar 4 19 4 4 4 Change the size of Frames and Controls 00000 ee eee 4 20 4 4 5 Align and space elements automatically 00000 4 21 4 5 Setup and application of the Preview window 0000e eee eens 4 22 4 6 General user dialog Windows 00 00 eee ee 4 23 4 6 1 Edit project propenles s s cass Gait od Boer Os SEES Oe ake PSs SESE es 4 23 4 6 2 Administration of the Image lists 2 0022 4 24 4 6 3 Process colors and Standard colors for process lists
6. Table 5 70 Overview of Instructions 07 2010 OScAR Pro Customized Operator User Manual 5 93 The Elements of a DCO Script Instructions Instruction Description The Instruction GotoFrame Invokes another Frame Instructions to set Variables The Instruction SetCheckBox ToVariable Sets a Variable to the state of a Checkbox The Instruction SetComboTo Variable Sets a Variable to the selected Combobox entry The Instruction SetEditToVari able Sets a Variable to the content of an Edit field The Instruction SetListBoxSe lectionToVariable Sets a Variable to the selected Listbox entry The Instruction SetListBoxTo Variable Copies all List elements of a Listbox to a Data list The Instruction SetVariable Set a Variable to a certain value Instructions to change the attributes of Frames The Instruction SetFrameCol or Changes the background color Instructions for Static elements The Instruction SetStaticBack Color Changes the background color The Instruction SetStaticBor derColor Changes the color of the Frame around an element The Instruction SetStaticPic tureName Changes the assigned image The Instruction SetStaticPic turePos Changes the positioning of the image The Instruction SetStaticPic tureScale Changes the scaling of the image The Instruction SetStaticRect
7. Sort the list The list is sorted in the same way as you sort in other Windows programs namely by making as single mouse Click into the column header Every further mouse click into the same header will sort the entries of this column alternating between ascending and descending order Edit entries For a number of entries in the tree structure the list view contains at least one column whose entries can be edited If you want to edit any of these entries use the left mouse key and dou bleclick the entry you want to edit This will either lead you to a user window in which you can edit the entry or open an entry or selection field directly in the column itself if needed with the option to define the new entry yourself 07 2010 OScAR Pro Customized Operator User Manual 4 15 Operating Instructions for the OScAR Pro Customized Operator Setup and application of the Layout window 4 4 Setup and application of the Layout window The Layout window constitutes the work station for all graphic operations in the OScAR Pro Customized Operatorand enables you to edit the representation of the Frames in the DCO Script Use the Layout window to place individual Controls in your interface for the operation and for the output of information i Layout Test z iol xi N Frame area A3 Static control ab with text and image 5 Listbox ER Combobox Checkbox Button Checkbox Toolbar Static element with image and tex
8. 00008 5 133 The Instruction SetButtonStatus 0 0 00 ee 5 134 The Instruction SetButtonText cs 0i0 eek Gs cent Ee SG oh OR ESE BOS OE 5 135 The Instruction SetButtonTextColor 0 0 0 ee 5 136 The Instruction SetCheckBoxBackColor 0 000000 eee ee eee 5 137 The Instruction SetCheckBoxCaption 00 eee ee eee 5 138 The Instruction SetCheckBoxRect 0 000 cee eee eee eee eee 5 139 The Instruction SetCheckBoxState 0 0 0 00 ee 5 140 The Instruction SetCheckBoxStatus 0 0 0 0 0000 cee eee 5 141 The Instruction SetCheckBoxTextColor aaan auauua aaa 5 142 The Instruction SetCheckBoxToVariable 0 00 00 cee eee 5 143 The Instruction SetComboBoxBackColor 0000 0 eee 5 144 The Instruction SetComboBoxList 0 0 0 00 c eee 5 145 The Instruction SetComboBoxRect 0 000 ee 5 146 The Instruction SetComboBoxStatus 0 0 0 0 000 ccc ee 5 147 The Instruction SetComboBoxTextColor 0 0 0 0 eee 5 148 The Instruction SetComboToVariable 0 0 00 cee ee eee 5 149 The Instructions SetEditBackColor u auauna aaa aaa 5 150 The Instruction SetEditBackColorBlink 0 00 0 c eee eee 5 151 The Instruction SetEditRect ao 6 Seen Oh ee eee Ee Reed POS SM 5 153 The Instruction SetEditStatus auaa hoarse bw seas oeted ob eva stad ecu hearse 5 154 The Instruction SetEditText aaua are eg ed
9. Parameter group Broadcasts Admin amp bdc_id 1100 ID of the broadcast group administrated in OScAR Technics Pro for the area Admin amp Technics Production 1 bdc_id 1200 ID of the broadcast group administrated in OScAR Pro for the area Production 2 Production 2 bdc_id 1300 ID of the broadcast group administrated in OScAR Pro for the area Production 2 Management bdc_id 1000 ID of the broadcast group administrated in OScAR Pro for the area Management Table 6 13 Create Parameters 07 2010 6 30 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the global objects 6 4 3 Create the Variables Now create create the following Variables see Section 5 6 2 Add a new Variable Name Data type Value Description AdminTech bool 0 Info field to indicate that the Button Admin amp Tech blinking nics is currently blinking Production 1 bool O Info field to indicate that the Button Production 1 is blinking currently blinking Production 2 bool O Info field to indicate that the Button Production 2 is blinking currently blinking Fire alert blink bool 0 Info field to indicate that the Button Fire alert is cur ing rently blinking Short circuit bool 0 Info field to indicate that the Button Short circuit is blinking currently blinking Leakage blink bool O In
10. 0 0 0 0 0c cee 5 26 Create thie Fills fai wets an Ske a ie A A tacit ont a A i 5 28 Edit the attributes of Filters nnau naaa teed Saw eh asian kak Aas eee 5 28 OScAR Pro Customized Operator User Manual 0 11 Tables Table 5 28 Table 5 29 Table 5 30 Table 5 31 Table 5 32 Table 5 33 Table 5 34 Table 5 35 Table 5 36 Table 5 37 Table 5 38 Table 5 39 Table 5 40 Table 5 41 Table 5 42 Table 5 43 Table 5 44 Table 5 45 Table 5 46 Table 5 47 Table 5 48 Table 5 49 Table 5 50 Table 5 51 Table 5 52 Table 5 53 Table 5 54 Table 5 55 Table 5 56 Table 5 57 Table 5 58 Table 5 59 Table 5 60 Table 5 61 Table 5 62 Table 5 63 Table 5 64 Table 5 65 Table 5 66 Table 5 67 Table 5 68 Table 5 69 Table 5 70 Add an ID ranges 5 044 oe ie he Ewa DE ls Phe aS Se ed Oat tae 5 29 Edit the attributes of ID anges 20iw esate hea idles oi eee ewes 5 29 Add an Included ID esee a ak cnet h aah ane a kay ik oe ot eG 5 30 Edit the attributes of Included IDs 00 00 0000 ce eee 5 30 Add excluded Bc nanena aaa ae aaa ae re ea nO ener 5 31 Edit the attributes of an Excluded ID 0 0 0 000 eee 5 31 Attributes of FrameSauws oo Sos eee katate to hoG0Se deh eee we 5 32 The child nodes of the node Frames 00 0000 cee eee eae 5 35 PGC AMOW FANN sore tre Lee dened anette da Remake Lhe a a A E are 5 36 Edit the attributes of a Frame 20 44 4cc0ie tok nate See kee e oe ae 5 36 Add a new Control through t
11. 0 00 cee eee 5 140 The arguments of the Instruction SetCheckBoxStatus 5 141 0 13 Tables Table 5 115 Table 5 116 Table 5 117 Table 5 118 Table 5 119 Table 5 120 Table 5 121 Table 5 122 Table 5 123 Table 5 124 Table 5 125 Table 5 126 Table 5 127 Table 5 128 Table 5 129 Table 5 130 Table 5 131 Table 5 132 Table 5 133 Table 5 134 Table 5 135 Table 5 136 Table 5 137 Table 5 138 Table 5 139 Table 5 140 Table 5 141 Table 5 142 Table 5 143 Table 5 144 Table 5 145 Table 5 146 Table 5 147 Table 5 148 Table 5 149 Table 5 150 Table 5 151 Table 5 152 Table 5 153 Table 6 1 Table 6 2 Table 6 3 Table 6 4 Table 6 5 The arguments of the Instruction SetCheckBoxTextColor 5 142 The arguments of the Instruction SetCheckBoxToVariable 5 143 The arguments of the Instruction SetComboBoxBackColor 5 144 The arguments of the Instruction SetComboBoxList 5 145 The arguments of the Instruction SetComboBoxRect 5 146 The arguments of the Instruction SetComboBoxStatus 5 147 The arguments of the Instruction SetComboBoxTextColor 5 148 The arguments of the Instruction SetComboToVariable 5 149 The arguments of the Instruction SetEditBackColor 5 150 The arguments of the Instruction SetEditBackColorBlink 5 151 The arguments of the Instruction SetEditRect 5 153 The arguments of the In
12. 0 055 4 26 A CA BOM TOMS sociated anal leek dimer E a ts net ad anti ane a tes aaa 4 29 46 5 JEG COIS 33 2 SY oneaws th a eke eau bakes creel eee Sula he eee bo 4 31 07 2010 OScAR Pro Customized Operator User Manual 0 1 Contents 5 The Elements of a DCO Script 000 e eee eee eee 5 1 Belt General Structure s arara n Moy us kore bse a alg tear Rata nana ARG GN sat etch ecg al a eel aa 5 5 5 2 The DCO data types and their value rangeS 00 0c eee eee 5 7 BO OF MASS 3 fw aaa fot a eaa te ete Gu baits abs paian tee e foe Dyn O aaa ach aad dak eed 5 9 BEA E oA A oe ghee tent hau E aA coke a Dada ple rata pS aes abs dda bt ES 5 11 5 4 1 The attributes of Constants a a 0k lt c eneswas OP dae Pinion eben ek GR 5 11 5 4 2 Add anew Constant onciches So F45 5 65 ead Rede CSG ba dda ewe 5 12 5 4 3 Edit the attributes of a Constant 0 0 00000 eee 5 12 SS Parameters a Cees Pract ret dar a oh Gia aah nerk Cay pha ett hag cuba Sinan Nuak Sach ar ei betes ear ibe ee 5 13 5 5 1 Add a new Parameter group 0 ee ee 5 14 5 5 2 The attributes of Parameters 044 30 h6 6 eerie eee Ooh d eee Sees 5 15 55 3 AO a NEW F alalnelen so eissa ne ata es dena ar ea Mo a aS ate a 5 16 5 5 4 Edit the attributes of a Parameter 00 0000 ccc ee 5 16 560 WAN GDIOS ss oo ute ona aul a atc ate ae ow hen a A a anus uote won ata ae Mirela aea 5 17 5 6 1 The attributes of Variables nuanua naaa t Ge ce Pak aww wo ale W
13. 6 5 5 The User Function More blink on Description Use this Function to switch on the blinking of the Button More Attributes Attribute Contents Name More blink on Condition More blinking AND Selected message UEQ 1 Messagebox Instructions Instruction Arguments Contents The Instruction SetBut Button More tonBlink 1 Blink color E Blink color 2 Blink color E Background color Blink interval Blink interval 07 2010 6 36 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 6 The User Function Management blink on Description Use this Function to switch on the blinking of the Button Management Attributes Attribute Contents Name Management blink on Condition Management blinking Messagebox Instructions Instruction Arguments Contents The Instruction SetBut Button Management ton BNNK 1 Blink color M Blink color 2 Blink color M Background color Blink interval Blink interval 6 5 7 The User Function AdminTechnics blink on Description Use this Function to switch on the blinking of the Button AdminTechnics Attributes Attribute Contents Name AdmintTechnics blink on Condition AdminTech blinking Messagebox Instructions Instruction Arguments Contents The Instru
14. Instruction Arguments Contents The Instruction Call Function Enable invoke The Instruction Call Function Disable invoke 6 40 07 2010 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 13 The User Function Blink Buttons Description Use this Function to set all Buttons to blinking Attributes Attribute Contents Name Blink Buttons Condition Messagebox Instructions Instruction Arguments Contents The Instruction OffBut Button Fire tonBlink The Instruction OffBut Button Deflagration tonBlink The Instruction OffBut Button Leakage tonBlink The Instruction OffBut Button Short circuit tonBlink The Instruction OffBut Button More tonBlink The Instruction OffBut Button Management tonBlink The Instruction OffBut Button AdminTechnics tonBlink The Instruction OffBut Button Production 1 tonBlink The Instruction OffBut Button Production 2 tonBlink The Instruction Call Function Fire alert blink on The Instruction Call Function Deflagration blink on The Instruction Call Function Leakage blink on The Instruction Call Function Short circuit blink on The Instruction Call Function More blink on The Instruction Call Function Management blink on The Instruction Call Function AdminTechnics blink
15. Table 4 7 Edit standard colors for process lists 07 2010 4 26 OScAR Pro Customized Operator User Manual Operating Instructions for the OScAR Pro Customized Operator General user dialog windows Summary of the fields in the windows Standard colors for process lists and Process colors Input field Description Active broadcast a Active broadcast eae Active conference e Active conference a Active info telephone profile ky Active info telephone profile lt Inactive process a XX Cancel ENERE XK Cancel Idle subscriber pase Idle subscriber a Called subscriber Ea Called subscriber i Subscriber not reached Ez Subscriber not reached Sibscriber listens to announcement am Sibscriber listens to announcement Welcome announcement to subscriber completed Ea Welcome announcement to subscriber completed PIN entry requested from subscriber Ea PIN entry requested from subscriber kz Subscriber reached Ea Subscriber reached za Calling of subscriber paused Calling of subscriber paused Ex No further processing of subscriber Ea No further processing of subscriber z Conferee has muted himself Conferee has muted himself x Conferee paticipates passively ES Conferee paticipates passively aa Conferee paticipates actively Conferee paticipates actively EI Conferee on hold Ea Conferee on hold i Active broadcast This color visualizes a broadcast that
16. To edit the font font size or font style simply make a double click on this line to open the corresponding user window with the name Font see Section 4 6 4 Edit fonts Text color Editable combobox to specify the general color for entries in the Combobox Here you can e enter a color value e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors or e assign a Constant Parameter or Variable of the data type color The color of the entries ina Combobox can be changed during the execution of the DCO Script with the command The In struction SetComboBoxTextColor Type Combobox to define the data type for the Combobox see Sec tion 5 2 The DCO data types and their value ranges Table 5 66 Special attributes of Comboboxes The child nodes of Comboboxes Each Combobox has the following child node Child node Description Data elements This child node can contain a list of data elements that are out put in the Combobox itself as entries For a detailed description of the attributes of the data ele ments please see the Section 5 7 1 The attributes and child nodes of the node Data lists Table 5 67 The child nodes of Comboboxes 07 2010 OScAR Pro Customized Operator User Manual 5 87 The Elements of a DCO Script Controls 5 9 17 Selection events of Comboboxes Selecting a combobox entry internally leadts to sending a
17. CheckBoxCaption Note If you add a amp sign to your string the character that comes after the sign is automatically underlined For the DCO De signer to output the amp sign on a Checkbox always make sure you enter the sign twice e g amp amp State Combobox to define if the Button is marked Here you can e choose 0 to remove the marking from the selected Check box e 1 to mark a Checkbox or e assign a Constant Parameter or Variable of the data type bool The state of a Checkbox can be changed during the execution of the DCO Script with the command The Instruction Set CheckBoxState Table 5 60 Special attributes of Checkboxes 5 78 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls 5 9 12 Child nodes and special attributes of Listboxes Listboxes have the following additional attributes Attribute Description Font Field indicating the font currently used for the entries of the Listbox To edit the font font size or font style simply make a double click on this line to open the corresponding user window with the name Font see Section 4 6 4 Edit fonts Text color Editable combobox to specify the color in which the entry shall be rendered in a Listbox entry ignored in Comboboxes Here you can e enter a color value e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colo
18. Table 5 39 Add a new Control through the Layout window 07 2010 5 38 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Frames 5 8 6 Edit the attributes of a Control Follow the below instructions to edit the attributes of an existing Control No Task Go to the tree structure and open the node Frames 2 Open the parent Frame of the Control you want to edit 3 Still in the tree open the child node Controls under Frames that contains the Control you want to edit 4 Now click the Control whose attributes you want to edit 5 To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value see Section 5 9 Controls If necessary also edit the attributes and Instructions in the other child nodes of this Con trol Table 5 40 Edit the attributes of a Control 07 2010 OScAR Pro Customized Operator User Manual 5 39 The Elements of a DCO Script Frames 5 8 7 OScAR Pro command templates OScAR Pro commands are created and edited in the child node OScAR Pro command tem plates under the node Frames and with the help of instructions seeSection 5 11 Instruc tions addressed to the OScAR Pro server through the OScAR Pro TT Operator Tool where they set off processes broadcasts conferences etc You can create as many commands as you like The attributes of the OScAR Pro command templates are equivalent to th
19. The project is based on the below plant map of the company premises j Map of Plant EXP Chemical Industries Inc Plant Anywhere Legend m Fire department mm Security services Management m Administration amp Technics m Production area 1 File Production area 2 Image 6 1 Plant map of the premises and grounds of Chemical Industries Inc The map covers four areas e Central Administration in light green e Administration amp Technics against violet background e Production Area 1 against light salmon background and e Production Area 2 against yellow background 07 2010 OScAR Pro Customized Operator User Manual 6 5 The planning and implementation of a DCO Project The case study project 6 1 3 Objects administrated in OScAR Pro To meet the demands of this project the following objects were administrated through the DAKS TT Administrator Tool and added to the objects installed ex works ID Name Description Subscribers sysadm System administrator with the PIN 9500 and full admin istrative and operative rights Test Management This test phone represents the area Management Test A amp P This test phone represents the area Admin amp Technics Test F1 This test phone represents the area Production 1 Test F2 This test phone represents the area Production 2 Test Fire alert This test phone represents the fire department
20. dial all call numbers assign a Constant Parameter or Variable of the data type byte or assign the reference to a Control that has the data type byte Table 5 41 Attributes and child nodes of the node OScAR Pro command templates 5 42 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Frames Attribute Description Cornet N Q performance features Combobox to define if Cornet specific features shall be applied for hunt groups Here you can e select 0 if you do not want to use Cornet N Q features e select 1 to use Cornet N Q features e assign a Constant Parameter or Variable of the data type bool or e assign the reference to a Control that has the data type bool Monitor subscriber connec tion status Combobox to define if you want the system to monitor the states of subscribers in hunt groups Here you can e select 0 if you do not want the system to monitor the states of subscribers e select 1 to monitor the states of the subscribers e assign a Constant Parameter or Variable of the data type bool or e assign the reference to a Control that has the data type bool Key confirmation Combobox to define if you want the subscribers of hunt groups to confirm their acceptance of the call by pushing a key Here you can e select 0 for no request of key confirmation e select 1 to use the request key conformation option e assign a Constant Parameter or Var
21. ed Button the text color of which you want to edit Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Color Editable combobox to define the text color you want to assign to the Static element of the Button Here you can e enteracolor value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 105 The arguments of the Instruction SetButtonStaticTextColor 07 2010 5 132 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 38 The Instruction SetButtonStaticTextPosition Description Use this Function Instruction to edit the positioning of the text of a Static element on a Button Arguments Arguments Description Button Editable combobox to choose the Button with the Static ele ment whose text position you want to edit Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Static element Editable combobox to choose the Static element of the select ed Button the text position of which you want to edit Here you can e enter the name of the Static el
22. 320 x 240 Sets the size of the Frame to 320 x 240 pixels Ctrl F7 640 x 480 Sets the size of the Frame to 640 x 480 pixels Ctr1 F8 Table 4 2 Summary of the menu items and buttons of the OScAR Pro Customized Op erator 07 2010 4 10 OScAR Pro Customized Operator User Manual Operating Instructions for the OScAR Pro Customized Operator Layout of the interface of the OSCAR Pro Customized Operator Menu item Description 800 x 600 Sets the size of the Frame to 800 x 600 pixels Ctr1l F9 1024 x 768 Sets the size of the Frame to 1024 x 768 pixels Ctrl F10 1280 x 1024 Sets the size of the Frame to 1280 x 1024 pixels Ctr1l F10 User defined Opens a window to adjust the Frame size to your own de Ctrl F12 mands Special entries of the Preview window The pull down menu Project Parameter editor Opens the editor to edit the parameters of the DCO Script SHIFT Ctrl P Table 4 2 Summary of the menu items and buttons of the OScAR Pro Customized Op erator 4 2 4 Functions of the mouse The functions of the mouse are largely Windows compliant However the Structure and the Layout window of the OScAR Pro Customized Operator offer some additional functions that are described below The left mouse key e Drag amp Drop with the left mouse key In the Structure window the entries in the tree list view can be moved and copied by Drag ging them with the left mouse key In this way you ca
23. Changes the position and size The Instruction SetStaticSta tus Changes the output and editing The Instruction SetStaticText Changes the text The Instruction SetStaticText Color Changes the text color Table 5 70 5 94 Overview of Instructions OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions Instruction Description The Instruction SetStaticText Changes the positioning of the text Position Instructions for Edit fields The Instruction OffEditBack Turns the background blinking off ColorBlink The Instruction OffEditText Turns the blinking of the text off ColorBlink The Instructions SetEditBack Changes the background color Color The Instruction SetEditBack Turns the background blinking on ColorBlink The Instruction SetEditRect Changes the position and size The Instruction SetEditStatus Changes the output and editing The Instruction SetEditText Changes the content The Instruction SetEditText Changes the color of the content Color The Instruction SetEditText Turns the blinking of the content on ColorBlink The Instruction SetEditToVari Sets a Variable to the content able Instructions for Buttons The Instruction OffButton Turns the blinking off Blink The Instruction SetButton Turns the blinking on Blink
24. Computation operations 5 9 CON 5 24 5 41 5 46 5 108 Concatenation 5 9 Conditions 5 91 example 5 92 greater than 5 91 greater than or equal to 5 91 less than 5 91 less than or equal to 5 91 logical and connection 5 91 logical or connection 5 91 negation 5 91 same as equal 5 91 unequal 5 91 Consistency 4 22 Constants 2 5 4 14 5 6 5 11 add a new Constant 5 12 attributes 5 11 edit Constant attributes 5 12 name 5 11 type 5 11 value 5 11 Control name 5 59 Controls 4 16 4 17 5 56 add a new Control via the Layout window 5 38 add a new Control via the Structure win dow 5 37 background color 5 60 Change size 4 20 edit Control attributes 5 39 height 5 59 left 5 59 Mark 4 18 Move 4 19 references to Controls 5 58 Space evenly 4 21 status 5 61 top 5 59 use Controls 5 56 width 5 59 Create Background image 6 14 Buttons 6 19 Captions 6 16 Constants 6 29 Controls 6 12 DAKS command templates 6 33 Data lists 6 32 Filters 6 32 Frames 6 12 Functions 6 34 Listboxes 6 24 Lists 6 32 Parameters 6 30 Separator lines 6 15 Variables 6 31 Currently available images 2 5 Customized interface 2 2 2 4 07 2010 OScAR Pro Customized Operator User Manual D DAKS command template 5 106 DAKS command templates 5 40 add anew DAKS command template 5 52 BDC attributes 5 42 bring all other broadcasts to top 5 48 bring all other conferences to top 5 48 bring own broadcasts to top 5
25. delete or use personal data in any way whatsoever e Make sure that no unauthorized persons have access to data storage mediums for exam ple backup disks or printouts of protocols This applies both to service work performed at your company and to the storage and transport of data mediums e Make sure that all data storage mediums that are no longer needed are completely de stroyed Also always check that you do not leave behind any papers that could become openly accessible to others 07 2010 1 4 OScAR Pro Customized Operator User Manual Overview 2 Overview Overview This chapter gives you a general overview of the product itself It explains the philosophy that underlies the DCO Designer and covers the different components that are needed for the full operation of the system Contents The chapter covers the following areas 2 1 Description of functions 2 2 Example application 2 3 Interactions of the DCO components 2 4 The tasks of the OScAR Pro Customized Operator 2 5 The tasks of the DCO Script 2 6 The tasks of the OScAR Pro TT Operator Tool 07 2010 OScAR Pro Customized Operator User Manual 2 1 Overview Description of functions 2 1 Description of functions The OScAR Pro Customized Operator short DCO enables you to tweak the operation and output of the OScAR Pro TT Operator Tool to the individual needs and requirements of your business In the past the corporate persons who operate the OScAR Pro TT O
26. e Top 105 5 8 6 Edit the attributes of a Con e Width 450 trol e Height 360 e Font Microsoft Sans Serif e Font style Standard 4 6 4 Edit fonts e Size 10 Table 6 11 Add Controls to the Frame Announcement selection 07 2010 6 24 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create Frames and Controls No Task References Now create a Button with the following attribute val ues Name Ok 5 8 5 Add a new Control through the Layout window J e Left 200 5 8 6 Edit the attributes of a Con e Top 470 trol e Width 200 e Height 60 e Font Microsoft Sans Serif 4 6 4 Edit fonts e Font style bold e Size 14 e Text Ok e Image scaling in 70 e Image Ok GIF 7 Now create a Button with the following attribute val 5 8 5 Add a new Control through ues the Layout window e Name Cancel e Left 450 5 8 6 Edit the attributes of a Con e Top 470 trol e Width 200 e Height 60 e Font Microsoft Sans Serif 4 6 4 Edit fonts e Font style bold e Size 14 e Text Cancel e Image scaling in 70 e Image CANCEL GIF 8 Next click Gly to switch to the Layout window and ver ify your results 9 Finally click ej to save the project Table 6 11 Add Controls to the Frame Announcement selection 07 2010 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create Frames and Controls 6 3 7 Screensho
27. normal page The broadcasted messages are processed in the specified Function of the branch On_Message of both pages Arguments Arguments Description Message Editable combobox to specify the function name in the branch On_Message that shall be executed Here you can e enter the name of an On_Message function direct or e select a On_Message function from the list of all avail able functions Table 5 76 The arguments of the Instruction BroadcastMessage 07 2010 5 104 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 9 The Instruction ClearComboBox Description Use this Instruction to clear a Combobox i e remove all List elements Arguments Arguments Description Combobox Editable combobox to specify the Combobox that you want to clear Here you can e either enter the name of the Combobox direct or e select a Combobox from the list of all available Combob Oxes Table 5 77 The arguments of the Instruction ClearComboBox 07 2010 OScAR Pro Customized Operator User Manual 5 105 The Elements of a DCO Script Instructions 5 11 10 The Instruction Execute Description Use this Instruction to carry out a OScAR Pro command template see Section 5 8 7 OScAR Pro command templates to trigger the below processes in OScAR Pro Launch Broadcasts Convene conferences Switch Info Telephone Start scenarios Set the o
28. the name Font see Section 4 6 4 Edit fonts Table 5 54 Special attributes of Buttons 07 2010 5 70 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls Attribute Description Text color Editable combobox to choose the color for the title of the But ton Here you can e enter a color value e Click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors or e assign a Constant Parameter or Variable of the data type color The color of the title of the Button can be changed during the execution of the DCO Script with the command The Instruc tion SetButtonTextColor Image scaling in Editable combobox to define the scaling factor for the image on a Button Here you can e enter a scaling factor in e select proportional to align the image with the size of the Button in keeping with the Button s height width propor tion or e select unproportional to align the image with the full scale of the Static element irrespective of the actual height width proportion The image assigned to a Button can also be scaled during the execution of the DCO Script with the command The Instruc tion SetButtonPictureScal Image Editable combobox to specify the image assigned to a Button Here you can e enter a file name from the List of images e select an image in the user window that opens as you click
29. 24 5 11 25 5 11 26 5 11 27 5 11 28 5 11 29 5 11 30 5 11 31 5 11 32 5 11 33 5 11 34 5 11 35 5 11 36 5 11 37 5 11 38 5 11 39 5 11 40 5 11 41 5 11 42 5 11 43 5 11 44 5 11 45 5 11 46 5 11 47 5 11 48 5 11 49 5 11 50 5 11 51 5 11 52 5 11 53 5 11 54 5 11 55 5 11 56 5 11 57 5 11 58 5 11 59 5 11 60 5 11 61 5 11 62 5 11 63 5 11 64 5 11 65 5 11 66 The Instruction OffListBoxltemBlink 0 0 0 0 00 0 0c cee eee 5 117 The Instruction SetButtonBlink 0 0000000000 cee ee 5 118 The Instruction SetButtonColor a nus aaa naaa a cae oe he ek eee 5 120 The Instruction SetButtonPicture 0 0 0 0 ee 5 121 The Instruction SetButtonPictureScal 0 0 0 0 0 cc ee 5 122 The Instruction SetButtonRect aaua aaau aaea 5 123 The Instruction SetButtonStaticBackColor 2 0 0 0 cee ee 5 124 The Instruction SetButtonStaticBorderColor 0 0 00 0c eee 5 125 The Instruction SetButtonStaticPictureName 00 00008 5 126 The Instruction SetButtonStaticPicturePos 0 0 00 000 ee 5 127 The Instruction SetButtonStaticPictureScale 00005 5 128 The Instruction SetButtonStaticRect 0 0 0000 eee 5 129 The Instruction SetButtonStaticStatus 2 0 ee 5 130 The Instruction SetButtonStaticText 0 00 00 ee 5 131 The Instruction SetButtonStaticTextColor 0 0 ee 5 132 The Instruction SetButtonStaticTextPosition
30. 42 5 45 5 107 blink 6 8 6 34 6 41 Blink interval 5 118 Bounding box 4 19 5 38 6 20 07 2010 OScAR Pro Customized Operator User Manual Index Broadcast group 2 2 BroadcastMessage 5 104 Button 4 17 5 56 add a new Function to a Button 5 73 add a new Static element 5 75 background color 5 60 edit Function attributes 5 74 edit Static element attributes 5 76 font 5 70 Functions 5 72 height 5 59 image 5 71 image scaling 5 71 layout 5 70 left 5 59 name 5 59 Static elements 5 72 status 5 61 text 5 70 text color 5 71 top 5 59 width 5 59 C Call 5 93 5 103 CALLWHI 5 41 5 47 CANCELWHI 5 41 Case study Project 6 4 CD ROM 3 2 cdsetup 3 2 Change height 4 20 5 33 5 59 Change height and width 4 20 Change left position 5 59 Change the sequence of the columns 4 15 Change top position 5 59 Change width 4 20 5 33 5 59 Change width and height 4 20 Checkbox 4 17 5 56 5 58 background color 5 60 border style 5 77 font 5 77 height 5 59 left 5 59 name 5 59 Index references to Checkboxes 5 58 state 5 78 status 5 61 text 5 78 text color 5 77 top 5 59 width 5 59 Child nodes 4 14 ClearComboBox 5 98 5 105 Combobox 4 17 5 57 5 58 background color 5 60 data elements 5 87 font 5 87 height 5 59 left 5 59 name 5 59 references to Comboboxes 5 58 status 5 61 text color 5 87 top 5 59 type 5 87 width 5 59 Compare texts 5 10 Components 2 4 Computation instruction 5 9 Computation of integers 5 9
31. 48 bring own conference to top 5 48 Broadcasts 5 45 CALLWHI attributes 5 47 CON attributes 5 46 conference ID 5 46 Cornet N Q features 5 43 dialing parameters 5 46 dialing subscribers 5 42 5 46 display text 5 42 edit DAKS command template attributes 5 53 End broadcast via ID 5 50 End conference via ID 5 51 End process via process list 5 49 general attributes 5 40 Group announcements 5 45 high priority call 5 43 info telephone ID 5 46 Info text 5 47 ITL attributes 5 46 monitor subscriber status 5 43 name 5 40 OnMax 5 44 OnMin 5 44 scenario ID 5 47 SCN attributes 5 47 SET_PRM attributes 5 48 Show local call dialog 5 47 Standard announcements 5 45 type 5 41 WHI number 5 47 DAKS commands 2 4 DAKS Customized Operator 2 2 DAKS Processes 2 6 DAKS Release 7 OScAR Pro V3 R2 1 2 3 2 DAKS Server 3 2 07 2010 OScAR Pro Customized Operator User Manual Index DAKS TT Operator Tool DCO Window 7 2 start DCO in a child window 7 3 Data elements 5 19 add a new data element 5 23 color 5 21 displayed text 5 21 edit data element attributes 5 23 value 5 21 Data list 5 19 Data lists add a new Data list 5 22 data elements 5 20 edit Data list attributes 5 22 name 5 20 type 5 20 Data types 5 7 ann_id 5 8 bdc_id 5 7 bool 5 7 byte 5 7 cas_id 5 7 color 5 8 con_id 5 7 dsp_txt 5 8 float 5 7 int 5 7 itemlist 5 8 phone_no 5 7 process 5 8 string 5 7 uint 5 7 value ranges 5 7 Database 2 5 DCO Designer Graphic editor 2 5 Instal
32. 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 121 The arguments of the Instruction SetComboBoxTextColor 07 2010 5 148 OScAR Pro Customized Operator User Manual 5 11 54 Description The Elements of a DCO Script Instructions The Instruction SetComboToVariable Use this Function Instruction to save the element that is currently selected in a Combobox ina Variable To do so the Variable and the Combobox must have the same data type see Section 5 2 The DCO data types and their value ranges Arguments Arguments Description Combobox Editable combobox to specify the Combobox whose currently selected element you want to save in a Variable Here you can e enter the name of the Combobox direct or e select a Combobox from the list of all available Combob oxes Variable Editable combobox to specify the Variable in which you want to save the selected Combobox element Here you can e enter the name of the Variable direct or e select a Variable from the list of all Variables that are avail able Table 5 122 07 2010 The arguments of the Instruction SetComboToVariable OScAR Pro Customized Operator User Manual 5 149 The Elements of a DCO Script Instructions 5 11 55 The Instructions SetEditBackColor Description Use this Function Instructio
33. 5 24 5 41 5 46 5 110 K Keywords 5 9 KILLBDC 5 50 KILLCON 5 51 KILLPRC 5 49 L Language 3 3 LastGUlOpened 7 10 LastGUIReOpen 7 10 Less than 5 10 Less than or equal to 5 10 LET 5 10 Link texts together 5 9 List view 4 15 Listbox 4 17 5 56 5 58 5 107 5 108 5 110 5 112 5 113 add a new process Filter 5 85 background color 5 60 blink interval 5 80 border style 5 79 data elements 5 81 edit process Filter attributes 5 86 font 5 79 Index height 5 59 left 5 59 name 5 59 process process colors 5 80 process Process filters 5 81 process Tan 5 80 references to Listboxes 5 58 status 5 61 text color 5 79 top 5 59 type 5 79 width 5 59 Lists 4 14 5 6 LOGICAL 5 24 Logical AND operation 5 10 Logical connection 5 91 Logical operation 5 9 Logical OR operation 5 10 LT 5 10 M Mark 4 18 Mark Controls 4 19 Mathematical statement 5 9 Menu bar 4 4 Message window 5 90 Button No 5 90 Button Yes 5 90 Messagebox 5 90 Mouse functions 4 11 Move columns 4 15 MSG 5 24 5 112 MUL 5 9 Multiplication 5 9 N Network 3 2 Nodes 4 14 none 5 62 5 68 5 77 5 79 Notations used in this manual 1 3 Note Button blink 5 119 execute external program 5 182 show announcement 5 112 show broadcasts 5 107 2 6 show conferences 5 108 show info telephone 5 110 show scenarios 5 113 Numeric statement 5 9 O OffAllListBoxltemBlink 5 97 5 114 OffButtonBlink 5 95 5 115 OffEditBackColorBlink 5 95 5 115 OffEditTextColorBlink 5
34. 76 height 5 59 image 5 63 image file name 5 63 image position 5 64 image scaling 5 65 left 5 59 name 5 59 status 5 61 top 5 59 width 5 59 Status bar 4 12 SUB 5 9 Subtraction 5 9 sunken 5 68 5 77 5 79 Symbols used in this manual 1 3 sysadm 6 6 T Test 4 22 Test area 4 22 Test the DCO Script 6 66 tetronik DAKS TT 3 5 Text Image horizontal 5 70 vertical 5 70 The Parameters 4 14 Tile automatically 4 21 Toolbar 4 4 5 33 Toolbar is fixed 5 34 Toolbar size 5 34 Touchscreen 6 4 TRUE 5 91 Type 5 32 07 2010 OScAR Pro Customized Operator User Manual U Unequal 5 10 uninstall 3 6 unproportional 5 65 5 71 5 128 5 175 UQL 5 10 Use standard colors 4 28 User 5 35 5 54 5 55 User window 4 23 V Validation 2 4 Validity 4 22 Variables 2 5 4 14 5 6 add a new Variable 5 18 edit Variable attributes 5 18 name 5 17 type 5 17 value 5 17 Version number 4 23 W Windows 3 2 Execute 3 2 registry entries 7 10 07 2010 OScAR Pro Customized Operator User Manual Index Index Z 10 07 2010 OScAR Pro Customized Operator User Manual
35. 95 5 116 OffListBoxltemBlink 5 97 5 117 On_Load 5 35 5 54 5 55 On_Message 5 35 5 54 5 55 On_Timer 5 35 5 54 5 55 Open PDF file 5 182 Operands 5 91 Operator 1 5 91 AND 5 91 EQL 5 91 UEQ 5 91 Operators 5 91 OR 5 10 P Parameter group add a new Parameter group 5 14 Parameters 5 6 6 8 add a new Parameter 5 16 comment 5 15 edit Parameter attributes 5 16 file 5 13 name 5 15 Parameter group 5 13 standard values 5 13 type 5 15 values 5 15 Parenthesis 5 91 PHYSICAL 5 24 Placeholder 5 11 5 13 5 17 07 2010 OScAR Pro Customized Operator User Manual Plant map 6 5 Position 5 34 h center bottom 5 64 5 67 5 127 5 133 5 174 5 180 h center top 5 64 5 67 5 127 5 133 5 174 5 180 h center v center 5 64 5 67 5 127 5 133 5 174 5 180 left bottom 5 64 5 67 5 127 5 133 5 174 5 180 6 14 left top 5 64 5 67 5 127 5 133 5 174 5 180 left v center 5 64 5 67 5 127 5 133 5 174 5 180 right bottom 5 64 5 67 5 127 5 133 5 174 5 180 right top 5 64 5 67 5 127 5 133 5 174 5 180 right v center 5 64 5 67 5 127 5 133 5 174 5 180 Preview window 4 22 Privacy and data security 1 4 Procedures 2 5 Process context 5 50 5 51 Process filters 5 81 name 5 82 process status 5 83 status 5 84 type 5 82 PROCESS_BDC 5 82 PROCESS_BDCMBR 5 82 PROCESS_CON 5 82 PROCESS_CONMBR 5 82 PROCESS_ITL 5 82 Processes 2 6 Colors 4 26 Project 4 3 case study 6 4 create 6 10 Name 4 23 open 6 1
36. Add Functions to a Button 5 9 8 Edit the attributes of the Functions of a Button 5 9 9 Add Static elements to a Button 5 9 10 Edit the attributes of the Static elements of a Button 5 9 11 Special attributes of Checkboxes 5 9 12 Child nodes and special attributes of Listboxes 5 9 13 Double click events of Listboxes 5 9 14 Add new Process filters to Listboxes 5 9 15 Edit the attributes of Process filters 5 9 16 The child nodes and special attributes of Comboboxes 5 9 17 Selection events of Comboboxes 5 10 Functions 5 10 1 The attributes and child nodes of Functions 5 10 2 Setup and syntax of conditions 07 2010 5 2 OScAR Pro Customized Operator User Manual The Elements of a DCO Script 5 11 Instructions 5 11 1 Arguments of Instructions 5 11 2 Overview of Instructions 5 11 3 Add a new Instruction 5 11 4 Edit Instructions 5 11 5 Change the order in which the Instructions are executed 5 11 6 The Instruction AddListtoComboBox 5 11 7 The Instruction Call 5 11 8 The Instruction BroadcastMessage 5 11 9 The Instruction ClearComboBox 5 11 10 The Instruction Execute 5 11 11 The Instruction GetBroadcasts 5 11 12 The Instruction GetConferences 5 11 13 The Instruction GetComboBoxSelText 5 11 14 The Instruction GetInfotelephones 5 11 15 The Instruction GetListBoxSelText 5 11 16 The Instruction GetMessages 5 11 17 The Instruction GetScenarios 5 11 18 The Instruction GotoFrame 5 11 19 The Instructi
37. Arguments Arguments Description Button Editable combobox to define the Button whose position and size you want to edit Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Links Editable combobox to define the left and upper top margin as Top well as the width and the height in pixels Here you can Width e enter a numeric value Height e assign a Constant Parameter or Variable of the data type int or e assign a reference to a Control that has the data type int Table 5 96 The arguments of the Instruction SetButtonRect 07 2010 OScAR Pro Customized Operator User Manual 5 123 The Elements of a DCO Script Instructions 5 11 29 The Instruction SetButtonStaticBackColor Description Use this Function Instruction to change the background color of a Static element on a Button Arguments Arguments Description Button Editable combobox to define the Button whose Static element you want to give a different background color Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Static element Editable combobox to define the Button s Static element to which you want to assign a different background color Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Color Editable combobox to define the background col
38. Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 115 The arguments of the Instruction SetCheckBoxTextColor 07 2010 5 142 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 48 The Instruction SetCheckBoxToVariable Description Use this Function Instruction to save a Checkbox s current state in a Variable of the data type bool In this process the Variable assumes one of the below integers e Oif the Checkbox is not marked or e 1 if the Checkbox is marked Arguments Arguments Description Checkbox Editable combobox to specify the Checkbox whose state you want to save in a Variable Here you can e enter the name of the Checkbox direct or e select a Checkbox from the list of all Checkboxes that are available Variable Editable combobox to specify the Variable you want to use to save the state of the selected Checkbox Here you can e enter the name of the Variable direct or e select a Variable of the data type bool from the list of all available Variables Table 5 116 The arguments of the Instruction SetCheckBoxToVariable 07 2010 OScAR Pro Customized Operator User Manual 5 143 The Elements of a DCO Script Instructions 5 11 49 The Instruction SetComboBoxBackColor Description Use this Function Instruction to change the background color of a Combobo
39. Description This Function launches a broadcast for the Production area 2 provided 1 is selected for the Variable Production 2 blinking Attributes Attribute Contents Name Invoke Production 2 Condition Production 2 blinking AND Selected message UEQ 1 Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable Selected broadcast able Value Production 2 The Instruction Exe Execute OScAR Pro com Invoke broadcast cute mand template 07 2010 6 46 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 20 On_Load Function Set Buttons Description This Function sets the blink attributes of the Buttons in keeping with the blink states on load specified in the matching Variables Attributes Attribute Contents Name Set Buttons Condition Fire alert blinking AND Selected message UEQ 1 Messagebox Instructions Instruction Arguments Contents The Instruction Call Function Blink Buttons 6 5 21 The Functions of the Button Fire alert The Functions underneath the Button Fire alert are automatically invoked when this Button is pressed 6 5 21 1 The Function Delete Description Use this Function to reset the flag that governs the blinking of the Button Attributes Attribute Con
40. Edit field e choose 1 to show the Edit field and enable entries e choose 2 to output the Edit field but block all entries e assign a Constant Parameter or Variable of the data type uint or e assign the reference to a Control that has the data type uint Table 5 126 The arguments of the Instruction SetEditStatus 07 2010 5 154 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 59 The Instruction SetEditText Description Use this Function Instruction to change the content text of the Edit field Arguments Arguments Description Edit field Editable combobox to specify the Edit field whose content you want to edit Here you can e enter the name of an Edit field direct or e select an Edit field from the list of all Edit fields that are available Text Editable combobox to enter the content of the Edit field Here you can e enter a string e assign a Constant Parameter or Variable of the data type string e assign the reference to a Control that has the data type string Table 5 127 The arguments of the Instruction SetEditText 07 2010 OScAR Pro Customized Operator User Manual 5 155 The Elements of a DCO Script Instructions 5 11 60 The Instruction SetEditTextColor Description Use this Function Instruction to change the color of the text of an Edit field Arguments Arguments Description Edit field Editable combobox to specify the Ed
41. Here you can e enter the name of the Data list direct or e select a Data list from the list of all available Data lists of the data type bdc_id Filter Editable combobox to define the Filter that is used to limit the received broadcasts Here you can e enter the name of the Filter direct or e select one of the Filters of the type BDC that are already available Table 5 79 The arguments of the Instruction GetBroadcast Note To have the broadcast List received with this command output on top you need to place a List or Combobox in the Frame and in a second step fill either or both using the command The Instruction SetListBoxList or The Instruction SetComboBoxList and the aforementioned Data list 07 2010 OScAR Pro Customized Operator User Manual 5 107 The Elements of a DCO Script Instructions 5 11 12 The Instruction GetConferences Description Use this Instruction to invoke a list of all DAKS TT Administrator Tool administrated conferenc es and fill the Data list with the obtained entries Please note that the Data list is automatically cleared before it is filled with the new entries In this process the system will apply if available the Filter that was specified see Section 5 7 Lists Note The List invoked with this Instruction only contains conferences for which the field ID to trigger via telephone was enabled Arguments Arguments Description Data list E
42. Instruction GotoF Frame Main page rame 07 2010 6 64 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Frame Announcement selection 6 6 4 2 The Function Without selection Description This Function detects if the Button was pressed before an announcement was marked Whenever this occurs the Function will ask the user in a messagebox if he really wants to cancel the dialog If the user confirms the system will immediately jump back to the Main page Attributes Attribute Contents Name Without selection Condition LISTBOX Announcement list EQL Messagebox No selection found Cancel Instructions Instruction Arguments Contents The Instruction Call Function On cancel 07 2010 OScAR Pro Customized Operator User Manual 6 65 The planning and implementation of a DCO Project Test the DCO Script 6 7 Test the DCO Script Follow the below instructions to test your DCO Script No Task Next click I to switch to the Layout window and verify the result Confirm the query if you want to save the project with Yes Now press the Button Fire alert The Button must start to blink and the Static element Event name should read 1000 Fire alert 4 Press the Button Fire alert again The Button should now stop blinking 5 Repeat steps 3 and 4 for the Buttons Deflagrati
43. Note title e Left 1105 e Top 785 e Width 150 e Height 25 e Text Hints e Text color 0000FF e Position left v center e Font Microsoft Sans Serif e Font style bold e Size 14 Table 6 7 Add a Caption 07 2010 OScAR Pro Customized Operator User Manual 6 17 The planning and implementation of a DCO Project Create Frames and Controls No Task References values e Name Left Top Width Height Text Text color Position Font Font style Size 9 Now repeat steps 4 and 5 with the following attributes Note text 1105 820 150 50 1 Select event n 2 Select area n 3 Invoke 0000FF left top Microsoft Sans Serif bold 10 10 Finally click fj to save the project ify the result 11 Next click E to switch to the Layout window and ver Table 6 7 6 18 Add a Caption 07 2010 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create Frames and Controls 6 3 5 Add Buttons to the Main page This section shows you how to create e the Event Buttons e the Area Buttons and e the Invoke Button Also texts and images are assigned to of these Buttons Insert Event Buttons Follow the below instructions to insert Event Buttons through the Layout window No Task References 1 Goto the tree view of the Structure Window and open the node Frames 2 Now open the node Main
44. OScAR Pro Customized Operator User Manual The DCO in the OScAR Pro TT Operator Tool Operation of the DCO Window 7 3 1 Load a DCO Scripts for the first time in the OScAR Pro TT Operator Tool When it first started the OScAR Pro TT Operator Tool has neither a DCO Script set up for it nor is the DCO Window visible Follow the below instructions to open the DCO Window and create a DCO Script No Task 1 Start the OScAR Pro TT Operator Tool see the OScAR Pro TT User Manual 2 Go to the menu bar and click Window gt OScAR Pro Customized Operator and use the keyboard shortcut CtrltSHIFT F4 or click EJ in the toolbar 3 The DCO Window is opened in form of a child window Application Operations DCO View Window E a C Localhost 1 amp Name Broadcasts Broadcasts Co RA Locanosee OOO OOOO OOOO BR Sc Be lt 4 in this window select the menu item Custom Operator gt load DCO Script This will open a user window to select a file 5 Select the DCO Script dco file you want to open and close the window with Ok Table 7 3 Initial loading of a DCO Script in the OScAR Pro TT Operator Tool 07 2010 OScAR Pro Customized Operator User Manual 7 7 The DCO in the OScAR Pro TT Operator Tool Operation of the DCO Window No Task 6 If needed adjust the parameters of the DCO Script with the Parameter Editor see The DCO Parameter Editor
45. Ok to close the window The DCO Designer outputs the newly added process Filter in the tree view of the Struc ture window and there in the child node Process Filter of the pertinent Listbox If needed you can now edit the attributes of the process Filter Table 5 64 Add Process filters to a Listbox 07 2010 OScAR Pro Customized Operator User Manual 5 85 The Elements of a DCO Script Controls 5 9 15 Edit the attributes of Process filters Follow the below instructions to edit the attributes of an existing process Filter No Task Go to the tree structure and open the node Frames Open the parent Frame of the Listbox whose Process filters you want to edit Now open the child node Controls Open the Listbox whose Process filters you want to edit Now click the child node Process filters Select the process Filter whose attributes you want to edit To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value Se Pe SPN ee Table 5 65 Edit the attributes of the Process filters of a Listbox 07 2010 5 86 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls 5 9 16 The child nodes and special attributes of Comboboxes Comboboxes have the following additional attributes Attribute Description Font Field indicating the font that is currently used for the entries in the Combobox
46. Operator Tool 7 7 7 4 The DEO Parameter Editor s ssc s ae vice Ge were se B Goats ean een eee 7 9 7 5 Special registry entries forthe DCO 0 0 ee 7 10 Ndek og ee eee eee Mee ee eno eee Ree ete aa eile ae nae Be we area ae eae Z 1 07 2010 OScAR Pro Customized Operator User Manual 0 7 Contents 07 2010 0 8 OScAR Pro Customized Operator User Manual Images Image 2 1 Image 2 2 Image 4 1 Image 4 2 Image 4 3 Image 4 4 Image 5 1 Image 6 1 Image 6 2 Image 6 3 Image 6 4 07 2010 Images Example of a DCO output in the OScAR Pro TT Operator Tool 2 3 Integration of the different DCO components in OScAR Pro Classic 2 4 Layout of the interface of the OScAR Pro Customized Operator 4 3 Image of the Structure window with example 4 13 Image of the Layout window with example 05 4 16 Image of the Preview window with example project 4 22 View of the Structure window with numerous entries 5 5 Plant map of the premises and grounds of Chemical Industries Inc 6 5 Screenshot of the Structure window 00000 eae 6 26 Screenshot of the final Main page 0000 eee 6 27 Screenshot of the final Announcement selection Frame 6 28 OScAR Pro Customized Operator User Manual 0 9 Images 07 2010 0 10 OScAR Pro Customized Operator User Manual Tables Table 1 1 Table 3 1 Table 3 2 T
47. Path to enter the directory name e g c tetronik OScAR Pro TT or enter the path by clicking __ Note The system will automatically create a directory with the above mentioned project name underneath the path entered here 5 Adjust if necessary the automatically generated name of the DCO Script file 6 Click Ok to have theOScAR Pro Customized Oper ator create the project Table 6 1 Create the project 07 2010 6 10 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Project administration The descriptions and explanations in this chapter are based on the assumption that you have successfully started the DCO Designer and created a new or opened an already existing proj ect 6 2 2 Open an existing project Follow the below instructions to open an existing project No Task References 1 Start the DCO Designer 4 1 Start the OScAR Pro Custom ized Operator 2 The menu item Project lists the last 4 projects that were edited From this list select the project you want to use or open another already existing project via Project gt Open and select the matching DCO Script in the next user window Table 6 2 Open an existing project Note If you make changes to a project we recommend you save the project in regular in tervals to ensure that no changes are lost 07 2010 OScAR Pro Customized Operat
48. Special attributes of CheckboxeS nananana 0c eee 5 77 Special attributes of Listbox n naana naana 5 79 The child nodes of Listboxes 5 8 ose Ace ese abn a 5 81 Attributes of Process filters 0 0 a 5 82 Add Process filters to a Listbox 0 0 0 0 0c cece eee ee 5 85 Edit the attributes of the Process filters of a Listbox 5 86 Special attributes of Comboboxes 2 00 cee 5 87 The child nodes of Comboboxes 0 00 c eee eee eee eee 5 87 Attributes of FUNCUONS os can das S ceeds toh See een d AO eG es bye ad ead 5 89 The child nodes of the node Functions 0000 ee ee 5 90 OVEIVIEW of Instructions reesen Gate Rowe a ea eae AOE ae OSS 5 93 07 2010 OScAR Pro Customized Operator User Manual Table 5 71 Table 5 72 Table 5 73 Table 5 74 Table 5 75 Table 5 76 Table 5 77 Table 5 78 Table 5 79 Table 5 80 Table 5 81 Table 5 82 Table 5 83 Table 5 84 Table 5 85 Table 5 86 Table 5 87 Table 5 88 Table 5 89 Table 5 90 Table 5 91 Table 5 92 Table 5 93 Table 5 94 Table 5 95 Table 5 96 Table 5 97 Table 5 98 Table 5 99 Table 5 100 Table 5 101 Table 5 102 Table 5 103 Table 5 104 Table 5 105 Table 5 106 Table 5 107 Table 5 108 Table 5 109 Table 5 110 Table 5 111 Table 5 112 Table 5 113 Table 5 114 07 2010 OScAR Pro Customized Operator User Manual Tables Add a new Instruction to a Function 0 eee eee 5 98 Edit an Instruction
49. TRUE or 4 mM Table 5 68 Attributes of Functions 07 2010 OScAR Pro Customized Operator User Manual 5 89 The Elements of a DCO Script Functions Attribute Description Messagebox Edit field to enter a text for amessage box with the buttons Yes and No The message box is output to the user whenever the corre sponding Function is invoked and the Function s Instructions are only executed after the query in this window is confirmed with Yes Example of a messagebox DAKS TT DCO Designer xi jJ Select fire alert Table 5 68 Attributes of Functions Note If both attributes Condition and Messagebox are filled for a Function the mes sage box will only be output if the prior verification of the condition met with the result TRUE The child nodes of the node Functions Functions have the following child nodes Child node Description Instructions This node serves to administrate the Instructions of Functions see Section 5 10 Functions Table 5 69 The child nodes of the node Functions 07 2010 5 90 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Functions 5 10 2 Setup and syntax of conditions General A condition consists of at least one operation that in return comprises operators and one or two operands The logical connection of the operands based on theoperators yields a Boolean result either as TRUE
50. Test Security This test phone represents the security services Sabadillen Operator with the PIN 9999 and with full operative rights Announcements 1000 Fire alert Announcement with text message to alert all called sub scribers to a fire alarm 1001 Deflagration Announcement with text message to alert all called sub scribers to a deflagration in the production area 1002 Leakage Announcement with text message to alert all called sub scribers to a leakage emergency or hazardous spill in the production area 1003 Short circuit Announcement with text message to alert all called sub scribers to a short circuit 1004 Forceful entry Announcement with text message to alert all called sub scribers of a forceful entry into the company premises 1999 Current announcement Announcement with text message to alert all called sub scribers to other current emergencies This announce ment should to be recorded as the situation arises and be fore the pertinent broadcasts are launched 07 2010 6 6 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project The case study project ID Name Description Broadcasts 1000 Management Broadcast group to alert all called subscribers in the Man agement area 1100 Admin amp Technics Broadcast group to alert all called subscribers of the Ad min amp Technics area 1200 Production 1 Broadcast group to alert all called subscribers in t
51. a list of several entries but with a more compact ren dition Before you can choose an entry you must first open the global List by clicking the Button that is located on the right hand side of the Combobox Table 5 46 Application of the Controls 07 2010 OScAR Pro Customized Operator User Manual 5 57 The Elements of a DCO Script Controls 5 9 2 References to Controls Just like Constants Parameters and Variables the Controls e Edit field e Checkbox e _Listbox and e Combobox use an attribute to assign them to a data type see Section 5 2 The DCO data types and their value ranges For each Edit field Listbox and Combobox the type is assigned individually while check boxes always have the data type bool This makes it possible to add references to these Controls for Instructions see Section 5 11 Instructions and arguments see Section 5 10 2 Setup and syntax of conditions and to read out their contents To do so use the name of the Control and add a new declaration before the name For each Control use the corresponding declaration as described below Control Declaration and description Edit field EDIT lt Name of the Edit field gt e g for an Edit field with the name TelNumber EDIT TelNumber A reference to an Edit field always outputs as result the content of the pertinent Edit field Checkbox CHECKBOX lt Name of the Checkbox gt e g for a Checkbox with the
52. already with a finished interface amp DAKS TT DCO Designer EXP Chemical Industries Inc dco Project Edit Layout Options Window 2 la DALT W bexi Tane ure EXP Chemical Industri ies Inc dco EXP Chemical Industries Inc Constants 3D Parameters Variables A Lists 2 Frames amp a he Announcement selection x 819 y 1 STATIC Map of plant Image 4 1 Layout of the interface of the OScAR Pro Customized Operator Usually each project has exactly one DCO Script file There are 3 different child windows to every project for the editing and testing namely e The Structure window where the entire project data is output in a hierarchical structure This window emulates the Microsoft Windows Explorer user interface and enables you to edit all entries directly The Layout window where you can edit both the Frames that are created in a project and all of its elements The Preview window where you can validate the DCO Script and check it for errors but also carry out extensive testing of a created project 07 2010 OScAR Pro Customized Operator User Manual 4 3 Operating Instructions for the OScAR Pro Customized Operator Layout of the interface of the OSCAR Pro Customized Operator 4 2 1 The menu bar The menu bar contains several pull down menus that help you activate the diverse functions of the OScAR Pro Customized Operator For a detailed description of the menus and menu items please r
53. bring it to the top quickly by clicking the button EF in the toolbar of the OScAR Pro TT Operator Tool The main advantage of using the DCO Window in a child window lies in the fact that this mode of operation does not minimize the workspace As a result it leaves more room for the DCO Script frames and for the monitoring and supervision of the various processes 07 2010 OScAR Pro Customized Operator User Manual 7 3 The DCO in the OScAR Pro TT Operator Tool Layout in the OScAR Pro TT Operator Tool 7 2 2 The DCO in the toolbar If the DCO Script is executed in a toolbar the DCO Window is automatically and at all times visible on top and cannot be covered by any child window In the same way no other child windows can be covered by the DCO Window Here however the workspace of the OScAR Pro TT Operator Tool is qualified as follows e Ifthe the toolbar is not connected No qualification the toolbar floats over the OScAR Pro TT Operator Tool e Ifthe toolbar is connected on the left or on the right The width of the workspace is qualified by the width that is currently defined for the toolbar e Ifthe toolbar is connected at the top or bottom The height of the workspace is qualified by the height that is currently defined for the toolbar The primary advantage of using the DCO Window in form of a toolbar is that no other window can overlap it If not connected the DCO Window can also be moved to a second screen As aresult
54. can contain a list of the ID ranges that shall be considered in a query The value of each ID range entry lies within a range that is defined as from to Included IDs This child node can contain a list of included IDs that are ex pressible considered in a query e g to ensure that the ID 4000 is always included in the query if properly administrated in the database Excluded IDs This child node can contain a list of excluded IDs that shall be neglected in a query e g to ensure that the ID 1000 is never included in a query even if properly administrated in the data base Table 5 22 The child nodes of the node Filters In a query the lists of a Filter are processed in the following sequence e first the entries of the child node ID ranges e then the entries of the child node Included IDs and e finally the entries of the child node Excluded IDs Consequently every ID that is listed in an ID range or as an Included ID but at the same time also specified as Excluded ID will not appear in the query result The attributes of ID ranges ID ranges have the following attributes Attribute Description from Editable combobox to specify the first ID starting with which datasets are let pass by the Filter Here you can e enter a valid ID with up to 4 digits or e assign a Constant a Parameter or a Variable of the data type bdc_id con_id itl_id scn_id or msg_id Table 5 23 The attributes o
55. ce ne a 5 155 The Instruction SetEditTextColor a oa anana ee 5 156 The Instruction SetEditTextColorBlink 0 0 00 0 cee ee 5 157 The Instruction SetEditToVariable 0 0 0 0 0 ee 5 159 The Instruction SetFrameColor 0 0 ee 5 160 The Instruction SetListBoxBackColor 0 00 0000 ee 5 161 The Instruction SetListBoxBlinkTime 0 000 000 cee eee 5 162 The Instruction SetListBoxltemBlink 0 0 00 0000 cee eee 5 163 07 2010 OScAR Pro Customized Operator User Manual Contents 5 11 67 The Instruction SetListBoxltemColor 0 0 00 00 c ee 5 164 5 11 68 The Instruction SetListBoxList 2c oc sak ee be Wee del ee ee ae 5 165 5 11 69 The Instruction SetListBoxRect 0 0 000000 cee 5 166 5 11 70 The Instruction SetListBoxSelectionToVariable 00 5 167 5 11 71 The Instructions SetListBoxStatus 0 000000 ee 5 168 5 11 72 The Instruction SetListBoxTextColor 0 0 aeaa 5 169 5 11 73 The Instruction SetListBoxToVariable 0 00 00 aaan 5 170 5 11 74 The Instruction SetStaticBackColor 0 0 0 0 0 cee ee 5 171 5 11 75 The Instruction SetStaticBorderColor 0 0 ee 5 172 5 11 76 The Instruction SetStaticPictureName 0 0 00 00 00 cee eee eee 5 173 5 11 77 The Instruction SetStaticPicturePos 0 000 000 ce ee 5 174 5 11 78 The Instruction SetStaticPictureScale 0 0 0 00 5 175 5 11 79 The Instruction SetStaticRec
56. context Editable combobox to define the context in which the broad cast you want to end is running Here you can enter 0 to end broadcasts started by any user enter 1 to end all broadcasts that were NOT started by the present user enter 2 to end all broadcasts that were started by the present user enter 3 to end all broadcasts that were started by the present user via the OScAR Pro TT Operator Tool enter 4 to end all broadcasts that were started by the present user via the OpenScape Alarm Response Profes sional use the selection field to assign a Constant a Parameter or a Variable of the data type uint or assign the reference to a Control that has the data type uint Broadcast ID Editable combobox to define the ID of the broadcast you want to end Here you can leave the entry blank to end ALL broadcasts listed active in the Process context or enter a valid ID of a broadcast with up to 4 digits use the selection field to assign a Constant a Parameter or a Variable of the data type bdc_id or assign the reference to a Control that has the data type bdc_id Table 5 41 5 50 Attributes and child nodes of the node OScAR Pro command templates 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Frames Attribute Description Additional attributes of the Command KILLCON Process context Editable combobox to define the context in which the
57. down menu Project New Opens a window to create a new project i e empty DCO CTRL N Script directory If a project is already open at this time the n system will if necessary query the user and close it Open Opens a window to open an already existing project i e a Ctrl O DCO Script file in a project directory If a project is already m open at this time the system will if necessary query the user a and close it Save Saves a project after editing Ctr1l s fa Save as Saves the DCO Script of a project under a different name Close Closes the project that is currently open Pop up menu Settings u Properties Opens the window to define the properties of the project see Section 4 6 1 Edit project properties Image list Opens the window to administrate the Project image list F12 see Section 4 6 2 Administration of the Image lists End program Ends the OScAR Pro Customized Operator after the user con Alt F4 firms positive a security prompt Table 4 2 Summary of the menu items and buttons of the OScAR Pro Customized Op erator 07 2010 OScAR Pro Customized Operator User Manual 4 5 Operating Instructions for the OScAR Pro Customized Operator Layout of the interface of the OSCAR Pro Customized Operator Menu item Description The pull down menu Options Toolbar Shows or hides the toolbar Status bar Shows or hides the status bar Default colors Opens the window to edit the default col
58. fields in the window Font 07 2010 OScAR Pro Customized Operator User Manual 4 31 Operating Instructions for the OScAR Pro Customized Operator General user dialog windows Input field Description Hue Edit field to enter the color hue represented by an integer in a scale from 0 to 239 If you change the value of this field the reticle will move horizon tally over the above prismatic color system Sat Edit field to enter the color saturation represented by an integer in a scale from 0 to 240 If you change the value of this field the reticle will move ver tically across the above prismatic color system Lum Edit field to enter the brightness value represented an integer in a range from 0 to 240 As you change the lumination value the arrow of the bright ness scale next to the prismatic color system will move up and down Red Edit field to enter directly the red components of a color represented by an integer in a scale from 0 to 255 If you modify this integer the reticle will jump to the corresponding position in the above prismatic color system and brightness scale Green Edit field to enter directly the green components of a color represented by an integer in a scale from 0 to 255 If you modify this integer the reticle will jump to the corresponding position in the above prismatic color system and brightness scale Blue Edit field to enter directly the blue components of a color re
59. in the center e right top to place the image in the upper right corner of the Static element e left v center to place the image at the left border of the Static element and there vertically in the center e h center v center to position the image in the vertical and horizontal center of the Static element e right v center to place the image at the right border of the Static element and there vertically in the center e left bottom to place the image in the lower left corner of the Static element e h center bottom to place the image at the lower border of the Static element and there horizontally in the center e right bottom to place the image in the lower right corner of the Static element e or assign a Constant Parameter or Variable of the data type string The position of the image can be edited during the execution of the DCO Script for e Static elements with the command The Instruction SetStaticPicturePos e Static elements placed on a Button with the command The Instruction SetButtonStaticPic turePos e Table 5 51 Attributes of the child node Image of a Static element 5 64 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls Attribute Description Scaling in Editable combobox to define the scaling factor in for the im age assigned to the Static element Here you can e enter a scaling factor in e select proportional to ali
60. is currently active Active confer ence This color visualizes a conference that is currently ongoing Active info tele phone profile This color visualizes an info telephone profile that is currently active Inactive process This color visualizes an inactive broadcast or conference process Idle subscriber This color visualizes a broadcast member or conferee whose telephone line is idle Called subscrib er This color visualizes a broadcast member or conferee who is currently be ing called by the system Subscriber not reached This color stands for a broadcast member or conferee who could not be reached Subscriber listen ing to announce ment This color visualizes a subscriber who was reached and who is momen tarily listening to the broadcast announcement or the welcome message of the conference Welcome an nouncement to subscriber com pleted This color visualizes a subscriber who has been played the full broadcast announcement or conference welcome announcement 07 2010 OScAR Pro Customized Operator User Manual 4 27 Operating Instructions for the OScAR Pro Customized Operator General user dialog windows Input field Description PIN entry re quested from sub scriber This color visualizes a broadcast member or conferee who has been re quested to enter his PIN scriber paused Subscriber This color visualizes a broa
61. message also see Section 5 11 8 The Instruction BroadcastMessage though it is only processed on the page the combobox is located on The message sent is processed by the function with the same name as the com bobox in branch On_Message 07 2010 5 88 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Functions 5 10 Functions The node Functions serves to group a list of Instructions see Section 5 11 Instructions that shall be carried out during the course of the DCO Script Use Condition and Messagebox to specify if the Instructions of the Function are executed Only Frames and Buttons own and or use Functions For Buttons the Functions are invoked in the order in which they are numbered under the col umn Index To change the order of the Functions for Frames and Buttons go to the menu bar of the Struc ture window and click Edit gt Move up and or Edit gt Move down 5 10 1 The attributes and child nodes of Functions Attributes of Functions Functions have the following attributes Attribute Description Name Edit field to enter a recognizable and unique name for the Functions Please bear in mind that the name must be unique among the other Functions of the Frame or Button Condition Edit field to enter a logical algorithm that is verified when the Function is invoked The Instructions of the Function are only performed if this value check meets with the result
62. name of the Variable direct or e select a Variable of the data type string from the list of all available Variables Table 5 81 07 2010 OScAR Pro Customized Operator User Manual The arguments of the Instruction GetComboBoxSelText 5 109 The Elements of a DCO Script Instructions 5 11 14 The Instruction Getinfotelephones Description Use this Instruction to invoke a list of all DAKS TT Administrator Tool administrated info tele phone profiles and fill the Data list with the obtained entries Please note that the Data list is automatically cleared before it is filled with the new entries In this process the system applies the specified Filter if available See Section 5 7 Lists Arguments Arguments Description Data list Editable combobox to specify the Data list to which you want to add the received info telephone profiles Here you can e enter the name of the Data list direct or e select a Data list from the list of all available Data lists of the data type itl_id Filter Editable combobox to define the Filter that is used to limit the received info telephone profiles Here you can e enter the name of the Filter direct or e select a Filter of the type IITL from the list of all available Filters Table 5 82 The arguments of the Instruction GetInfotelephones Note To output the List of info telephone profiles that are received with this command place a List or Combobox in the Frame and fi
63. of Process filters 07 2010 OScAR Pro Customized Operator User Manual 5 83 The Elements of a DCO Script Controls Child node Description For the type PROCESS _CONMBR Process status Here you can e 1 to filter all subscribers e 1 to filter only subscribers whose processing has not started or whose dial up by the system is momentarily in a pause e 2 to filter only subscribers who are momentarily in the pro cess of being called e 3 to filter only subscribers who could not be reached e Ato filter only subscribers who are currently being receiv ing the welcome message e 5to filter only subscribers for whom the welcome mes sage is already over e 6to filter only subscribers who have switched themselves to mute e 8 to filter only subscribers who are participating in the conference passively i e who do not have the right to speak e 10 to filter only subscribers who are participating in the conference actively i e who have the right to speak e 11 to filter only subscribers who are currently being parked i e who have neither the right to speak nor to lis ten to the active conference and who are being played an announcement instead e 256 to filter only subscribers who are participating in the conference actively i e 6 and 11 e 257 to filter only subscribers who are otherwise participat ing in the conference i e 8 and 11 e 258 to filter only subscribers who are not yet participating in th
64. or 1 or as UNTRUE or 0 Operands can be e Constants Parameters Variables Controls or fixed numeric values and texts texts are output in between inverted commas An operand can also be an operation in parenthesis Syntax Variables must be set in between signs Constants and Parameters in between signs If you want to use Controls please be careful to add a corresponding reference see Section 5 9 2 References to Controls Operators The following operators can be used in conditions Operators No of Example Description operands 1 ISVAR_AS Negation GT 2 SVAR_AS GT SVAR_BS Greater Than LT 2 SVAR_AS LT SVAR_BS Less Than GET 2 SVAR_AS GET SVAR_BS Greater than or Equal To LET 2 SVAR_AS LET SVAR_BS Less than or Equal To EQL 2 SVAR_AS EQL SVAR_BS Same as EQuaL UEQ 2 SVAR_AS UEQ VAR_BS UnEQual AND 2 SVAR_AS AND S VAR_BS Logical and connection AND OR 2 SVAR_AS S OR VAR_BS logical or connection OR 07 2010 OScAR Pro Customized Operator User Manual 5 91 The Elements of a DCO Script Functions Example of a condition with several elements BT AND CHECKBOX CB OR BOOL_VAR AND RTS EQL CONST AND RTR EQL OTHER Constant here CONST Negation Control element Checkbox here CB Logical connection here AND Variable here BT Fixed test Note Before the Functions are executed a copy is made of the co
65. outer left and the outer right ele ment e Down i e vertically from top to bottom between the highest and the lowest element 07 2010 OScAR Pro Customized Operator User Manual 4 21 Operating Instructions for the OScAR Pro Customized Operator Setup and application of the Preview window 4 5 Setup and application of the Preview window The preview window constitutes the test area of theOScAR Pro Customized Operator It is this environment that proofreads your settings in the DCO Script for validity and consistency and that makes it possible to test the entire script Preview EXP Chemical Industries Inc dco loj x Events Fire alert A cate E Leakage A ore Image 4 4 Image of the Preview window with example project In this test you can also carry out an easy simulation of the connection to a OScAR Pro TT Op erator Tool 07 2010 4 22 OScAR Pro Customized Operator User Manual 4 6 Operating Instructions for the OScAR Pro Customized Operator General user dialog windows General user dialog windows In addition to the three windows of the working area there are modal user dialogs that enable you to enter or select individual values and properties 4 6 1 Edit project properties Follow the below instructions to edit the project properties No Task 1 Start the DCO Designer 2 Open the menu Project gt Settings gt Properties The window Project properties
66. oxSelText The Instruction SetComboB Changes the background color oxBackColor The Instruction SetComboB _ Fills the Combobox from a Data list oxList The Instruction SetComboB Changes the position and size oxRect SetComboBoxStatus Changes the output and editing The Instruction SetComboB Changes the text color oxTextColor The Instruction SetComboTo Sets a Variable to the selected Combobox entry Variable Table 5 70 Overview of Instructions 5 11 3 Add a new Instruction Follow the below steps to add a new Instruction to a Function No Task Go to the tree structure and open the node Frames Open the parent Frame of the Function to which you want to add a new Instruction Open e either the node Functions and continue with step 4 e or the node Controls and continue with step 5 4 Open e either the child node On_Load e the child node On_Message e the child node On_Timer e or the child node User Continue with step 7 5 Open the parent Button of the Function to which you want to add a new Instruction Table 5 71 Add a new Instruction to a Function 07 2010 5 98 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions Task Click the child node Functions Open the Function to which you want to add a new Instruction Mark the child node Instructions Po No
67. templates of the Frame seeSection 5 8 7 OScAR Pro command templates 6 If needed edit the Functions of the Frame see Section 5 10 Functions Table 5 37 Edit the attributes of a Frame 07 2010 5 36 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Frames 5 8 4 Add a new Control through the Structure window Follow the below instructions to add a new Control to a Frame via the Structure window No Task Go to the tree structure and open the node Frames Open the Frame to which you want to add a new Control Now click the child node Controls of that Frame Now go to the menu bar and select Edit gt New This will open the below user window to add the new process Filter x Create which control A oe e Static element Input field X Cancel Button Checkbox C Listbox Combobox Select the Control type you want to add and close the window with Ok This will open the following user window to add the new Control Assign a unique and recognizable name to the new Control 8 Finally click Ok to close the window The DCO Designer outputs the new Control in the tree view of the Structure window and there in the child node Controls of the pertinent Frame If needed you can now edit the attributes of the Control see Section 5 9 Controls Table 5 38 Add a new Control through the St
68. the DAKS TT Administrator Tool you can easily adjust the corresponding Parameter with the Parameter editor of the OS cAR Pro TT Operator Tool without having to change the DCO script 07 2010 OScAR Pro Customized Operator User Manual 5 13 The Elements of a DCO Script Parameters 5 5 1 Add a new Parameter group Follow the below instructions to create a new Parameter group No Task Go to the tree structure on the right and select the node Parameters 2 Now go to the menu bar and select Edit gt New This will open the following user window to add the new Control xi Please name entry ir Name Announcements i i K Cancel 3 Enter a unique name for the new Parameter group 4 Finally click Ok to close the window The DCO Designer outputs the new Parameter group in the tree structure of the Struc ture window and there in the node Parameters Table 5 7 Add a new Parameter group Note Note that the name given a created Parameter group cannot be changed afterwards 5 14 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Parameters 5 5 2 The attributes of Parameters Parameters have the following attributes Attribute Description Name Edit field to enter the name of the Parameter Select a name that is recognizable and unique among the other Parameters and Constants Type Combobox to specify the type of the Pa
69. the entry Select image in the drop down list see Section 4 6 2 Administration of the Image lists or e assign a Constant Parameter or Variable of the data type string The image assigned to a Button can be changed during the ex ecution of the DCO Script with the command The Instruction SetButtonPicture Table 5 54 Special attributes of Buttons 07 2010 OScAR Pro Customized Operator User Manual 5 71 The Elements of a DCO Script Controls The child nodes of Buttons Buttons have the following child nodes Child node Description Functions This node serves to administrate the Functions of the Button For a detailed description of the Functions please see the Section 5 10 Functions Static elements Apart from the actual attributes a Button can also have up to 4 Static elements that are output on it This makes it possible to position several texts in different col ors or fonts and or several images on one Button For a detailed descriptions of Static elements please see Sec tion 5 9 4 Child nodes and special attributes of Static ele ments Table 5 55 The child nodes of Buttons 5 72 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls 5 9 7 Add Functions to a Button Follow the below instructions to add a new Function to a Button No Task Go to the tree structure and open the node Frames Open the parent Fra
70. the node OScAR Pro command templates 07 2010 5 48 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Frames Attribute Description Additional attributes of the Command KILLPRC Process context Editable combobox to define the context in which the process you want to end is running Here you can e enter 0 to end processes started by any user e enter 1 to end all processes that were NOT started by the present user e enter 2 to end all processes that were started by the pres ent user e enter 3 to end all processes that were started by the pres ent user via the OScAR Pro TT Operator Tool e enter 4 to end all processes that were started by the pres ent user via the OpenScape Alarm Response Profession al e use the selection field to assign a Constant a Parameter or a Variable of the data type uint or e assign the reference to a Control that has the data type uint TAN Editable combobox to define the TAN of the process you want to end Here you can e leave the entry blank to end ALL processes listed active in the Process context or e assign the reference to a Listbox that has the type pro cess Table 5 41 Attributes and child nodes of the node OScAR Pro command templates 07 2010 OScAR Pro Customized Operator User Manual 5 49 The Elements of a DCO Script Frames Attribute Description Additional attributes of the Command KILLBDC Process
71. will automatically pop up 3 Edit the properties as needed and in keeping with the field descriptions 4 When you have finished click Ok to save the project properties Table 4 5 Edit project properties Summary of the fields in the window Project properties Input field Description Name of Zz Project properties Version of script 6 1 3 0 Current start frame 5 X Cancel Mainpage o Refresh interval 2000 ms 4 script EXP Chemical Industries Inc Name The field that displays the project name Version The field that displays the version number of the DCO Script Start window tor Tool The field that defines the DCO start window in the OScAR Pro TT Opera Refresh interval etc Use this field to enter the interval in milliseconds in which you want the DCO to query the OScAR Pro TT Operator Tool for any changes of the process status e g Broadcast started end Info telephone profile switch Summ 07 2010 OScAR ary of the fields in the window Project properties Pro Customized Operator User Manual Operating Instructions for the OScAR Pro Customized Operator General user dialog windows 4 6 2 Administration of the Image lists The window Project image list serves to administrate the images that are used in a project Follow the below instructions to edit the Image list No Task Start the DCO Designer 2 Open the menu
72. you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or 2 Blink color Editable combobox to enter the secondary blink color Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 124 The arguments of the Instruction SetEditBackColorBlink 07 2010 OScAR Pro Customized Operator User Manual 5 151 The Elements of a DCO Script Instructions Arguments Description Blink interval Editable combobox to enter an interval for the alternation be tween the two above mentioned colors in milliseconds 1000 milliseconds 1 second Here you can e enter 1 to use the interval of the parent Frame e enter a numeric value or e assign a Constant Parameter or Variable of the data type int Table 5 124 The arguments of the Instruction SetEditBackColorBlink 07 2010 5 152 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instr
73. 00 eee eee 6 38 6 5 9 The User Function Production 2 blink on 0 0 0 0 0 ee 6 38 6 5 10 The User Function Disable invoke 0 0000 0 ce ee ee 6 39 6 5 11 The User Function Enable invoke 2 0 0 0 0 cee ee ee 6 39 6 5 12 The User Function Activate invoke 0 0 0 0 ee ee 6 40 6 5 13 The User Function Blink Buttons 0 000 000 cece ee 6 41 6 5 14 The User Function Reset areas 0 0 0 0 0c ee 6 43 6 5 15 The User Function Reset events 0 000000 ee es 6 44 6 5 16 The User Function Invoke Management 0000 eee eee eee 6 45 6 5 17 The User Function Invoke AdminTechnics 0 00 eee eee 6 45 6 5 18 The User Function Invoke Production 1 00 0000 eee eee eee 6 46 6 5 19 The User Function Invoke Production 2 0 00000 cece eee eee 6 46 6 5 20 On_Load Function Set Buttons 0 0 00 ee 6 47 6 5 21 The Functions of the Button Fire alert 2 0 0 0 0 0 00 eee eee 6 47 6 5 21 The F ncti on Delete se ea he ts 4 al tine ne eee ee wea wae 6 47 6 5 2 1 2 The F ncti n Set eei aoe ae 68th wd arene OOS oh A Baca a pene 6 48 6 5 22 The Functions of the Button Deflagration 0000 eee 6 49 6 5 22 1 The Function Deleten puis dau a e a a cada aoa T A eer ae ee 6 49 60 5 222 The Function Set e oree eraa a a a Geka tee on hake eee E 6 50 6 5 23 The Functions of the Button Leakage 22 22 e eee eee
74. 1 Properties 4 23 Project Management 6 10 Project properties 4 23 07 2010 OScAR Pro Customized Operator User Manual Index proportional 5 65 5 71 5 128 5 175 R Reference manuals 1 2 Requirements 1 1 S Safety instructions 1 4 SCN 5 24 5 41 5 47 Select start Frame 4 23 Set Variable 6 44 SET_PRM 5 41 5 48 SetButtonBlink 5 95 5 118 SetButtonColor 5 95 5 120 SetButtonPicture 5 71 5 95 5 121 SetButtonPictureScal 5 71 5 95 5 122 SetButtonRect 5 59 5 61 5 95 5 123 SetButtonStaticBackColor 5 96 5 124 SetButtonStaticBorderColor 5 62 5 96 5 125 SetButtonStaticPictureName 5 63 5 96 5 126 SetButtonStaticPicturePos 5 64 5 96 5 127 SetButtonStaticPictureScale 5 65 5 96 5 128 SetButtonStaticRect 5 59 5 61 5 96 5 129 SetButtonStaticStatus 5 96 SetButtonStaticText 5 96 5 131 SetButtonStaticTextColor 5 96 5 132 SetButtonStaticTextPosition 5 96 5 133 SetButtonStatus 5 96 SetButtonText 5 70 5 96 5 135 SetButtonTextColor 5 71 5 96 5 136 SetCheckBoxBackColor 5 96 5 137 SetCheckBoxCaption 5 78 5 96 5 138 SetCheckBoxRect 5 59 5 61 5 96 5 139 SetCheckBoxState 5 78 5 96 5 140 SetCheckBoxStatus 5 97 SetCheckBoxTextColor 5 77 5 97 5 142 SetCheckBoxToVariable 5 94 5 97 5 143 SetComboBoxBackColor 5 97 5 98 5 144 SetComboBoxList 5 98 5 145 SetComboBoxRect 5 59 5 61 5 98 5 146 SetComboBoxTextColor 5 87 5 98 5 148 SetComboToVariable 5 94 5 98 5 149 Index SetEditBackColor 5 95 5 150 Set
75. 2 Administration of the Image lists e assign a Constant Parameter or Variable of the data type string e assign the reference to a Control that has the data type string Table 5 99 The arguments of the Instruction SetButtonStaticPictureName 07 2010 5 126 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 32 The Instruction SetButtonStaticPicturePos Description Use this Function Instruction to change the positioning of the image of a Static element on a Button Arguments Arguments Description Button Editable combobox to choose the Button for which you want to reposition the image of the Static element Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Static element Editable combobox to choose the Static element of the select ed Button whose image you want to reposition Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Position Drop down list to select the position for the image in the But ton s Static element Here you can e choose from left top h center top right top left center h center v center right center left bottom h center bottom and right bottom to find the best position for the text of the Static element of the Butto
76. 2 2 Open an existing project 6 3 Create Frames and Controls 6 3 1 Create and customize the Frames 6 3 2 Add a background image to the Main page 6 3 3 Add visual separators to the Main page 6 3 4 Add Captions to the Main page 6 3 5 Add Buttons to the Main page 6 3 6 Add Controls to the Frame Announcement selection 6 4 Create the global objects 6 4 1 Create Constants 6 4 2 Create the Parameters 6 4 3 Create the Variables 6 5 Create the Functions of the Main page 6 5 1 The User Function Fire alert blink on 6 5 2 The User Function Deflagration blink on 6 5 3 The User Function Leakage blink on 6 5 4 The User Function Short circuit blink on 6 5 5 The User Function More blink on 6 5 6 The User Function Management blink on 6 5 7 The User Function AdminTechnics blink on 07 2010 OScAR Pro Customized Operator User Manual 6 1 The planning and implementation of a DCO Project 6 5 8 The User Function Production 1 blink on 6 5 9 The User Function Production 2 blink on 6 5 10 The User Function Disable invoke 6 5 11 The User Function Enable invoke 6 5 12 The User Function Activate invoke 6 5 13 The User Function Blink Buttons 6 5 14 The User Function Reset areas 6 5 15 The User Function Reset events 6 5 16 The User Function Invoke Management 6 5 17 The User Function Invoke AdminTechnics 6 5 18 The User Function Invoke Production 1 6 5 19 The User Function Invoke Prod
77. 4 Add Captions to the Main page 0 0 ccc ees 6 16 6 3 5 Add Buttons to the Main page 000 eee ee es 6 19 6 3 6 Add Controls to the Frame Announcement selection 6 24 6 3 7 Screenshot of the final interface eo cece ree Sw Pare ars ee 6 26 6 4 Create the global objects 0 020 eee 6 29 6 4 1 Greate COnStaits lt cenin eren ae Sark ea ee eS ew dee eae ee oS 6 29 0 4 2 Create the Parameters ccs no0 oh iN Fee ce oN sawn deo A eee valk 6 30 6 453 Gredie Ine Variables wiiced cand dm deck eager Ramble Sas Re hee ae esas 6 31 6 4 4 Create the LISIS Px oo ate ta dou eae hse dn en a 6 32 6 4 5 Create the OScAR Pro command template Invoke broadcast 6 33 07 2010 OScAR Pro Customized Operator User Manual 0 5 Contents 6 5 Create the Functions of the Main page 2 cece eee eee eee 6 34 6 5 1 The User Function Fire alert blink on 0 0 0 0 naaa aa 6 34 6 5 2 The User Function Deflagration blink on 2 0 2 ee 6 35 6 5 3 The User Function Leakage blink on 20 0 0c cee ee 6 35 6 5 4 The User Function Short circuit blink on 0 ee 6 36 6 5 5 The User Function More blink on 2 0 00000 ce ee ee 6 36 6 5 6 The User Function Management blink on 2 2 0 ee 6 37 6 5 7 The User Function AdminTechnics blink on 0 0 2 0 00002 eee eee 6 37 6 5 8 The User Function Production 1 blink on 00 00
78. 5 6 3 Edit the attributes of a Variable 5 7 Lists 5 7 1 The attributes and child nodes of the node Data lists 5 7 2 Add a new Data list 5 7 3 Edit the attributes of a Data list 5 7 4 Add a new data element 5 7 5 Edit the attributes of a data element 5 7 6 The attributes and child nodes of the node Filters 5 7 7 Add a new Filter 07 2010 OScAR Pro Customized Operator User Manual 5 1 The Elements of a DCO Script 5 7 8 Edit the attributes of a Filter 5 7 9 Add an ID range 5 7 10 Edit the attributes of an ID range 5 7 11 Add an Included ID 5 7 12 Edit the attributes of an Included ID 5 7 13 Add an Excluded ID 5 7 14 Edit the attributes of an Excluded ID 5 8 Frames 5 8 1 The attributes and child nodes of the node Frames 5 8 2 Add a new Frame 5 8 3 Edit the attributes of a Frame 5 8 4 Add a new Control through the Structure window 5 8 5 Add a new Control through the Layout window 5 8 6 Edit the attributes of a Control 5 8 7 OScAR Pro command templates 5 8 8 Add a new OScAR Pro command template 5 8 9 Edit the attributes of a OScAR Pro command template 5 8 10 Add a new Function to a Frame 5 8 11 Edit the attributes of the Functions of a Frame 5 9 Controls 5 9 1 The use of Controls 5 9 2 References to Controls 5 9 3 Attributes shared by all Controls 5 9 4 Child nodes and special attributes of Static elements 5 9 5 Special attributes of Edit fields 5 9 6 Special attributes and child nodes of Buttons 5 9 7
79. 500 ee eee 5 70 5 9 7 Add Functions to a Button deca 8 Avena Sa PB Caea ad Alte a 5 73 5 9 8 Edit the attributes of the Functions of a Button 008 5 74 5 9 9 Add Static elements to a Button 0 0 0 0 cc ee 5 75 5 9 10 Edit the attributes of the Static elements of a Button 5 76 5 9 11 Special attributes of Checkboxes 0 ccc eee eee 5 77 5 9 12 Child nodes and special attributes of Listboxes 005 5 79 5 9 13 Double click events of ListboxesS 0 0 0 0 0c ee 5 84 5 9 14 Add new Process filters to ListboxeS 0 0 000000 ccc ee 5 85 5 9 15 Edit the attributes of Process filters icc oscars Dewar ewe ee wee eA 5 86 5 9 16 The child nodes and special attributes of Comboboxes 5 87 5 9 17 Selection events of ComboboxeS 0 0 00 cc ee es 5 88 STO SUI TONS kf eer att stein Ss Sak e a a tne hE ace a Gh ha aaa Ao id cde aoe se de 5 89 5 10 1 The attributes and child nodes of Functions 000000e 5 89 5 10 2 Setup and syntax of conditions 000 ce eee 5 91 5 TI 4 061 110 6 gt ae a a a o a oa a E a aA e E eE 5 93 5 11 1 Arguments of Instructions nannaa aaae 5 93 5 11 2 Overview of Instructions a uaa naaa aa ee ee ees 5 93 5 11 3 Add a new Instruction 4 a sc0 cede Gas 6SrG ahah wee ee O haw awe we alee ne 5 98 Le ig bid efi ech hot 0 6 116 9 gt ee Oe Re ee ce et Rn AE 5 99 5 11 5 Change the
80. 6 51 05 231 The FPUNCHONs Delete er rretra eae a aed barca eb ted eae aes 6 51 65 232 The Function OO rrarena bt ches eae Rene o ed ate ewe eats 6 52 6 5 24 The Functions of the Button Short circuit 2 2 0 0 ee 6 53 6 5 24 1 The FUNCTION DClETS alee aei oe once bees ie arcGe tina mate Be Sante od oa ea cee 6 53 65 2402 The Function Set nicaieri e ta a tir r a be dekh kad ee ue eee eet 6 54 6 5 25 The Functions of the Button More Open announcement selection 6 55 6 5 26 The Functions of the Button Management 00000 eee eee 6 56 65 201 6 The Function Delete curee Pa aaa ae hci Poy Hews ato ok Sota geese 6 56 6 5 26 2 The F nction Set ied ieecd sce Sais wok aE aaa we once ace aos a re a a 6 56 6 5 27 The Functions of the Button AdminTechnics 000000 ee 6 57 60 5 27 1 The F nction Delete er Sais ne ever ate Weve ak eat awa de tn ahah ae Aa eM 6 57 60 5272 The FUNCION SETS sos grad ccc aw Ooo bee AA eters wearer a ae 6 57 6 5 28 The Functions of the Button Production 1 00 0000 cee eee 6 58 6 5 28 ThE Function Deleter roetis mr 85 Pb Mek eee ae oe Ed oe awe 6 58 5 28 2 The Function SeT a saw aha dai a eee acer ase ace hrs Lada en en ae 6 58 07 2010 0 6 OScAR Pro Customized Operator User Manual Contents 6 5 29 The Functions of the Button Production 2 nanana aaan annann 6 59 65 29 The FUNGCION Delet ris ende ene eer dy ea hak wi
81. 6 6 4 2 The Function Without selection 6 7 Test the DCO Script 07 2010 OScAR Pro Customized Operator User Manual 6 3 The planning and implementation of a DCO Project The case study project 6 1 The case study project On the basis of the Section 2 2 Example application case study that is already included in the this chapter will show you how to successfully plan outline create and bring together a DCO Script and then incorporate the final product it into the OScAR Pro TT Operator Tool You can realize this project yourself at any time and at the same time retain the case study IDs and objects as well as your own real life telephone numbers All files that are used in this case study are included ex works in the installation CD and there in the directory lt CD ROM gt DCO Designer Example 6 1 1 Case study requirements The objective of the case study is to realize for a fictitious chemical company styled EXP Chem ical Industries Inc EXP short for example a DCO Script that is both easy to operate and that can be used to invoke a number of different broadcasts to respond to any kind of emergen cy in the best way possible using individual and even related announcements This project is designed for touch screens with a resolution of 1280 x 1024 pixels 07 2010 6 4 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project The case study project 6 1 2 Case study plant map
82. 7 2010 5 32 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Frames Attribute Description Width Editable combobox to specify the Frame width in pixels Here you can e enter an integer or e assign a Constant Parameter or Variable of the data type int You can also define the size of the Frame width with the menu Layout in the Layout window Height Editable combobox to specify the Frame height in pixels Here you can e enter an integer or e assign a Constant Parameter or Variable of the data type int You can also define the Frame height with the menu Layout in the Layout window Interval Editable combobox to enter a time interval for the synchronous blinking of all Controls of the type Button in a Frame Here you can e enter an integer or e assign a Constant Parameter or Variable of the data type int Execute functions as snap shot Editable combobox to specify the behavior when loading the variables for processing the functions Here you can e select 0 to specify that the variables are re evaluated with every single call of a function or e select 1 to specify that the variables are only evaluated on the first called function Special attributes for pages of type normal Toolbar Combobox to select which toolbar page is linked to this nor mal page Here you can select a previously added toolbar page Table 5 34 Attributes of
83. BoxSelectionToVariable Use this Function Instruction to save the element that is currently selected in a Listbox in a Vari able Please note that to do so the Variable and the Listbox must have the same data type see Sec tion 5 2 The DCO data types and their value ranges Arguments Arguments Description Listbox Editable combobox to specify the Listbox whose currently se lected element you want to save in a Variable Here you can e enter the name of the Listbox direct or e select a Listbox from the list of all available Listboxes Variable Editable combobox to specify the Variable in which you want to save the selected Listbox element Here you can e enter the name of the Variable direct or e select a Variable from the list of all Variables that are avail able Table 5 138 The arguments of the Instruction SetListBoxSelectionToVariable 07 2010 OScAR Pro Customized Operator User Manual 5 167 The Elements of a DCO Script Instructions 5 11 71 The Instructions SetListBoxStatus Description Use this Function Instruction to edit the way in which a Listbox is output and used Arguments Arguments Description Listbox Editable combobox to specify the Listbox you want to edit with regard to the way in which it is output and used Here you can e enter the name of the Listbox direct or e select a Listbox from the list of all available Listboxes Status Editable combobox to specify the way in
84. Data list Editable combobox to specify the Data list that shall be used to fill the Combobox Here you can e enter the name of the Data list direct or e select a Data list from the list of all available Data lists Table 5 118 The arguments of the Instruction SetComboBoxList 07 2010 OScAR Pro Customized Operator User Manual 5 145 The Elements of a DCO Script Instructions 5 11 51 The Instruction SetComboBoxRect Description Use this Function Instruction to change the position and size of a Combobox Arguments Arguments Description Combobox Editable combobox to specify the Combobox whose position and size you want to edit Here you can e enter the name of the Combobox direct or e select a Combobox from the list of all available Combob oxes Links Editable combobox to define the left and upper top margin as Top well as the width and the height in pixels Here you can Width e enter a numeric value Height e assign a Constant Parameter or Variable of the data type int or e assign a reference to a Control that has the data type int Table 5 119 The arguments 5 146 of the Instruction SetComboBoxRect 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 52 The Instruction SetComboBoxStatus Description Use this Function Instruction to edit the way in which a Combobox is output and used Arguments Arguments Description C
85. Documentation OpenScape Alarm Response Professional OScAR Pro V3 R2 Classic Applications OScAR Pro Customized Operator User Manual A31003 S1730 U103 1 7619 Communication for the open minded Siemens Enterprise Communications SI E M E N S www siemens enterprise com Communication for the open minded Siemens Enterprise Communications www siemens enterprise com Our Quality and Environmental Management Sys tems are implemented according to the require ments of the IS09001 and 1ISO14001 standard cer tified by an external certification company Copyright Siemens Enterprise Communications GmbH amp Co KG 2010 Hofmannstr 51 80200 M nchen Siemens Enterprise Communications GmbH amp Co KG is a Trademark Licensee of Siemens AG Reference No A31003 S1730 U103 1 7619 The information provided in this document contains merely general descriptions or characteristics of performance which in case of actual use do not always apply as described or which may change as a result of further development of the products An obligation to provide the respective characteristics shall only exist if expressly agreed in the terms of contract Availability and technical specifications are subject to change without notice OpenScape OpenStage and HiPath are registered trademarks of Siemens Enterprise Communications GmbH amp Co KG All other company brand product and service names are trademarks or registered trademark
86. Each time you press an arrow key the elements are shifted in increments of one pixel To increase these increments to five pixels simply press the SHIFT key to gether with the arrow key 2 Mark the elements you want to move to a new position and move the mouse cursor over one of the marked elements This will change the mouse cursor to ate Now press the left mouse key and keep it pressed The elements can now be moved to the new position 07 2010 OScAR Pro Customized Operator User Manual 4 19 Operating Instructions for the OScAR Pro Customized Operator Setup and application of the Layout window 4 4 4 Change the size of Frames and Controls There are two ways to change the size of a Control 1 Mark the elements you want to select press the SHIFT and Ctrl key and keep both keys pressed and use the arrow keys amp 04 gt to increase or decrease the size of the ele ment Each time you press an arrow key the size of the selected elements will increase or decrease in increments of 1 pixel 2 Mark the element you want to select and move the mouse cursor over one of the 8 black squares of the accented frame This will change your mouse cursor to Position of the black square Cur sor Upper left and lower right corner ki Upper and lower center t Left and right center t Lower left and upper right corner ea Now press the left mouse key keep the key pressed and change the size as needed in the direct
87. EditBackColorBlink 5 95 5 151 SetEditRect 5 59 5 61 5 95 5 153 SetEditStatus 5 95 SetEditText 5 68 5 95 5 155 SetEditTextColor 5 68 5 95 5 156 SetEditTextColorBlink 5 95 5 157 SetEditToVariable 5 94 5 95 5 159 SetFrameColor 5 94 5 160 SetListBoxBackColor 5 97 5 161 SetListBoxBlinkTime 5 80 5 97 5 162 SetListBoxltemBlink 5 97 5 163 SetListBoxltemColor 5 97 5 164 SetListBoxList 5 97 5 165 SetListBoxRect 5 59 5 61 5 97 5 166 SetListBoxSelectionToVariable 5 94 5 97 5 167 SetListBoxStatus 5 97 SetListBoxTextColor 5 79 5 97 5 169 SetListBoxToVariable 5 94 5 97 5 170 SetStaticBackColor 5 94 5 171 SetStaticBorderColor 5 62 5 94 5 172 SetStaticPictureName 5 63 5 94 5 173 SetStaticPicturePos 5 64 5 94 5 174 SetStaticPictureScale 5 65 5 94 5 175 SetStaticRect 5 59 5 61 5 94 5 176 SetStaticStatus 5 94 SetStaticText 5 66 5 94 5 178 SetStaticTextColor 5 66 5 94 5 179 SetStaticTextPosition 5 67 5 95 5 180 SetVariable 5 94 5 181 SHOW_BDC 5 41 SHOW_CON 5 41 simple 5 62 5 68 5 77 5 79 6 15 Simulation 4 22 Sort list view 4 15 Sort the list view 4 15 Standard colors 4 26 StartProgram 5 182 Statements 5 9 Static control 4 17 Static element 5 56 add a new Static element to a Button 5 75 background color 5 60 border color 5 62 border style 5 62 border width 5 62 caption 5 63 caption font 5 67 caption position 5 67 caption text 5 66 caption text color 5 66 edit the attributes of a Button 5
88. Frame Announcement selection 6 6 1 The User Function On cancel Description This Function covers the instructions that are applied if the Ok Button is pressed before a valid announcement was selected or in the event the Cancel Button is clicked Attributes Attribute Contents Name On cancel Condition Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable More blinking able Value 0 The Instruction SetVari Variable Selected message able Value 1 The Instruction GotoF Frame Main page rame 07 2010 OScAR Pro Customized Operator User Manual 6 61 The planning and implementation of a DCO Project Create the Functions of the Frame Announcement selection 6 6 2 On_Load Functions Fill announcement list Description With the help of the Data list Administrated emergency messages this Function reads out the announcements administrated in OScAR Pro and copies them into the Announce ment list Attributes Attribute Contents Name Fill announcement list Condition Messagebox Instructions Instruction Arguments Contents The Instruction Get Listbox Administrated emergency messages Messages Filters Emergency message Filter The Instruction SetList Listbox Announcement list BoxList Listbox Administrated emergency messages 07 2010 6 62 OScAR Pro Customiz
89. Frames 07 2010 OScAR Pro Customized Operator User Manual 5 33 The Elements of a DCO Script Frames Attribute Description Special attributes for pages of type toolbar Position Combobox to select the position where the toolbar page is shown relative to the normal page linked to Here you can e select top to specify that the toolbar page ist shown on the upper border of the normal page e select bottom to specify that the toolbar page ist shown on the lower border of the normal page e select left to specify that the toolbar page ist shown on the left border of the normal page e select right to specify that the toolbar page ist shown on the right border of the normal page Toolbar size Editible combobox to specify the heigth with Position top or bottom resp width with Position left or right in pixels Here you can e enter an integer or e assign a Constant Parameter or Variable of the data type int Toolbar is fixed Combobox to select whether the height resp width of the tool bar page is adjustable at runtime Here you can e select 0 to supress any with or height changes e select 1 to allow any with or height changes e assign a Constant Parameter or Variable of the data type bool or e assign the reference to a Control that has the data type bool Table 5 34 Attributes of Frames 5 34 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Sc
90. Frames that are output on the screen and their Controls During a project the number of Frames that may be created and that the user may move be tween is unrestricted Table 5 1 Description of the predefined nodes of the tree structure Also there are a number of different data types that are used in the DCO Script and thus in the Structure window 5 6 07 2010 OScAR Pro Customized Operator User Manual 5 2 The Elements of a DCO Script The DCO data types and their value ranges The DCO data types and their value ranges Every DCO Script uses special data types or references to Controls that belong to these data types for the properties of the different objects Also the DCO Designer only supports meaningful assignments of data types and references to the pertinent properties The below table summarizes the possible data types and their values ranges Datatype Value range Description bool 0 1 Data type for logic statements with 0 false untrue not assigned not enabled and 1 correct true assigned enabled byte Positive integer Data type for various small integers between 0 and 255 int Positive or Data type for overall integers negative integer between 32768 32767 uint Positive integer Data type for overall and purely positive integers between 0 65535 string Any text Data type for texts max 256 phone_no _ Text max 24 Phone numbers with charact
91. Function Instruction to edit the way in which a Static element is output and used Arguments Arguments Description Static element Editable combobox to choose the Static element that you want to edit with regard to the way in which it is output and used Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Status Editable combobox to specify the way in which the selected Static element is output and used Here you can e choose 0 to hide the Static element e choose 1 to show the Static element and enable entries e choose 2 to output the Static element but block all entries e assign a Constant Parameter or Variable of the data type uint or e assign the reference to a Control that has the data type uint Table 5 148 The arguments of the Instruction SetStaticStatus 07 2010 OScAR Pro Customized Operator User Manual 5 177 The Elements of a DCO Script Instructions 5 11 81 The Instruction SetStaticText Description Use this Function Instruction to edit the text of a Static element Arguments Arguments Description Static element Editable combobox to specify the Static element whose text you want to edit Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Text Editable combobox to define the text you want to assi
92. Group announcement IDs List with up to 4 entries to define the additional announcement groups that shall currently be used in the broadcast Here you can e enter a valid ID with up to 4 digits e use the selection field to assign a Constant Parameter or Variable or e assign the reference to a Control that has the data type msg_id Table 5 41 Attributes and child nodes of the node OScAR Pro command templates 07 2010 OScAR Pro Customized Operator User Manual 5 45 The Elements of a DCO Scrip Frames t Attribute Description Additional attributes of the type CON Conference ID Editable combobox to define the ID of the conference that shall be convened Here you can e enter a valid ID with up to 4 digits e use the selection field to assign a Constant Parameter or Variable or e assign the reference to a Control that has the data type con_id Dialing subscribers Editable combobox to enter the telephone numbers at which the system shall contact a person Here you can e enter one of the following numbers 1 dial 1st call number only 2 dial 2nd call number only 3 dial 1st and 2nd call number e use the selection field to assign a Constant Parameter or Variable of the data type byte or e assign the reference to a Control that has the data type byte Dialing parameters Editable combobox to define if subscribers shall be dialed Here you can e enter 0 to choose that no subscrib
93. KILLPRC to end active processes broadc amp conf KILLBDC to end only specific active broadcasts selected on the basis of their ID KILLCON to end only specific active conferences select ed on the basis of their ID Table 5 41 07 2010 Attributes and child nodes of the node OScAR Pro command templates OScAR Pro Customized Operator User Manual 5 41 The Elements of a DCO Script Frames Attribute Description Additional attributes of the t ype BDC Display text Edit field to enter the text that shall be output on the display of the handset of the called person Here you can enter a text with up to 64 characters assign a Constant Parameter or Variable of the data type string assign the reference to a Control that has the data type string Dialing subscribers Combobox to specify the call numbers that shall be dialed to contact a person Here you can e enter one of the following numbers 1 dial only 1st call number 2 dial only 2nd call number 3 dial 1st and 2nd call number 4 dial only 3rd call number 5 dial 1st and 3rd call number 6 dial 2nd and 3rd call number 7 dial 1st 2nd and 3rd call number 8 dial only 4th call number 9 dial 1st and 4th call number 10 dial 2nd and 4th call number 11 dial 1st 2nd and 4th call number 12 dial 3rd and 4th call number 13 dial 1st 3rd and 4th call number 14 dial 2nd 3rd and 4th call number 15
94. Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable Production 1 blinking able Value 0 The Instruction Call Function Blink Buttons 6 5 28 2 The Function Set Description Use this Function to set the flag that governs the blinking of the Button Attributes Attribute Contents Name Set Condition Production 1 blinking Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable Production 1 blinking able Value 1 The Instruction Call Function Blink Buttons 07 2010 6 58 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 29 The Functions of the Button Production 2 The Functions underneath the Button Production 2 are automatically invoked when the But ton is pressed 6 5 29 1 The Function Delete Description Use this Function to reset the flag that governs the blinking of the Button Attributes Attribute Contents Name Delete Condition Production 2 blinking Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable Production 2 blinking able Value 0 The Instruction Call Function Blink Buttons 6 5 29 2 The Function Set Description Use this Functio
95. Pro Customized Operator User Manual 6 33 The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 Create the Functions of the Main page To successfully create the Functions of the Main page and due to the fact that the Functions Activate invoke and Blink Buttons covered in this section utilize the Functions described ear lier it is especially important that you add the below listed Functions in the correct order 6 5 1 The User Function Fire alert blink on Description Use this Function to activate the blinking of the Button Fire alert Attributes Attribute Contents Name Fire alert blink on Condition Fire alert blinking AND Selected message UEQ 1 Messagebox Instructions Instruction Argumentss Contents The Instruction SetBut Button Fire alert onn 1 Blink color E Blink color 2 Blink color E Background color Blink interval Blink interval 6 34 07 2010 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 2 The User Function Deflagration blink on Description Use this Function to switch on the blinking of the Button Deflagration Attributes Attribute Contents Name Deflagration blink on Condition Deflagration blinking AND Selected message UEQ 1 Messagebox Instructions
96. Project gt Settings gt Image list This will open the window Project image list 3 Add new images to the project or delete obsolete images from the project see below If you activated the Image list via the properties of a Control select the image you want to assign to this Control 4 Now click Ok to close the Image list or copy the assigned image to the proper Control Table 4 6 Administration of the Project image list 07 2010 4 24 OScAR Pro Customized Operator User Manual Summary of the fields in the window Project image list Operating Instructions for the OScAR Pro Customized Operator General user dialog windows Input field Description Filter by type Bw Displayed text WY acid cit danger aif electric gif explosion gif 7 fire gif 4 4 Map ipg production_1 gif f production 2 aif Currently available images E Project images list Width 1067 Fa Height 938 b par a i Filter by type Editable drop down combobox to filter the available images by type Currently avail able images This list outputs all images that are currently available in keeping with the selected filter select the image type to have all images output Add images Use this button to add new images to your image list When you click this button a user dialog will automatically open
97. Special attributes of Buttons Buttons have the following additional attributes Attribute Description Layout Combobox to define how the the text and image shall be orga nized Here you can e Image Text horizontal to position first the image and then the text from left to right e Image Text vertical to position first the image and then the text from top to bottom e Text Image horizontal to position first the text and then the image from left to right e Text Image vertical to position first the text and then the image from top to bottom Text Editable combobox to specify the Button title Here you can e enter up to 256 characters as the Button title or e assign a Constant Parameter or Variable of the data type string The title of a Button can be edited during the execution of the DCO Script with the command The Instruction SetButton Text Note e f you add a amp sign to your string the character that comes after the sign is automatically underlined For the DCO Designer to output the amp sign on a Button always make sure you enter the sign twice e g amp amp e f you want the text on your Button to be output in several lines you can force a shift return by entering n Font Field indicating the font currently used for the title of the Button To edit the font font size or font style simply make a double click on this line to open the corresponding user window with
98. Technics Production area 1 Production area 2 Image 6 3 Screenshot of the final Main page 07 2010 OScAR Pro Customized Operator User Manual 6 27 The planning and implementation of a DCO Project Create Frames and Controls Screenshot of the page Announcement selection Please select announcement FA Ok x Cancel Image 6 4 6 28 Screenshot of the final Announcement selection Frame 07 2010 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the global objects 6 4 Create the global objects 6 4 1 Create Constants Now create the following Constants see Section 5 4 2 Add a new Constant Name Data type Value Description A Blink color color FF6800 Blink color of the Button AdminTechnics A Background color 6300C6 Background color of the Button AdminTechnics color Blink interval int 1 Interval in which the colors change when blinking E Blink color color FF6800 Blink color of the Event Buttons E Background color D4D0C8 Background color of the Event Buttons when blink color ing P1 Blink color color FF6800 Blink color of the Button Production 1 P1 Back color 804000 Background color of the Button Production 1 ground color P2 Blink color color FF6800 Blink color of the Button Production 2 P2 Back color 804000 Background color of the Button Product
99. Technics are automatically invoked when this Button is pressed 6 5 27 1 The Function Delete Description Use this Function to reset the flag that governs the blinking of the Button Attributes Attribute Contents Name Delete Condition AdminTech blinking Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable AdmintTech blinking able Value 0 The Instruction Call Function Blink Buttons 6 5 27 2 The Function Set Description Use this Function to set the flag that governs the blinking of the Button Attributes Attribute Contents Name Set Condition AdminTech blinking Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable AdmintTech blinking able Value 1 The Instruction Call Function Blink Buttons 07 2010 OScAR Pro Customized Operator User Manual 6 57 The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 28 The Functions of the Button Production 1 The Functions underneath the Button Production 1 are automatically invoked when this But ton is pressed 6 5 28 1 The Function Delete Description Use this Function to reset the flag that governs the blinking of the Button Attributes Attribute Contents Name Delete Condition Production 1 blinking
100. The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 98 The arguments of the Instruction SetButtonStaticBorderColor 07 2010 OScAR Pro Customized Operator User Manual 5 125 The Elements of a DCO Script Instructions 5 11 31 The Instruction SetButtonStaticPictureName Description Use this Function Instruction to change the image of a Static element on a Button Arguments Arguments Description Button Editable combobox to define the Button whose Static element you want to give a different image Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Static element Editable combobox to define the Static element of the selected Button to which you want to assign a different image Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Image Editable combobox to define the image you want to assign to the Button s Static element Here you can e enter a file name from the List of images e select an image in the user window that opens as you click the entry Select image in the drop down list see Section 4 6
101. The Instruction SetButtonCol Changes the color of the Button or The Instruction SetButtonPic Changes the assigned image ture The Instruction SetButtonPic Changes the scaling of the image tureScal The Instruction SetButton Changes the position and size Rect Table 5 70 Overview of Instructions 07 2010 OScAR Pro Customized Operator User Manual 5 95 The Elements of a DCO Script Instructions Instruction Description The Instruction SetButtonStat icBackColor Changes the background color of one of the Static elements of a Button The Instruction SetButtonStat icBorderColor Changes the color of the Frame that surrounds one of the Static elements of a Button The Instruction SetButtonStat icPictureName Changes the image assigned to one of the Static elements of a Button The Instruction SetButtonStat icPicturePos Changes the positioning of the image assigned to one of the Static elements of a Button The Instruction SetButtonStat icPictureScale Changes the scaling of the image assigned to one of the Stat ic elements of a Button The Instruction SetButtonStat icStatus Changes the way in which one of the Static elements of a Button is output and edited The Instruction SetButtonStat icRect Changes the position and size of one of the Static elements of a Button The Instruction SetButtonStat icText Changes the text of one of t
102. Variable Editable combobox to specify the Variable to which you want to assign a new value Here you can e enter the name of the Variable direct or e selecta Variable from the list of all Variables that are avail able Value Editable combobox to specify the value you want to assign to the selected Variable Here you can e enter a numeric value or a string e assign a Constant Parameter or Variable or e assign a Control Table 5 152 The arguments of the Instruction SetVariable 07 2010 OScAR Pro Customized Operator User Manual 5 181 The Elements of a DCO Script Instructions 5 11 85 The Instruction StartProgram Description Use this Function Instruction to trigger an external document or program and if needed wait for it to be closed again Provided you enter a document for Executable program whose file extension is properly reg istered under Windows the system will start the corresponding program and open the docu ment Arguments Arguments Description Executable program Editable combobox to specify the document or program you want to open or start respectively Here you can e enter a string or e assign a Constant Parameter or Variable of the data type string Parameter Editable combobox to specify the prompting parameters Here you can e enter a string or e assign a Constant Parameter or Variable of the data type string Wait for completion Combobox to define if the you want the system to
103. a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Blink interval Editable combobox to enter an interval for the alternation be tween the two above mentioned colors in milliseconds 1000 milliseconds 1 second Here you can e enter 1 to use the interval of the parent Frame e enter a numeric value or e assign a Constant Parameter or Variable of the data type int Table 5 92 The arguments of the Instruction SetButtonBlink 07 2010 5 118 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions Note If you want the colors of a Button to alternate between the regular background color here light gray and a second indicator color here red we recommend you assign the indicator color red to the argument 1 Blink color and the background color light gray to the argument 2 Blink color This will provide an immediate and well visible reaction whenever the Button is pressed 07 2010 OScAR Pro Customized Operator User Manual 5 119 The Elements of a DCO Script Instructions 5 11 25 The Instruction SetButtonColor Description Use this Function Instruction to specify the background color of a Button Arguments Arguments Description Button Editable combobox to select the Button whose background color you want to edit Here you ca
104. a color for the text see Section 4 6 5 Edit col ors r e assign a Constant Parameter or Variable of the data type color The color of the text of an Edit field can be edited during the execution of the DCO Script with the command The Instruc tion SetEditTextColor Text Editable combobox to enter a default text for the Edit field Here you can e astring in keeping with the type that is selected for the Edit field see below or e assign a Constant Parameter or Variable of the data type string The default text of an Edit field can be edited during the execu tion of the DCO Script with the command The Instruction SetEditText Table 5 53 Special attributes of Edit fields 07 2010 5 68 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls Attribute Description Multiple lines Combobox to specify if the Edit field shall have one or more lines Here you can e 0 if you want the Edit field to have one line only e 1 if you want the Edit field to have multiple lines or e assign a Constant Parameter or Variable of the data type bool Type Combobox to define the type of the Edit field see Section 5 2 The DCO data types and their value ranges Table 5 53 Special attributes of Edit fields 07 2010 OScAR Pro Customized Operator User Manual 5 69 The Elements of a DCO Script Controls 5 9 6 Special attributes and child nodes of Buttons
105. a ee ea es 5 17 5 6 2 AOC eine Wan AO se ca ee esr he rear wr tees a eh Pe nes ek OE eB ie a 5 18 5 6 3 Edit the attributes of a Variable 0 0 0 0 ec ee 5 18 Bot ISIS 56 8 ASO a 8 Re ih eh ale RS a Bere Mee We a EE RO Bled Gy eG aoe oot Oe 5 19 5 7 1 The attributes and child nodes of the node Data lists 5 20 5 72 Add anew Data iSt phe aie a ey ach ieee E Cs ee nt a Me iy Ske Maco teen a 5 22 5 7 3 Edit the attributes of a Data list 0 00 00 0000 ee ee 5 22 5 7 4 Add a new data element ces ccc diareeha oo Marea oa we te Ae aa ee 5 23 5 7 5 Edit the attributes of a data element 0 0 0 00000 cc eee ee ee 5 23 5 7 6 The attributes and child nodes of the node Filters 00 5 24 571 Adda MEW Fit G65 oe dew dice sh den ytd wide Pie ton we eee ahah Fee ES oe wee 5 28 5 7 8 Edit the attributes of a EIEN gto bce a cdeeaa rara Mean cars ts mine eo a 5 28 BOCA an Taney rnis ks sner hed evack ae ee aah enel oes Yash eee ee oe 5 29 5 7 10 Edit the attributes of an ID range sacs bo ke whe Basera es Marie a whe ba aaa Du dw ects 5 29 5 711 Aad ai Neluded IDi 25 2b ack sat aco wena seek ala dtc te ates wg Maca ea aa tc Ree DS 5 30 5 7 12 Edit the attributes of an Included ID 00 0 ee 5 30 5 7 Loe Add an Excluded ID rodinn cle ous oa eat be arena 2a 240 Bete ed At 5 31 5 7 14 Edit the attributes of an Excluded ID 0 0 0 0 cc eee 5 31 Ori ATES zoer re vaie ene ee oa ae h
106. able 4 1 Table 4 2 Table 4 3 Table 4 4 Table 4 5 Table 4 6 Table 4 7 Table 4 8 Table 4 9 Table 5 1 Table 5 2 Table 5 3 Table 5 4 Table 5 5 Table 5 6 Table 5 7 Table 5 8 Table 5 9 Table 5 10 Table 5 11 Table 5 12 Table 5 13 Table 5 14 Table 5 15 Table 5 16 Table 5 17 Table 5 18 Table 5 19 Table 5 20 Table 5 21 Table 5 22 Table 5 23 Table 5 24 Table 5 25 Table 5 26 Table 5 27 07 2010 Tables Notations hect i0 5 a icia km asthe eet Reseed Soe eae Go ase 1 3 How to install the OScAR Pro Customized Operator 3 2 Uninstall the OScAR Pro Customized Operator 3 6 Start the OScAR Pro Customized Operator 000000 4 2 Summary of the menu items and buttons of the OScAR Pro Customized Ope rator 4 5 Summary of all available Controls 00000 cece eee eee 4 17 Rendition of marked objects 0 0000 eee eens 4 18 Edit project properties 0 0 eee 4 23 Administration of the Project image list 00000 4 24 Edit standard colors for process listS 20500 cee eee eeee 4 26 Add MEW AION 335d ctnicte cit con es hes GW Ree ah rele eee eae 4 29 AGO NEWTON eene oean Fo bow ei aoe bern oe ae ae wae on aerated Bee 4 31 Description of the predefined nodes of the tree structure 5 6 Summary of the different data types 2 0 000 e eee 5 7 List of logical operations in Formulas 000 e
107. able 5 9 Add a new Parameter 5 5 4 Edit the attributes of a Parameter Follow the below instructions to edit an existing Parameter No Task Go to the tree view of the Structure window and open the node Parameters Now open the Parameter group of the Parameter you want to edit Select the Parameter you want to edit A N gt To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value Table 5 10 Edit the attributes of Parameters 5 16 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Variables 5 6 Variables Just like Constants and Parameters Variables are place holders based on the data types as described in the Section 5 2 The DCO data types and their value ranges Variables can be used any number of times and at any place in a project Their first and fore most purpose is the exchange of information between the different elements of a Frame or also between different Frames global Usually the values of Variables change during the course of a DCO Script in the OScAR Pro TT Operator Tool When using the Variable in the subsequent course of the DCO script its name is output in be tween characters Example You can for example create a Variable to memorize in a Frame which announcements were used by a subscriber for a broadcast In a OScAR Pro command template see Section 5 8 7 OScAR Pro c
108. ackColor 07 2010 OScAR Pro Customized Operator User Manual 5 137 The Elements of a DCO Script Instructions 5 11 43 The Instruction SetCheckBoxCaption Description Use this Function Instruction to edit the text or caption of a Checkbox Arguments Arguments Description Checkbox Editable combobox to specify the Checkbox whose text you want to edit Here you can e enter the name of the Checkbox direct or e select a Checkbox from the list of all Checkboxes that are available Text Editable combobox to enter the text for the Checkbox Here you can e enter a string e assign a Constant Parameter or Variable of the data type string e assign the reference to a Control that has the data type string Table 5 111 The arguments of the Instruction SetCheckBoxCaption 07 2010 5 138 OScAR Pro Customized Operator User Manual 5 11 44 Description The Elements of a DCO Script Instructions The Instruction SetCheckBoxRect Use this Function Instruction to change the position and size of a Checkbox Arguments Arguments Description Checkbox Editable combobox to specify the Checkbox whose position and size you want to edit Here you can e enter the name of the Checkbox direct or e select a Checkbox from the list of all Checkboxes that are available Links Editable combobox to define the left and upper top margin as Top well as the width and the height in pixe
109. al in which you want the blinking Listbox items to change color Arguments Arguments Description Listbox Editable combobox to specify the Listbox whose blink interval you want to edit Here you can e enter the name of the Listbox direct or e select a Listbox from the list of all available Listboxes Blink interval Editable combobox to enter an interval for the alternation be tween the two above mentioned colors in milliseconds 1000 milliseconds 1 second Here you can e enter 1 to use the interval of the parent Frame e enter a numeric value or e assign a Constant Parameter or Variable of the data type int Table 5 133 The arguments of the Instruction SetListBoxBlinkTime 07 2010 5 162 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 66 The Instruction SetListBoxltemBlink Description Use this Function Instruction to switch on the blinking of a List element of a Listbox Arguments Arguments Description Listbox Editable combobox to specify the Listbox whose element you want to blink switch blinking of an item on Here you can e enter the name of the Listbox direct or e select a Listbox from the list of all available Listboxes List element Editable combobox to specify the index of the List element of the selected List box the blinking of which you want to switch on Here you can e enter a numeric value e assign a Constant P
110. alk aid a aan Bi Bases ba Ana adalah ee ee 5 32 5 8 1 The attributes and child nodes of the node Frames 0005 5 32 58 2 Adda NEW FRAMES ori 3 68 04m on Be eed ES a ee Gone Ae tan Se aero 5 36 5 8 3 Edit the attributes of a Frame 6 604i ee a eee ee eee 5 36 5 8 4 Add a new Control through the Structure window 000 ees 5 37 5 8 5 Add a new Control through the Layout window 00 eeee eee 5 38 5 8 6 Edit the attributes of a Control 0 ee 5 39 5 8 7 OScAR Pro command templates 000 c eee eee eee eee 5 40 5 8 8 Add anew OScAR Pro command template 0 0000 eee eee 5 52 5 8 9 Edit the attributes of aOScAR Pro command template 5 53 5 8 10 Add a new Function to a Frame 0 0 0 ce eee 5 54 5 8 11 Edit the attributes of the Functions of a Frame 00 0000 cee 5 55 07 2010 0 2 OScAR Pro Customized Operator User Manual Contents 5 Oo CONUS paca i ese rewn tad fn 23S USAO a a e Tae Seen eee Rea neta i 5 56 59 1 Theuse eg Controls earen nee Sa eo ara h 5 56 5 0 2 Ref rences to GCONUOISS 66 5 0 enn a eh RR Shane dae ee Shoe ee eae 5 58 5 9 3 Attributes shared by all Controls 0 0000 eee 5 59 5 9 4 Child nodes and special attributes of Static elements 5 62 5 9 5 Special attributes of Edit fields sx c c5s eee eae dace node MWA eae eet 5 68 5 9 6 Special attributes and child nodes of Buttons 00
111. all elements of the List The Instruction OffListBox ItemBlink Turns off the blinking for one element of the List The Instruction SetListBox BackColor Changes the background color The Instruction SetListBox BlinkTime Changes the blinking interval of the List elements The Instruction SetListBox ItemBlink Turns on the blinking for one element of the List The Instruction SetListBox ItemColor Changes the color of the text of a List element The Instruction SetListBoxList Fills the Listbox from a Data list The Instruction SetList BoxRect Changes the position and size The Instruction SetListBoxSe lectionToVariable Fills a Data list with the elements selected in the List The Instructions SetListBox Status Changes the output and editing The Instruction SetListBoxTex tColor Changes the general text color The Instruction SetListBoxTo Variable Fills a Data list with the Listbox Instructions for Comboboxes The Instruction AddListTo ComboBox Adds a datalist to the existing elements Table 5 70 07 2010 OScAR Pro Customized Operator User Manual Overview of Instructions 5 97 The Elements of a DCO Script Instructions Instruction Description The Instruction ClearComboB Deletes all elements ox The Instruction GetComboB Sets a Variable to the selected text
112. arameter or Variable of the data type int or e assign a reference to a Control that has the data type int 1 Blink color Editable combobox to define the primary blink color Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or 2 Blink color Editable combobox to enter the secondary blink color Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 134 The arguments of the Instruction SetListBoxltemBlink 07 2010 OScAR Pro Customized Operator User Manual 5 163 The Elements of a DCO Script Instructions 5 11 67 The Instruction SetListBoxltemColor Description Use this Function Instruction to change the text color of a List element of a Listbox Arguments Arguments Description Listbox Editable combobox to specify the parent Listbox of the List el ement whose text color you want to change Here you can e enter the name
113. arameter or Variable of the data type uint or e assign the reference to a Control that has the data type uint Table 5 107 The arguments of the Instruction SetButtonStatus 07 2010 5 134 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 40 The Instruction SetButtonText Description Use this Function Instruction to edit the text or caption of a Button Arguments Arguments Description Button Editable combobox to define the Button whose text you want to edit Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Text Editable combobox to enter the text you want to give the But ton Here you can e enter a string e assign a Constant Parameter or Variable of the data type string e assign the reference to a Control that has the data type string Table 5 108 The arguments of the Instruction SetButtonText 07 2010 OScAR Pro Customized Operator User Manual 5 135 The Elements of a DCO Script Instructions 5 11 41 The Instruction SetButtonTextColor Description Use this Function Instruction to edit the color of the text of a Button Arguments Arguments Description Button Editable combobox to choose the Button whose text color you want to edit Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Color Editable combob
114. arguments of the Instruction SetButtonColor 5 120 The arguments of the Instruction SetButtonPicture 5 121 The arguments of the Instruction SetButtonPictureScal 5 122 The arguments of the Instruction SetButtonRect 5 123 The arguments of the Instruction SetButtonStaticBackColor 5 124 The arguments of the Instruction SetButtonStaticBorderColor 5 125 The arguments of the Instruction SetButtonStaticPictureName 5 126 The arguments of the Instruction SetButtonStaticPicturePos 5 127 The arguments of the Instruction SetButtonStaticPictureScale 5 128 The arguments of the Instruction SetButtonStaticRect 5 129 The arguments of the Instruction SetButtonStaticStatus 5 130 The arguments of the Instruction SetButtonStaticText 5 131 The arguments of the Instruction SetButtonStaticTextColor 5 132 The arguments of the Instruction SetButtonStaticTextPosition 5 133 The arguments of the Instruction SetButtonStatus 5 134 The arguments of the Instruction SetButtonText 5 135 The arguments of the Instruction SetButtonTextColor 5 136 The arguments of the Instruction SetCheckBoxBackColor 5 137 The arguments of the Instruction SetCheckBoxCaption 5 138 The arguments of the Instruction SetCheckBoxRect 5 139 The arguments of SetCheckBoxState
115. at to do so the Variable and the Edit field must have the same data type see Section 5 2 The DCO data types and their value ranges Arguments Arguments Description Edit field Editable combobox to specify the Edit field whose content you want to be saved in a Variable Here you can e enter the name of an Edit field direct or e select an Edit field from the list of all Edit fields that are available Variable Editable combobox to specify the Variable you want to use to save the content of the indicated Edit field Here you can e enter the name of the Variable direct or e select a Variable from the list of all available Variables with the same data type Table 5 130 07 2010 The arguments of the Instruction SetEditToVariable OScAR Pro Customized Operator User Manual 5 159 The Elements of a DCO Script Instructions 5 11 63 Description The Instruction SetFrameColor Use this Function Instruction to change the background color of a Frame As a rule this Instruc tion will always apply to the Frame that is the parent of the Function that is invoked and there fore executed Arguments Arguments Description Color Editable combobox to define the background color you want to assign to the Frame Here you can e enteracolor value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color s
116. be added to the child node Controls under the node Frame every Button child node under the node Controls may have up to 4 own Static elements that are stored under the parent node Button and there in their respective Static elements child node Edit field Use the Edit field to enter the numeric or alphanumeric val ues that are needed for the later operation e g display texts that shall be output to the alerted subscribers during broad casts Button The Control Button is used to execute Functions triggered by the user e g to activate broadcasts in OScAR Pro In addition to its attributes every Buttons also has a child node that is used to administrate the Functions that shall be execut ed when the Button is pressed Checkbox The Checkbox is used for Yes No True False and Set Changed arguments e g to define that the selected broad casts are started individually or together in form of a hunt group Listbox The Listbox is used to select an entry from a list of several entries e g to choose a specific announcement from the glob al List of all announcements that are currently available Entries in a Listbox can have different colors Table 5 46 Application of the Controls 07 2010 5 56 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls Attribute Description Combobox Just like the Listbox the Combobox is used to select an en try from
117. ble of the data type bool or e assign the reference to a Control that has the data type bool Bring all other broadcasts to Editable combobox to define if the windows of other broad top casts processes are automatically be brought to the front Here you can e enter 0 to keep Process windows in the background e enter 1 to bring the Process window to the front e use the selection field to assign a Constant Parameter or Variable of the data type bool or e assign the reference to a Control that has the data type bool Bring own conferences to top Editable combobox to define if the windows of the user s own conference processes are automatically be brought to the front Here you can e enter 0 to keep Process windows in the background e enter 1 to bring Process windows to the front e use the selection field to assign a Constant Parameter or Variable of the data type bool or e assign the reference to a Control that has the data type bool Bring all other conferences to Editable combobox to define if the windows of other confer top ence processes are automatically be brought to the front Here you can e enter 0 to keep Process windows in the background e enter 1 to bring Process windows to the front e use the selection field to assign a Constant Parameter or Variable of the data type bool or e assign the reference to a Control that has the data type bool Table 5 41 Attributes and child nodes of
118. boxes with the command The Instruction SetComboBoxBackColor Table 5 48 5 60 Attributes shared by all Controls 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls Attribute Description Status Editable combobox to define if a Control is rendered and how it is used Here you can e 0 to hide the Control e 1 to show the Control and enable entries e 2 to show the Control and block entries or e aConstant Parameter or Variable of the data type uint The status can be edited while the DCO Script is being execut ed for e Static elements with the command The Instruction Set StaticStatus e Edit fields with the command The Instruction SetEdit Status e Buttons with the command The Instruction SetButton Status e Static elements placed on a Button with the command The Instruction SetButtonStaticStatus e Checkboxes with the command The Instruction Set CheckBoxStatus e Listboxes with the command The Instructions SetList BoxStatus e Comboboxes with the command The Instruction Set ComboBoxStatus Table 5 48 Attributes shared by all Controls 07 2010 OScAR Pro Customized Operator User Manual 5 61 The Elements of a DCO Script Controls 5 9 4 Child nodes and special attributes of Static elements Special attributes of Static elements Static elements have the following additional attributes Attribute De
119. cale 5 175 The arguments of the Instruction SetStaticRect 5 176 The arguments of the Instruction SetStaticStatus 5 177 The arguments of the Instruction SetStaticText 5 178 The arguments of the Instruction SetStaticTextColor 5 179 The arguments of the Instruction SetStaticTextPosition 5 180 The arguments of the Instruction SetVariable 5 181 The arguments of the Instruction StartProgram 5 182 Create ihe project sd esl ek aimee eile yee bata tees 6 10 Open an existing project 5 oi 42 aes Saito er ees 4 SG oh okonenns 6 11 Create and adjust the Main page 00 cee eee eee eee 6 12 Create and tweak the Frame Announcement selection 6 13 Add a background image to the Main page 005 6 14 07 2010 OScAR Pro Customized Operator User Manual Table 6 6 Table 6 7 Table 6 8 Table 6 9 Table 6 10 Table 6 11 Table 6 12 Table 6 13 Table 6 14 Table 6 15 Table 6 16 Table 6 17 Table 7 1 Table 7 2 Table 7 3 Table 7 4 07 2010 Tables Insertseparator lines cs 20 Res iow tee See dS te ee teers oad 6 15 Adda Capti m nue iia i ha ap he ce Rae ed ay ae oa va aR ar a ee ee Be 6 16 Insert Event BUMONS 2 eq ieknes oy eerie sate va mdee oh atetes 6 19 Insert Area ButtonS a an anaana ht ek lw be been dd Saeed ek 6 21 Insert Invoke Buttons ne soc visa vrs danc
120. changed during the execution of the DCO Script with the command The In struction SetStaticTextColor Table 5 52 5 66 Attributes of the child node Caption of a Static element 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls Attribute Description Position Drop down list to select the position for the text that shall ap pear on the Static element Here you can e left top to place the image in the upper left corner of the Static element e h center top to place the image at the upper border of the Static element and there in horizontally in the center e right top to place the image in the upper right corner of the Static element e left v center to place the image at the left border of the Static element and there vertically in the center e h center v center to position the image in the vertical and horizontal center of the Static element e right v center to place the image at the right border of the Static element and there vertically in the center e left bottom to place the image in the lower left corner of the Static element e h center bottom to place the image at the lower border of the Static element and there horizontally in the center e right bottom to place the image in the lower right corner of the Static element e orassign a Constant Parameter or Variable of the data type string The position of the text that shall be output on a Stat
121. choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or 2 Blink color Editable combobox to enter the secondary blink color Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 129 The arguments of the Instruction SetEditTextColorBlink 07 2010 OScAR Pro Customized Operator User Manual 5 157 The Elements of a DCO Script Instructions Arguments Description Blink interval Editable combobox to enter an interval for the alternation be tween the two above mentioned colors in milliseconds 1000 milliseconds 1 second Here you can e enter 1 to use the interval of the parent Frame e enter a numeric value or e assign a Constant Parameter or Variable of the data type int Table 5 129 The arguments of the Instruction SetEditTextColorBlink 07 2010 5 158 OScAR Pro Customized Operator User Manual 5 11 62 Description The Elements of a DCO Script Instructions The Instruction SetEditToVariable Use this Function Instruction to save the content of an Edit field in a Variable Please note th
122. ck fg to switch to the Structure window 2 Add anew Frame and assign to it the name An 5 8 2 Add a new Frame nouncement selection This Frame that will later be opened with the click of a Button has the form of a user dialog for an easy se lection of the right announcement 3 In the tree mark the newly added Frame Announce ment selection then go to the toolbar and click E 4 This time select Layout gt Frame size 4 4 4 Change the size of Frames gt 600x800 in the menu bar to adjust your Frame to and Controls a smaller Frame size 5 Finally click ey to save the project Table 6 4 Create and tweak the Frame Announcement selection 07 2010 OScAR Pro Customized Operator User Manual 6 13 The planning and implementation of a DCO Project Create Frames and Controls 6 3 2 Add a background image to the Main page In the next step you need to place the map of the company plant as a background image onto the Main page To do so you first need to add a Static element that can be used to place im ages captions or info texts anywhere in the Frame Follow the below instructions to create the map of the plant through the Structure window No Task References 1 Goto the tree view of the Structure Window and open the node Frames 2 Now open the node Main page under the parent node Frames still in the tree view of the Structure window 3 Under t
123. combobox to choose the Static element whose image you want to reposition Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Position Drop down list to define the position of the image in the Static element Here you can e choose from left top h center top right top left center h center v center right center left bottom h center bottom and right bottom to find the best position for the image of the Static element e assign a Constant Parameter or Variable of the data type string or e assign the reference to a Control that has the data type string Table 5 145 The arguments of the Instruction SetStaticPicturePos 07 2010 5 174 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 78 The Instruction SetStaticPictureScale Description Use this Function Instruction to edit the scaling of the image of a Static element Arguments Arguments Description Static element Editable combobox to choose the Static element whose image you want to scale Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Scaling Editable combobox to define the scaling factor in for the im age assigned to the Static element Here you can e enter a scaling factor in e
124. confer ence you want to end is running Here you can enter 0 to end conferences started by any user enter 1 to end all conferences that were NOT started by the present user enter 2 to end all conferences that were started by the present user enter 3 to end all conferences that were started by the present user via the OScAR Pro TT Operator Tool enter 4 to end all conferences that were started by the present user via the OpenScape Alarm Response Profes sional use the selection field to assign a Constant a Parameter or a Variable of the data type uint or assign the reference to a Control that has the data type uint Conference ID Editable combobox to define the ID of the conference you want to end Here you can leave the entry blank to end ALL conferences listed active in the Process context or enter a valid ID of a broadcast with up to 4 digits enter a valid ID with up to 4 digits use the selection field to assign a Constant Parameter or Variable of the data type con_id or assign the reference to a Control that has the data type con_id Table 5 41 Attributes and child nodes of the node OScAR Pro command templates 07 2010 OScAR Pro Customized Operator User Manual 5 51 The Elements of a DCO Script Frames 5 8 8 Add a new OScAR Pro command template Follow the below instructions to add a new OScAR Pro command template to a Frame No Task 1 Go to the tree structure and open th
125. ction SetBut Button AdminTechnics tonBlink 1 Blink color A Blink color 2 Blink color A Background color Blink interval Blink interval 07 2010 OScAR Pro Customized Operator User Manual 6 37 The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 8 The User Function Production 1 blink on Description Use this Function to activate the blinking of the Button Production 1 Attributes Attribute Contents Name Production 1 blink on Condition Production 1 blinking Messagebox Instructions Instruction Arguments Contents The Instruction SetBut Button Production 1 tonBlink 1 Blink color P1 Blink color 2 Blink color P1 Background color Blink interval Blink interval 6 5 9 The User Function Production 2 blink on Description Use this Function to activate the blinking of the Button Production 2 Attributes Attribute Contents Name Production 2 blink on Condition Production 2 blinking Messagebox Instructions Instruction Arguments Contents The Instruction SetBut Button Production 2 ORES 1 Blink color P2 Blink color 2 Blink color P2 Background color Blink interval Blink interval 07 2010 6 38 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Mai
126. customized inter face but it will surely be helpful if you are have a global understanding of variables constants functions and procedures and filters The OScAR Pro Customized Operator enables you to e create customized interfaces also multi level and design their layout e adjust the properties of the objects used in these interfaces for example their typeface or color e import images e create and use constants variables functions and filters and e validate and simulate the obtained results 2 5 The tasks of the DCO Script DCO Scripts are created by the OScAR Pro Customized Operator and can be edited through the system whenever necessary DCO Scripts are comparable to small databases as they contain all the information that is needed by the OScAR Pro TT Operator Tool to output the customized interface and execute its commands In addition each DCO Script has a sub directory titled Images where all the imported images are stored 07 2010 OScAR Pro Customized Operator User Manual 2 5 Overview The tasks of the OSCAR Pro TT Operator Tool 2 6 The tasks of the OScAR Pro TT Operator Tool The OScAR Pro TT Operator Tool reads and interprets the DCO Script and outputs the cus tomized interface 1 1 like it was created and simulated in the OScAR Pro Customized Operator In addition the OScAR Pro TT Operator Tool interprets the OScAR Pro commands contained in the DCO Script and transmits them to the OScAR Pro serv
127. d Operator User Manual 5 31 The Elements of a DCO Script Frames 5 8 Frames Use the node Frames to create and edit the various screen frames of the visual interface as they are output in the OScAR Pro TT Operator Tool through the DCO script You can create any number of Frames and customize their design individually Use the Layout window to design the graphic look of the Frames created here The Frames themselves are created in the node Frames Here each Frame node has the following three child nodes e Controls e OScAR Pro command templates and e Functions 5 8 1 The attributes and child nodes of the node Frames The attributes of Frames Frames have the following attributes Attribute Description Type Combobox to specify the type of the page Here you can e select normal to define a normal page or e select toolbar to define a toolbar page Other than the special attributes described below toolbar pages do not differ from normal pages Name Edit field to enter the name of the Frame Select a name that is recognizable and unique among the other Frame names Color Editable combobox to choose the background color of the Frame Here you can e enter a color value e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors or e assign a Constant Parameter or Variable of the data type color Table 5 34 Attributes of Frames 0
128. d an entry to cover the value range from 0000 to 1999 In Excluded IDs you added an entry with the value 1000 In Included IDs you added an entry with the value 4000 If you invoke this Filter with the command GetMessages a Data list will be output with all ad ministrated announcements whose IDs lie between 0000 and 1999 In addition the List will include the announcement with the ID 4000 but omit the announcement with the ID 1000 07 2010 OScAR Pro Customized Operator User Manual 5 27 The Elements of a DCO Script Lists 5 7 7 Add a new Filter Follow the below instructions to create a new Filter No Task Go to the tree structure and open the node Lists Now open the child node Filters Now go to the menu bar and select Edit gt New This will open the below user window to add the new process Filter x Please name entry Name AnnouncementList SERRE Resale Type MSG K Cancel Enter a name for the Filter that is clear and unique Specify the data type of the Filter Finally click Ok to close the window The DCO Designer outputs the newly created Filter in the tree structure of the Structure window and there in the Filters child node of the node Lists If needed you can now edit the attributes of the Filters entries in the subordinate child nodes ID ranges Included IDs and Excluded IDs Table 5 26 Create the Filter
129. d eter ae ae de a 6 59 0529 2 ThE PUNCIION SO cote 4 02 a a Bee OY ah ee ee ae aa 6 59 6 5 30 The Functions of the Button Invoke Invoke broadcast 6 60 6 6 Create the Functions of the Frame Announcement selection 6 61 6 6 1 The User Function On cancel 0 0 00 ee ee es 6 61 6 6 2 On_Load Functions Fill announcement list 0000s 6 62 6 6 3 The Functions of the Button Cancel Cancel dialog 6 63 6 6 4 The Functions of the Button Ok 0 0 0 0 ccc eee eee ee 6 64 6 6 4 1 The Function With selection 22 uciimed ov acc ews Haw a 6 64 6 6 4 2 The Function Without selection 0 0 0 0 ee ee 6 65 6 7 Test th DCO SC pl inp tice ea yd ook ok wa aR ae Merl ee OD ede Laon ew ka 6 66 7 The DCO in the OScAR Pro TT Operator Tool 000 eee eee eee eee 7 1 7 1 Publication of the DCO Script t026ss fae hoe he too det ke eek oe bs 7 2 7 2 Layout in the OScAR Pro TT Operator Tool 000 0 cece eee eee 7 2 7 2 1 The DCO in the child WINKOW esis ass nea 895 95 wack ne Se Ee een dete Bea 7 3 7 2 2 The DCO in the TOCID ALS 2c fi dee Bre 2 nance wld cectorter de ce tiga sees Geib Brora edged bn Mon fa 7 4 7 2 3 Summary of the enhanced menu bar in the OScAR Pro TT Operator Tool 7 4 7 3 Operation of the DCO Window isch ace Gard ot arnw ea hake ean iced wre ree DRS 7 5 7 3 1 Load a DCO Scripts for the first time in the OScAR Pro TT
130. d instructions Every DCO Script that has been created and tested in the DCO Designer is executed in the OScAR Pro TT Operator Tool in a special window the so called DCO Window DCO Scripts can be executed in two different versions see Section 7 2 3 Summary of the en hanced menu bar in the OScAR Pro TT Operator Tool e ina child window or e ina toolbar Each OScAR Pro TT Operator Tool workstation can operate a separate and if needed cus tomized DCO Script This enables you to set up multiple workstations and assign specific and distinctive interfaces to each one 07 2010 7 2 OScAR Pro Customized Operator User Manual The DCO in the OScAR Pro TT Operator Tool Layout in the OScAR Pro TT Operator Tool 7 2 1 The DCO in the child window If the DCO Script is executed in a child window it automatically shares the so called workspace with the other windows of the OScAR Pro TT Operator Tool namely e the Admin window of the OScAR Pro TT Operator Tool e all Broadcast Process windows and e all Conference Process windows Please note that the Process windows and the Admin window may cover the DCO Window in full or in in part Vice versa Process windows can also be covered by the DCO Window Under some circumstances this may entail that the activation of a new process in the background goes unnoticed by and therefore escapes the attention of the OScAR Pro TT Operator Tool user If the DCO Window is in the background you can
131. d open the node Frames 2 Now open the node Main page under the parent node Frames still in the tree view of the Structure window 3 Now click lJ to switch to the Layout window 4 Now add a new Static element with the following at 5 8 5 Add a new Control through tribute values the Layout window e Name Event e Left 0 5 8 6 Edit the attributes of a Con e Top 10 trol e Width 150 e Height 60 5 Change the attribute values in the node Caption to 5 8 6 Edit the attributes of a Con e Text Events trol e Text color FF6800 e Font Microsoft Sans Serif 4 6 4 Edit fonts e Font style bold e Size 14 6 Now repeat steps 4 and 5 with the following attributes values e Name Event title e Left 1105 e Top 10 e Width 170 e Height 15 e Text Currently selected e Text color 0000FF e Position left top e Font Microsoft Sans Serif e Font style bold e Size 10 Table 6 7 Add a Caption 07 2010 6 16 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create Frames and Controls No Task References 7 Now repeat steps 4 and 5 with the following attributes values e Name Event name e Left 1105 e Top 30 e Width 170 e Height 38 e Text Hints e Text color FF6800 e Position left v center e Font Microsoft Sans Serif e Font style Italics e Size 10 8 Now repeat steps 4 and 5 with the following attributes values e Name
132. d select Edit gt New This will open the below user window to add the new process Filter xi Please name entry Name MessageBoxWelcome i J 6 Enter a name for the new Function that is clear and distinct in this Frame 7 Finally click Ok to close the window The DCO Designer outputs the new Function in the tree structure of the Structure win dow and there in the child nodes On_Load On_Message On_Timer or User If needed you can now edit the attributes of the new Function and its Instructions Table 5 44 Add a new Function to a Frame 07 2010 5 54 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Frames 5 8 11 Edit the attributes of the Functions of a Frame Follow the below instructions to edit the attributes of an existing Function of a Frame No Task Go to the tree structure and open the node Frames Open the parent Frame of the Function you want to edit Now open the child node Functions that contains the Function you want to edit Here you can choose between the child nodes e On_Load if you want the Function you want to edit also to be executed when the Frame is loaded or e On_Message if you want the new Function to be invoked by instructions of the type Broadcast Message see Section 5 11 8 The Instruction BroadcastMessage by double clicking on a listbox entry or by selecting an entry in a combob
133. d there in the node Variables You can now edit the attributes of the Variable Table 5 12 Add a new Variable 5 6 3 Edit the attributes of a Variable Follow the below instructions to edit an existing Variable No Task Go to the tree structure and open the node Variables Now select the Variable you want to edit To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value Table 5 13 Edit the attributes of a Variable 07 2010 5 18 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Lists 5 7 Lists The node Lists does not possess any attributes but has the child nodes e Data lists and e Filters Short summary of the Data lists The Data lists are place holders of a certain data type see Section 5 2 The DCO data types and their value ranges with subordinate data elements They serve to fill the Controls List box and Combobox The Data lists can be filled in the OScAR Pro Customized OperatorDCO Designer with Con stant data elements or obtain the data from theSection 5 11 Instructions through various In structions see OScAR Pro TT Operator Tool Apart from the attributes each Data list also has data elements that are output in the Controls Listbox and Combobox and administrated in a special child node called Data Elements Short summary of Filters The purpose of Filters is to con
134. dcast member or conferee who is has been reached successfully reached Calling of sub This color visualizes a broadcast member or conferee who is momentarily in a dialing pause No further pro cessing of sub scriber This color visualizes a broadcast member or conferee whose processing has been fully completed Conferee has muted himself This color visualizes a broadcast member or conferee who has switched himself to mute microphone OFF Conferee partici pates passively This color stands for a conference member who is partaking passively in the conference i e listening only Conferee partici pates actively This color stands for a conference member to is participating actively in the conference i e both listening and speaking Conferee on hold This color visualizes a subscriber who has temporarily left the conference hearing on hold message Default settings Button to reset all values to the default settings Standard colors This button is only visible in the window Process colors Use this button to reset all values to the standard colors 4 28 07 2010 OScAR Pro Customized Operator User Manual Operating Instructions for the OScAR Pro Customized Operator General user dialog windows 4 6 4 Edit fonts Use the window Font to define the fonts of the texts that are output in the various elements of the Frame Follow the below instructions to select a
135. ditable combobox to specify the Data list to which you want to add the received conferences Here you can e enter the name of the Data list direct or e select a Data list from the list of all available Data lists of the data type con_id Filter Editable combobox to define the Filter that is used to limit the received conferences Here you can e enter the name of the Filter direct or e select a Filter of the type CON from the list of all available Filters Table 5 80 The arguments of the Instruction GetConferences Note To have the conference List received with this command output on top you need to place a List or Combobox in the Frame and in a second step fill either or both with the command The In struction SetListBoxList and the aforementioned Data list 07 2010 5 108 OScAR Pro Customized Operator User Manual 5 11 13 Description The Elements of a DCO Script Instructions The Instruction GetComboBoxSelText This commands enables you to read out a selected Combobox text and save it in a Variable Arguments Arguments Description Combobox Editable combobox to specify the Combobox whose selected text you want be to read out Here you can e enter the name of the Combobox direct or e select a Combobox from the list of all available Combob oxes Variable Editable combobox to specify the Variable you want to use to save the selected Combobox text Here you can e enter the
136. e 5 11 49 The Instruction SetComboBoxBackColor 5 11 50 The Instruction SetComboBoxList 5 11 51 The Instruction SetComboBoxRect 5 11 52 The Instruction SetComboBoxStatus 5 11 53 The Instruction SetComboBoxTextColor 5 11 54 The Instruction SetComboToVariable 5 11 55 The Instructions SetEditBackColor 5 11 56 The Instruction SetEditBackColorBlink 5 11 57 The Instruction SetEditRect 5 11 58 The Instruction SetEditStatus 5 11 59 The Instruction SetEditText 5 11 60 The Instruction SetEditTextColor 5 11 61 The Instruction SetEditTextColorBlink 5 11 62 The Instruction SetEditToVariable 5 11 63 The Instruction SetFrameColor 5 11 64 The Instruction SetListBoxBackColor 5 11 65 The Instruction SetListBoxBlinkTime 5 11 66 The Instruction SetListBoxltemBlink 5 11 67 The Instruction SetListBoxltemColor 5 11 68 The Instruction SetListBoxList 5 11 69 The Instruction SetListBoxRect 5 11 70 The Instruction SetListBoxSelectionToVariable 5 11 71 The Instructions SetListBoxStatus 5 11 72 The Instruction SetListBoxTextColor 5 11 73 The Instruction SetListBoxToVariable 5 11 74 The Instruction SetStaticBackColor 5 11 75 The Instruction SetStaticBorderColor 5 11 76 The Instruction SetStaticPictureName 5 11 77 The Instruction SetStaticPicturePos 5 11 78 The Instruction SetStaticPictureScale 5 11 79 The Instruction SetStaticRect 5 11 80 The Instruction SetStaticStatus 5 11 81 The Instruction SetStaticT
137. e A Function that is automatically invoked when this Frame is loaded and that fills the Listbox with all administrated announcements within the D area from 0000 to 1999 e A Function that is triggered when Ok is clicked without a prior confirmation of the se lected announcements and also when the Cancel Button is clicked e The Ok Button is given a Function to store the selected announcement and jump to the Main Page e The Cancel Button jumps directly to the Main Page 07 2010 OScAR Pro Customized Operator User Manual 6 9 The planning and implementation of a DCO Project Project administration 6 2 Project administration 6 2 1 Create the project Follow the below instructions to create the project No Task References 1 Start the DCO Designer 4 1 Start the OScAR Pro Custom ized Operator 2 Gotothe menu bar and click Project gt New and use the keyboard shortcut Ctrl N or click in the tool bar This will open the window E Create project Project name project directory EXP Chemical Industries Inc Path Cancel C Mtetronik DAKS TTS E _Xtwee File name of DCO script EXP Chemical Industries Inc dco x 3 Use the field Project name project directory to en ter a unique and recognizable name for your project enter max 50 characters not supported characters are lt gt e g EXP Chemical Industries Inc 4 Use the field
138. e Edit field upon which you want the blinking to end Here you can e enter the name of an Edit field direct or e select an Edit field from the list of all Edit fields that are available Table 5 89 The arguments of the Instruction OffEditBackColorBlink 07 2010 OScAR Pro Customized Operator User Manual 5 115 The Elements of a DCO Script Instructions 5 11 22 The Instruction OffEditTextColorBlink Description Use this Function Instruction to turn OFF the blinking of the text content of an Edit field Arguments Arguments Description Edit field Editable combobox to define the Edit field upon which you want the blinking to end Here you can e enter the name of an Edit field direct or e select an Edit field from the list of all Edit fields that are available Table 5 90 The arguments of the Instruction OffEditTextColorBlink 07 2010 5 116 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 23 The Instruction OffListBoxltemBlink Description Use this Function Instruction to turn OFF the blinking of a single item of a Listbox Arguments Arguments Description Listbox Editable combobox to specify the Listbox the blinking of which you want to switch off Here you can e enter the name of the Listbox direct or e select a Listbox from the list of all available Listboxes List element Editable combobox to define the index of the List element t
139. e col or Table 5 143 The arguments of the Instruction SetStaticBorderColor 5 172 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 76 The Instruction SetStaticPictureName Description Use this Function Instruction to change the image of a Static element Arguments Arguments Description Static element Editable combobox to choose the Static element whose image you want to edit Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Image Editable combobox to define the image you want to assign to the Static element Here you can e enter a file name from the List of images e select an image in the user window that opens as you click the entry Select image in the drop down list see Section 4 6 2 Administration of the Image lists e assign a Constant Parameter or Variable of the data type string e assign the reference to a Control that has the data type string Table 5 144 The arguments of the Instruction SetStaticPictureName 07 2010 OScAR Pro Customized Operator User Manual 5 173 The Elements of a DCO Script Instructions 5 11 77 The Instruction SetStaticPicturePos Description Use this Function Instruction to change the positioning of the image of a Static element Arguments Arguments Description Static element Editable
140. e conference or e aConstant Parameter or Variable of the data type int Table 5 63 Attributes of Process filters 5 9 13 Double click events of Listboxes Double clicking on a listbox entry internally leads to sending a message also see Section 5 11 8 The Instruction BroadcastMessage though it is only processed on the page the list box is located on The message sent is processed by the function with the same name as the listbox in branch On_Message 07 2010 5 84 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls 5 9 14 Add new Process filters to Listboxes Please bear in mind that Process filters can only be added to a Listbox if the Listbox has the type process Follow the below instructions to create a new process Filter for a Listbox No Task Go to the tree structure and open the node Frames Open the parent Frame of the Listbox to which you want to add a new new process Filter Now open the child node Controls Open the Listbox to which you want to add a new process Filter Click the child node Process Filter Now go to the menu bar and select Edit gt New This will open the below user window to add the new process Filter xi r Please name entry Name Active broadcasts i Dnj re N gt 2 lt Cancel 7 _ Assign a unique and recognizable name to the new process Filter 8 Finally click
141. e covers the entries that are created in the OScAR Pro TT Operator ToolWin dows Registry of the whenever the DCO is used Entry Description HKEY CURRENT _USER Software tetronik GmbH AEN tetronik OScAR Pro TT Operator Tool Set tings LastGUIOpened Entry of the type REG_SZ that is used to store the path of the currently assigned DCO Script LastGUIReOpen Entry of the type REG_DWORD that is used to store the infor mation if the DCO Script is automatically loaded at the pro gram start yes 1 or no 0 GUIBar Entry of t he type REG_DWORD that is used store the infor mation if the DCO Script is shown as a docking window 1 or as a child window 0 Table 7 4 DCO registry entries in the OScAR Pro TT Operator Tool 07 2010 7 10 OScAR Pro Customized Operator User Manual Index Subtract 5 9 Symbole l not equal 5 10 5 9 multiply 5 9 divide 5 10 amp 5 70 5 78 amp logical and 5 10 amp amp 5 70 5 78 5 11 5 13 5 91 add 5 9 lt less than 5 10 lt less than or equal to 5 10 equals 5 10 gt 5 10 gt great than 5 10 gt greater than or equal to 5 10 logical or 5 10 5 17 5 91 A ADD 5 9 Add new font 4 29 Addition 5 9 AddListTtoComboBox 5 97 5 102 Alarm plans 2 2 Alarms 2 2 Align Controls 6 19 ALL 5 24 AND 5 10 Announcement 2 2 Announcement text for TTV 5 44 Announcements 2 2 B BDC 5 24 5 41 5
142. e editable Parame ters of the corresponding Frame in the OScAR Pro TT Operator Tool The attributes and child nodes of the node OScAR Pro command templates Depending on their type OScAR Pro command templates have different attributes and child nodes Attribute Description Global attributes Name Edit field to enter the name of the OScAR Pro command tem plate Table 5 41 Attributes and child nodes of the node OScAR Pro command templates 07 2010 5 40 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Frames Attribute Description Type Combobox to specify the type of the OScAR Pro command template Depending on its type a OScAR Pro command tem plates can have further attributes Here you can choose BDC to set off a broadcast or a broadcast hunt group CON to invoke a conference ITL to switch the info telephone profile that is currently ac tive SCN to start a scenario CALLWHI to contact a telephone number through a Sie mens Dial Assistant Interface short WHI or USB Call Bridge CANCELWHI to disconnect a call through a Siemens Call Assistant Interface or USB CallBridge SHOW_BDC to output the window of an active broadcast in the OScAR Pro TT Operator Tool SHOW_CON to output the window of an active confer ence in the OScAR Pro TT Operator Tool or SET_PRM to set the Parameters for the output of Process windows in the OScAR Pro TT Operator Tool
143. e he anaana 6 23 Add Controls to the Frame Announcement selection 6 24 Create Constants o s sta lt a wea bik gree E E ee gS cede eee oe 6 29 Create Parameters a s s o dye hie diy 84 hea elena ale taa ear PS awe we 6 30 Create Variables s itii di it EA E E aR oa lyre Staves 6 31 Create DatailiSts 23 0 tw ev ikk heey eae eu See dhe E AEEY 6 32 Create the Piltohe i645 0 9078 6 noria they ceed ae cet pe ye E tees 6 32 Add a background image to the Main page 000 6 66 Summary of the enhanced menu bar in the OScAR Pro TT Operator Tool 7 4 Summary of the menu items and buttons of the DCO Window 7 5 Initial loading of a DCO Script in the OScAR Pro TT Operator Tool 7 7 DCO registry entries in the OScAR Pro TT Operator Tool 7 10 OScAR Pro Customized Operator User Manual 0 15 Tables 07 2010 0 16 OScAR Pro Customized Operator User Manual Conventions and Operating Instructions 1 Conventions and Operating Instructions Target audience and qualifications The DCO Designer V 1 02 User Manual is designed for all users and service providers involved in creating and editing customized interfaces for the OScAR Pro TT Operator Tool To successfully carry out the operations treated in this document you need to be familiar with Windows and you should know how to operate OScAR Pro through the OScAR Pro TT Oper ator Tool Contents The chapter covers the following sections 1 1 Referenc
144. e manuals 1 2 Notations and symbols 1 3 Privacy and data security 07 2010 OScAR Pro Customized Operator User Manual 1 1 Conventions and Operating Instructions Reference manuals 1 1 Reference manuals The OScAR Pro TT User Manual OScCAR Pro Release 7 OSCAR Pro V3 R2 offers additional detailed information and tutorials that can be of valuable assistance for the operation of OS cAR Pro 07 2010 1 2 OScAR Pro Customized Operator User Manual Conventions and Operating Instructions Notations and symbols 1 2 Notations and symbols Conventions The following definitions are used in this document Text Both the texts from the files described in this manual and the en tries made into them appear in the non proportional Courier typeface The password 123456 Details and instructions in the continuous text that are of particu lar importance or that must be heeded appear in bold print Buttons are also in bold print The global cfg file Files and directories appear in the non proportional type face Courier Name Field names menu names and window descriptions are placed in quotation marks lt Place holder gt Entries and outputs both of which may vary depending on the in dividual situation are placed in angle brackets and shown in ital ics Table 1 1 Notations Symbols The following symbols are used in the DCO Designer User Manual Throughout this manual t
145. e node Frames Open the Frame to which you want to add a new OScAR Pro command template 3 Still in the tree click the child node OScAR Pro command templates under the node Frames 4 Now go to the menu bar and select Edit gt New This will open the below user window to add the new process Filter x Please name entry Name Launch broadcast Type BDC ue X Cancel 5 Give the new name for the new OScAR Pro command template that is clear and distinct from the other templates in this Frame 6 Select the type for the OScAR Pro command template 7 Finally click Ok to close the window The DCO Designer outputs the newly created OScAR Pro command template in the tree view of the Structure window and there in the child node OScAR Pro command templates under the node Frames If needed you can now edit the attributes of the new OScAR Pro command template Table 5 42 Add a new OScAR Pro command template 07 2010 5 52 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Frames 5 8 9 Edit the attributes of aOScAR Pro command template Follow the below instructions to edit the attributes of an already existing OScAR Pro command template No Task Go to the tree structure and open the node Frames Open the Frame to which you want to add a new OScAR Pro command template Still in the tree click the child node OScAR Pro co
146. e the child node On_Message e the child node On_Timer e orthe child node User Continue with step 7 5 Open the parent Button of the Function to which you want to add a new Instruction 6 Click the child node Functions 7 _ Now open the child node Functions that contains the Instruction you want to edit 8 Now open the child node Instructions 9 Now go to the menu bar and select Edit gt New This will open the following user window to edit the selected Instruction x m Instruction i F z m SetButtonBlink E m Arguments X Cancel Button Fire alert gt 1 Blink color 2 Blink color uxe Background color Blink interval Blink interval Start blinking of a button 10 Edit the Instructions and or arguments as required 11 Finally click Ok to save your changes and close the user window Table 5 72 Edit an Instruction of a Function 07 2010 5 100 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 5 Change the order in which the Instructions are executed Follow the below instructions to change in a Function the order in which the existing Instructions are executed No Task Go to the tree structure and open the node Frames 2 Open the parent Frame of the Function whose Instructions you want edit with regard to the order in which they are executed 3 Open e either the node Functions and continue with step 4 e
147. ed Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Frame Announcement selection 6 6 3 The Functions of the Button Cancel Cancel dialog Description This Function is automatically invoked whenever the Button is pressed and invokes the Function On cancel Attributes Attribute Contents Name Cancel dialog Condition Messagebox Instructions Instruction Arguments Contents The Instruction Call Function On cancel 07 2010 OScAR Pro Customized Operator User Manual 6 63 The planning and implementation of a DCO Project Create the Functions of the Frame Announcement selection 6 6 4 The Functions of the Button Ok The Functions underneath the Button Ok are automatically invoked when this Button is pressed 6 6 4 1 The Function With selection Description This Function uses the Variable Selected message to save the selected announcement and jumps back to the Main page Attributes Attribute Contents Name With selection Condition LISTBOX Announcement list UEQ Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable More blinking able Value 1 The Instruction SetVari Variable Selected message able Value LISTBOX Announcement list The Instruction GetList Listbox Announcement list BoxSelText Variable Selected message The
148. ed Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 22 The Functions of the Button Deflagration The Functions underneath the Button Deflagration are automatically invoked when this But ton is pressed 6 5 22 1 The Function Delete Description Use this Function to reset the flag that governs the blinking of the Button Attributes Attribute Contents Name Delete Condition Deflagration blinking Messagebox Instructions Instruction Arguments Contents The Instruction Call Function Reset events The Instruction Call Function Blink Buttons 07 2010 OScAR Pro Customized Operator User Manual 6 49 The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 22 2 The Function Set Description Use this Function to set the flag that governs the blinking of the Button Attributes Attribute Contents Name Set Condition Deflagration blinking Messagebox Instructions Instruction Arguments Contents The Instruction Call Function Reset events The Instruction SetVari Variable Deflagration blinking able Value 1 The Instruction SetVari Variable Selected message able Value Deflagration The Instruction SetVari Variable Selected event able Value Deflagration name The Instruction Call Function Blink Butt
149. ee Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 131 5 160 The arguments of the Instruction SetFrameColor 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 64 The Instruction SetListBoxBackColor Description Use this Function Instruction to change the background color of a Listbox Arguments Arguments Description Listbox Editable combobox to specify the Listoox whose background color you want to edit Here you can e enter the name of the Listbox direct or e select a Listbox from the list of all available Listboxes Color Editable combobox to define the background color you want to assign to the Listbox Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 132 The arguments of the Instruction SetListBoxBackColor 07 2010 OScAR Pro Customized Operator User Manual 5 161 The Elements of a DCO Script Instructions 5 11 65 The Instruction SetListBoxBlinkTime Description Use this Function Instruction to edit the interv
150. ee eee 5 9 Attributes of Constants 3 3 65 25400 ba eee eas Re dees eas Bas 5 11 Add a new Constant ics Fea talus Selig Pte ewe Eru et aoa en aa 5 12 Edit the attributes of a Constant 00 000 eee ee 5 12 Add a new Parameter group 00 00 eee eee eee 5 14 Attributes of Parameters 0 0 0 0 0000 eee ee 5 15 PAC MOV Paramete tert bts hoon ear kona Lea ata ei aaah We time AA 5 16 Edit the attributes of Parameters 0 0 00 cee eee 5 16 Attributes of VanableSies oso sak erechcd Soke end 46 G eee ow SOA ee 5 17 Add a new Variable naannanaa lace oe aed oe ards ee ee aes 5 18 Edit the attributes of a Variable 0 0 0 0 0 0 eee 5 18 Attributes of Data lists 2 0 5 20 The child nodes of the node Data lists 000 00 5 20 Attributes of data elements ivies b sad ke hae hd Waele se BERG We ee 5 21 Add a new new Data list aaua area oo 8 ode ake eee oo 5 22 Edit Data list attribUlES ss acc wre te twee eed eae be EGS ee eS 5 22 Add new data element osha a ence ee Saas be esd haa eke eae bes 5 23 Edit the attributes of data elements 0 000000 cease 5 23 The attributes OF Filters ib sn eds hand ose bt ote bbe a bone he a AO ee Bw 5 24 The child nodes of the node Filters 0 0 0 0 000 cece eee 5 25 The attributes of ID ranges ak ces ee ke ie eR BR ee 5 25 Attributes of Excluded IDs 0 0 0 0 0 0c es 5 26 The attributes of Excluded IDS
151. efer to Section 4 2 3 Descrip tion of the menu commands and the buttons of the OScAR Pro Customized Operator If a menu command entails further user dialogs it has 3 dots after the name e g New Certain menu commands can also be reached via keyboard shortcuts e g Ctrl N to create a new project 4 2 2 The toolbar Use the buttons of the toolbar to activate the functions of the OScAR Pro Customized Operator directly with a mouse click The buttons represent functions that can also be reached with the corresponding menu items Section 4 2 3 Description of the menu commands and the buttons of the OScAR Pro Customized Operator 07 2010 4 4 OScAR Pro Customized Operator User Manual Operating Instructions for the OScAR Pro Customized Operator Layout of the interface of the OScAR Pro Customized Operator 4 2 3 Description of the menu commands and the buttons of the OScAR Pro Customized Operator The below table itemizes and explains the menu commands of the OScAR Pro Customized Op eratorwith the equivalent keyboard shortcuts and button symbols The table is divided into e generic entries i e entries that apply to each of the 3 child windows e special entries that only appear in the Structure window e special entries that only appear in the Layout window and e special entries that only appear in the Preview window Menu item Description Generic entries The pull
152. ej to save the project Table 6 8 Insert Event Buttons Create Area Buttons Follow the below instructions to insert Area Buttons through the Layout window No Task References 1 Goto the tree view of the Structure Window and open the node Frames 2 Now open the node Main page under the parent node Frames still in the tree view of the Structure window 3 Insert a Button with the following attribute values 5 8 5 Add a new Control through e Name Management the Layout window e Left 80 e Top 875 5 8 6 Edit the attributes of a Con e Width 200 trol e Height 60 e Background color 008000 e Text Management e Font Microsoft Sans Serif e Font style bold 4 6 4 Edit fonts e Size 12 e Image file RING_FILES GIF 4 6 2 Administration of the Image lists Table 6 9 Insert Area Buttons 07 2010 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create Frames and Controls No Task References 4 Add another Button with the following attribute val ues e Name AdminTechnics e Left 160 e Top 630 e Width 200 e Height 60 e Background color 6300C6 e Text Admin amp amp Technics e Font Microsoft Sans Serif e Font style bold e Size 12 e Image file TECHNICS GIF 5 Add another Button with the following attribute val ues e Name Production 1 e Left 160 e Top 310 e Width 200 e Height 60 e Bac
153. ement direct or e select a Static element from the list of all Static elements that are available Position Drop down list to select the position for the image in the But ton s Static element Here you can e choose from left top h center top right top left center h center v center right center left bottom h center bottom and right bottom to find the best position for the text of the Static element of the Button e assign a Constant Parameter or Variable of the data type string or e assign the reference to a Control that has the data type string Table 5 106 The arguments of the Instruction SetButtonStaticTextPosition 07 2010 OScAR Pro Customized Operator User Manual 5 133 The Elements of a DCO Script Instructions 5 11 39 The Instruction SetButtonStatus Description Use this Function Instruction to edit the way in which a Button is output and used Arguments Arguments Description Button Editable combobox to choose the Button you want to edit with regard to the way in which it is output and used Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Status Editable combobox to define the way in which the Button is output and used Here you can e choose 0 to hide the Button e choose 1 to show the Button and enable entries e choose 2 to output the Button but block all entries e assign a Constant P
154. er via the OScAR Pro TT Server application Every OScAR Pro process triggered by a DCO Script for example a broadcast is automatical ly output in the OScAR Pro TT Operator Tool The DCO Script can query at any time the events and results of a process and output both ac cordingly in the DCO interface 07 2010 2 6 OScAR Pro Customized Operator User Manual Installation 3 Installation Overview This chapter shows you how to install and uninstall the OScAR Pro Customized Operator Contents The chapter covers the following areas 3 1 How to install the OpenScape Alarm Response Professional 3 2 Uninstall the OpenScape Alarm Response Professional 07 2010 OScAR Pro Customized Operator User Manual 3 1 Installation How to install the OpenScape Alarm Response Professional 3 1 How to install the OpenScape Alarm Response Professional The entire OpenScape Alarm Response Professional can be installed in a single process rights to install OScAR Pro Cus tomized Operator DCO Please bear in mind that under Windows 2000 XP you must have the administrative To install the software on your computer the following requirements must be fulfilled Microsoft Windows 2000 Professional or Windows XP if necessary also Windows 2003 Server must be installed on your PC You need to be familiar with the Windows operating system and you must know how to install software OScAR Pro Release 7 or OScAR Pro V3 R2 respectively
155. ers are dialed e enter 1 to choose that subscribers are dialed e use the selection field to assign a Constant Parameter or Variable of the data type bool or e assign the reference to a Control that has the data type bool Additional attributes of the OScAR Pro command ITL Info telephone ID Editable combobox to enter the ID of the info telephone profile that shall be activated Here you can e enter a valid ID with up to 4 digits e use the selection field to assign a Constant Parameter or Variable of the data type itl_id or e assign the reference to a Control that has the data type itl_id Table 5 41 Attributes and 5 46 child nodes of the node OScAR Pro command templates 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Frames Attribute Description Additional attributes of the OScAR Pro command SCN Scenario ID Editable combobox to enter the ID of the scenario that shall be activated Here you can e enter a valid ID with up to 4 digits e use the selection field to assign a Constant Parameter or Variable of the data type scn_id or e assign the reference to a Control that has the data type scn_id Additional attributes of the OScAR Pro command CALLWHI WHI number Editable combobox to enter the telephone number that shall be dialed Here you can e enter a call number with up to 24 digits e use the selection field to assign a Co
156. ers space character comma 0 1 2 3 4 5 6 7 8 9 float Floating point Data type for very precise rational values number between 1407 3 4 e 38 bdc_id Broadcast ID Valid ID of a broadcast administrated in the DAKS TT Admin istrator Tool con_id Conference ID Valid ID of a conference administrated in the DAKS TT Ad ministrator Tool cas_id Call profile ID Valid ID of a call profile administrated in the DAKS TT Admin istrator Tool Table 5 2 Summary of the different data types 07 2010 OScAR Pro Customized Operator User Manual 5 7 The Elements of a DCO Script The DCO data types and their value ranges Datatype Value range Description ann_id Announcement _ Valid ID of an announcement administrated in the DAKS TT ID Administrator Tool dsp_txt Display text max Text message for output on the display of a telephone hand 64 characters set color 000000 Data type to identify color values in hexadecimal convention FFFFFF The format is lt rea gt lt green gt lt blue gt Each of the 3 color components may range between 00 ff Examples e 000000 black e FF0000 light red e 00FF00 light green e 0000FF deep blue e FFFFFF white process Process ID ID of one active process in the OScAR Pro TT Operator Tool i e only in the OScAR Pro server itemlist DCO data types _ List comprising the data types described in this table It is these lists that are used to fi
157. ersion 6 12 and ff Pull down menu DCO Loading DCO Script Opens a window to select an existing DCO Script dco file Ctrl L Open DCO Parameter Opens a window to edit the parameters of the DCO Script that is cur Editor rently loaded Load DCO at program Defines if the current DCO Script is started automatically at the start start of the OScAR Pro TT Operator Tool box ticked or not box not ticked Show DCO as toolbar Defines if the current DCO Window is output in a toolbar box ticked or not box not ticked Pull down menu Window Standard view Moves the DCO Window to the background and brings the standard re Admin window of the OScAR Pro TT Operator Tool to the top Other entries See OScAR Pro TT User Manual Version 6 12 and ff Pull down menu All entries See OScAR Pro TT User Manual Version 6 12 and ff Table 7 2 Summary of the menu items and buttons of the DCO Window 07 2010 OScAR Pro Customized Operator User Manual 7 5 The DCO in the OScAR Pro TT Operator Tool Operation of the DCO Window Note In either of the above mentioned output versions you can access the pull down menu DCO easily by making a right mouse click in the empty area of the DCO Win dow Please bear in mind that the menu commands in this pull down menu are only en abled for users who have full administrative right to Set up OScAR Pro Custom Op erator 07 2010 7 6
158. etStaticTextPosition Description Use this Function Instruction to change the positioning of the text of a Static element Arguments Arguments Description Static element Editable combobox to choose the Static element whose text you want to reposition Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Position Drop down list to select the position for the text that shall ap pear on the Static element Here you can e choose from left top h center top right top left center h center v center right center left bottom h center bottom and right bottom to find the best position for the text of the Static element e assign a Constant Parameter or Variable of the data type string or e assign the reference to a Control that has the data type string Table 5 151 The arguments of the Instruction SetStaticTextPosition 07 2010 5 180 OScAR Pro Customized Operator User Manual 5 11 84 Description The Elements of a DCO Script Instructions The Instruction SetVariable Use this Function Instruction to save a value in a Variable Please bear in mind that the entry assigned here in the argument Value must have the same data type as the Variable itself see Section 5 2 The DCO data types and their value rang es Arguments Arguments Description
159. ew and doubleclick the relevant item listed in the column Value Table 5 31 Edit the attributes of Included IDs OF ge G8 Ia ee 07 2010 5 30 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Lists 5 7 13 Add an Excluded ID Follow the below instructions to add Excluded IDs to an existing filter No Task Go to the tree view of the Structure window and open the node Filters Still in the tree open the filter to which you want to add an Excluded ID Click the child node Excluded IDs Now go to the menu bar and select Edit gt New The DCO Designer outputs the new Excluded ID in the list view on the left 5 To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value Table 5 32 Add excluded IDs E Go a 5 7 14 Edit the attributes of an Excluded ID Follow the below instructions to edit the attributes of the excluded IDs of an existing Filter No Task Go to the tree structure and open the node Lists Now open the child node Filters in the tree Next open the filter whose Included IDs you want to edit Click the child node Excluded IDs To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value Table 5 33 Edit the attributes of an Excluded ID a e N 07 2010 OScAR Pro Customize
160. ext 5 11 82 The Instruction SetStaticTextColor 5 11 83 The Instruction SetStaticTextPosition 5 11 84 The Instruction SetVariable 5 11 85 The Instruction StartProgram 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script General structure 5 1 General structure As mentioned above in Section 4 3 Setup and application of the Structure window the DCO Script is output in the Structure Window in a hierarchical structure The below image illustrates the Structure window and its entries that are explained in full detail in this chapter Structure EXP Chemical Industries Inc dco EXP Chemical Industries Inc J Constants Constants 3 AnnFromID Parameters BlinkColor Variables DefaultColor D Lists Parameters B Announcement IDs J Frames a Fire alert E variables fa Selected announcement amp Lists Data lists E All announcements Data elements Filters AnnouncementList ID ranges Excluded IDs Included IDs E Frames m Main page 3 Controls lt Fire alert Functions Blink on UseFireAlert ansage 5 Static controls Symbol E Text KY Map of campus w Image i Caption 5 DAKS command templates amp Launch broadcast FE Broadcast IDs f Announcement IDs E Functions E On_Load EH User alleventsBlinkoff
161. f ID ranges 07 2010 OScAR Pro Customized Operator User Manual 5 25 The Elements of a DCO Script Lists Attribute Description to Editable combobox to specify the last ID up to which datasets are let pass by the Filter Here you can e enter a valid ID with up to 4 digits or e assign a Constant a Parameter or a Variable of the data type bdc_id con_id itl_id scn_id or msg_id Table 5 23 The attributes of ID ranges The attributes of Included IDs Included IDs have the following attributes Attribute Description Value Editable combobox to specify an ID that will be accepted by the Filter Here you can e enter a valid ID with up to 4 digits or e assign a Constant a Parameter or a Variable of the data type bdc_id con_id itl_id scn_id or msg_id Table 5 24 Attributes of Excluded IDs The attributes of excluded IDs Excluded IDs have the following attributes Attribute Description Value Editable combobox to specify an ID that shall be blocked by the Filter Here you can e enter a valid ID with up to 4 digits or e assign a Constant a Parameter or a Variable of the data type bdc_id con_id itl_id scn_id or msg_id Table 5 25 The attributes of Excluded IDs 07 2010 5 26 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Lists Example You may want to create a Filter with the name Announcement List In ID ranges you adde
162. f the Check box To edit the font font size or font style simply make a double click on this line to open the corresponding user window with the name Font see Section 4 6 4 Edit fonts Border style Drop down list to choose the style of the border surrounding the Checkbox Here you can e none if you do not want the Checkbox to have a border e simple if you want the Checkbox to be surrounded by a simple black line or e sunken if you want the Checkbox to have a two color border Text color Editable combobox to choose the color for the title of the Checkbox Here you can e enter acolor value e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors or e assign a Constant Parameter or Variable of the data type color The color assigned to a Checkbox title can be changed during the execution of the DCO Script with the command The In struction SetCheckBoxTextColor Table 5 60 Special attributes of Checkboxes 07 2010 OScAR Pro Customized Operator User Manual 5 77 The Elements of a DCO Script Controls Attribute Description Text Editable combobox to define the title of the Checkbox Here you can e enter up to 256 characters as Checkbox title or e assign a Constant Parameter or Variable of the data type string The title of a Checkbox can be changed during the execution of the DCO Script with the command The Instruction Set
163. f the Data list Here you can e enter the name of the Combobox direct or e select a Combobox from the list of all available Combob oxes Listbox Editable combobox to specify the Data list whose data ele ments you want to add to the selected Combobox Here you can e enter the name of the Data list direct or e select a Data list from the list of all available Data lists Table 5 74 Arguments of the Instruction AddListtoComboBox 07 2010 5 102 OScAR Pro Customized Operator User Manual 5 11 7 Description The Elements of a DCO Script Instructions The Instruction Call Use this Instruction to carry out the Instructions of another Function Please note that this feature only applies to the Functions that are stored in the child node Us er of a Frame that is also the parent Frame of the Instruction you are currently editing Arguments Arguments Description Function Editable combobox to define the Function that shall be execut ed Here you can e enter the name of the Function direct or e select a Function from the list of all available Functions Table 5 75 The arguments of the Instruction Call 07 2010 OScAR Pro Customized Operator User Manual 5 103 The Elements of a DCO Script Instructions 5 11 8 Description The Instruction BroadcastMessage Use this instruction to broadcast a message to the own page or i a an associated page from normal page toolbar page or from toolbar page gt
164. f the program 07 2010 OScAR Pro Customized Operator User Manual Operating Instructions for the OScAR Pro Customized Operator Setup and application of the Structure window 4 3 Setup and application of the Structure window The Structure window constitutes the main work station of the OScAR Pro Customized Oper ator It is this window that outputs the entire content of the DCO Script in a hierarchical tree structure A Structure EXP Chemical Industries Inc dco E EXP Chemical Industries Inc E Constants Controls C parameters DAKS command templates 5 variables Functions os E Lists nterval 500 a Frames H 1 E m Announcement selection eight a Width 1280 HEMain page an Color HFFFFFF Name Main page Image 4 2 Image of the Structure window with example The Structure window is divided into two separate areas e the tree structure and e the list view 07 2010 OScAR Pro Customized Operator User Manual 4 13 Operating Instructions for the OScAR Pro Customized Operator Setup and application of the Structure window 4 3 1 The tree structure of the Structure window The tree structure is located underneath the root with the project name and has the below five nodes e Constants seeSection 5 4 Constants e Parameters see Section 5 5 Parameters e Variables see Section 5 6 Variables e Lists See Section 5 7 Lists e Frames see Section 5 8 Fra
165. file start GIF 4 6 2 Administration of the Image lists 4 Next click Ey to switch to the Layout window and ver ify the result 5 Finally click ej to save the project Table 6 10 Insert Invoke Buttons 07 2010 OScAR Pro Customized Operator User Manual 6 23 The planning and implementation of a DCO Project Create Frames and Controls 6 3 6 Add Controls to the Frame Announcement selection In the next step you need to add the Controls to the dialog Frame Announcement selection and assign texts and images to them Follow the below instructions to add the Controls through the Layout window No Task References 1 Goto the tree view of the Structure Window and open the node Frames 2 Goto the tree view of the Structure Window and open the Frame Announcement selection 3 Select the node Controls in the tree view 4 Nowcreate a new Static element with the following 5 8 5 Add a new Control through attribute values the Layout window e Name Dialog title e Lett 200 5 8 6 Edit the attributes of a Con e Top 70 trol e Width 450 e Height 25 e Text Please select announce ment e Text color 0000FF e Position left v center 4 6 4 Edit fonts e Font Microsoft Sans Serif e Font style bold e Size 14 5 Now create a Listbox with following attribute values 5 8 5 Add a new Control through e Name Announcement list the Layout window e Lett 200
166. fo field to indicate that the Button Leakage is cur ing rently blinking Selected mes msg_id 1 Info field for the event that is currently selected sage Selected bdc_id 1 User window for the broadcast that currently needs broadcast to attended Selected event string No Info field for the currently selected event text of the event Static element Event name More blinking bool 0 Info field to indicate that the Button More is current ly blinking Deflagration bool 0 Info field to indicate that the Button Deflagration is blinking currently blinking Management bool 0 Info field to indicate that the Button Management is blinking currently blinking Table 6 14 Create Variables 07 2010 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the global objects 6 4 4 Create the Lists To fill the list field Announcement list located under the Frames child node Announcement selection and there under Controls you need a corresponding data container in form of a Data list This Data list is filled with the instruction The Instruction GetMessages and then copied to the list field with the instruction The Instruction SetListBoxList To restrict the value range of the administrated announcements you also require a matching Filter Create the Data list Create the following Data list see Section 5 7 2 Add a new Data list Name Data
167. following attributes Attribute Description Name Edit field to enter the name of the Constant Select aname that is recognizable and unique among the other Constants and Parameters Type The selection field to enter the Constant type see Section 5 2 The DCO data types and their value ranges Value Edit field to enter the initial value of the Constant in keeping with the pertinent Constant type Table 5 4 Attributes of Constants 07 2010 OScAR Pro Customized Operator User Manual 5 11 The Elements of a DCO Script Constants 5 4 2 Add a new Constant Follow the below instructions to create a new Constant No Task Select the node Constants in the tree structure 2 Now go to the menu bar and select Edit gt New This will open the following user window to add the new Control xi Please name entry i q Name ButtonColor i K Cancel 3 Enter a unique name for the new Constant 4 Finally click Ok to close the window The DCO Designer outputs the new Constant in the tree structure of the Structure win dow and there in the node Constants If necessary you can now edit the attributes of the new Constant Table 5 5 Add a new Constant 5 4 3 Edit the attributes of a Constant Follow the below instructions to edit the attributes of an existing Constant No Task Go to the tree structure on the right and open the node Constants Se
168. font No Task Start the DCO Designer 2 in the tree of the Structure window open the attributes of the relevant Control and dou bleclick Font in the list view This will open the window Font 3 Select the font font style and the size you want to use see below 4 Click OK to save your changes Table 4 8 Add new font 07 2010 OScAR Pro Customized Operator User Manual 4 29 Operating Instructions for the OScAR Pro Customized Operator General user dialog windows Summary of the fields in the window Font Input field Description TO I 2 xi Font Font style i fT ahoma Bod Terminal O Times New Roman O Trebuchet MS Sample AaBbYy2z Font Edit field to enter the font you want to use Underneath this field you will find a list with all fonts that are available to you Font style Edit field to enter the font style you want to use Underneath this field you will find a list with all font styles that are available to you Size Edit field to enter the font size you want to use Underneath this field you will find a list with all font sizes that are available to you Summary of the fields in the window Font Note Each time you close this window with OK the system will save your changes and use the settings as a template for new Controls 07 2010 4 30 OScAR Pro Customized Operator User Manual Operating Instruc
169. gn the image with the size of the Static element in keeping with the Static element s height width proportion or e select unproportional to align the image with the full scale of the Static element s surface irrespective of the height width proportion The position of the image assigned to a Static element can be changed during the execution of the DCO Script for e a Static element with the command he Instruction SetStaticPictureScale e Static elements placed on a Button with the command The Instruction SetButtonStaticPictureScale Table 5 51 Attributes of the child node Image of a Static element 07 2010 OScAR Pro Customized Operator User Manual 5 65 The Elements of a DCO Script Controls Attributes of the child node Caption of a Static element The captions of Static elements have the following attributes Attribute Description Text Edit field to enter the text to appear on the Static element The text entered for a Static element can be changed during the execution of the DCO Script with the command The In struction SetStaticText Text color Editable combobox to choose the color for the text of the Static element Here you can e enter a color value e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors or e assign a Constant Parameter or Variable of the data type color The color of the text of a Static element can be
170. gn to the selected Static element Here you can e enter a string e assign a Constant Parameter or Variable of the data type string e assign the reference to a Control that has the data type string Table 5 149 The arguments of the Instruction SetStaticText 07 2010 5 178 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 82 The Instruction SetStaticTextColor Description Use this Function Instruction to change the color of the text of a Static element Arguments Arguments Description Static element Editable combobox to specify the Static element whose text color you want to edit Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Color Editable combobox to define the text color you want to assign to the selected Static element Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 150 The arguments of the Instruction SetStaticTextColor 07 2010 OScAR Pro Customized Operator User Manual 5 179 The Elements of a DCO Script Instructions 5 11 83 The Instruction S
171. h the command The Instruction SetListBoxBlinkTime Special attributes of the type process TAN Combobox to define the relation between several Listboxes of the type process Here you can e 1 to retain all existing entries or e areference to a Listbox that has the type process If you enter a reference to a Listbox the TAN will refer to the entry selected for that Listbox It is this entry that will generally be applied when querying subordinate process information e g the subscribers of a broadcast marked in another Listbox Process colors The field indicating the selected process color In this line make a doubleclick under the column Value to open the user window in which you can define the individual process colors see Section 4 6 3 Process colors and Stan dard colors for process lists If no individual process colors are defined for the Listbox the regular standard colors will be used Table 5 61 Special attributes of Listbox 5 80 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls The child nodes of Listboxes Depending on the selected type Listboxes have the following child nodes Child node Description For the type process Process filters This node serves to administrate the Process filters Each Fil ter that is created is listed as a new child node The purpose of Process filters is to control or res
172. he blinking of which you want to end Here you can e enter the index of the List element e select a Listbox from the list of all available Listboxes e assign a Constant Parameter or Variable of the data type int or e assign a reference to a Control that has the data type int Table 5 91 The arguments of the Instruction OffListBoxltemBlink 07 2010 OScAR Pro Customized Operator User Manual 5 117 The Elements of a DCO Script Instructions 5 11 24 The Instruction SetButtonBlink Description Use this Function Instruction to turn ON the blinking of a Button Arguments Arguments Description Button Editable combobox to define the Button you want to blink Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons 1 Blink color Editable combobox to define the primary blink color Here you can e enteracolor value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or 2 Blink color Editable combobox to enter the secondary blink color Here you can e enteracolor value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose
173. he i is used to indicate useful information 07 2010 OScAR Pro Customized Operator User Manual 1 3 Conventions and Operating Instructions Privacy and data security 1 3 Privacy and data security The system described in this manual may draw on and process both personal and corporate data In the Federal Republic of Germany the processing and use of personal and corporate data is subject to a number of federal laws and regulations such as the Federal Data Protection Act Bundesdatenschutzgesetzes short BDSG Please be careful to follow the laws and regula tions for personal data protection that are currently in force in the country you work in The purpose of data protection is to protect the individual against any infringement of his per sonal rights through the misuse of personal data In addition data privacy protection has the aim to protect the data itself from being misused during the different phases of processing and thereby ward off any infringement of external or internal interests in need of protection Please help protect data privacy and data security by being aware of these issues as you work e Make sure that only authorized persons have access to personal data e Make consistent use of every opportunity to assign passwords and do not grant unauthor ized persons access to passwords e g by writing them down e Make sure that no unauthorized persons can manipulate e g save modify communicate block
174. he Pro duction 1 area 1300 Production 2 Broadcast group to alert all called subscribers in the Pro duction 2 area 6 1 4 How to implement the case study The implementation of the case study is divided into the following logical segments in the first step you will need to design the user interface see Section 6 3 Create Frames and Con trols after that you will add in several steps the functional contents to the script see Section 6 4 Create the global objects to Section 6 6 Create the Functions of the Frame Announce ment selection The structure of the case study user interface In this case study the user interface is divided into 07 2010 The Main Page used for the creation of the various visual and info elements and for several Event Buttons that enable the operator to select the best suitable an nouncements for the most important emergencies an Event display to output the currently selected announcement to the operator an Area Button for each area that make it possible for the operator to select the area s that need s to be alerted plus an Invoke Button that is only enabled if at least one announcement and a minimum of one area have been are selected and that is used by the operator to activate broadcasts The Frame child node Announcement selection has the form of a user dialog and can be opened with the Event Button More It is used to create aListbox to select additio
175. he Static elements of a Button The Instruction SetButtonStat icTextColor Changes the color of the text of one of the Static elements of a Button The Instruction SetButtonStat icTextPosition Changes the positioning of the text of one of the Static ele ments of a Button The Instruction SetButtonSta tus Changes the output and editing The Instruction SetButtonText Changes the caption The Instruction SetButtonText Color Changes the color of the caption Instructions for Checkboxes The Instruction SetCheckBox BackColor Changes the background color The Instruction SetCheckBox Caption Changes the caption The Instruction SetCheck BoxRect Changes the position and size The Instruction SetCheckBox State Changes the state Table 5 70 5 96 Overview of Instructions 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions Instruction Description The Instruction SetCheckBox Status Changes the output and editing The Instruction SetCheckBox TextColor Changes the color of the caption The Instruction SetCheckBox ToVariable Sets a Variable to the state Instructions for Listboxes The Instruction GetListBoxSel Text Sets a Variable to the first selected text The Instruction OffAllListBox ItemBlink Turns off the blinking for
176. he Structure window 5 37 Add a new Control through the Layout window 5 38 Edit the attributes of a Control 1 2 eee 5 39 Attributes and child nodes of the node OScAR Pro command templates 5 40 Add a new OScAR Pro command template 0000006 5 52 Edit the attributes of aOScAR Pro command template 5 53 Add anew Function toa Frame 2 0 ee 5 54 Edit the attributes of the Functions of aFrame 5 55 Application of the Controls xin ce hae poke ae Ge A ease es 8h 5 56 Reference declarations for ControlS 0 0 eee ee eee eee 5 58 Attributes shared by all Controls 000 000 e eee eee 5 59 Special attributes of Static elements 0 00 00 ce eee 5 62 The child nodes of Static elements 0 00 eee eee eee 5 63 Attributes of the child node Image of a Static element 5 63 Attributes of the child node Caption of a Static element 5 66 Special attributes of Edit fieldS 0 0 ccc eee eee 5 68 Special attributes of Buttons 0 0 eee 5 70 The child nodes of ButtonS 0 0 0 0 cc ee 5 72 Add a new Function to a Button 2 0 0 0 ee ee 5 73 Edit the attributes of the Functions of a Button 5 74 Add a new Function to a Button 1 2 0 0 0 ee ee 5 75 Edit the attributes of the Static elements of a Button 5 76
177. he Version dieser Seite eae oe xi co nfi rm with O K em Select the lanquage for this installation from the choices below 4 The installation is now initialized sstallShield Wizard DAKS Customized Operator Setup is preparing the InstallShield Wizard which wl guide you through the program setup process lease w Table 3 1 How to install the OScAR Pro Customized Operator 07 2010 OScAR Pro Customized Operator User Manual 3 3 Installation How to install the OpenScape Alarm Response Professional No Task Window Click on Next to make all installation set tings i DAKS Customized Operator InstallShield Wizard Welcome to the InstallShield Wizard for DAKS Customized Operator The InstallShield R Wizard will install DAKS Customized Operator on your computer To continue click Next WARNING This program is protected by copyright law and international treaties Enter the user name and the name of the or ganization or company Specify if you want the software to be in stalled for all users of this computer or only for you Now click Next ig DAKS Customized Operator InstallShield Wizard Customer Information Please enter your information User Name my name Organization my company Install this application For Anyone who uses this computer all users C Only for me my name Installshield l
178. he child node Functions Select the Function whose attributes you want to edit E Pe ee a Ese ee To edit the attributes of the Function go to the list view and doubleclick the relevant item listed in the column Value See Section 5 10 1 The attributes and child nodes of Func tions If needed edit the Instructions of the Function see Section 5 11 Instructions Table 5 57 Edit the attributes of the Functions of a Button 5 74 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls 5 9 9 Add Static elements to a Button Follow the below instructions to add Static elements to a Button No Task Go to the tree structure and open the node Frames Open the parent Frame of the Button to which you want to add a new Static element Now open the child node Controls Open the Button to which you want to add a new Static element Click the child node Static elements Now go to the menu bar and select Edit gt New This will open the below user window to add the new process Filter E Create entry Please name entry f Name Fire icon 2 lt Cancel Dnj e N gt 7 Assign a unique and recognizable name to the new Static element 8 Finally click Ok to close the window The DCO Designer outputs the new Static element in the tree view of the Structure win dow and there in the child node Sta
179. he field ID was enabled Arguments Arguments Description Data list Editable combobox to specify the Data list to which you want to add the obtained scenario details Here you can e enter the name of the Data list direct or e select a Data list from the list of all available Data lists of the data type scn_id Filter Editable combobox to define the Filter that is used to limit the received scenarios Here you can e enter the name of the Filter direct or e select a Filter of the type SCN from the list of all available Filters Table 5 85 The arguments of the Instruction GetScenarios Note To output the List of all scenarios received with this command place a List or Combobox in the Frame and fill either or both with the command The Instruction SetListBoxList and the afore mentioned Data list 07 2010 OScAR Pro Customized Operator User Manual 5 113 The Elements of a DCO Script Instructions 5 11 18 The Instruction GotoFrame Description This command opens a new Frame Note Whenever a new Frame is opened with this Instruction the current Frame with the present output is automatically cleared If you want to save the different states of these Controls or other elements please save them in Variables before you open the new Frame see Section 5 11 2 Overview of Instructions Arguments Arguments Description Frame Editable combobox to defi
180. he parent node Main Page open the node Controls 4 Now add a new Static element with the following at 5 8 4 Add a new Control through tribute values the Structure window e Name Plant map e Lett 0 e Top 0 e Width 1280 e Height 1024 5 Next go back to the tree view and select Image 6 in the list view of the Structure window open the ed itable combobox of the attribute File name and click Select image 7 In the window Project images list click the file 4 6 2 Administration of the Image MAP JPG to add the image to the image list of your lists project and then close the dialog with Ok 8 In the list view of the Structure window change the value of the attribute Position to left bottom 9 Finally click yj to save the project 10 Next click E to switch to the Layout window and ver ify the result Table 6 5 Add a background image to the Main page 07 2010 6 14 OScAR Pro Customized Operator User Manual 6 3 3 The planning and implementation of a DCO Project Create Frames and Controls Add visual separators to the Main page We recommend you use the areas above and on the right hand side of the plant map for But tons For this reason the areas are visually separated from the rest of the page with separator lines Follow the below instructions to add a separator line through the Structure window OScAR Pro C
181. he tree open the filter that contains the Excluded ID you want to edit In the tree structure select the next child node ID ranges To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value Table 5 29 Edit the attributes of ID ranges Oh Reco feos 07 2010 OScAR Pro Customized Operator User Manual 5 29 The Elements of a DCO Script Lists 5 7 11 Add an Included ID Follow the below instructions to add an Included ID in an existing Filter No Task Go to the tree structure and open the node Lists Now open the child node Filters in the tree Still in the tree open the Filter to which you want to add an Included ID Click the entry Included IDs Now go to the menu bar and select Edit gt New The DCO Designer outputs the new Included ID in the list view on the left 6 To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value Table 5 30 Add an Included ID NN ae 5 7 12 Edit the attributes of an Included ID Follow the below instructions to edit the attributes of the included IDs of an existing Filter No Task Go to the tree structure and open the node Lists Now open the child node Filters in the tree Next open the filter whose Included IDs you want to edit Click the entry Included IDs To edit the attributes go to the list vi
182. iable of the data type bool or e assign the reference to a Control that has the data type bool High priority broadcast Combobox to specify for hunt groups if the broadcast shall be given a high priority or with a low priority when activated Here you can e select 0 for a low priority broadcast e select 1 for a high priority broadcast e assign a Constant Parameter or Variable of the data type bool or e assign the reference to a Control that has the data type bool Table 5 41 Attributes and child nodes of the node OScAR Pro command templates 07 2010 OScAR Pro Customized Operator User Manual 5 43 The Elements of a DCO Script Frames Attribute Description Message text for TTV Input field to enter the text of the message you want the system to convert via speech synthesis TTV Text To Voice into an ad hoc announcement and play in the broadcast Here you can e assign a Constant Parameter or Variable of the data type string e assign the reference to a Control that has the data type string OnMin Editable combobox to enter the first value where you want the serial number range of reference to begin Here you can e enter a number between 0 and 255 e assign a Constant Parameter or Variable of the data type byte or e assign the reference to a Control that has the data type byte OnMax Editable combobox to enter the final value where you want the serial number range of
183. ibute values except for e Name Deflagration e Left 310 e Text Deflagration e Image file EXPLOSION GIF 10 Repeat the steps 3 through 8 for the Button Leak age and use the same attribute values except for e Name Leakage e Left 490 e Text Leakage e Image file ACID GIF 11 Repeat the steps 3 through 8 for the Button Short Circuit and use the same attribute values except for e Name Short circuit e Left 660 e Text Short circuit e Image file ELECTRIC GIF 12 Repeat the steps 3 through 8 for the Button More and use the same attribute values except for e Name More e Left 920 e Text More e Image file DANGER GIF 13 Now clickElJ to switch to the Layout window 14 Select the tool make a left mouse click into the 4 4 2 Mark a Frame area ora area above the Static element Events keep the Control mouse key pressed and draw a border Frame around all Event Buttons The Buttons are now marked Table 6 8 Insert Event Buttons 07 2010 6 20 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create Frames and Controls No Task References 15 Use the menu item Lay out gt Space even ly gt Across to distribute all Controls evenly along the upper border of the page 4 4 5 Align and space elements automatically 16 Next click EJ to switch to the Layout window and ver ify the result 17 Finally click
184. ic element can edited during the execution of the DCO Script with the command The Instruction SetStaticTextPosition Font Field indicating the font currently used for the text of the Static element To edit the font font size or font style simply make a double click on this line to open the corresponding user window with the name Font see Section 4 6 4 Edit fonts Table 5 52 07 2010 Attributes of the child node Caption of a Static element OScAR Pro Customized Operator User Manual 5 67 The Elements of a DCO Script Controls 5 9 5 Special attributes of Edit fields Edit fields have the following additional attributes Attribute Description Font Field indicating the font currently selected for the text of the Edit field To edit the font font size or font style simply make a double click on this line to open the corresponding user window with the name Font see Section 4 6 4 Edit fonts Border style Combobox to choose the style of the border surrounding the Edit field Here you can e none if you do not want the Edit field to have a border e simple if you want the Edit field to be surrounded by a simple black line or e sunken if you want the Edit field to have a two color bor der Text color Editable combobox to choose the color for the text of the Edit field Here you can e enter a color value e Click Select color and use the next user window to choose
185. ing Messagebox Instructions Instruction Arguments Contents The Instruction Call Function Reset events The Instruction SetVari Variable Leakage blinking able Value 1 The Instruction SetVari Variable Selected message able Value P Leakage The Instruction SetVari Variable Selected event able Value Leakage name The Instruction Call Function Blink Buttons Note Here the Variable Selected message is filled directly with the parameter Leak age If for any reason the ID of the Deflagration announcement changes in OS cAR Pro the value of the Parameter must be easily adjusted accordingly in the Pa rameter editor see Section 7 4 The DCO Parameter Editor of the OScAR Pro TT Operator Tool 07 2010 6 52 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 24 The Functions of the Button Short circuit The Functions underneath the Button Short circuit are automatically invoked when this Button is pressed 6 5 24 1 The Function Delete Description Use this Function to reset the flag that governs the blinking of the Button Attributes Attribute Contents Name Delete Condition Short circuit blinking Messagebox Instructions Instruction Arguments Contents The Instruction Call Function Reset eve
186. ing or e assign the reference to a Control that has the data type string Table 5 94 The arguments of the Instruction SetButtonPicture 07 2010 OScAR Pro Customized Operator User Manual 5 121 The Elements of a DCO Script Instructions 5 11 27 The Instruction SetButtonPictureScal Description Use this Function Instruction to edit the scaling of an image on a Button Arguments Arguments Description Button Editable combobox to define the Button for which you want to scale the image Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Scaling Editable combobox to define the scaling factor for the image on a Button Here you can e enter a scaling factor in e select proportional to align the image with the size of the Static element in keeping with the Static element s height width proportion e select unproportional to align the image with the full scale of the Static element s surface irrespective of the height width proportion or e assign a reference to a Control that has the data type float Table 5 95 The arguments of the Instruction SetButtonPictureScal 07 2010 5 122 OScAR Pro Customized Operator User Manual 5 11 28 Description The Elements of a DCO Script Instructions The Instruction SetButtonRect Use this Function Instruction to edit the position and size of a Button
187. inutes Status Installshield ext gt 10 Click Finish to complete the installation IE DAKS Customized Operator Tee InstallShield Wizard Completed After the installation is completed the pro gram symbol for the is listed in the Windows The InstallShield Wizard has successfully installed DAKS Customized Operator Click Finish to exit the wizard Program Manager and there under the pro gram group OpenScape Alarm Response Professionaltetronik OScAR Pro TT I Cancel Table 3 1 How to install the OScAR Pro Customized Operator 07 2010 OScAR Pro Customized Operator User Manual 3 5 Installation Uninstall the OpenScape Alarm Response Professional 3 2 Uninstall the OpenScape Alarm Response Professional No Task Window 1 Open the Windows Control Panel agp corte i Control Panel j KJ aac o Network Connections a a Printers and Faxes B Taskbar and Start Menu 2 Open Software Bee File Edit View Favorites Tools Help Ei Qa Y i JO search gt Folders E adess cow O O do amp B 40 i Accessibility Add Hardware A 0 Administrative Options oye Tools Y wy Automatic Date and Time Display Folder Options Updates z 3 Select the entry OpenScape Alarm Re sponse Professional and click Delete 4 Confirm your entry with Yes n x The uninstall process is started Are you sure you
188. ion SetListBoxToVariable Description Use this Function Instruction to save all selected List elements of a Listbox in a Data list Please note that to do so the Data list and the Listbox must have the same data type see Sec tion 5 2 The DCO data types and their value ranges Arguments Arguments Description Listbox Editable combobox to define the Listbox whose selected ele ments you want to save in a Data list Here you can e enter the name of the Listbox direct or e select a Listbox from the list of all available Listboxes Data list Editable combobox to specify the Data list in which you want to save the selected elements of the Listbox Here you can e enter the name of the Data list direct or e select a Data list from the list of all available Data lists Table 5 141 The arguments of the Instruction SetListBoxToVariable 07 2010 5 170 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 74 The Instruction SetStaticBackColor Description Use this Function Instruction to change the background color of a Static element Arguments Arguments Description Static element Editable combobox to specify the Static element whose back ground color you want to edit Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Color Editable combobox to choose the background c
189. ion 2 ground color No event string lt none gt Text for the Static element Event name if no event is currently selected M Blink color color FF6800 Blink color of the Button Management Deflagration msg_id 1001 ID of the announcement administrated in OScAR Pro for the event Deflagration Deflagration string 1001 Defla Text for the Static element Event name if the user name gration has selected the event Deflagration M Back color 804000 Background color of the Button Management ground color Table 6 12 Create Constants 07 2010 OScAR Pro Customized Operator User Manual 6 29 The planning and implementation of a DCO Project Create the global objects 6 4 2 Create the Parameters Now create the below listed Parameter groups see Section 5 5 1 Add a new Parameter group and Parameters see Section 5 5 3 Add a new Parameter Name Data type Value Description Parameter group Announcements Short circuit msg_id 1003 ID of the announcement administrated in OScAR Pro for the event Short circuit Short circuit string 1003 Short Text for the Static element Event name if the user name circuit has selected the event Short circuit Leakage msg_id 1002 ID of the announcement administrated in OScAR Pro for the event Leakage Leakage name __ string 1002 Leak Text for the Static element Event name if the user age has selected the event Leakage
190. ions indicated by the mouse cursor You can also blend several elements in size To do so mark at least two elements you want to blend in size Here the DCO Designer will usually focus on the first element that is marked Now go to the menu bar open Layout gt Make Same Size and choose the way in which you want to blend the marked elements Width Height or Both The elements are now blended in size in keeping with this selection and on the basis of the element that has the focus usually the one that was marked first 07 2010 4 20 OScAR Pro Customized Operator User Manual Operating Instructions for the OScAR Pro Customized Operator Setup and application of the Layout window 4 4 5 Align and space elements automatically The DCO Designer makes it possible to align elements easily with another elements To do so mark at least two objects go to the menu bar and open Layout gt Align and select the way in which you want to align the objects Top Left Right Bottom Horiz center Vert center The DCO Designer will align the marked objects with the elements that has the focus Just as easily you can also space elements evenly To do so mark at least three objects go to the menu bar and open Layout Space evenly and select the way in which you want to space the objects Across Down The DCO De signer will evenly space the marked elements e Across i e horizontally from side to side between the
191. it field whose text color you want to edit Here you can e enter the name of an Edit field direct or e select an Edit field from the list of all Edit fields that are available Color Editable combobox to choose a new text color for the selected Edit field Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 128 The arguments of the Instruction SetEditTextColor 07 2010 5 156 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 61 The Instruction SetEditTextColorBlink Description Use this Function Instruction to turn ON the blinking of the content text of an Edit field Arguments Arguments Description Edit field Editable combobox to specify the Edit field whose content you want to blink switch ON Here you can e enter the name of an Edit field direct or e select an Edit field from the list of all Edit fields that are available 1 Blink color Editable combobox to define the primary blink color Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to
192. itches the blinking to ON or OFF in keeping with the Button s matching Variable One Function to switch OFF the blinking of Event Buttons Three Functions to control the status enabled blocked of the Invoke Button The ob jective here is to ensure that this Button is not enabled unless one event and at least one area have been selected One Function that is invoked whenever the Main page is loaded and that switches the blinking of the Buttons to ON or OFF in keeping with their corresponding Variables Please note that while the system supports the simultaneous blinking of several Area Buttons can it only support the blinking of one Event Button at a time The Area and Event Buttons receive the below Functions They are automatically in voked whenever these Buttons are pressed One Function in case the Button is not yet blinking One Function in case the Button is already blinking The Event Button More is assigned a Function to jump to Announcement selection 07 2010 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project The case study project e Foreach individual area the Invoke Button is assigned a Function that depending on the blink state of the correlating Button starts the matching broadcast The Functions of the Frames child node Announcement selection The following elements must be implemented for the child node Announcement selection un der the node Frames
193. kbox you want to edit with regard to the way in which it is output and used Here you can e enter the name of the Checkbox direct or e select a Checkbox from the list of all Checkboxes that are available Status Editable combobox to specify the way in which the selected Checkbox is output and used Here you can e choose 0 to hide the Checkbox e choose 1 to show the Checkbox and enable entries e choose 2 to output the Checkbox but block all entries e assign a Constant Parameter or Variable of the data type uint or e assign the reference to a Control that has the data type uint Table 5 114 The arguments of the Instruction SetCheckBoxStatus 07 2010 OScAR Pro Customized Operator User Manual 5 141 The Elements of a DCO Script Instructions 5 11 47 The Instruction SetCheckBoxTextColor Description Use this Function Instruction to edit the color of the text of a Checkbox Arguments Arguments Description Checkbox Editable combobox to specify the Checkbox whose text color you want to edit Here you can e enter the name of the Checkbox direct or e select a Checkbox from the list of all Checkboxes that are available Color Editable combobox to choose the text color for the selected Checkbox Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a
194. kground color 804000 e Text Production 1 e Font Microsoft Sans Serif e Font style bold e Size 12 e Image file PRODUCTION_1 GIF 6 Add another Button with the following attribute val ues e Name Production 2 e Left 765 e Top 310 e Width 200 e Height 60 e Background color FF8040 e Text Production 2 e Font Microsoft Sans Serif e Font style bold e Size 12 e Image file PRODUCTION_2 GIF Table 6 9 Insert Area Buttons 07 2010 6 22 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create Frames and Controls No Task References 7 Next click EJ to switch to the Layout window and ver ify the result 8 Finally click ej to save the project Table 6 9 Insert Area Buttons Create an Invoke Button Follow the below instructions to create the Invoke Button through the Layout window No Task References 1 Goto the tree view of the Structure Window and open the node Frames 2 Now open the node Main page under the parent node Frames still in the tree view of the Structure window 3 Add a Button with the following attribute values 5 8 5 Add a new Control through e Name Invoke the Layout window e Left 1105 e Top 932 5 8 6 Edit the attributes of a Con e Width 150 trol e Height 60 e Status 2 disabled e Text Invoke e Font Microsoft Sans Serif e Font style bold 4 6 4 Edit fonts e Size 14 e Image
195. l Uninstall 3 1 Keyboard shortcuts 4 5 Layout window 4 3 4 16 List view 4 13 Menu Bar 4 4 Menu commands 4 5 Preview window 4 3 Start 4 2 Index Status bar 4 12 Structure window 4 3 4 13 4 15 5 5 Symbols 4 5 Toolbar 4 4 Tree structure 4 13 DCO Script 5 1 execute 7 2 File 4 3 Publish 7 2 Tasks 2 5 Declaration CHECKBOX 5 58 COMBOBOX 5 58 EDIT 5 58 LISTBOX 5 58 Disable Button 6 40 DIV 5 10 Division 5 10 E Edit color 4 31 Edit entries 4 15 Edit field 5 56 5 58 background color 5 60 border style 5 68 font 5 68 height 5 59 left 5 59 multiple lines 5 69 name 5 59 reference to Edit fields 5 58 status 5 61 text color 5 68 text 5 68 top 5 59 type 5 69 width 5 59 Edit font 4 29 Elements 5 9 E mail 5 182 Emergencies 2 2 Enable Button 6 40 EQL 5 10 Equal 5 10 Example Add a background image 6 14 Caption 6 16 color values 5 8 condition 5 92 conditions in Functions 5 92 Constants 5 11 Filter 5 27 messagebox 5 90 parameters 5 13 Separator line 6 15 Variable 5 17 Excluded IDs add an Excluded ID 5 31 edit Excluded ID attributes 5 31 value 5 26 Execute 5 93 5 106 Execute functions as snapshot 5 33 F FALSE 5 91 Filter name 5 24 subtype 5 24 type 5 24 Filters 2 5 5 19 5 107 5 108 5 110 5 112 5 113 add a new Filter 5 28 edit Filter attributes 5 28 example 5 27 excluded IDs 5 24 5 25 ID ranges 5 24 5 25 included IDs 5 24 5 25 Fomula 5 9 Frame 5 114 Frames 4 14 5 6 add anew Fra
196. l that has the data type float Table 5 101 The arguments of the Instruction SetButtonStaticPictureScale 07 2010 5 128 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 34 The Instruction SetButtonStaticRect Description Use this Function Instruction to edit the position and size of a Static element on a Button Arguments Arguments Description Button Editable combobox to define the Button whose Static element you want to edit in position and size Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Static element Editable combobox to enter the Static element of the selected Button the position and size of which you want to edit Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Links Editable combobox to define the left and upper top margin as Top well as the width and the height in pixels Here you can Width e enter a numeric value Height e assign a Constant Parameter or Variable of the data type int or e assign a reference to a Control that has the data type int Table 5 102 The arguments of the Instruction SetButtonStaticRect 07 2010 OScAR Pro Customized Operator User Manual 5 129 The Elements of a DCO Script Instructions 5 11 35 The Instruction SetButtonStaticS
197. le of a DCO output in the OScAR Pro TT Operator Tool 07 2010 OScAR Pro Customized Operator User Manual 2 3 Overview Interactions of the DCO components 2 3 Interactions of the DCO components The OScAR Pro Customized Operator DCO is based on the interaction of the following com ponents e OScAR Pro Customized Operator Editor used to create edit and validate DCO Scripts e DCO Scripts File with a corresponding directory and the figures that are needed to de scribe the customized interface e OScAR Pro TT Operator Tool Tool to output the customized interface and execute the OS cAR Pro commands used therein The below image illustrates graphically the interaction of the above components Pg a DCO Designer A DCO script mirrors customized user interfaces develops the layout in DAKS TT Operator Tool and triggers processes k gt fe 1 X 4 DCO scripts DAKS TT Server DAKS server database Image 2 2 Integration of the different DCO components in OScAR Pro Classic 07 2010 2 4 OScAR Pro Customized Operator User Manual Overview The tasks of the OScAR Pro Customized Operator 2 4 The tasks of the OScAR Pro Customized Operator The OScAR Pro Customized Operator is an editor based at the same time on text and structure as well as on graphics to create the so called DCO Scripts and to package the images that are used therein Users principally need no specific programming skills to be able to create a
198. lect the Constant that you want to edit To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value Table 5 6 Edit the attributes of a Constant 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Parameters 5 5 Parameters Just like the Constants Parameters are place holders based on the data types that are de scribed in the Section 5 2 The DCO data types and their value ranges Parameters can be used any number of times and at any place wanted in the project They can be edited easily through the Parameter editor of the OScAR Pro TT Operator Tool see Section 7 4 The DCO Parameter Editor When using the Parameters in the course of a DCO script their names are output in between Signs When the DCO script is loaded in the OScAR Pro TT Operator Tool the Parameters are initial ized with their corresponding values as found in the Parameter file If no entry is found for a Parameter in the matching Parameter file the Parameter is automatically initialized with its de fault value as assigned in the DCO script Parameters are divided into logical groups A Parameter is also always assigned to a specific Parameter group Example For example you can define an announcement ID as a Parameter and assign it to different In structions see Section 5 11 Instructions If the ID of the pertinent announcement is later changed through
199. ll either or both with the command The Instruction SetList BoxList and the aforementioned Data list 07 2010 5 110 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 15 The Instruction GetListBoxSelText Description This commands enables you to read out the text of the first selected element of a Listbox and save it in a Variable Arguments Arguments Description Listbox Editable combobox to specify the Listbox the first selected text of which you want be to read out Here you can e enter the name of the Listbox direct or e select a Listbox from the list of all available Listboxes Variable Editable combobox to define the Variable in which you want to save the first selected text of the Listbox Here you can e enter the name of the Variable direct or e select a Variable of the data type string from the list of all available Variables Table 5 83 The arguments of the Instruction GetListBoxSelText 07 2010 OScAR Pro Customized Operator User Manual 5 111 The Elements of a DCO Script Instructions 5 11 16 The Instruction GetMessages Description Use this Instruction to invoke a list of all DAKS TT Administrator Tool administrated announce ments and fill the Data list with the obtained entries Please note that the Data list is automati cally cleared before it is filled with the new entries In this process the system applies the specified Fil
200. ll the Controls Listbox and Combobox Table 5 2 Summary of the different data types 07 2010 5 8 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Formulas 5 3 Formulas Formulas can be used nearly everywhere e g to describe the values of attributes or in func tions see below Formulas are computing instructions that are used to carry out logic operations with integers or concatenated strings All Formulas applied in a DCO Script are output in and e Every Formula consists of a statement with a minimum of 2 elements and a logic operation that lies between these two elements For example if you take the strictly numeric statement 1 2 the integers 1 and 2 rep resent the elements whereas the sign represents the logic operation Logic operations can be mathematical signs or keywords You can also add further brackets to a Formula to add additional statements e g 1 2 28 Note In every Formula a space character must be entered in front of and after every state ment and in front of and after each logic operation The following rules apply e Every Parameter Variable or Control See below as well as every direct entry can be an element of a statement e All elements in a Formula must be of the same data type e g STRING e Do not use any Control names in the Control attributes see below e Every Formula is processed from left to right and in keeping with the
201. ls Here you can Width e enter a numeric value Height e assign a Constant Parameter or Variable of the data type int or e assign a reference to a Control that has the data type int Table 5 112 The arguments of the Instruction SetCheckBoxRect 07 2010 OScAR Pro Customized Operator User Manual 5 139 The Elements of a DCO Script Instructions 5 11 45 The Instruction SetCheckBoxState Description Use this Function Instruction to edit the state marked not marked of a Checkbox Arguments Arguments Description Checkbox Editable combobox to specify the Checkbox whose state you want to edit Here you can e enter the name of the Checkbox direct or e select a Checkbox from the list of all Checkboxes that are available State Combobox to define if the Checkbox is marked Here you can e choose 0 to remove the marking from the selected Check box e choose 1 to mark the selected Checkbox e assign a Constant Parameter or Variable of the data type bool or e assign the reference to a Control that has the data type bool Table 5 113 The arguments of SetCheckBoxState 07 2010 5 140 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 46 The Instruction SetCheckBoxStatus Description Use this Function Instruction to edit the way in which a Checkbox is output and used Arguments Arguments Description Checkbox Editable combobox to choose the Chec
202. me 5 36 add a new Function 5 54 color 5 32 Controls 5 32 5 35 DAKS command templates 5 32 5 35 edit Frame attributes 5 36 07 2010 OScAR Pro Customized Operator User Manual edit the attributes of a Function 5 55 Functions 5 32 5 35 height 5 33 interval 5 33 name 5 32 width 5 33 Functions 2 5 add a new Function to a Button 5 73 condition 5 89 edit attributes Frame 5 55 edit the attributes of a Button 5 74 Instructions 5 90 messagebox 5 90 name 5 89 New Frame 5 54 G GET 5 10 GetBroadcasts 5 19 5 93 5 107 GetComboBoxSelText 5 109 5 111 GetConferences 5 19 5 93 5 108 GetInfotelephones 5 19 5 93 5 110 GetMessages 5 19 5 93 5 112 GetScenarios 5 19 5 93 5 113 GotoFrame 5 94 5 114 Graphic files 7 2 Greater than 5 10 Greater than or equal to 5 10 GT 5 10 GUIBar 7 10 l ID ranges add a new ID range 5 29 edit ID range attributes 5 29 from 5 25 to 5 26 Image Text horizontal 5 70 vertical 5 70 Images 2 5 Add 4 25 Delete 4 25 Image list 4 24 Implementation 6 7 07 2010 OScAR Pro Customized Operator User Manual Index Included IDs add an Included ID 5 30 edit Included ID attributes 5 30 value 5 26 Input field 4 17 Installation 3 2 Installation CD 3 2 Installation path 3 4 Settings 3 4 Instructions 2 5 5 93 add a new Instruction 5 98 arguments 5 93 change sequence 5 101 edit 5 99 overview 5 93 Interface 4 3 6 7 Inverted commas 5 91 Invoke DAKS command template 6 45 ITL
203. me of the Button to which you want to add a new Function Now open the child node Controls Open the Button to which you want to add the new Function Click the child node Functions Now go to the menu bar and select Edit gt New This will open the below user window to add the new process Filter E Create entry Please name entry f Name Select fire alert announcement 2 lt Cancel Dnj AWI N gt 7 Assign a unique and recognizable name to the new Function 8 Finally click Ok to close the window The DCO Designer outputs the newly added Function under the child node Functions of the parent Button If necessary you can now edit the attributes of the Function see Section 5 10 1 The attributes and child nodes of Functions If needed edit the Instructions of the Function see Section 5 11 Instructions Table 5 56 Add a new Function to a Button 07 2010 OScAR Pro Customized Operator User Manual 5 73 The Elements of a DCO Script Controls 5 9 8 Edit the attributes of the Functions of a Button Follow the below instructions to edit the attributes of an existing Function on a Button No Task Go to the tree structure and open the node Frames Open the parent Frame of the Button whose Function you want to edit Now open the child node Controls Open the Button whose Function you want to edit Click t
204. ment Caption This node is used to administrate the attributes of the text for the Static element Table 5 50 The child nodes of Static elements Attributes of the child node Image of a Static element The images of Static elements have the following attributes Attribute Description File name Editable combobox to select the image assigned to a Static el ement Here you can e enter a file name from the List of images e select an image in the user window that opens as you click the entry Select image in the drop down list see Section 4 6 2 Administration of the Image lists or e assign a Constant Parameter or Variable of the data type string The image assigned to the Static element can be replaced du ring the execution of the DCO Script for e a Static element with the command The Instruction SetStaticPictureName e Static elements placed on a Button with the command The Instruction SetButtonStaticPictureName Table 5 51 Attributes of the child node Image of a Static element 07 2010 OScAR Pro Customized Operator User Manual 5 63 The Elements of a DCO Script Controls Attribute Description Position Drop down list to define the position of the image in the Static element Here you can e left top to place the image in the upper left corner of the Static element e h center top to place the image at the upper border of the Static element and there in horizontally
205. mes You can open the nodes and their child nodes by clicking and close them again by clicking amp In this way you can for example open the entry Frames for a direct overview of all created Frames When you select an entry in the tree structure its subentries are if available automat ically output in the list view For example when you select a specific Frame its corresponding entries such as Parameters OScAR Pro commands templates etc are automatically output in the list view 07 2010 4 14 OScAR Pro Customized Operator User Manual Operating Instructions for the OScAR Pro Customized Operator Setup and application of the Structure window 4 3 2 The list view of the Structure window As arule the details that are output in the list view always match the entry you select in the tree structure If for example you select Parameters in the tree structure the list view will output all parameters Change the sequence of the columns You can also easily change the column order to best meet the own requirements Follow the below instructions to change the column order No Task Make a left mouse key click the column header and keep it pressed 2 Move the column header to the new position The new position is indicated with a small arrow zz attribute value B 1 gt 000000 Rardar Ayla Old position New position 3 Release the mouse key The column is shifted
206. meter of a structure element for edit Alt Enter ing These are usually input or selection fields that are output directly in the list view w Undo Undoes the last action Use this command to renter an entry Alt Z that was deleted by mistake Ka Cut Cuts the marked entries and copies them to the Win dows Ctrl Xx Clipboard Use Paste to insert entries from the clipboard if x needed at another place in the project Copy Cuts the marked entries and copies them to the Win dows Ctrl C Clipboard Use Paste to insert entries from the clipboard at an other place in the project p proj Paste Pastes entries copied to the Windows clipboard to the posi Ctrl V tion of your project that was marked manually B Delete Deletes the selected element from the structure of the DCO Ctrl Del Script x Table 4 2 Summary of the menu items and buttons of the OScAR Pro Customized Op erator 07 2010 OScAR Pro Customized Operator User Manual 4 7 Operating Instructions for the OScAR Pro Customized Operator Layout of the interface of the OSCAR Pro Customized Operator Menu item Description Move up Ctrl Arrow up t Moves an entry up in the order of the list view Move down Ctrl Arrow down Moves an entry down in the order of the list view Table 4 2 erator Summary of the menu items and buttons of the OScAR Pro Customized Op 07 2010 OScAR Pro Customized O
207. mmand templates under Frames Select the OScAR Pro command template that you want to edit To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value RO Ea Table 5 43 Edit the attributes of a OScAR Pro command template 07 2010 OScAR Pro Customized Operator User Manual 5 53 The Elements of a DCO Script Frames 5 8 10 Add a new Function to a Frame Follow the below instructions to add a new Function to a Frame No Task 1 Go to the tree structure and open the node Frames 2 Open the Frame to which you want to add a new Function 3 Under the Frame you selected open the child node Functions to add a new Function 4 Here you can choose from the nodes e On_Load if you want the new Function to be executed whenever the Frame is loaded or e On_Message if you want the new Function to be invoked by instructions of the type Broadcast Message see Section 5 11 8 The Instruction BroadcastMessage by double clicking on a listbox entry or by selecting an entry in a combobox e On_Timer if you want the new Function to be invoked cyclic depending on the interval value see Section 5 8 1 The attributes and child nodes of the node Frames of the page or e User if you want the new Function you want to create only to be available when the In structions of this Frame are invoked 5 Now go to the menu bar an
208. must be installed on your PC or in your network for details please refer to the OScAR Pro User Manual OScAR Pro TT Server has previously been connected at least once with the correspond ing OScAR Pro server online to return to the previous window for example to make changes If you want to end and not finish the installation click Cancel Follow the system instructions output during the installation Click Back if you want No Task Window 1 Place the Installation CD in the CD ROM iNe Te 2 xi 2 Type the name of a program Folder document or Internet resource and Windows will open it For you If the installation software fails to start auto matically please start the CD installation Open d cdsetup 7 manually from the Windows interface by us ing the command Run menu aaa Ta To trigger this command you need to enter lt CD Rom drive gt cdsetup e g d cdsetup in the command line and confirm your entry with OK Table 3 1 How to install the OScAR Pro Customized Operator 3 2 07 2010 OScAR Pro Customized Operator User Manual Installation How to install the OpenScape Alarm Response Professional No Task Window 2 Click the menu item x Install OpenScape Alarm Response rf tetronik combi ProfessionalV1 hore derdiei reteni oS Amini i ahd User manual DAKS d Operator a tetronik GmbH AEN homepage Bes Deutsc
209. n e assign a Constant Parameter or Variable of the data type string or e assign the reference to a Control that has the data type string Table 5 100 The arguments of the Instruction SetButtonStaticPicturePos 07 2010 OScAR Pro Customized Operator User Manual 5 127 The Elements of a DCO Script Instructions 5 11 33 The Instruction SetButtonStaticPictureScale Description Use this Function Instruction to change the scaling of an image of a Static element on a Button Arguments Arguments Description Button Editable combobox to define the Button with the Static element whose image you want to scale Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Static element Editable combobox to choose the Static element of the select ed Button whose image you want to scale Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Scaling Editable combobox to define the scaling for the image of the Static element Here you can e enter a scaling factor in e select proportional to align the image with the size of the Static element in keeping with the Static element s height width proportion e select unproportional to align the image with the full scale of the Static element s surface irrespective of the height width proportion or e assign a reference to a Contro
210. n e enter the name of the Button direct or e select a Button from the list of all available Buttons Color Editable combobox to choose the background color for the se lected Button Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 93 The arguments of the Instruction SetButtonColor 07 2010 5 120 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 26 The Instruction SetButtonPicture Description Use this Function Instruction to assign a new or a different image to a Button Arguments Arguments Description Button Editable combobox to choose the Button to which you want to assign a new or a different image Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Image Editable combobox to specify the image assigned to a Button Here you can e enter a file name from the List of images e select an image in the user window that opens as you click the entry Select image in the drop down list see Section 4 6 2 Administration of the Image lists e assign a Constant Parameter or Variable of the data type str
211. n for example move Controls in the Structure window to a new Frame or copy them by keeping the Ctrl key pressed at the same time In the Layout window you can duplicate Controls see below by keeping the Ctrl key pressed at the same time 07 2010 OScAR Pro Customized Operator User Manual 4 11 Operating Instructions for the OScAR Pro Customized Operator Layout of the interface of the OSCAR Pro Customized Operator The right mouse key 4 2 Context menu A right mouse key click opens the context menu for the window that is currently open This usually enables you to quickly access the functions that can also be reached with the menu bar drop down menus or buttons e g New Edit Copy etc However the context menu additionally offers functions that only make sense for the window that is currently open The most important differences are Move up and Move down in the Structure window Tools Align Make same size and Space evenly in the Layout window New Edit etc in the Structure as well as in the Layout window The functions of the context menu entries are the same as the ones of the corresponding pop up menu entries Section 4 2 3 Description of the menu commands and the buttons of the OScAR Pro Customized Operator 5 The status bar The status bar is located at the lower end of the main window It gives you additional informa tion 4 12 on the various menu commands and outputs status messages o
212. n page 6 5 10 The User Function Disable invoke Description Use this Function to block the Button Invoke against entries Attributes Attribute Contents Name Disable invoke Condition Selected message EQL 1 OR Management blinking AND AdminTech blinking AND Production 1 blinking AND Production 2 blinking Messagebox Instructions Instruction Arguments Contents The Instruction SetBut Button Invoke tonStatus Status 2 disabled 6 5 11 The User Function Enable invoke Description Use this Function to enable the Button Invoke to accept entries OScAR Pro Customized Operator User Manual Attributes Attribute Contents Name Enable invoke Condition Selected message UEQ 1 AND Management blinking OR AdminTech blinking OR Production 1 blinking OR Production 2 blinking Messagebox Instructions Instruction Arguments Contents The Instruction SetBut Button Invoke tonStatus Status 1 enabled 07 2010 6 39 The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 12 The User Function Activate invoke Description Use this Function to specify if the Button Invoke is enabled or disabled to accept entries Attributes Attribute Contents Name Activate invoke Condition Messagebox Instructions
213. n the Data list to which you want to add a new data element In the relevant Data list click the child node Data element Now go to the menu bar and select Edit gt New A new data element is now automatically added to the List 6 Inthe active Edit field enter the text with which the data element shall be output in a List box or Combobox 7 _ If needed you can now edit the other attributes of the new data element Table 5 19 Add new data element ror COO IN ee 5 7 5 Edit the attributes of a data element Follow the below instructions to edit an existing data element No Task Go to the tree structure and open the node Lists Now open the child node Data lists Open the Data list whose data elements you want to edit In the tree click the child node Data elements To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value Oy BP oO hy gt Table 5 20 Edit the attributes of data elements 07 2010 OScAR Pro Customized Operator User Manual 5 23 The Elements of a DCO Script Lists 5 7 6 The attributes and child nodes of the node Filters The actual Filters are created in the node Filters that is a child node of the node Lists Each Filter has the following child nodes e ID ranges e Included IDs e Excluded IDs The attributes of Filters Filters have the following at
214. n to edit the background color of an Edit field Arguments Arguments Description Edit field Editable combobox to specify the Edit field whose background color you want to edit Here you can e enter the name of an Edit field direct or e select an Edit field from the list of all Edit fields that are available Color Editable combobox to define the background you want to give to the selected Edit field Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 123 The arguments of the Instruction SetEditBackColor 07 2010 5 150 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 56 The Instruction SetEditBackColorBlink Description Use this Function Instruction to turn ON the blinking of the background of an Edit field Arguments Arguments Description Edit field Editable combobox to specify the Edit field wnose background blinking you want to switch on Here you can e enter the name of an Edit field direct or e select an Edit field from the list of all Edit fields that are available 1 Blink color Editable combobox to define the primary blink color Here
215. n to set the flag that governs the blinking of the Button Attributes Attribute Contents Name Set Condition Production 2 blinking Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable Production 2 blinking able Value 1 The Instruction Call Function Blink Buttons 07 2010 OScAR Pro Customized Operator User Manual 6 59 The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 30 The Functions of the Button Invoke Invoke broadcast Description This Function is automatically invoked whenever the Button Invoke is pressed and acti vates the broadcasts in keeping with the selected areas Attributes Attribute Contents Name Invoke broadcast Condition Selected message UEQ 1 Messagebox Invoke broadcast s Instructions Instruction Arguments Contents The Instruction Call Function Invoke Management The Instruction Call Function Invoke AdminTechnics The Instruction Call Function Invoke Production 1 The Instruction Call Function Invoke Production 2 Call Function Reset events Call Function Reset areas Call Function Blink Buttons 07 2010 6 60 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Frame Announcement selection 6 6 Create the Functions of the
216. nal event related announcements an Ok Button to confirm your selection s and a Cancel Button to close the Frame and discard all selection s OScAR Pro Customized Operator User Manual 6 7 The planning and implementation of a DCO Project The case study project Global objects The below listed global objects are created for the internal storage of the data and to commu nicate with OScAR Pro To render the different possibilities of proceeding the data of the announcement 1000 Fire alert is entered directly in form of values the announcement 1001 Deflagration is created in form of a Constant and the announcements 1002 Leakage and 1003 Short circuit are created in form of parameters The entire broadcast data is entered exclusively in form of parameters In order to select the announcements administrated in OScAR Pro via the Frames child node Announcement selection an index is created with a corresponding Data list and a matching Filter Variables are created to store the currently selected announcement as well as its name and the currently selected broadcast Except for the Button that is used to invoke the broadcast a Variable is created for each Button on the Main Page to retain the information if the respective Button shall blink or not The Functions of the Main page The following Functions are implemented on the Main Page For each blinking Button a Function is created that sw
217. name Huntgroup CHECKBOX Huntgroup A reference to a Checkbox always outputs as result the status of the pertinent Checkbox Listbox LISTBOX lt Name of the Listbox gt e g for a Listbox with the name Broadcasts LISTBOX Broadcasts A reference to a Listbox always outputs as result the entries that were chosen for that Listbox Combobox COMBOBOX lt Name of the Combobox gt e g for a Combobox with the name Announcements COMBOBOX Announcements A reference to a Combobox always outputs as result the entry that was chosen for that Combobox Table 5 47 Reference declarations for Controls 07 2010 5 58 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls 5 9 3 Attributes shared by all Controls The below attributes are shared by all Controls Attribute Description Name Edit field to enter the name of the Control Select a name that is recognizable and unique among the Controls of a Frame Links Editable comboboxes to define the left and upper top margin as well as the width and the height in pixels Top Here you can Width e enter a numeric value or Height e assign a Constant Parameter or Variable of the data type int The width height and the distance to the left and top border can be edited during the execution of the DCO Script for e Static elements with the command The Instruction Set StaticRect e Edit fields with
218. nce IDs etc Please note that the information and tutorials in this chapter are based on the assumption that you are already familiar with the OScAR Pro TT Operator Tool Contents The chapter covers the following sections 7 1 Publication of the DCO Script 7 2 Layout in the OScAR Pro TT Operator Tool 7 2 1 The DCO in the child window 7 2 2 The DCO in the toolbar 7 2 3 Summary of the enhanced menu bar in the OScAR Pro TT Operator Tool 7 3 Operation of the DCO Window 7 4 The DCO Parameter Editor 7 5 Special registry entries for the DCO 07 2010 OScAR Pro Customized Operator User Manual 7 1 The DCO in the OScAR Pro TT Operator Tool Publication of the DCO Script 7 1 Publication of the DCO Script After a project has been completed in the DCO Designer you need to publish the correspond ing DCO Script To do so simply copy the project file e directly onto the PC that is used to run the OScAR Pro TT Operator Tool or e onto a network drive for which the OScAR Pro TT Operator Tool PC has complete read and write permissions Note As you publish your DCO Script please be careful to copy not only the dco files and the ini file but also the corresponding subdirectory with the title images and all the graphic data files contained therein 7 2 Layout in the OScAR Pro TT Operator Tool In the OScAR Pro TT Operator Tool the DCO Script is executed like an individual program and follows the defined processes an
219. nd open Lists Next select the child node Data lists Now go to the menu bar and select Edit gt New This will open the following user window to add the new Control x Please name entry Name Administered emergency ann bee Lye Fea aia 4 Assign a unique and recognizable name to the new Data list 5 Specify the Data list type 6 Finally click Ok to close the window The DCO Designer outputs the new Data list in the tree structure of the Structure win dow and there in the node Data lists You can now edit the attributes of the Data list and if needed add data elements Table 5 17 Add a new new Data list 5 7 3 Edit the attributes of a Data list Follow the below instructions to edit an existing Data list No Task Go to the tree structure and open the node Lists Now open the child node Data lists In the tree view select the Data list you want to edit AJON gt To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value Table 5 18 Edit Data list attributes 07 2010 5 22 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Lists 5 7 4 Add a new data element Follow the below instructions to add a new data element to a Data list No Task Go to the tree structure and open the node Lists Now open the child node Data lists Ope
220. ne the Frame that shall be opened Here you can e enter the name of the Frame direct or e select a Frame from the list of all available Frames Table 5 86 The arguments of the Instruction GotoFrame 5 11 19 The Instruction OffAllListBoxltemBlink Description Use this Function Instruction to turn OFF the blinking of all items of a Listbox Arguments Arguments Description Listbox Editable combobox to specify the Listbox the blinking of which you want to switch off Here you can e enter the name of the Listbox direct or e select a Listbox from the list of all available Listboxes Table 5 87 The arguments of the Instruction OffAllListBoxltemBlink 07 2010 5 114 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 20 The Instruction OffButtonBlink Description Use this Function Instruction to turn OFF the blinking of a Button Arguments Arguments Description Button Editable combobox to define the Button the blinking of which you want to switch off Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Table 5 88 The arguments of the Instruction OffButtonBlink 5 11 21 The Instruction OffEditBackColorBlink Description Use this Function Instruction to turn OFF the blinking of the background of a Listbox Arguments Arguments Description Edit field Editable combobox to define th
221. nstant Parameter or Variable of the data type phone_number or e assign the reference to a Control that has the data type phone_number Info text Editable combobox to enter the name of the destination for the above WHI number Here you can e enter a call number with up to 24 digits e use the selection field to assign a Constant Parameter or Variable of the data type string or e assign the reference to a Control that has the data type string Show local call dialog Editable selection field to specify if the system shall output the local call dialog when dialing the WHI number Here you can e select 0 if the system shall NOT show the dialog e select 1 if the system shall show the dialog e assign a Constant Parameter or Variable of the data type bool or e assign the reference to a Control that has the data type bool Table 5 41 Attributes and child nodes of the node OScAR Pro command templates 07 2010 OScAR Pro Customized Operator User Manual 5 47 The Elements of a DCO Script Frames Attribute Description Additional attributes of the OScAR Pro command SET_PRM Bring own broadcasts to top Editable combobox to define if the windows of the user s own broadcast processes are automatically be brought to the front Here you can e enter 0 to keep Process windows in the background e enter 1 to bring Process windows to the front e use the selection field to assign a Constant Parameter or Varia
222. nt a broadcast group was created with subscribers was e For every imaginable emergency situation a voice announcement was created and record ed e Also an additional so called ad hoc or current voice announcement was created to for un foreseen emergency situations At this point the company own fire brigade requested that the different departments and an nouncements be output together so that they could be monitored in parallel This aim was to make sure that alarms could be raised quickly via touchscreen with as few mouse clicks as possible 07 2010 2 2 OScAR Pro Customized Operator User Manual Overview Example application The fire brigade s IT manager enrolled in a training course were he learned how to operate the OScAR Pro Customized Operator and then realized the aforementioned corporate require ments as described below see next page Ti tetronik DAKS TT Operator Tool Localhost 2 7 15 x Operations DCO View Window Help la x wese a Tf Currently selected Events bl Fire alert A Deflagration E Leakage A Short circuit x More lt none gt Production 1 haiie Production 2 W Admin amp Technics 4 Map of Plant Hints EXP Chemical Industries Inc 1 Select event Plant Anywhere 2 Select area Legend 3 Invoke m Fire department Management mm Security services Management m Administration amp Technics Production area 1 o nvolee Production area 2 C v Image 2 1 Examp
223. ntent of each Variable that is used in a condition If a Variable is edited within the Functions the changes will only enter into effect when the conditions are verified again during the next execution of the Functions This does not apply to Functions that are invoked with the command The Instruction Call Example A Button has the Functions func_1 and func_2 In addition a Variable Number was created with type int and the initial value 2 The Function func_1 has the condition SNumber EQU 2 and the Instructions to set the Variable Number to the value 5 The Function func_2 has the condition SNumber UEQ 2 and the Instructions to set the Variable Number to the value 2 The user presses the Button and thereby initiates the execution phase The Function func_1 is executed The Function func_2 however is not performed as the condition is checking a copy of the Variable number which still has the value PA When the Button is pressed a second time the func_2 is executed but the func_1 not as the copy of the Variable number now has the value 5 5 92 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 Instructions Instructions are orders with which the system responds to user inputs and that help to control the sequence of the DCO Script The Instructions are administrated under Functions see Section 5 10 Functions with each Functions able to have an unlimited
224. nter of each line More than one Button marked 4 fe piii 4 vA 4 Button g If two or more Buttons are marked each button is surrounded by a frame that has accented edges but no squares The But ton that has the focus has an additional solid black frame on the inside of the accented frame Table 4 4 Rendition of marked objects To mark only one element simply make a left mouse click on the element This will give the el ement the bounding box 4 18 07 2010 OScAR Pro Customized Operator User Manual Operating Instructions for the OScAR Pro Customized Operator Setup and application of the Layout window There are two ways to mark more than one element in one step 1 Mark the first element press the SHIFT key and keep it pressed and make a left mouse click each other element you want to mark To delete the marking from an element simply click the element again Move the mouse cursor over your window or Frame area and find a place where it does not collide with any other element Then press the left mouse key keep it pressed and pull a bounding box around the elements you want to mark Now release the mouse key Every element that is completely surrounded by the bounding box is marked Button Button 4 4 3 Move Controls There are two ways to move one or several Controls 1 Mark the elements you want to move and use the arrow keys 4 gt to shift them to the new position
225. nts The Instruction Call Function Blink Buttons 07 2010 OScAR Pro Customized Operator User Manual 6 53 The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 24 2 The Function Set Description Use this Function to set the flag that governs the blinking of the Button Attributes Attribute Contents Name Set Condition Short circuit blinking Messagebox Instructions Instruction Arguments Contents The Instruction Call Function Reset events The Instruction SetVari Variable Short circuit blinking able Value 1 The Instruction SetVari Variable Selected message able Value Short circuit The Instruction SetVari Variable Selected event able Value Short circuit name The Instruction Call Function Blink Buttons 6 54 07 2010 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 25 The Functions of the Button More Open announcement selection Description This Function is automatically invoked whenever this Button is pressed and opens the user window Announcement selection Attributes Attribute Contents Name Open announcement selection Condition Messagebox Instructions Instruction Arguments Contents The Instruction Call Function Reset events The Instruc
226. number of Instructions Within the Functions the Instructions are performed in the order in which they are numbered under the column Index To change the order of the Instructions go to the menu bar of the Structure window and click Edit gt Move up and or Edit gt Move down 5 11 1 Arguments of Instructions Please note that Instructions do not have attributes but so called arguments The number and type of the arguments that are available differ from Instruction to Instruction and are described in detail below 5 11 2 Overview of Instructions The below table summarizes the Instructions that are available in the system and groups them according to their logic proportion Instruction Description Control Instructions BroadcastMessage Sends a message to the own page andi a to a correlating page e g assigned toolbar The Instruction Call Triggers Functions The Instruction Execute Starts and Controls OScAR Pro processes and queries them The Instruction GetBroad Filters all administrated broadcasts from OScAR Pro casts The Instruction GetConferenc Filters all administrated conferences from OScAR Pro es The Instruction GetInfotele Filters all administrated info telephone profiles from OScAR phones Pro The Instruction GetMessages Filters all administrated announcements from OScAR Pro The Instruction GetScenarios Filters all administrated scenarios from OScAR Pro
227. o com Invoke broadcast cute mand template 6 5 17 The User Function Invoke AdminTechnics Description This Function launches a broadcast for the Admin amp Technics area provided 1 is selected for the Variable AdminTech blinking Attributes Attribute Contents Name Invoke AdminTechnics Condition AdminTech blinking AND Selected message UEQ 1 Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable Selected broadcast able Value Admin amp Technics The Instruction Exe cute Execute OScAR Pro com mand template Invoke broadcast 07 2010 OScAR Pro Customized Operator User Manual 6 45 The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 18 The User Function Invoke Production 1 Description This Function launches a broadcast for the Production Area 1 provided 1 is selected for the Variable Production 1 blinking Attributes Attribute Contents Name Invoke Production 1 Condition Production 1 blinking AND Selected message UEQ 1 Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable Selected broadcast able Value Production 1 The Instruction Exe Execute OScAR Pro com Invoke broadcast cute mand template 6 5 19 The User Function Invoke Production 2
228. of a Function ates Ua be dwg Oyo ore ws 5 99 Edit an Instruction of a Function 0 000 c eee eee ee 5 101 Arguments of the Instruction AddListToComboBox 5 102 The arguments of the Instruction Call 2000 00005 5 103 The arguments of the Instruction BroadcastMessage 5 104 The arguments of the Instruction ClearComboBox 5 105 The arguments of the Instruction Execute 2 04 5 106 The arguments of the Instruction GetBroadcast 5 107 The arguments of the Instruction GetConferences 5 108 The arguments of the Instruction GetComboBoxSelText 5 109 The arguments of the Instruction GetInfotelephones 5 110 The arguments of the Instruction GetListBoxSelText 5 111 The arguments of the Instruction GetMessages 5 112 The arguments of the Instruction GetScenarios 5 113 The arguments of the Instruction GotoFrame 05 5 114 The arguments of the Instruction OffAllListBoxltemBlink 5 114 The arguments of the Instruction OffButtonBlink 5 115 The arguments of the Instruction OffEditBackColorBlink 5 115 The arguments of the Instruction OffEditTextColorBlink 5 116 The arguments of the Instruction OffListBoxltemBlink 5 117 The arguments of the Instruction SetButtonBlink 5 118 The
229. of the Listbox direct or e select a Listbox from the list of all available Listboxes List element Editable combobox to specify the index of the List element of the selected List box the text color of which you want to edit Here you can e enter a numeric value e assign a Constant Parameter or Variable of the data type int or e assign a reference to a Control that has the data type int Color Editable combobox to choose the text color you want to assign to the selected List element of the Listbox Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 135 The arguments of the Instruction SetListBoxltemColor 07 2010 5 164 OScAR Pro Customized Operator User Manual 5 11 68 Description The Elements of a DCO Script Instructions The Instruction SetListBoxList Use this Function Instruction to fill a Listbox with the elements of a Data list Please note that to do so the Data list and the Listbox must have the same data type see Sec tion 5 2 The DCO data types and their value ranges Arguments Arguments Description Listbox Editable combobox to specify the Listbox that you want to fill
230. of the fact that toolbars operate in a menu free context the DCO Window has in this case no menu of its own in the menu bar of the OScAR Pro TT Operator Tool Instead you can open the DCO drop down menu see Section 7 3 Operation of the DCO Window with a right mouse click 7 2 3 Summary of the enhanced menu bar in the OScAR Pro TT Operator Tool The table below lists the menu items of the OScAR Pro TT Operator Tool that are automatically enhanced if DCO is enabled on the chip card of the OScAR Pro Server Menu item Description Pull down menu Window OScAR Pro Customized Op Opens a DCO Script for output and execution era tor Ctr1l SHIFT F4 a All other entries See OScAR Pro TT User Manual Version 6 12 and ff Table 7 1 Summary of the enhanced menu bar in the OScAR Pro TT Operator Tool 07 2010 7 4 OScAR Pro Customized Operator User Manual The DCO in the OScAR Pro TT Operator Tool Operation of the DCO Window 7 3 Operation of the DCO Window This section covers the general operation elements of the DCO Window The menu bar and buttons The below table lists in detail the different menu items of the DCO Window in the OScAR Pro TT Operator Tool including their pertinent keyboard shortcuts and symbols Menu item Description Pull down menu Application All entries See OScAR Pro TT User Manual Version 6 12 and ff Pull down menu Operations All entries See OScAR Pro TT User Manual V
231. olor you want to assign to the Static element Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 142 The arguments of the Instruction SetStaticBackColor 07 2010 OScAR Pro Customized Operator User Manual 5 171 The Elements of a DCO Script Instructions 5 11 75 The Instruction SetStaticBorderColor Description Use this Function Instruction to edit the color of the border surrounding a Static element Arguments Arguments Description Static element Editable combobox to specify the Static element whose border color you want to change Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Color Editable combobox to define the color of the border surround ing the Static element Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data typ
232. ols Child node Description For the types PROCESS BDC and PROCESS_CON Process status Here you can e 0 to filter only processes who are still active and being processed e 1 to filter processes whose processing has already been completed but who still have windows in the OScAR Pro TT Operator Tool e 1 to filter all processes active and completed that have windows in the OScAR Pro TT Operator Tool or e aConstant Parameter or Variable of the data type int For the ROCESS _BDCMBR Process status Here you can e 1 to filter all subscribers e 0 to filter only subscribers who are not yet being pro cessed e 1 to filter only subscribers who are momentarily in the pro cess of being called e 2 to filter only subscribers who could either not be reached or who confirmed negative e 3 to filter only subscribers who are currently being played the broadcast announcement e 4to filter only subscribers for whom the system is current ly waiting to enter their PIN e 5 to filter only subscribers who were either reached or who confirmed positive e 6 to filter only subscribers whose dial up by the system is momentarily in a pause e 7 tofilter only subscribers whose processing has not been fully completed e 256 to filter only subscribers for whom no final result has yet been received i e not 2 or 7 or e aConstant Parameter or Variable of the data type int Table 5 63 Attributes
233. ombobox Editable combobox to specify the Combobox you want to edit with regard to the way in which it is output and used Here you can e enter the name of the Combobox direct or e select a Combobox from the list of all available Combob oxes Status Editable combobox to specify the way in which the selected Combobox is output and used Here you can e choose 0 to hide the Combobox e choose 1 to show the Combobox and enable entries e choose 2 to output the Combobox but block all entries e assign a Constant Parameter or Variable of the data type uint or e assign the reference to a Control that has the data type uint Table 5 120 The arguments of the Instruction SetComboBoxStatus 07 2010 OScAR Pro Customized Operator User Manual 5 147 The Elements of a DCO Script Instructions 5 11 53 The Instruction SetComboBoxTextColor Description Use this Function Instruction to change the color of the text of a Combobox Arguments Arguments Description Combobox Editable combobox to specify the Combobox whose text color you want to edit Here you can e enter the name of the Combobox direct or e select a Combobox from the list of all available Combob oxes Color Editable combobox to choose the color for the text of the Com bobox Here you can e enteracolor value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6
234. ommand templates the Variable could be used at the beginning of a broadcast so that the currently assigned value namely the ID of the selected announcement is trans ferred to the OScAR Pro TT Operator Tool 5 6 1 The attributes of Variables Variables have the following attributes Attribute Description Name Edit field to enter the name of a Variable Make sure you select a name that is recognizable and unique in this list Type Combobox to specify the type of the Variable see Section 5 2 The DCO data types and their value ranges Value Editable combobox to enter the initial value of the Variable in keeping with the pertinent Variable type Table 5 11 Attributes of Variables 07 2010 OScAR Pro Customized Operator User Manual 5 17 The Elements of a DCO Script Variables 5 6 2 Add a new Variable Follow the below instructions to create a new Variable No Task go to the tree structure and open the node Variables 2 Now go to the menu bar and select Edit gt New This will open the following user window to add the new Control x Please name entry Name Selected announcement Type msa id XK Cancel 3 Assign a unique and recognizable name to the new Variable 4 Specify the Variable type 5 Finally click Ok to close the window The DCO Designer will output the newly created Variable in the tree structure of the Structure window an
235. on Leakage and Short circuit 6 Repeat steps 3 and 4 for all Area Buttons 7 During the steps 3 through 6 the Invoke Button may only be enabled if exactly one Event Button and at least one Area Button are blinking 8 Now press the Button More This should open the Frame Announcement selection and its Announcement list un der Controls should already be filled with dummy values 9 Select an announcement and click Ok This will again open the Main page with the Button More blinking and the selected announcement entered under the Static element Event name 10 Continue the testing until satisfied 11 Select one Event Button plus at least one Area Button and click the Button Invoke One after another a message window should now open for each selected Area Button and contain an XML Structure index listing both the IDs of the selected broadcast and the selected announcement Table 6 17 Add a background image to the Main page 07 2010 6 66 OScAR Pro Customized Operator User Manual The DCO in the OScAR Pro TT Operator Tool 7 The DCO in the OScAR Pro TT Operator Tool Overview This chapter shows you how to load and run a DCO Script created in the DCO Designer in the OScAR Pro TT Operator Tool It also explains how to use the Parameter editor to adjust the parameters to the latest values for example to adjust the parameters of process IDs Broadcast IDs Confere
236. on Arguments Arguments Description Button Editable combobox to choose the Button of the Static element whose text you want to edit Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Static element Editable combobox to choose the Button s Static element whose text you want to edit Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Text Editable combobox to enter the text you want to assign to the Button s Static element Here you can e enter a string e assign a Constant Parameter or Variable of the data type string e assign the reference to a Control that has the data type string Table 5 104 The arguments of the Instruction SetButtonStaticText 07 2010 OScAR Pro Customized Operator User Manual 5 131 The Elements of a DCO Script Instructions 5 11 37 The Instruction SetButtonStaticTextColor Description Use this Function Instruction to change the color of the text of a Static element on a Button Arguments Arguments Description Button Editable combobox to choose the Button whose Static element you want to edit with regard to the color of its text Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Static element Editable combobox to choose the Static element of the select
237. on OffAllListBoxltemBlink 5 11 20 The Instruction OffButtonBlink 5 11 21 The Instruction OffEditBackColorBlink 5 11 22 The Instruction OffEditTextColorBlink 5 11 23 The Instruction OffListBoxltemBlink 5 11 24 The Instruction SetButtonBlink 5 11 25 The Instruction SetButtonColor 5 11 26 The Instruction SetButtonPicture 5 11 27 The Instruction SetButtonPictureScal 5 11 28 The Instruction SetButtonRect 5 11 29 The Instruction SetButtonStaticBackColor 5 11 30 The Instruction SetButtonStaticBorderColor 5 11 31 The Instruction SetButtonStaticPictureName 5 11 32 The Instruction SetButtonStaticPicturePos 5 11 33 The Instruction SetButtonStaticPictureScale 5 11 34 The Instruction SetButtonStaticRect 5 11 35 The Instruction SetButtonStaticStatus 5 11 36 The Instruction SetButtonStaticText 5 11 37 The Instruction SetButtonStaticTextColor 5 11 38 The Instruction SetButtonStaticTextPosition 5 11 39 The Instruction SetButtonStatus 5 11 40 The Instruction SetButtonText 5 11 41 The Instruction SetButtonTextColor 5 11 42 The Instruction SetCheckBoxBackColor 5 11 43 The Instruction SetCheckBoxCaption 07 2010 OScAR Pro Customized Operator User Manual 5 3 The Elements of a DCO Script 5 11 44 The Instruction SetCheckBoxRect 5 11 45 The Instruction SetCheckBoxState 5 11 46 The Instruction SetCheckBoxStatus 5 11 47 The Instruction SetCheckBoxTextColor 5 11 48 The Instruction SetCheckBoxToVariabl
238. on The Instruction Call Function Production 1 blink on The Instruction Call Function Production 2 blink on 07 2010 OScAR Pro Customized Operator User Manual 6 41 The planning and implementation of a DCO Project Create the Functions of the Main page 6 42 Instruction Arguments Contents The Instruction Set StaticText Static element Event name Text Selected event The Instruction Call Function Activate invoke 07 2010 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 14 The User Function Reset areas Description Use this Function to reset all Variables that were tagged for the Area Buttons Attributes Attribute Contents Name Reset areas Condition Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable Management blinking anes Value 0 The Instruction SetVari Variable AdminTech blinking able Value 0 The Instruction SetVari Variable Production 1 blinking ae Value 0 The Instruction SetVari Variable Production 2 blinking able Value 0 07 2010 OScAR Pro Customized Operator User Manual 6 43 The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 15 The User Function Reset events Description Use this Functi
239. on to reset the flag Variables for Event Buttons and enter the default settings in the Variable Name of event Attributes Attribute Contents Name Reset events Condition Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable Fire alert blinking apie Value 0 The Instruction SetVari Variable Deflagration blinking ane Value 0 The Instruction SetVari Variable Leakage blinking able Value 0 The Instruction SetVari Variable Short circuit blinking ables Value 0 The Instruction SetVari Variable More blinking able Value 0 The Instruction SetVari Variable Selected message aye Value 1 The Instruction SetVari Variable Selected event able Value P NO event 07 2010 6 44 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 16 The User Function Invoke Management Description This Function launches a Management broadcast provided 1 is selected for the Variable Management blinking Attributes Attribute Contents Name Invoke Management Condition Management blinking AND Selected message UEQ 1 Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable Selected broadcast able Value Management The Instruction Exe Execute OScAR Pr
240. ons stead Note Here the Variable Selected message is filled directly with the Constant Deflagra tion If for any reason the ID of the Deflagration announcement changes in OS cAR Pro the value of the Constant must be adjusted accordingly in all related areas of the DCO Script For this reason we recommend you use a Parameter see Button Leakage in 6 50 07 2010 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 23 The Functions of the Button Leakage The Functions underneath the Button Leakage are automatically invoked when this Button is pressed 6 5 23 1 The Function Delete Description Use this Function to reset the flag that governs the blinking of the Button Attributes Attribute Contents Name Delete Condition Leakage blinking Messagebox Instructions Instruction Arguments Contents The Instruction Call Function Reset events The Instruction Call Function Blink Buttons 07 2010 OScAR Pro Customized Operator User Manual 6 51 The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 23 2 The Function Set Description Use this Function to set the flag that governs the blinking of the Button Attributes Attribute Contents Name Set Condition Leakage blink
241. or User Manual 6 11 The planning and implementation of a DCO Project Create Frames and Controls 6 3 Create Frames and Controls To begin with you need to create the Frames and then add the Controls to the Frames 6 3 1 Create and customize the Frames Create the Main page Follow the below instructions to create the Main page No Task References 1 Create a new Frame with the following attributes 5 8 2 Add a new Frame e Name Main page e Interval 500 2 Now specify if you want to start with the Main page 4 6 1 Edit project properties in the OScAR Pro TT Operator Tool and set the re fresh interval to 2000 3 Open the Layout window to edit the Main page in 4 4 Setup and application of the terms of its layout Layout window To do so mark the child node Main page under the node Frames in the tree and click EI 4 Next go to the menu bar and select Layout gt Frame 4 4 4 Change the size of Frames size and Controls gt 1280x1024 so that the plant map will fit into the Frame 5 Finally click ej to save the project Table 6 3 Create and adjust the Main page 07 2010 6 12 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create Frames and Controls Create the child node Announcement selection under the node Frames Follow the below instructions to create the Frame Announcement selection No Task References Cli
242. or selection for new projects Pop up menu Languages gt German Specifies that the DCO Designer language is German English Specifies that the DCO Designer language is English Pull down menu Window Structure window Opens the Structure window and or brings it to the front Ctr1 T fa Layout window Opens the Layout window and or brings it to the front Ctrl L Please note that the Layout window can only open if you mark Ey a child node under the node Frame in the Structure window Preview window Opens the Preview window and or brings it to the front In this Ctrl R process the current project is saved and validated after a se e curity prompt Pull down menu About tetronik DCO Desig n er Opens the about box with details on the OScAR Pro Custom ized Operator F1 Table 4 2 Summary of the menu items and buttons of the OScAR Pro Customized Op erator 07 2010 4 6 OScAR Pro Customized Operator User Manual Operating Instructions for the OScAR Pro Customized Operator Layout of the interface of the OScAR Pro Customized Operator Menu item Description Special entries of the Structure window Pull down menu Edit New Ins Make a doubleclick in an empty area of the list view Creates a new element in the structure of the DCO Script Doubleclick the cell you want to edit in the list field view ty Edit Opens the selected para
243. or the node Controls and continue with step 5 4 Open e either the child node On_Load e the child node On_Message e the child node On_Timer e or the child node User Continue with step 7 5 Open the parent Button of the Function whose Instructions you want edit with regard to the order in which they are executed 6 Click the child node Functions 7 Open the Function whose Instructions you want edit with regard to the order in which they are executed 8 Now open the child node Instructions 9 Select the Instruction that you want to be executed earlier or later relative to the other Instructions 10 Here you can e the menu item Edit gt Move up to move the execution of the Instruction further up in the order or e the menu item Edit gt Move down to move the execution of the Instruction further down in the order Table 5 73 Edit an Instruction of a Function 07 2010 OScAR Pro Customized Operator User Manual 5 101 The Elements of a DCO Script Instructions 5 11 6 Description The Instruction AddListToComboBox Use this Instruction to add the data elements of a Data list to the existing list elements of a Com bobox Please note that to do so the Data list and the Combobox must be of the same type Arguments Arguments Description Combobox Editable combobox to specify the Combobox to which you want to add the data elements o
244. or you want to assign to the selected Static element of the Button Here you can e enteracolor value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 97 The arguments of the Instruction SetButtonStaticBackColor 07 2010 5 124 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 30 The Instruction SetButtonStaticBorderColor Description Use this Function Instruction to edit the color of the border surrounding a Static element ona Button Arguments Arguments Description Button Editable combobox to define the Button whose Static element you want to give a different border color Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Static element Editable combobox to define the Static element of the selected Button whose border you want to give a different color Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Color Editable combobox to define the color of the border surround ing the Static element Here you can e enter a color value see Section 5 2
245. order in which the Instructions are executed 5 101 5 11 6 The Instruction AddListToComboBox anasan aaa aaaea aaa ee 5 102 5 107 Th ilnstruction Cal sce Sis oh a etka a heaton tg te ne a ee aS awed Goa a 5 103 5 11 8 The Instruction BroadcastMessage 2 eee eee ee 5 104 5 11 9 The Instruction ClearComboBox 0 0 0 00 cc eee 5 105 5 11 10 The Instruction Exec te aio eae iene aici e aia ate at ates Aa ace ee ea aerate 5 106 5 11 11 The Instruction GetBroadcasts ee eke iw See ee ee ea are be 5 107 5 11 12 The Instruction GetConferences 0 0 0000 0 ccc ee eee 5 108 5 11 13 The Instruction GetComboBoxSelText 0 0 0 0 cc ee 5 109 5 11 14 The Instruction GetInfotelephones 00 cee ees 5 110 5 11 15 The Instruction GetListBoxSelText 0 0 0 ee 5 111 5 11 16 The Instruction GetMessages 00 0c eee ee 5 112 5 11 17 The Instruction GetScenarios 0 0 00 ee 5 113 5 11 18 The Instruction GOtOFrame ssc dcciow ce ace ee et he we 5 114 5 11 19 The Instruction OffAllListBoxltemBlink 0 0 0 0 0 000 c eee 5 114 5 11 20 The Instruction OffButtonBlink 0 00000000 cee ee 5 115 5 11 21 The Instruction OffEditBackColorBlink 0 0 00 00 cee 5 115 5 11 22 The Instruction OffEditTextColorBlink 0 0 00 00 cee eee 5 116 07 2010 OScAR Pro Customized Operator User Manual 0 3 Contents 5 11 23 5 11
246. ox e On_Timer if you want the new Function to be invoked cyclic depending on the interval value see Section 5 8 1 The attributes and child nodes of the node Frames of the page or e User if you want the Function you want to edit only to be available when the Instructions of this Frame are invoked A O N gt 5 To edit the attributes of the Function go to the list view and doubleclick the relevant item listed in the column Value see Section 5 10 1 The attributes and child nodes of Func tions If needed edit the Instructions of the Function see Section 5 11 Instructions Table 5 45 Edit the attributes of the Functions of a Frame 07 2010 OScAR Pro Customized Operator User Manual 5 55 The Elements of a DCO Script Controls 5 9 Controls Controls are graphic object elements of a Frame with which the user makes entries defines selections and activates Instructions For a detailed List of all Controls that are available in the DCO Designer please refer to Section 4 4 Setup and application of the Layout window 5 9 1 The use of Controls The below table gives you an overview of the way in which the different Controls are used Attribute Description Static element The Static elements are used to place info graphics and texts e g a floor plan or site map and to add symbols repre senting specific Functions and titles Apart from the Static elements that can
247. ox to choose the color for the text of the But ton Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 109 The arguments of the Instruction SetButtonTextColor 07 2010 5 136 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 42 The Instruction SetCheckBoxBackColor Description Use this Function Instruction to change the background color of a Checkbox Arguments Arguments Description Checkbox Editable combobox to define the Checkbox whose background color you want to edit Here you can e enter the name of the Checkbox direct or e select a Checkbox from the list of all Checkboxes that are available Color Editable combobox to define the background color of the se lected Checkbox Here you can e enter a color value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 110 The arguments of the Instruction SetCheckBoxB
248. page under the parent node Frames still in the tree view of the Structure window 3 Insert a Button with the following attribute values 5 8 5 Add a new Control through e Name Fire alert the Layout window e Left 150 e Text Fire alert 5 8 6 Edit the attributes of a Con e Font Microsoft Sans Serif trol e Font style bold e Size 10 4 6 4 Edit fonts e Image scaling in 40 e Image FIRE GIF 4 6 2 Administration of the Image lists 4 Now clickEJ to switch to the Layout window 5 Select the tool and click the Static element 4 4 2 Mark a Frame area or a Events Control Press the Ctrl key keep it pressed and click the But ton Fire alert Both Control elements are now marked with the Static element Events now having a double border Frame 6 Use the menu item Layout gt Make same 4 4 4 Change the size of Frames size gt Both to bring both Control elements to the and Controls same size Table 6 8 Insert Event Buttons 07 2010 OScAR Pro Customized Operator User Manual 6 19 The planning and implementation of a DCO Project Create Frames and Controls No Task References 7 Use the menu item Layout gt Adjust gt Top to align 4 4 5 Align and space elements both Control elements with the top border automatically 8 Finally click to save the project 9 Repeat the steps 3 through 8 for the Button Defla gration and use the same attr
249. perator User Manual Operating Instructions for the OScAR Pro Customized Operator Layout of the interface of the OScAR Pro Customized Operator Menu item Description Special entries in the Layout window Pull down menu Edit Delete Deletes the selected element from the structure of the DCO Ctrl Del Script x Pull down menu Layout Pop up menu Toolbar Pointer Selects the tool Pointer Use this tool to move graphical ob Ctrl 1 ject to a new positions or change their size S Static control Selects the tool Static control Use this tool to place new stat Ctrl 2 ic controls in the current frame e g images or static texts K Edit field Selects the tool Edit field Use this tool to add new Edit fields Ctrl 3 to the current Frame abl Button Selects the tool Button Use this tool to place new Buttons in Ctrl 4 the current Frame Z Checkbox Selects the tool Checkbox Use this tool to place new Check Ctrl 5 boxes onto the current Frame Listbox Selects the tool Listbox Use this tool to place a new Listbox Ctrl 6 in the current Frame g Table 4 2 Summary of the menu items and buttons of the OScAR Pro Customized Op erator 07 2010 OScAR Pro Customized Operator User Manual 4 9 Operating Instructions for the OScAR Pro Customized Operator Layout of the interface of the OSCAR Pro Customized Operator Menu item Description Combobox Selects
250. perator Tool have often found the system s standard visual output too complex to respond quickly and efficiently enough in an emergency situation or crisis It is against this background that the demand was formulated to develop a user friendly cus tomized interface with a limited number of buttons and if needed underlying company and floor maps The solution is the OScAR Pro Customized Operator short DCO Even without any specific programming skills any trained person can work with the OScAR Pro Customized Operator to create an individual customized interface These customized in terfaces can be edited at any later point in time to make sure that changes or increased growing corporate needs and requirements are continuously met 2 2 Example application The below example is taken from a real life application and demonstrates the user friendliness of the DCO system In this example the company styled EXP Chemical Industries Inc EXP short for Example purchased a OScAR Pro server for their in house fire brigade at company site company site Yoursite to help the firefighters respond to every imaginable emergency situation in the fastest and most efficient way possible EXP Chemical Industries is divided into a number of different business areas and every imag inable emergency scenario have been defined and grouped into corresponding alarm plans These alarm plans were then realized accordingly in OScAR Pro e For each departme
251. presented by an integer in a scale from 0 to 255 If you modify this integer the reticle will jump to the corresponding position in the above prismatic color system and brightness scale Add to Custom Colors Use this button to add the current color to your list of Custom colors Summary of the fields in the window Font Note You can also use the right mouse key to click the wanted color directly in the prismat ic color system or brightness scale 4 32 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script 5 The Elements of a DCO Script Overview This chapter covers the elements properties values etc of the DCO Script and shows you how to use them The descriptions and explanations in this chapter are based on the assumption that you have successfully started the DCO Designer see Section 4 1 Start the OScAR Pro Customized Operator and opened an already existing or created a new project Contents The chapter covers the following areas 5 1 General structure 5 2 The DCO data types and their value ranges 5 3 Formulas 5 4 Constants 5 4 1 The attributes of Constants 5 4 2 Add a new Constant 5 4 3 Edit the attributes of a Constant 5 5 Parameters 5 5 1 Add a new Parameter group 5 5 2 The attributes of Parameters 5 5 3 Add a new Parameter 5 5 4 Edit the attributes of a Parameter 5 6 Variables 5 6 1 The attributes of Variables 5 6 2 Add a new Variable
252. r numeric information Button A Button can set specific modes and trigger events It can be compared to a switch Checkbox A Checkbox exclusively serves to set specific modes Listbox A Listbox outputs lists in which the user can mark individual entries Combobox A combobox serves to give a choice of options from with the user Operator can select exactly one entry Table 4 3 Summary of all available Controls Both the Controls that are placed in a Frame and the Frame area itself can be modified in terms of size Also you can move Controls to a new place or have them aligned or positioned auto matically 07 2010 OScAR Pro Customized Operator User Manual 4 17 Operating Instructions for the OScAR Pro Customized Operator Setup and application of the Layout window 4 4 2 Mark a Frame area or a Control Before you can edit a Frame area or a Control you need to mark the corresponding element Frame area or Control For Controls you also have the option to edit several Controls at the same time The below table illustrates the different ways in which marked elements are output on the screen using the example of marked and unmarked Buttons Button Description Not marked The element is neither marked nor surrounded by an extra frame Button One Button marked Ea If only one Button is marked it is surrounded by a frame with accented edges and squares both at its corner points and in the ce
253. rameter see Section 5 2 The DCO data types and their value ranges Value Edit field to enter the default value for the Parameter in keep ing with the pertinent Parameter type You may leave this field empty In this case however you will need enter the value through the Parameter editor of the OS cAR Pro TT Operator Tool Comment Edit field for additional information e g explaining the use of the Parameter in DCO script The comment is output in the Pa rameter editor of the OScAR Pro TT Operator Tool Table 5 8 Attributes of Parameters 07 2010 OScAR Pro Customized Operator User Manual 5 15 The Elements of a DCO Script Parameters 5 5 3 Add a new Parameter Follow the below instructions to create a new Parameter No Task Go to the tree structure on the right and open the node Parameters In the tree select the Parameter group to which you want to add the new Parameter Now go to the menu bar and select Edit gt New This will open the following user window to add the new Control x Please name entry Name Fire announcement i Xcore Enter a name for the Parameter that is clear and unique Finally click Ok to close the window The DCO Designer outputs the new Parameter in the tree structure of the Structure win dow and there in its proper group in the node Parameters If needed you can now edit the attributes of the Parameter T
254. reference to end Here you can e enter a number between 0 and 255 e assign a Constant Parameter or Variable of the data type byte or e assign the reference to a Control that has the data type byte Table 5 41 Attributes and child nodes of the node OScAR Pro command templates 5 44 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Frames Attribute Description Child nodes of the node BDC Broadcast IDs List with up to 16 entries to enter the IDs of the broadcasts that need to be activated in an emergency situation If this List consists of one ID only the pertinent broadcast is launched with its administrated attributes If the List however covers 2 or more IDs the relevant broad casts will be joined together in a so called hunt group in keep ing with the attributes that were defined for such a group Here you can e enter a valid ID with up to 4 digits e assign a Constant Parameter or Variable of the data type bdc_id through the selection field or e assign the reference to a Control that has the data type bdc_id Standard announcement IDs List with up to 16 entries to select and compose the standard announcement group that shall currently be used in the broad cast Here you can e enter a valid ID with up to 4 digits e use the selection field to assign a Constant Parameter or Variable or e assign the reference to a Control that has the data type msg_id
255. ript Frames The child nodes of the node Frames The node Frames has the following child nodes Child node Description Controls This node is used to administrate the Controls that were creat ed in this Frame For a detailed description of the Control please see the Sec tion 5 9 Controls OScAR Pro command tem plates This node is used to administrate the command templates that are used to invoke queries of the OScAR Pro TT Operator Tool or to activate processes via the OScAR Pro TT Operator Tool For a detailed description of the OScAR Pro command tem plates please see the Section 5 8 7 OScAR Pro command templates Functions This node serves to administrate the Functions of the Frame This node has the child nodes e On_Load The Functions created in this child node are executed au tomatically when the Frame is loaded e On_Message The Functions created in this child node are invoked with instructions of the type BroadcastMessage see Section 5 11 8 The Instruction BroadcastMessage by doub le clicking on a listbox entry or by selecting an entry ina combobox e On_Timer The Functions created in this child node are invoked cy clic depending on the interval value see Section 5 8 1 The attributes and child nodes of the node Frames of the page e User The Functions created in this child node can only be in voked with instructions of the type Call
256. rs or e assign a Constant Parameter or Variable of the data type color The color of the general entries of Listboxes can be changed during the execution of the DCO Script with the command The Instruction SetListBoxTextColor Border style Drop down list to choose the style of the border surrounding the Listbox Here you can e none if you do not want the Listbox to have a border e simple if you want the Listbox to be surrounded by a sim ple black line or e sunken if you want the Listbox to have a two color bor der Type The selection field to define the data type of the Listbox see Section 5 2 The DCO data types and their value ranges Listboxes have the additional type pro cess If a Listbox is of this type it can also be filled using the Data lists and Filters with entries from the OScAR Pro TT Operator Tool Table 5 61 07 2010 Special attributes of Listbox OScAR Pro Customized Operator User Manual 5 79 The Elements of a DCO Script Controls Attribute Description Blink interval Editable combobox to specify the interval in milliseconds in which the data elements of Listboxes blink 1000 milliseconds 1 seconds Here you can e enter 1 to use the interval of the parent Frame e enter an integer or e assign a Constant Parameter or Variable of the data type int The blink interval of a Listbox can be changed during the exe cution of the DCO Script wit
257. ructure window 07 2010 OScAR Pro Customized Operator User Manual 5 37 The Elements of a DCO Script Frames 5 8 5 Add a new Control through the Layout window Follow the below instructions to add a new Control to a Frame via the Layout window No Task Go to the tree structure and open the node Frames Mark the Frame to which you want to add a new Control Go the the menu bar and click Window Layout window to open the Layout window for the selected Frame 4 Now go to the menu bar and open Layout gt Tools to select the Control type you want to add the Frame 5 Next move your cursor to the top left position where the Control shall be placed Press the left mouse key keep it pressed and enlarge the bounding box the correct size of your new Control Release the mouse key 6 This will open the following user window to add the new Control x Please name enty i Name Fire aet cc Ok eet XK Cancel 7 Assign a unique and recognizable name to the new Control 8 Finally click Ok to close the window The DCO Designer outputs the new Control in the Layout view at the place and in the size defined with the bounding box In the tree view of the Structure window the new Control is be listed in the child node Controls of the relevant Frame If needed you can now edit the attributes of the Control see Section 5 9 Controls
258. s no function or greater than or equal to the sec GET ond or 0 if not lt Equals 1 if the first integer is no function or smaller than the second or 0 if LT not lt Equals 1 if the first integer is no function or smaller than or equal to the sec LET ond or 0 if not Table 5 3 List of logical operations in Formulas 07 2010 5 10 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Constants 5 4 Constants Constants are place holders and based on the data types described in the Section 5 2 The DCO data types and their value ranges Constants always remain the same throughout a project They can be used any number of times at any place within the project and their values can easily be edited at a central level in the OScAR Pro Customized Operator When using a Constant in the subsequent course of the DCO script its name is output between characters In the subsequent execution of the DCO script the Constant is automatically substituted in the script with its assigned values Example You can for example define a specific color for a specific type of Button as a Constant and subsequently assign this Constant as text color to other Buttons If you want to change the color of the Buttons of this type later you do not need to edit each of these Buttons individually but can change the color of the Constant centrally instead 5 4 1 The attributes of Constants Constants can have the
259. s of their respective holders Contents Contents 1 Conventions and Operating InstructionS 0000 cece eee eee 1 1 1 1 Reference manuals ot nt aee Sheet te eke eR eee eee ear es Oe Merk e 1 2 1 2 Notations and SYMDOIS 3 ob mt ke 8 du Oe ent ee wk a ew om Dia cee Ade oh il 1 3 1 3 Privacy and data security ric cad taidale Vee hie Ye ok Se tle cee Rae ene 1 4 2 OVGIVIGW osd ein eet wk cee eee ba PERE VERON ee eee be de swe eee ee des 2 1 2 1 Description of functions dw d Soon cets be wie ta ar bine Se aoe arene ere ks a alate wee me te 2 2 2 2 Example application n oa Sai apts lng es ee alan ban SN whats Me amp eRe eee adi 2 2 2 3 Interactions of the DCO components 0 00 0 cece eee eee eens 2 4 2 4 The tasks of the OScAR Pro Customized Operator 0000 cee aee 2 5 2 5 The tasks Of the DCO Seript i cc hodw ae cote oe She Rhea tame Re eee eee nE 2 5 2 6 The tasks of the OScAR Pro TT Operator Tool 000 cece eee eae 2 6 3 Installation ec 2 lt tweens ecw g ee te beta dee wea et eia te kad fae eee aes 3 1 3 1 How to install the OpenScape Alarm Response Professional 3 2 3 2 Uninstall the OpenScape Alarm Response Professional 0005 3 6 4 Operating Instructions for the OScAR Pro Customized Operator 4 1 4 1 Start the OScAR Pro Customized Operator 000 cee eee ees 4 2 4 2 Layout of the interface of the OScAR Pro Customized Operator
260. scription Border style Drop down list to choose the style of the border surrounding the Static element Here you can e none if you do not want the Static element to have a bor der e simple if you want the Static element to be surrounded by a simple black line Border width Editable combobox to define the width of the Frame around the Static element in pixels Here you can e enter an integer or e assign a Constant Parameter or Variable of the data type int Border color Editable combobox to define the color of the Frame around the Static element Here you can e enter a color value e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors or e assign a Constant Parameter or Variable of the data type color The color of the border around the Static element can be changed during the execution of the DCO Script for e Static elements with the command The Instruction SetStaticBorderColor e Static elements placed on a Button with the command The Instruction SetButtonStaticBorderColor Table 5 49 Special attributes of Static elements 07 2010 5 62 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Controls The child nodes of Static elements Static elements have the following child nodes Attribute Description Image This node is used to administrate the attributes of the image of the Static ele
261. see Section 5 11 7 The Instruction Call For a detailed description of the attributes of Functions please see the Section 5 10 Functions Table 5 35 The child nodes of the node Frames 07 2010 OScAR Pro Customized Operator User Manual 5 35 The Elements of a DCO Script Frames 5 8 2 Add a new Frame Follow the below instructions to create a new Frame No Task Go to the tree view and select the node Frames 2 Now go to the menu bar and select Edit gt New This will open the below user window to add the new process Filter x Please name entry Name Main page i K Cancel 3 Assign a unique and recognizable nameto the new Frame 4 Finally click Ok to close the window The DCO Designer outputs the new Frame in the tree structure of the Structure window and there in the node Frames If necessary you can now edit the attributes of the new Frame Table 5 36 Add a new Frame 5 8 3 Edit the attributes of a Frame Follow the below instructions to edit the attributes of an already existing Frame No Task Go to the tree structure and open the node Frames Select the Frame that you want to edit To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value 4 If needed edit the Controls of the Frame see Section 5 9 Controls 5 If needed edit the OScAR Pro command
262. select proportional to align the image with the size of the Static element in keeping with the Static element s height width proportion or e select unproportional to align the image with the full scale of the Button irrespective of the actual height width proportion Table 5 146 The arguments of the Instruction SetStaticPictureScale 07 2010 OScAR Pro Customized Operator User Manual 5 175 The Elements of a DCO Script Instructions 5 11 79 The Instruction SetStaticRect Description Use this Function Instruction to edit the position and size of a Static element Arguments Arguments Description Static element Editable combobox to enter the Static element whose position and size you want to edit Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Links Editable combobox to define the left and upper top margin as Top well as the width and the height in pixels Here you can Width e enter a numeric value Height e assign a Constant Parameter or Variable of the data type int or e assign a reference to a Control that has the data type int Table 5 147 The arguments 5 176 of the Instruction SetStaticRect 07 2010 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 80 The Instruction SetStaticStatus Description Use this
263. struction SetEditStatus 5 154 The arguments of the Instruction SetEditText 5 155 The arguments of the Instruction SetEditTextColor 5 156 The arguments of the Instruction SetEditTextColorBlink 5 157 The arguments of the Instruction SetEditToVariable 5 159 The arguments of the Instruction SetFrameColor 5 160 The arguments of the Instruction SetListBoxBackColor 5 161 The arguments of the Instruction SetListBoxBlinkTime 5 162 The arguments of the Instruction SetListBoxltemBlink 5 163 The arguments of the Instruction SetListBoxltemColor 5 164 The arguments of the Instruction SetListBoxList 5 165 The arguments of the Instruction SetListBoxRect 5 166 The arguments of the Instruction SetListBoxSelectionToVariable 5 167 The arguments of the Instruction SetListBoxStatus 5 168 The arguments of the Instruction SetListBoxTextColor 5 169 The arguments of the Instruction SetListBoxToVariable 5 170 The arguments of the Instruction SetStaticBackColor 5 171 The arguments of the Instruction SetStaticBorderColor 5 172 The arguments of the Instruction SetStaticPictureName 5 173 The arguments of the Instruction SetStaticPicturePos 5 174 The arguments of the Instruction SetStaticPictureS
264. t 0 a na auauua aeaa ee 5 176 5 11 80 The Instruction SetStaticStatus 0 0 0 0 ce ee 5 177 5 11 81 The Instruction SetStaticText 0 ee 5 178 5 11 82 The Instruction SetStaticTextColor 0 ee 5 179 5 11 83 The Instruction SetStaticTextPosition 0 0 0 0 0000 00 ce eee 5 180 5 11 84 The Instruction SetVariable 0 0 00 cc ee 5 181 5 11 85 The Instruction StartProgram scx Sees sence cee hy ce teale setae be 5 182 6 The planning and implementation of a DCO Project 20 220eeeeeee 6 1 6 T The CaSe Study PlrojeCls ft eee eta rade ta es gee ested tae eee 6 4 6 1 1 Case study requirements 24 ss caw Cine ey tees bee a 6 4 6 1 2 Case study plant Mapes ecu snedew shun ae So eee needs vad Sewers chee sees 2 6 5 6 1 3 Objects administrated in OSCAR Pro 00000 ee 6 6 6 1 4 How to implement the case study 00000 es 6 7 6 2 Projectadministrati n sate dtd oes tee dene aoa te trees wa nan dee 6 10 6 2 1 Create the Project ne trae Od mai ite a eRe eeu ae een ee au 6 10 6 2 2 Open an existing project c 2 2a Rate ob k ee ete a eeE Rae eer ane ee ons 6 11 6 3 Create Frames and Controls isa osu Rr eon enw Wise bye ra veld Rn ee ae ede bed 6 12 6 3 1 Create and customize the Frames 0 cece ee es 6 12 6 3 2 Add a background image to the Main page ee eee eee 6 14 6 3 3 Add visual separators to the Main page 0000 eee eee eee 6 15 6 3
265. t Background screen Edit field Button Image 4 3 Image of the Layout window with example The frame that is output in the layout window depends on the entry you select in the tree struc ture If for example the Layout window is open and you select an entry in the tree structure next to the node Frames the Layout window will output the Frame that was marked last 07 2010 4 16 OScAR Pro Customized Operator User Manual Operating Instructions for the OScAR Pro Customized Operator Setup and application of the Layout window 4 4 1 Toolbar and Controls The toolbar is usually located at the right hand side of your screen If you want it to float freely above your window or anchor at any of the other three sides of your screen simply make a mouse click on the upper end of the toolbar keep the mouse key pressed and drag it to the new position The actual Frame area is located on the gray background screen of the Layout window It is within the dimensions of this area that you can place Controls By definition Controls are elements that represent a something further and or enable you to actually realize the functions of your interface The Layout window includes the following Controls Control Description Static element A Static element serves to place graphics giving information as well as texts on your interface Edit field An Edit field enables the later user Operator to enter alpha nu meric and o
266. t Bak ne gt Cancel To change the installation path click Path in the corresponding option and select the new path in the window that opens next Now click Next ie DAKS Customized Operator InstallShield Wizard xj Destination Folder Click Next to install to this Folder or click Change to install to a different Folder W Z3 Install DAKS Customized Operator to c itetronik Dco Designer Change Installshield Cancel Table 3 1 How to install the OScAR Pro Customized Operator 07 2010 OScAR Pro Customized Operator User Manual Installation How to install the OpenScape Alarm Response Professional No Task Window 8 Click Install to install the OpenScape Alarm ji DAKS Customized Operator InstallShield Wizard Response Professional on your PC Ready to Install the Program The wizard is ready to begin installation The software is now installed in the directory cicinstatiobean the instalation you selected The progress of the installation 1 o Ren io rea ot ete 7 ok rar aaao ktos cat PakEo is visualized with a blue progress bar Now click Install Installshield 9 The software is now installed in the selected directory Installing DAKS Customized Operator The program features you selected are being installed Please wait while the InstallShield Wizard installs DAKS Customized Operator This may take several m
267. t of the final interface In the next step compare the project you have just created with the below screenshots Screenshot of the Structure window 1 Structure EXP Chemical Industries Inc dco ol x EXP Chemical Industries Inc a Attribute Yale Cid E Constants 5 Controls tale DAKS command templates Variables E Lists 500 5 Frames 1024 E m Announcement selection Controls 1280 E Announcement list HFFFFFF Cancel Main page RY Dialog title ok 5 DAKS command templates E Functions HEMain page J Controls AdminTechnics Deflagration Event Event name Event title B Fire alert RY Horizonzal line B Invoke Leakage Management RY Map of plant B More Note text Note title Production 1 Production 2 E Short circuit Vertical line 5 DAKS command templates E Functions EF A A H A Image 6 2 Screenshot of the Structure window 07 2010 6 26 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create Frames and Controls Screenshot of the Main page Production 1 a Admin amp Technics 4 Map of Plant EXP Chemical Industries Inc i Select event Plant Anywhere 2 Select area Legend B Invoke ww m Fire department Management mm Security services Management m Administration amp
268. tatus Description Use this Function Instruction to edit the way in which a Static element on a Button is output and used Arguments Arguments Description Button Editable combobox to choose the Button whose Static element you want to edit with regard to the way in which it is output and used Here you can e enter the name of the Button direct or e select a Button from the list of all available Buttons Static element Editable combobox to choose the Static element of the select ed Button that you want to edit with regard to the way in which it is output and used Here you can e enter the name of the Static element direct or e select a Static element from the list of all Static elements that are available Status Drop down list to define way in which the Button s Static ele ment is output and used Here you can e choose 0 to hide the Static element e choose 1 to show the Static element and enable entries e choose 2 to output the Static element but block all entries e assign a Constant Parameter or Variable of the data type uint or e assign the reference to a Control that has the data type uint Table 5 103 The arguments of the Instruction SetButtonStaticStatus 07 2010 5 130 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 36 The Instruction SetButtonStaticText Description Use this Function Instruction to edit the text of a Static element on a Butt
269. tents Name Delete Condition Fire alert blinking Messagebox Instructions Instruction Arguments Contents The Instruction Call Function Reset events The Instruction Call Function Blink Buttons 07 2010 OScAR Pro Customized Operator User Manual 6 47 The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 21 2 The Function Set Description Use this Function to set the flag that governs the blinking of the Button Attributes Attribute Contents Name Set Condition Fire alert blinking Messagebox Instructions Instruction Arguments Contents The Instruction Call Function Reset events The Instruction SetVari Variable Fire alert blinking able Value 1 The Instruction SetVari Variable Selected message able Value 1000 The Instruction SetVari Variable Selected event able Value 1000 Fire alert The Instruction Call Function Blink Buttons Note Please note that at this position the Variable Selected message is directly given the ID 1000 If for any reason the ID of the fire alert announcement is changed in OScAR Pro it must be adjusted accordingly in all related areas of the DCO Script For this reason we recommend you use a Parameter see Button Leakage or at least of a Constant see Button Deflagration instead 07 2010 6 48 OScAR Pro Customiz
270. ter if available see Section 5 7 Lists Arguments Arguments Description Data list Editable combobox to specify the Data list to which you want to add the obtained announcement details Here you can e enter the name of the Data list direct or e select a Data list from the list of all available Data lists of the data type msg_id Filter Editable combobox to define the Filter that is used to limit the received announcements Here you can e enter the name of the Filter direct or e select a Filter of the type MSG from the list of all available Filters Table 5 84 The arguments of the Instruction GetWessages Note To output the List of all announcements received with this command place a List or Combobox in the Frame and fill either or both with the command The Instruction SetListBoxList and the aforementioned Data list 07 2010 5 112 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 17 The Instruction GetScenarios Description Use this Instruction to invoke a list of all DAKS TT Administrator Tooladministrated scenarios and fill the Data list with the obtained entries Please note that the Data list is automatically cleared before it is filled with the new entries In this process the system will if available apply the specified Filter see Section 5 7 Lists Note The List invoked with this Instruction only contains scenarios for which t
271. the command The Instruction SetE ditRect e Buttons with the command The Instruction SetButton Rect e Static elements placed on a Button with the command The Instruction SetButtonStaticRect e Checkboxes with the command The Instruction Set CheckBoxRect e Listboxes with the command The Instruction SetList BoxRect e Comboboxes with the command The Instruction Set ComboBoxRect Table 5 48 Attributes shared by all Controls 07 2010 OScAR Pro Customized Operator User Manual 5 59 The Elements of a DCO Script Controls Attribute Description Background color Editable combobox to define the background color for a Con trol Here you can enter a color value click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors or assign a Constant Parameter or Variable of the data type color The background color can be edited during the execution of the DCO Script for Static elements with the command The Instruction SetStaticBackColor Edit fields with the command The Instructions SetEdit BackColor Buttons with the command The Instruction SetButton Color Static elements placed on a Button with the command The Instruction SetButtonStaticBackColor Checkboxes with the command The Instruction SetCheckBoxBackColor Listboxes with the command The Instruction SetList BoxBackColor Combo
272. the mathematical rule first multiplication and division then addition and subtraction List of logical operations in Formulas Logical opera Effect on Effect on tion numeric elements text elements Adds the two integers Connects two texts or ADD Subtracts the second integer no function or from the first SUB Multiplies the two integers with no function or each other MUL Table 5 3 List of logical operations in Formulas 07 2010 OScAR Pro Customized Operator User Manual 5 9 The Elements of a DCO Script Formulas Logical opera tion Effect on numeric elements Effect on text elements Divides the first integer by the no function or second DIV amp Equals 1 if both integers are 1 no function or Equals 0 if at least one of the AND two integers is 0 Equals 1 if at least one of the no function or two integers is 1 OR Equals 0 if both integers are 0 Equals 1 if the two integers are Equals 1 if the two texts are identical or 0 if or identical or O if the integers are the texts are different EQL different l Equals 1 if the two integers dif Equals 1 if the two texts are different or 0 if or ferent or 0 if the integers are the texts are identical UEQ identical gt Equals 1 if the first integer is no function or greater than the second or 0 if GT not gt Equals 1 if the first integer i
273. the tool Combobox Use this tool to place a new Ctrl 7 drop down Combobox in the current Frame Ea BE a Pop up menu Align gt Left Left aligns the selected objects with the main selected object Ctrl Arrow left Right Right aligns the selected objects with the main selected ob Ctrl Arrow right ject Top Aligns several selected objects with the upper border line of Ctrl Arrow up the main selected object Bottom Aligns the selected objects with the bottom border line of the Ctrl Arrow down main selected object Horiz center Centers the selected objects with the horizontal center line of Ctr1l Z the main selected object Vert center Centers the selected objects with the vertical center line of the Ctrl V main selected object Pop up menu Space evenly gt Across Arranges all selected objects evenly and horizontally between Alt Arrow right the outer left and the outer right selected object Down Arranges all selected objects evenly between the highest and Alt Arrow up lowest selected object Pop up menu Make same size Width Matches the width of all selected objects to the width of the Ctrl B main selected object Height Matches the height of all selected objects to the height of the Ctrl H main selected object Both Matches the height and width of all selected objects to the Ctrl G height and width of the main selected object Pop up menu Frame size u
274. tic element of the pertinent Button If necessary you can now edit the attributes of the Static element see Section 5 9 4 Child nodes and special attributes of Static elements Table 5 58 Add a new Function to a Button 07 2010 OScAR Pro Customized Operator User Manual 5 75 The Elements of a DCO Script Controls 5 9 10 Edit the attributes of the Static elements of a Button Follow the below instructions to edit the attributes of an existing Static element of a Button No Task Go to the tree structure and open the node Frames Open the parent Frame of the Button whose Static element you want to edit Now open the child node Controls Open the Button whose Static element you want to edit Click the child node Static elements Select the Static element whose attributes you want to edit To edit the attributes go to the list view and doubleclick the relevant item listed in the column Value see Section 5 9 4 Child nodes and special attributes of Static ele ments mae sal ccd lta Peace aca eo Table 5 59 Edit the attributes of the Static elements of a Button 07 2010 5 76 OScAR Pro Customized Operator User Manual 5 9 11 The Elements of a DCO Script Controls Special attributes of Checkboxes Checkboxes have the following additional attributes Attribute Description Font Field indicating the font currently used for the title o
275. tion Data elements This child node can carry a whole List of data elements that are output in form of entries when the superimposed Data list is assigned to a Listbox Table 5 15 The child nodes of the node Data lists 07 2010 5 20 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Lists The attributes of data elements Data elements have the following attributes Attribute Description Displayed text Edit field to enter the text with which the data element is output in a Listbox or Combobox Value Editable combobox to specify the initial value of the data ele ment in keeping with the pertinent Data list type Here you can e either enter the value of the data element directly e oruse the selection field and assign a Constant Parame ter or Variable Color Editable combobox to specify the color in which the entry shall be rendered in a Listbox entry ignored in Comboboxes Here you can e enter a color value e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors or e assign a Constant Parameter or Variable of the data type color Table 5 16 07 2010 OScAR Pro Customized Operator User Manual Attributes of data elements 5 21 The Elements of a DCO Script Lists 5 7 2 Add a new Data list Follow the below instructions to create a new Data list No Task Go to the tree view a
276. tion GotoF Frame Announcement selection rame 07 2010 OScAR Pro Customized Operator User Manual 6 55 The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 26 The Functions of the Button Management The Functions underneath the Button Management are automatically invoked when this But ton is pressed 6 5 26 1 The Function Delete Description Use this Function to reset the flag that governs the blinking of the Button Attributes Attribute Contents Name Delete Condition Management blinking Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable Management blinking able Value 0 The Instruction Call Function Blink Buttons 6 5 26 2 The Function Set Description Use this Function to set the flag that governs the blinking of the Button Attributes Attribute Contents Name Set Condition Management blinking Messagebox Instructions Instruction Arguments Contents The Instruction SetVari Variable Management blinking able Value 1 The Instruction Call Function Blink Buttons 07 2010 6 56 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the Functions of the Main page 6 5 27 The Functions of the Button AdminTechnics The Functions underneath the Button Admin
277. tions for the OScAR Pro Customized Operator General user dialog windows 4 6 5 Edit colors Use the window Colors to define the background and foreground color for the different Control elements of a Frame Follow the below instructions to edit the color table No Task Start the DCO Designer 2 in the tree of the structure window open the attributes of the relevant control and dou bleclick Text color in the list view This will activate a drop down combobox Unfold the combobox and click Select color The window Color will open 3 Select the color you want to use see below 4 Click OK to save your changes Table 4 9 Add new font Summary of the fields in the window Color Input field Description Color Basic colors Custom colors 11 SEE 1 MEANN 7 788880 Hue jo Red 255 Sat 240 Green fo ColorlS olid Lum fi 20 Blue fo Cancel Add to Custom Colors Basic colors Table with the basic colors that are available in Windows To choose a color from this table simply make a left mouse click on the wanted color box Custom colors Table with the customized colors you have defined so far To choose a color from this table simply make a left mouse click on the wanted color box ColorlSolid Window with a sample of the color you are currently editing E Ee na na Ea Define Custom Colors gt gt Summary of the
278. tributes Attribute Description Name Edit field to enter the name of the Filter Type Combobox to specify the type of the Filter Here you can e BDC to invoke a list of all broadcasts administered in the database with the command The Instruction GetBroad casts e CON to invoke a list of all conferences administered in the database with the command The Instruction GetConfer ences e ITL to invoke a list of all info telephone profiles adminis tered in the database with the command The Instruction Getlnfotelephones e MSG to invoke a list of all announcements administered in the database with the command The Instruction Get Messages or e SCN to invoke a list of all scenarios administered in the database with the command The Instruction GetScenar ios Subtype This attribute is only visible for the Filter type MSG Here you can e ALL to invoke a list of all announcements logical and physical administered in the database e PHYSICAL to invoke a list of all physical announcements administered in the database or e LOGICAL to invoke a list of all logical announcements ad ministered in the database Table 5 21 The attributes of Filters 07 2010 5 24 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Lists The child nodes of the node Filters Each Filters node has the following child nodes Child node Description ID ranges This child node
279. trict the way in which Data lists are filled via the OScAR Pro TT Operator Tool Contrary to the Filters of Lists it is only active processes that are considered here For all other types Data elements This child node can contain a list of data elements that are out put in the Listbox itself as entries For a detailed description of the attributes of the data ele ments please see the Section 5 7 1 The attributes and child nodes of the node Data lists Table 5 62 The child nodes of Listboxes 07 2010 OScAR Pro Customized Operator User Manual 5 81 The Elements of a DCO Script Controls The attributes of Process filters Child node Description Name Edit field to enter the name of the process Filter Select aname that is recognizable and unique in this list Type Combobox to specify what types of active process are select ed Here you can e PROCESS_BDC to filter all active broadcasts e PROCESS_BDCMBR to filter all subscribers of an active broadcast e PROCESS_CON to filter all active conferences e PROCESS_CONMBR to filter all subscribers of an active conference e PROCESS _IT to fitter the info telephone profile that is currently active The filter options of the attribute State change in correlation with the type that is selected here Table 5 63 Attributes of Process filters 07 2010 5 82 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Contr
280. trol and restrict the filling of Data lists via the OScAR Pro TT Operator Tool For this purpose it is only the so called IDs that can be used in Filters Assign these IDs to broadcast and conference groups scenarios info telephone profiles and announcements via the DAKS TT Administrator Tool You can use Filters for the following Instructions see Section 5 11 Instructions e The Instruction GetMessages Fills a Data list with the administrated announce ments e The Instruction GetBroadcasts Fills a Data list with the administrated broadcasts e The Instruction GetConferences Fills a Data list with the administrated conferences e The Instruction GetScenarios Fills a Data list with the administrated scenarios e The Instruction GetInfotelephones Fills a Data list with the administrated info tele phone profiles 07 2010 OScAR Pro Customized Operator User Manual 5 19 The Elements of a DCO Script Lists 5 7 1 The attributes and child nodes of the node Data lists The attributes of Data lists Data lists have the following attributes Attribute Description Name Edit field to enter the name for the Data list Select a name that is recognizable and unique among the Data lists Type Combobox to specify the type of the Data list see Section 5 2 The DCO data types and their value ranges Table 5 14 Attributes of Data lists The child nodes of the node Data lists Child node Descrip
281. type Description Administrated msg_id Data list to accept the emergency messages administrated in OS emergency cAR Pro messages Table 6 15 Create Data lists Create the Filter Create the below listed Filter see Section 5 7 7 Add a new Filter Name Data type IDs Description Emergency msg_id ID ranges Info field for the event that is currently selected message Filter e from 0000 e to 1999 Excluded IDs 1000 1001 1002 1003 Table 6 16 Create the Filter 07 2010 6 32 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project Create the global objects 6 4 5 Create the OScAR Pro command template Invoke broadcast In order to launch broadcasts on the basis of the selected events and company areas you need a so called OScAR Pro command template see Add a new OScAR Pro command template Description It is this command template that invokes the broadcast in keeping with the two Variables Selected message and Selected broadcast Attributes Attribute Contents Name Invoke broadcast Type BDC Display text Dialing subscribers Cornet N Q features Monitor subscriber state High priority broadcast OnMin OnMax olojololoj gt Broadcast IDs Broadcast IDs Selected broadcast Announcement IDs Announcement IDs Selected message 07 2010 OScAR
282. uction 2 6 5 20 On_Load Function Set Buttons 6 5 21 The Functions of the Button Fire alert 6 5 21 1 The Function Delete 6 5 21 2 The Function Set 6 5 22 The Functions of the Button Deflagration 6 5 22 1 The Function Delete 6 5 22 2 The Function Set 6 5 23 The Functions of the Button Leakage 6 5 23 1 The Function Delete 6 5 23 2 The Function Set 6 5 24 The Functions of the Button Short circuit 6 5 24 1 The Function Delete 6 5 24 2 The Function Set 6 5 25 The Functions of the Button More Open announcement selection 6 5 26 The Functions of the Button Management 6 5 26 1 The Function Delete 6 5 26 2 The Function Set 6 5 27 The Functions of the Button AdminTechnics 6 5 27 1 The Function Delete 6 5 27 2 The Function Set 6 5 28 The Functions of the Button Production 1 6 5 28 1 The Function Delete 6 5 28 2 The Function Set 6 5 29 The Functions of the Button Production 2 6 5 29 1 The Function Delete 6 5 29 2 The Function Set 6 5 30 The Functions of the Button Invoke Invoke broadcast 07 2010 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project 6 6 Create the Functions of the Frame Announcement selection 6 6 1 The User Function On cancel 6 6 2 On_Load Functions Fill announcement list 6 6 3 The Functions of the Button Cancel Cancel dialog 6 6 4 The Functions of the Button Ok 6 6 4 1 The Function With selection
283. uctions 5 11 57 The Instruction SetEditRect Description Use this Function Instruction to change the position and size of an Edit field Arguments Arguments Description Edit field Editable combobox to specify the Edit field whose position and size you want to edit Here you can e enter the name of an Edit field direct or e select an Edit field from the list of all Edit fields that are available Links Editable combobox to define the left and upper top margin as Top well as the width and the height in pixels Here you can Width e enter a numeric value Height e assign a Constant Parameter or Variable of the data type int or e assign a reference to a Control that has the data type int Table 5 125 The arguments of the Instruction SetEditRect 07 2010 OScAR Pro Customized Operator User Manual 5 153 The Elements of a DCO Script Instructions 5 11 58 The Instruction SetEditStatus Description Use this Function Instruction to edit the way in which an Edit field is output and used Arguments Arguments Description Edit field Editable combobox to specify the Edit field you want to edit with regard to the way in which it is output and used Here you can e enter the name of an Edit field direct or e select an Edit field from the list of all Edit fields that are available Status Editable combobox to specify the way in which the selected Edit field is output and used Here you can e choose 0 to hide the
284. ucture window 4 4 Setup and application of the Layout window 4 4 1 Toolbar and Controls 4 4 2 Mark a Frame area or a Control 4 4 3 Move Controls 4 4 4 Change the size of Frames and Controls 4 4 5 Align and space elements automatically 4 5 Setup and application of the Preview window 4 6 General user dialog windows 4 6 1 Edit project properties 4 6 2 Administration of the Image lists 4 6 3 Process colors and Standard colors for process lists 4 6 4 Edit fonts 4 6 5 Edit colors 07 2010 OScAR Pro Customized Operator User Manual 4 1 Operating Instructions for the OScAR Pro Customized Operator Start the OScAR Pro Customized Operator 4 1 Start the OScAR Pro Customized Operator Follow the below instructions to start the OScAR Pro Customized Operator No Task 1 Click start and open the menu tetronik listed under programs 2 Next click the menu item OScAR Pro Customized Operator 3 This will open the main window of the OScAR Pro Customized Operator Table 4 1 Start the OScAR Pro Customized Operator 07 2010 4 2 OScAR Pro Customized Operator User Manual Operating Instructions for the OScAR Pro Customized Operator Layout of the interface of the OScAR Pro Customized Operator 4 2 Layout of the interface of the OScAR Pro Customized Operator After you have started the OScAR Pro Customized Operator and created a new or opened a previous project the below window will pop up here
285. up to select the image file s that you want to add to your image list Remove images Use this button to delete the marked image s from the image list Summary of the fields in the window Project image list 07 2010 OScAR Pro Customized Operator User Manual 4 25 Operating Instructions for the OScAR Pro Customized Operator General user dialog windows 4 6 3 Process colors and Standard colors for process lists With the window Standard colors for process lists you can define the colors you want to use in new projects to signal the different process states However please bear in mind that the col ors selected at this level are exclusively used for visual outputs within Controls of the type List box Use the Listbox property Process colors to customize the process colors for each Listbox in dividually see Section 5 9 12 Child nodes and special attributes of Listboxes Follow the below instructions to customize standard colors for process lists No Task Start the DCO Designer 2 Go to the menu bar and click Options gt Standard colors This will open the window Standard colors for process lists 3 To change a color simply doubleclick the box with its sample next to the entry you want to edit see below This will open the window Color seeSection 4 6 5 Edit colors in which you can se lect the preferred new color 4 Click OK to save your changes
286. ustomized Operator User Manual No Task References 1 Goto the tree view of the Structure Window and open the node Frames 2 Now open the node Main page under the parent node Frames still in the tree view of the Structure window 3 Now add anew Static element with the following at 5 8 4 Add a new Control through tribute values the Structure window e Name Horizontal Line e Left 0 e Top 80 e Width 1080 e Height 2 e Border style simple e Border width 1 e Border color FF6800 4 Now add a new Static element with the following at 5 8 4 Add a new Control through tribute values the Structure window e Name Vertical line e Left 1080 e Top 80 e Width 2 e Height 944 e Border style simple e Border width 1 e Border color FF6800 5 Finally click fj to save the project 6 Next click E to switch to the Layout window and ver ify the result Table 6 6 Insert separator lines 07 2010 The planning and implementation of a DCO Project Create Frames and Controls 6 3 4 Add Captions to the Main page This section shows you how to place Buttons to the plant map that are used to select the event announcements To make this especially user friendly for the operator you will also add a cor responding caption Follow the below instructions to create the caption Events through the Layout window No Task References 1 Goto the tree view of the Structure Window an
287. utput parameters of the Process windows in the OScAR Pro TT Operator Tool Please note that this feature only applies to the OScAR Pro command templates that are stored in the Frame that is also the parent Frame of the Instruction you are currently editing Arguments Arguments Description OScAR Pro command tem __ Editable combobox to specify the OScAR Pro command tem plate plate that shall be executed Here you can e enter the name of the OScAR Pro command template di rect or e selecta OScAR Pro command template from the list of all available OScAR Pro command templates Table 5 78 The arguments of the Instruction Execute 07 2010 5 106 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 11 The Instruction GetBroadcasts Description Use this Instruction to invoke a list of all DAKS TT Administrator Tooladministrated broadcasts and fill the Data list with the obtained entries Please note that the Data list is automatically cleared before it is filled with the new entries In this process the system will apply if available the Filter that was specified see Section 5 7 Lists Note The List invoked with this Instruction only contains broadcasts for which the field ID to trigger via telephone was enabled Arguments Arguments Description Data list Editable combobox to define the Data list to which you want to add the obtained broadcast data
288. w go to the menu bar and select Edit gt New This will open the following user window to edit the selected Instruction E Function instructions d m Instruction SetButtonBlink m Arguments x Cancel Button Fire alert x 1 Blink color 2E Blink color z 2 Blink color 2E Background color x Blink interval xxB link interyal Start blinking of a button 10 Select the Instruction you want to add and choose arguments for it 11 Finally click Ok to close the window The DCO Designer outputs the newly added Instruction in the child node Instructions of the pertinent parent Function Table 5 71 Add a new Instruction to a Function 5 11 4 Edit Instructions Follow the below instructions to edit an existing Instruction in a Function No Task 1 Go to the tree structure and open the node Frames 2 Open the parent Frame of the Function to which you want to add a new Instruction Table 5 72 Edit an Instruction of a Function 07 2010 OScAR Pro Customized Operator User Manual 5 99 The Elements of a DCO Script Instructions No Task 3 Open e either the node Functions and continue with step 4 e or the node Controls and continue with step 5 4 Open e either the child node On_Load
289. wait for the completion of the selected program Here you can e choose 0 if you do not want to wait for the program end e choose 1 if you want to wait for the program end or e assign a Constant Parameter or Variable of the data type bool Table 5 153 The arguments of the Instruction StartProgram Note If you want to write e mails from within your DCO Script all you need to do is create a new But ton and assign a Function with this Function Instruction to it Then simply enter mailto lt E Mail Address gt g mailto my admin my company de in the argument Executable program In the same way you can also open a PDF file by entering the full path of the file in the argument Executable program e g my server iso9001 standardoperatingprocedure alarms alarmcalls pdf 07 2010 5 182 OScAR Pro Customized Operator User Manual The planning and implementation of a DCO Project 6 The planning and implementation of a DCO Project Overview The instructions in this chapter show you how to plan and realize a DCO project The chapter also includes a case study and a tutorial to guide you through the first steps of creating a DCO Script Contents The chapter covers the following sections 6 1 The case study project 6 1 1 Case study requirements 6 1 2 Case study plant map 6 1 3 Objects administrated in OScAR Pro 6 1 4 How to implement the case study 6 2 Project administration 6 2 1 Create the project 6
290. want to remove DAKS Customized Operator from your computer Table 3 2 Uninstall the OScAR Pro Customized Operator 07 2010 OScAR Pro Customized Operator User Manual Installation Uninstall the OpenScape Alarm Response Professional No Task Window 5 The software is now uninstalled Daks Customized Operator sa Please wait while Windows configures DAKS Customized Operator Gathering required information SERREEREORERRROREE Table 3 2 Uninstall the OScAR Pro Customized Operator 07 2010 OScAR Pro Customized Operator User Manual 3 7 Installation Uninstall the OpenScape Alarm Response Professional 07 2010 3 8 OScAR Pro Customized Operator User Manual Operating Instructions for the OScAR Pro Customized Operator 4 Operating Instructions for the OScAR Pro Customized Operator Overview This chapter gives you general operation instructions for the OScAR Pro Customized Operator It also covers the special functions of the system Contents The chapter covers the following areas 4 1 Start the OScAR Pro Customized Operator 4 2 Layout of the interface of the OScAR Pro Customized Operator 4 2 1 The menu bar 4 2 2 The toolbar 4 2 3 Description of the menu commands and the buttons of the OScAR Pro Customized Operator 4 2 4 Functions of the mouse 4 2 5 The status bar 4 3 Setup and application of the Structure window 4 3 1 The tree structure of the Structure window 4 3 2 The list view of the Str
291. which the selected Listbox is output and used Here you can e choose 0 to hide the Listbox e choose 1 to show the Listbox and enable entries e choose 2 to output the Listbox but block all entries e assign a Constant Parameter or Variable of the data type uint or e assign the reference to a Control that has the data type uint Table 5 139 The arguments of the Instruction SetListBoxStatus 07 2010 5 168 OScAR Pro Customized Operator User Manual The Elements of a DCO Script Instructions 5 11 72 The Instruction SetListBoxTextColor Description Use this Function Instruction to set the text color of the elements of a Listbox to the color values of a correlating Data list Arguments Arguments Description Listbox Editable combobox to specify the Listbox whose elements you want to give an individual text color Here you can e enter the name of the Listbox direct or e select a Listbox from the list of all available Listboxes Data list Editable combobox to specify the Data list that shall be used to determine the individual text colors of the elements of the se lected Listbox Here you can e enter the name of the Data list direct or e select a Data list from the list of all available Data lists Table 5 140 The arguments of the Instruction SetListBoxTextColor 07 2010 OScAR Pro Customized Operator User Manual 5 169 The Elements of a DCO Script Instructions 5 11 73 The Instruct
292. with the data elements of the Data list Here you can e enter the name of the Listbox direct or e select a Listbox from the list of all available Listboxes Data list Editable combobox to specify the Data list that shall be used to fill the Listbox Here you can e enter the name of the Data list direct or e select a Data list from the list of all available Data lists Table 5 136 The arguments of the Instruction SetListBoxList 07 2010 OScAR Pro Customized Operator User Manual 5 165 The Elements of a DCO Script Instructions 5 11 69 Description The Instruction SetListBoxRect Use this Function Instruction to change the position and size of a Listbox Arguments Arguments Description Listbox Editable combobox to define the Listbox whose position and size you want to edit Here you can e enter the name of the Listbox direct or e select a Listbox from the list of all available Listboxes Links Editable combobox to define the left and upper top margin as Top well as the width and the height in pixels Here you can Width e enter a numeric value Height e assign a Constant Parameter or Variable of the data type int or e assign a reference to a Control that has the data type int Table 5 137 The arguments of the Instruction SetListBoxRect 07 2010 5 166 OScAR Pro Customized Operator User Manual 5 11 70 Description The Elements of a DCO Script Instructions The Instruction SetList
293. x Arguments Arguments Description Combobox Editable combobox to specify the Combobox whose back ground color you want to edit Here you can e enter the name of the Combobox direct or e select a Combobox from the list of all available Combob Oxes Color Editable combobox to choose the background color for the se lected Combobox Here you can e enteracolor value see Section 5 2 The DCO data types and their value ranges e click Select color and use the next user window to choose a color see Section 4 6 5 Edit colors e assign a Constant Parameter or Variable of the data type color or e assign a reference to a Control that has the data type col or Table 5 117 The arguments of the Instruction SetComboBoxBackColor 07 2010 5 144 OScAR Pro Customized Operator User Manual 5 11 50 Description The Elements of a DCO Script Instructions The Instruction SetComboBoxList Use this Function Instruction to fill a Combobox with the elements of a Data list Please note that to do so the Data list and the Combobox must have the same data type see Section 5 2 The DCO data types and their value ranges Arguments Arguments Description Combobox Editable combobox to specify the Combobox that you want to fill with the data elements of the Data list Here you can e enter the name of the Combobox direct or e select a Combobox from the list of all available Combob oxes

Siemens A31003-51730-U103-7619 User's Manual

Contents

Download Pdf Manuals

Related Search

Related Contents