Graph Parameter Editor
Last updated
Last updated
Graph parameters are managed by the Graph parameters editor. The main purpose of this editor is to create, edit and remove internal graph parameters, link and unlink external parameter files and edit particular graph parameters in parameter files.
The Graph parameter editor is available via Outline view. Just double-click on the Graph parameters section.
The editor shows the internal and external parameters of the graph simultaneously. Internal parameters are located at the top level of the tree, while external parameters files are shown indented (e.g. workspace.prm in the figure above).
The order of the parameters in the graph defines the priority of use. If parameter names collide, the parameter that is above the other has a higher priority. The order of the graph parameters can be changed using the drag-and-drop actions available on the left toolbar.
If an error is detected in the graph parameters settings, a yellow exclamation mark icon is displayed on the affected graph parameters and an error message is displayed in a tooltip on the damaged graph parameter.
Adding a new graph parameter use To add a new parameter to the end of the list, use in-line editing of Add new parameter cell at the end of each parameter section. To insert a new graph parameter above the current position, use the Plus button on the left side.
Name and value editing Edit the name and value of a graph parameter directly in parameters viewer.
Changing the order of parameters Use left-side toolbar (Move top, Move up, Move down, Move bottom) or Drag&Drop to move the selected graph parameter. Order of parameter files can be changed as well. Multi-selection is supported.
Creating a new parameter file Create a new parameter file using the New parameter file button.
Linking an existing parameter file Link an existing parameter file using the Link parameter file button.
Filtering parameters Parameters filtering is based on a substring of parameter name and value.
Dialog supports commonly used operations known from graph editor:
Copy (Ctrl+C), Cut (Ctrl+X) and Paste (Ctrl+V) operation on selected graph parameters.
Undo (Ctrl+Z) and Redo (Ctrl+Y) operations.
Name Identifier of the parameter.
Value Value of the parameter. The Value field can use different editors to edit the value. The editors are set up using property Editor type.
Description Description is user-defined text for a graph parameter or graph parameter file. Unlike the label, the description can be several paragraphs long.
Public Not used in this version of Data Shaper Designer.
Required Not used in this version of Data Shaper Designer.
Label Not used in this version of Data Shaper Designer.
Value Hint Not used in this version of Data Shaper Designer.
Category Not used in this version of Data Shaper Designer.
Editor Type The public parameters can use a type of editor corresponding to the field of the component using the parameter. For example, you can use File URL Editor or Transform Editor. This field is available for all parameters. The editor type is primarily used for public parameters when setting them in parent graph (when configuring a subgraph).
The Graph Parameter Type Editor is used to set the correct editor for certain graph parameters. You can choose between Simple Type or Component binding. The dialog is opened from the parameter property Editor type in Graph parameters editor.
Simple type can be one of:
Basic
Integer - inline editor, allows you to enter only integers
Decimal - inline editor, allows you to enter decimal numbers
Boolean - inline editor - user selects true, false or empty value
Advanced
Date/Time - inline editor, allows you to set the date using the calendar.
Metadata Related
Enumerations
Component binding is not used in this version of Data Shaper Designer.
Edit Parameter Value is used to set a parameter value. The value of the parameter can be converted to the CTL2 code using the Convert to dynamic button.
If the Convert to dynamic button is used, the editor is changed.
See also: Edit Parameter CTL2 Value
The Edit Parameter CTL2 Value dialog is used to place a CTL2 code as a parameter value.
The value can be converted to string using the Convert to static button. If the button is used, the editor changes.
Multiline string parameter type lets you use a multiline string as a parameter value. If the parameter value is in xml or json format, its syntax can be checked.
Use the Validation configuration property to switch on XML or JSON syntax validation.
The File URL parameter type lets you configure File URL Dialog.
File Extension makes a File URL dialog to display files with particular suffix. It can be used to display files matching some patterns too. For example, you can display a txt file (*.txt) or XML files whose name starts with "a" (a*.xml).
Selection Mode displays files or directories or files or directories.
The Allow Multiple Selection checkbox lets you deny multiple file selection. If you uncheck the checkbox, you cannot select multiple files.
In the Select Types dialog, tick the file extensions to be available in File URL Dialog.
If a suffix is not available in the list, use the Other extensions field below. The suffix you define should start with an asterisk. If more extensions are defined, separate them with a comma.
The Properties type lets you use key-value pairs.
The Single Field type allows you to choose one metadata field from the list.
Configuration of Single Field specifies a subset of fields of one existing metadata. You can choose one field of the set. The metadata can be either static or referenced from a particular edge of the subgraph. Available metadata fields can be filtered depending on the metadata field type or on the container type.
If you use the parameter, you can choose one field using the following dialog.
The Multiple Fields parameter type is used to choose one or more metadata fields from the set.
The available fields are a subset of the existing metadata fields. The fields can be static metadata fields or edge metadata fields. Available metadata fields can be filtered by metadata field type or container type.
To add fields to the list, you can use the arrows or drag and drop.
The Field Mapping type requires metadata from both sides of the mapping. You specify the fields whose metadata can be mapped using the parameter.
In the Field Mapping dialog, you can define the mapping for the transformation.
When you define the Join Key parameter type, you choose which metadata is involved in the join:
The Join Key parameter value specifies joining fields.
The following dialog box is used to set the values available in the Enumeration selection list. The values available in the list are defined in Values. The pipe character is displayed escaped, the semicolon is surrounded by the " character.
User-defined values are allowed using the Allow Custom Value checkbox.
You can choose the value using the inline editor. If more than 10 (ten) values have been defined, you can choose the value using the external dialog box.
The Character set parameter type lets you choose one of the available character sets.
Time Zone allows you to choose time zone from a list. Java or Joda time zones can be used.
Field Type allows you to choose a field type from a list.
Locale allows you to set the locale.
Removing a graph parameter Use the Minus button or Delete key to remove selected parameters. Multi-selection is supported. To remove unused graph parameters, use .
Secure The parameter is considered as a Secure parameter. See
String - inline editing or external dialog ( or )
Multiline string - external dialog .
File URL - external dialog (File Url Dialog). A configuration of the dialog is described in File URL. For details on File URL Dialog, see .
Properties - inline editor, used to set up key-value pairs. See .
Single Field - external dialog, allows you to choose one metadata field. See .
Multiple Fields - external dialog, allows you to choose one or more fields. See .
Sort Key - external dialog, allows you to define sort key. See .
Field Mapping - external editor, allows you to set field mapping. See .
Join Key - external editor, allows you to set fields to be joined. See
Enumeration - inline or external editor, allows you to choose one option from a list; you may be allowed to define your own value. See .
Character set - external dialog, for choosing character set. See .
Time Zone - external dialog, for choosing time zone. See .
Field Type - inline editor, for choosing field data type. See .
Locale - external dialog, for choosing locale. See .
To store the password, use secure graph parameters. See .
See also:
See also .
Properties can be parsed with the function .
See also .
See also .
