To open the Build screen, click the Build button on the top menu bar. This is the interface where you create and manage configurations.
To open the Build screen, click the button on the top menu bar. This is the interface where you create and manage configurations.
...
Build screen
This view has two sections:
Display List – The left side of the Build screen shows the Main option that displays all available configurations int he system, and the existing, committed workflow packages in the Workflow Packages section. If you
click onselect a workflow package, the Browser will display the content of the selected package and if you want to display all configurations regardless of workflow package, click
onthe Main menu item. At the bottom of this section you can click
onthe Create package button to create workflow packages. For more information, see Workflow Packages.
Configurations Navigator – In the Configuration Browser you can create, manage, delete, and rename the configurations in the system if you have selected Main in the Display List.
Configuration Browser
The configurations can be either profiles that belong to specific agents, common profiles, or other types such as Event Notification or APL Collection Strategies. For more information, see /wiki/spaces/MD91/pages/23364668.
Option/Value | Description |
|---|
 Selection Checkbox | Select the |
checkbox for any configurations you want to perform actions for, see the section Table Action Bar with Configuration(s) Selected below, for more information. | |
Name | Displays the name of the configuration. |
Valid | Displays the validity of the configurations. Fields are automatically validatated in agents and other core functionality. |
Encrypted | Displays the encryption status of the configuration. |
Locked | Shows if the configuration is locked or not. |
Permission | Displays the permissions granted to the current user of the configuration. Permissions are shown as R (Read), W (Write) and X(eXecute). If the configuration is encrypted, an E will also be added. |
Owner | Displays the username of the user that created the configuration. The owner can:
|
Modified date | Displays the date when the configuration was last modified. |
Subfolders in the Configuration Browser
| Note |
|---|
Note!Subfolders in this context are visual representations of areas that you have partitioned to keep your configurations. They are meant to make your configuration browser look neat and tidy. They do not represent actual subfolders. |
You can enable subfolders to allow you to sort your configurations within your folders, making it easier to maintain larger implementations. To enable subfolders, you must set the property property mz.subfolders.enabled to to true in the the platform.conf file. You can refer to Platform Properties (to be removed) for more information on how to set the property.
To create subfolders, you will have to use the valid separators in the folder name when creating a new folder. Like the folder shown on the image above with "ftps_coll" and "ftps_coll_explicit". when subfolders are created, configurations are sorted into subfolders determined by the separator used in the folder name.
The only valid separators in a folder name are "_" or "-". If any other character is used as a separator the folder will not appear with subfolders.
Table Action Bar
The table action bar is located on top of the Browser. The actions available will change depending on if you have selected the check box checkbox for any configuration(s) or not.
...
Table Action Bar with no configurations selected
...
Table Action Bar with configuration(s) selected
...
When no configurations are selected, the table action bar contains the following actions:
Action | Description |
|---|---|
Filter | Click |
this button to open the Filter dialog where you can select which configuration types you want to view. | |
Search | This is a free text search box that you can use to search for specific workflow configurations that match the entered text. |
New Configuration | Click |
this button to open the Configurations dialog where you can select which type of configuration you want to create. The configurations have a common set of buttons, see Common Configuration Buttons, and some have specific buttons that are described in the documentation for each configuration. | |
New Folder | Click |
this button to create a new folder to save your configurations in. |
 The New Folder dialog box
|
| |
Refresh | Click |
this button to refresh the list of configurations. |
| Anchor | ||||
|---|---|---|---|---|
|
When selecting the
...
checkbox for one or more configurations, the table action bar will contain different actions you can do for the configuration(s).
The available actions are:
Action | Description |
|---|---|
Clear selection(s) | Click |
this button to clear the selection of configurations. The table action bar will show the default actions. | |
Delete | Click |
this button to delete the selected configuration(s). You will be asked if you are sure you want to delete before deletion is done. | |
Rename | Click |
this button to opens the Rename configuration or Rename folder dialog box where a new name for the configuration can be entered. |
 | |
