7 Each command has to be setted up. Eficas generates a data entry form.
8 This form varies dynamicaly, depending on the context : rules and already existing values.
10 This widget appears by selecting (clicking) on a command (first level in the tree view).
12 .. image:: images/DoubleFleche.png
15 You can navigate from command to command using the arrows buttons:
21 this widget is divided vertically into three separate areas :
24 - the optional keywords.
26 When needed, views provide scrollbar so that the entire information can be viewed.
28 A bottom widget provides a horizontal bar for presenting documentation as the status bar is used to display error or warning messages.
30 .. image:: images/Main.png
39 Eficas uses many different widgets in order to help you to choose values :
41 - Line editors for simple values
44 - Group boxes of button
46 see :ref:`features-label` to know more about each widget.
49 .. image:: images/Erreur.png
51 Eficas does not let you enter invalid values. It checks the type and the cardinality of the value.
52 It ensures that the value is in the value domain or proposes a set of discrete values.
53 Data entered is checked against a set of rules. Errors are displayed in red to draw attention.
56 Form construction is dynamic
57 ----------------------------
59 The form is updated according to values. It asks for the field depending on what's selected.
63 - if value of 'Initial_Conditions' is 'Zero Elevation', no additional data is needed
65 .. image:: images/Zero.png
68 - if value of 'Initial_Conditions' is 'TPXO satellite altimetry', you have to fill 'Ascii_Database_For_Tide'
70 .. image:: images/TPXO.png
73 Displaying optional keyword
74 ------------------------------
76 When you create a new command, the widget opens with the optional keywords of this command.
78 .. image:: images/OptionnelCommande.png
81 When entering in a "group keyword", the optional keywords list is updated to show optional keyword for this specific "group keyword".
83 .. image:: images/OptionnelCommande1.png
87 By clicking on command label ("INITIALIZATION") or on keyword label ("Input_files"), the corresponding optional keywords list is displayed.
89 Sometimes, when a user enters a value for a keyword, optional keywords are dependents on this value. Optional keywords list is updated.
90 This is the case for conditionnal keywords
92 .. image:: images/OptionnelParametersAdao.png
96 .. image:: images/OptionnelParametersAdao1.png
99 Adding/Deleting an optional keyword
100 ------------------------------------
102 Optional keywords (if any) are in the right part of the "command window". Just double-click on the checkbox to add the keyword.
103 The input data form is redisplayed and the list of possible optional keywords will be updated (for example, if two keywords cannot be simultaneously present).
105 .. image:: images/DblClickOnOptional.png
108 .. image:: images/Poubelle.png
110 To delete a keyword (or a command), just click the garbage icon :
116 The icon for a command may be one of three colors: green, yellow or red. These colors represent the status of the command and the color meanings is :
117 - red for unvalid command,
118 - green for valid command,
119 - yellow for commands which have to be named.
121 .. image:: images/NommerObjet.png
127 **Use tooltips to have information.**
129 - Tooltips on **labels** display **information about the keyword**. Double-click on the label to display this information in the comment area, at the bottom of the window. This is useful for long text. *(You also can double-click on the keyword in the tree dataset.)*
131 .. image:: images/ToolTipOnLabel.png
134 - Tooltips on **lineEdit** (one-line text editor) display **suggestion** for the input value. Suggestion are not very frequent. They are not default values, because you have to enter it explicitely.
136 .. image:: images/ToolTipOnLineEdit.png
139 - Tooltips on **Red point** display **information about the validity** for the keyword or for the group of keywords.
140 By double-clicking on the "red point" a window displaying the same information appears. It should be usefull if text
141 is too long to be read at one sitting.
143 .. image:: images/ToolTipOnRed.png
146 - Tooltips on **Commands Button** explain what the icon/button represents, and which action is activated by clicking.
148 .. image:: images/ToolTipOnButton.png
154 In the dataset tree, context menus (invoked by right-clicking) allow user to :
156 - create comments in the tree
158 - comment the command itself
161 .. image:: images/Menus.png
164 Some commands have associated scripts. They are easy to identify because the "run" icon is present :
166 .. image:: images/Roue.png
170 .. image:: images/Scripts.png