| Form Commands (ttadv3118s000) |  |
| use.session.to maintain form commands.
Fields | Description
ID | The form command's identification number.
Activate a | Select the type of component to be activated by the form command. The drop-down list contains these options: Session Function Business Method Menu
Session/Function/Business Method | The code of the session, function, or business method that the form command activates. Note The function or business method must be part of the session's program script, or DAL script respectively.
Parent (Menu) | To define a parent form command for your form command, enter the parent form command's ID. If you define a parent form command, your form command displays as a submenu item (horizontally) of the parent form command. Note The parent form command's Command Type must be Menu. The form command and the parent form command must belong to the same form. Form commands with the same parent display as a (vertically) cascading submenu. You cannot define a parent form command for a form command whose Command Type is Menu. That is, a Menu form command cannot display as a submenu item.
Sort Sequence | Determines the order in which Tools displays different form commands that have the same Command Type. Note Form commands with the same Command Type cannot have identical sequence numbers.
Command Type | Where the form command appears on the session's form. Allowed values: Possible Values
Group/Field Number | For form commands of Command Type: Group. From the Form Groups (ttadv3515m000) session, select the Group Id of the group to which the form command belongs. The form command only appears in the session's specific menu when the user selects the group's tab. Field. From the Form Fields (ttadv3506m000) session, select the Sequence Number of the field behind which the form command appears as a field button. Note Sessions can have multiple appearances of the same field, in which case the field has an entry in the Form Fields (ttadv3506m000) session for every appearance on the session's form. The sequence of the fields on the form is the same as the fields' order in the Form Fields (ttadv3506m000) session. If you define form command for a field that has multiple appearances on a form, make sure you have the correct sequence number of the field.
Category | The form command category used by the Infor Companion. The category determines the pull-down menu in which the command will be displayed. Allowed values
Action | The command is displayed in the session's Action menu.
Reference | The command is displayed in the session's Reference menu.
View | The command is displayed in the session's Views menu.
Special 1 | The command is displayed in an additional pull-down menu, which is specific to the session. Use the Special 1 and Special 2 categories to group frequently used commands. Per special category, you must select one default command. The description of this default command is displayed on the special category's menu button. See Default Command. Specify a short description in the Short Description field. If you leave the Short Description field empty, the Long description will be displayed on the menu button, so the button becomes too large.
Special 2
Important! The category is only used by the Infor Companion. If the session runs in another UI, the category is ignored. Form commands in a menu must have the same category as the menu.
Default Command | You can only select this check box if a command belongs to the Special 1 or Special 2 category. If this check box is selected, the command is the default command of its category. If the session runs in the Infor Companion, the description of the default command is displayed on the category's menu button. See Category. For example, you specify these form commands:
Session/Function/Business Method | Long description | Category | Default Command
exec.user.1 | Activate Job | Special 1 | Yes
exec.user.2 | Queue Job | Special 1 | No
exec.user.3 | Block Job | Special 1 | No
exec.user.4 | Cancel Job | Special 1 | No
The commands of the Special 1 category are displayed in the Activate Job pull-down menu. Note You can specify one default command per special category. The default command is only used by the Infor Companion. If the session runs in another UI, the default command is ignored.
Label | The code of the form command's label.
Add Ellipses to Label | If this check box is selected, an ellipsis (...) follows the form command's label. Use ellipses to indicate the form command opens a dialog box.
Long description | The form command's description shown on the session's specific menu at run time. You define the description in the Labels (ttadv1140m000) session, for the label code you select in the Label field. Note In the Labels (ttadv1140m000) session you can define two labels (that have the same code) but with different description lengths. If your label code has two labels of differing lengths, this field displays the label with greater than seventeen characters.
Short Description | The description shown when the form command is included as a button on the session's form, or as a text button in the session's application toolbar. You define the description in the Labels (ttadv1140m000) session, for the label code you select in the Label field. Note In the Labels (ttadv1140m000) session; You can define two labels (that have the same code) but with different description lengths. If your label code has two labels of differing lengths, this field displays the label with seventeen characters or less. If you define a label with a Context of Label value of Cascading Item on Button, Tools displays the label for the form command when the form command is included as a button on the session's form, or as a text button in the session's application toolbar. The label also displays as a tooltip. The label enables you to give a more detailed description than the short description. Example Cascading form command: Compile > Debug. The short description for the button is Debug, which would display on the form command's button. The developer defines the label Compile with Debug with a Context of Label value of Cascading Item on Button. The Compile with Debug label displays on the button, which gives the end-user a clearer definition of what the button activates.
Shortcut Key | Select from the drop-down list the form command's shortcut key.
Separator | If this check box is selected, Tools inserts a line in the menu under the form command. Use these lines to create separate groups of form commands in the menu.
Show as Button in modal (browse) Session | If this check box is selected, when a user zooms to the session, the form command displays as a field button on the session's form.
Show on Menu bar of Details window | If this check box is selected, the form command is shown on the details session's specific menu. Note Programming functions are available to create an application toolbar that includes a session's form commands.
Authorization Group | The Authorization level users must have to carry out the form command. All commands with an authorization group that is higher than the user’s authorization for the session are removed from the specific menu. Example: A user is authorized to view and to print records in a session. His authorization group for that session is 'Print/Display'. All form commands with authorization groups 'Full Authorization' (Delete/Insert/Modify/Print/Display), 'Insert/Modify/Print/Display' and 'Modify/Print/Display' will be removed from the specific menu. You must choose the authorization group of a form command according to the following guidelines:
Command Type | If this form command… | Authorization Group in Form Commands (ttadv3118s000) session
Form, Field or Group | gives access to functionality, where a delete action should be possible. | Full Authorization
Form, Field or Group | gives access to functionality, where an insert action should be possible, but no delete action is needed. | Insert/Modify/Print/Display
Form, Field or Group | gives access to functionality, where a modify action should be possible, but no insert or delete action is needed. | Modify/Print/Display
Form, Field or Group | gives access to functionality, where data is displayed, but no print, modify, insert, or delete actions are needed. | Display
Print | gives access to report functionality, which also provides an option for the end-user to delete data (or executes a delete action in the script). | Full Authorization
Print | gives access to report functionality, which also provides an option for the end-user to insert data, but not to delete (or executes an insert action in the script). | Insert/Modify/Print/Display
Print | gives access to report functionality, which also provides an option for the end-user to modify data, but not to insert or delete (or executes a modify action in the script). | Modify/Print/Display
Print | gives access to report functionality, which prints data, but does not provide an option to modify, insert or delete data. | Print/Display
Menu | n.a. | Display
Note You can define authorizations in the Authorization Management System module, and link these to a user on the Authorizations tab of the User Data (ttams1100s000) details session.
Command Availability | Select the form command's availability. Allowed values: Possible Values
Ask for Confirmation | If this check box is selected, before the Form Command is executed, Tools prompts the user with the question you enter in the Question field. For Tools to carry out the form command, the user must answer with the value in the Confirmation Answer to continue field.
Question | If you select the Ask for Confirmation checkbox, when the user tries to execute the form command, Tools prompts the user with the question whose code you enter in this field. Tools only carries out the form command if the user gives the answer whose code you enter in the Confirmation Answer to continue field.
Continue when answer is | To carry out form commands with the Ask for Confirmation checkbox selected, a user must give the answer you enter in this field when prompted by Tools with the question in the Question field.
For multiple selection, execute | For an overview session, when a user executes a form command with multiple records selected in the grid, if in this field you select: Once, Tools only carries out the form command for the first record selected in the grid. For every occurrence, Tools carries out the form command for every record selected in the grid.
Save before execution | If this check box is selected, when a user activates the form command, Tools saves the session's data before carrying out the form command. If this check box is cleared, when a user activates the form command, Tools carries out the form command without saving the session's data.
Start mode Session | Select the mode of the session the form command starts. Allowed values Modal Modeless Synchronized Child Modal Overview Note You can only maintain this field if you selected Session in the Activate a field.
Kind of Session | Select the type of session the form command starts from the options: Overview Window Details Window Note You can only maintain this field when you select Session in the Activate a field.
Refresh Parent | If this check box is selected, when users execute the form command in a session, the data affected by the form command automatically updates in any related sessions. If this check box is cleared, users must manually save the changes after they execute the form command for the changes to update in any related sessions.