Encrypt | Click |
this button to open the Encrypt configurations dialog box where a password can be provided thus securing the configuration from unauthorized access. This button is disabled if you have selected a |
checkbox for a folder. |
 | |
Decrypt | Click |
this button to open the Decrypt configurations dialog box where the encryption password can be provided giving access to the configuration. This button is disabled if the selected configuration is not encrypted. |
 |
 Properties | Click |
this button and select the option Properties to open the Properties dialog box where you can configure the properties for the selected configuration. This button is disabled if you have selected a folder or multiple configurations. See the section Configuration Properties below for more information. |
 Keyboard shortcuts | Click |
this button to open the Configurations - Keyboard shortcuts dialog. Click anywhere outside the dialog to close it. |
 |
| Anchor | ||||
|---|---|---|---|---|
|
To open the Configuration Properties dialog, select the check box checkbox for the configuration you want to set properties for and click on the button with three dots in the table action bar and select the option Properties. This dialog has four different tabs; Basic, Permission, Reference, History.
...
The Basic tab is the default tab in the Properties dialog.
...
It contains the following information:
Configuration Information | Description |
|---|---|
Name | Displays the name of the configuration. |
Type | Displays the type of configuration. |
Key | Displays the internal key used to identify the configuration. |
Folder | Displays the name of the folder in which the configuration is located. |
Version | Displays the version number of the configuration, see the History tab for further information about the different versions. |
Permissions | Displays the permissions granted to the current user of the configuration. Permissions are shown as R(Read), W (Write) and X (eXecute). If the configuration is encrypted, an E will also be added. For further information about permissions, see The section Permissions Tab. |
Owner | Displays the username of the user that created the configuration. The owner can:
|
Modified by | Displays the user name of the user that made the last modifications to the configuration. |
Modified | Displays the date when the configuration was last modified. |
If you want to use the information somewhere else you can highlight the information and press CTRL-C to copy the information to the clipboard.
The Permission Tab
The Permission tab contains settings for what different user groups are allowed to do with the configuration.
...
The Permission tab
As access permissions are assigned to user groups, and not individual users, it is important to make sure that the users are included in the correct user groups to allow access to different configurations.
R | W | X | E | Permission Description |
|---|---|---|---|---|
R | - | - | - | Allowed only to view the Configuration, given that the user is granted access to the application. |
- | W | - | - | Allowed to edit and delete the Configuration. |
- | - | X | - | Allowed only to execute the Configuration. |
R | W | - | - | Allowed to view, edit and delete the Configuration, given that the user is granted access to the application. |
- | W | X | - | Allowed to edit, delete and execute the Configuration. |
R | - | X | - | Allowed to view and execute the Configuration, given that the user is granted access to the application. |
R | W | X | - | Full access. |
- | - | - | E | Encrypted. |
The Reference Tab
The Reference tab contains information about which other configurations that the current configuration is referring to, and which other configurations that the current configuration is referenced by.
...
The Reference tab
...
If you want to edit any of the configurations, you can double-click the configuration to open it for editing.
The History Tab
The History tab contains version information for the configuration.
...
The History tab
In the table, the following columns are included:
Column | Description |
|---|---|
Version | Displays the version number. |
Modified Date | Displays the date and time when the version was saved. |
Modified By | Displays the user name of the user that saved the version. |
Comment | Displays any comments for the version. |
If you want to clear the history for the Configuration, click the Clear Configuration History button. The version number is not affected by this.
Build screen
This view has two sections:
- Display List – The left side of the Build screen shows the Main option that displays all available configurations in the system, and the existing, committed workflow packages in the Workflow Packages section. If you click on a workflow package, the Browser displays the content of the selected package and if you want to display all configurations regardless of workflow package, click on the Main menu item. At the bottom of this section you can click on the Create package button to create workflow packages. For more information, see Workflow Packages.
...
the
...
Configuration
...
The configurations can be either profiles that belong to specific agents, common profiles, or other types such as Event Notification, External References, Python Modules, Ultra formats, Workflows, Workflow Groups, Unit Tests, APL code, or APL Collection Strategies. For more information, see /wiki/spaces/MD91/pages/23364668.
...
Selection checkbox
...
Displays the validity of the configurations. Fields are automatically validated in agents and other core functionality.
...
Displays the username of the user that created the configuration. The owner can:
Read, modify (write), and execute the configuration
- Modify the permissions of user groups to read, modify, and execute the configuration.
...
Displays the date when the configuration was last modified.
Table Action Bar
The table action bar is located on top of the Browser. The actions available change depending on if you have selected the checkbox for any configuration(s) or not.
Table Action Bar with no configurations selected
Table Action Bar with configuration(s) selected
Table Actions with No Configurations Selected
When no configurations are selected, the table action bar contains the following actions:
...
The configurations have a common set of buttons, see Common Configuration Buttons, and some have specific buttons that are described in the documentation for each configuration.
...
Click this button to create a new folder to save your configurations in.
The New Folder dialog
| Note | ||
|---|---|---|
| ||
The maximum allowed length for a folders name is 40 characters. |
...
When selecting the checkbox for one or more configurations, the table action bar is populated with different actions you can do for the configuration(s).
The available actions are:
...
Click this button to open the Rename configuration or Rename folder dialog where a new name for the configuration can be entered.
...
Click this button to open the Encrypt configurations dialog where a password can be provided thus securing the configuration from unauthorized access. This button is disabled if you have selected a checkbox for a folder.
...
Click this button to open the Decrypt configurations dialog where the encryption password can be provided to access the configuration. This button is disabled if the selected configuration is not encrypted.
...
Properties
...
Keyboard shortcuts
...
Click this button to open the Configurations - Keyboard shortcuts dialog. Click anywhere outside the dialog to close it.
...
To open the Configuration Properties dialog, select the checkbox for the configuration you want to set properties for and click the button with three dots in the table action bar and select the option Properties. This dialog has four different tabs: Basic, Permission, Reference, and History.
The Basic Tab
The Basic tab is the default tab in the Properties dialog.
It contains the following information:
...
Name
...
Displays the name of the configuration.
...
Type
...
Displays the type of configuration.
...
Key
...
Displays the internal key used to identify the configuration.
...
Folder
...
Displays the name of the folder in which the configuration is located.
...
Version
...
Displays the version number of the configuration, see the History tab for further information about the different versions.
...
Permissions
...
Displays the permissions granted to the current user of the configuration. Permissions are shown as R(Read), W (Write), and X (eXecute). If the configuration is encrypted, an E is also added. For further information about permissions, see section Permissions Tab.
...
Owner
...
Displays the username of the user that created the configuration. The owner can:
Read, modify (write), and execute the configuration
Modify the permissions of user groups to read, modify, and execute the configuration.
...
Modified by
...
Displays the user name of the user that made the last modifications to the configuration.
...
Modified
...
Displays the date when the configuration was last modified.
If you want to use the information somewhere else you can highlight the information and press CTRL-C to copy the information to the clipboard.
The Permission Tab
The Permission tab contains settings for what different user groups are allowed to do with the configuration.
The Permission tab
As access permissions are assigned to user groups, and not individual users, it is important to make sure that the users are included in the correct user groups to allow access to different configurations.
...
The Reference Tab
The Reference tab contains information about which other configurations that the current configuration refers to, and which other configurations that the current configuration is referenced by.
The Reference tab
The Reference tab contains two sub-tabs: Used By, which displays all the configurations that use the current configuration, and Uses, which displays all the configurations that the current configuration uses.
If you want to edit any of the configurations, you can double-click the configuration to open it for editing.
The History Tab
The History tab contains version information for the configuration.
The History tab
In the table, the following columns are included:
...
Version
...
Displays the version number.
...
Modified Date
...
Displays the date and time when the version was saved.
...
Modified By
...
Displays the user name of the user that saved the version.
...
Comment
...
Displays any comments for the version.
If you want to clear the configuration's history, click the Clear Configuration History button. The version number is not affected by this.
...