How do I use the ConcatGen Generator?
Modified on: Mon, 30 Oct, 2023 at 6:43 AM
The ConcatGen Generator combines (concatenates) two or more values together and returns a single String result.
The following parameters may be configured for the ConcatGen Generator. Items with an asterisk* are required.
- list - Defines a list of strings to concatenate.
- caseType* - Defines if the case of the string should be changed. The options are: noCase, lowerCase, and upperCase.
The following video can be used to see a quick tutorial on how to use the ConcatGen Generator:
How to use the ConcatGen Generator
To use the ConcatGen Generator, you will need to complete these steps:
- Create an Attribute for a selected Domain
- Assign the ConcatGen Generator to the Attribute
- Add list Paramater values and/or references.
- Add spaces (if needed) for the concatenated String.
- Choose a caseType and then save the Generator configuration.
Step 1: Create an Attribute for a selected Domain in your Project
You will need to create an Attribute and assign the ConcatGen Generator to the Attribute. Alternatively, you can simply assign the Generator if the Attribute already exists.
- Click on the Add Attribute button in the left panel of the Domain Dashboard.
- Enter a Name for the Attribute and then click the Save button.
Step 2: Assign the ConcatGen Generator to the Attribute
You will be taken to the Attribute Dashboard after creating the new Attribute. If possible, a Generator will be automatically assigned to the new Attribute and will need to be removed to assign the ConcatGen Generator.
This information can be found at the bottom of the Attribute Dashboard. To reassign the appropriate Generator, complete the following steps:
- Click on the Remove Generator button.
- Click Yes in the confirmation message to remove the currently assigned Generator.
- Select the ConcatGen Generator in the Add a Generator dialog window by clicking on the Plus +.
- You will now be taken to the Attribute Dashboard and can configure the parameters.
Step 3: Add Values and/or References to the list Parameter
Next, you will need to enter each value that will be concatenated by the Generator and/or add references to Domain Attributes, Attribute Generators, Global Variables, Resources, and Organization Variables.
3a: Adding a Value to the List Parameter
Click on the input field and type in the value.
- Then press your Enter/Return Key on the keyboard or click the + Add button to the right to submit the value.
- The value will appear to to the right of the parameter name.
3b: Adding a Reference to the List Parameter
- Double click on the input field to add a reference.
- Click on a tab to view available items to reference. You may reference Domain Attributes, Attribute Generators, Global Variables, Resources, and Organization Variables.
- For this example, the firstName Attribute will be selected.
- Click on the Plus + to add a reference.
- The reference will appear to to the right of the parameter name.
- For this example, the list value Hello will be combined with the firstName Attribute, as shown below:
- The options located on the right of list parameter can be used for managing list values.
- Move Up - Move a selected value up in the list.
- Move Down - Move a selected value down in the list.
- Remove - Remove the selected value from the list.
- Edit - Make changes to a selected value in the list.
- Add - Add a new value to the list.
- Add Space - Add a space to the list to separate values in the concatenated String.
- For this example, Hello will be selected and moved up to ensure the concatenated String will be "Hello firstName".
- Select the list value and then click on one of the provided options.
- The configuration will appear as shown below:
- The output would appear as below. With the above configuration, the Strings will run together.
Step 4: Add Spaces (if necessary) to the Concatenated String
- A space can be added and placed between the two list values by clicking on Add Space.
- Select the space in the list and move it up so that it resides between "Hello" and the firstName Attribute reference.
- The configuration will appear as shown below:
Step 5: Choose a caseType (optional) and Save the Generator Configuration
- The caseType may be changed if needed. It defaults to noCase, but may be changed to uppperCase or lowerCase.
- For this example, it will be left with the default selection.
- Click the Save Generator button to save the configuration changes.
- The sample data will appear like this:
How to Edit an Value in the List
- Select the item you want to edit and click the Edit button.
- The item will appear in the input field and changes can be made to it.
- Press the Return/Enter Key on your keyboard or click the Add button to update the item.
- Click the Save Generator button to save the configuration change.
Did you find it helpful?
Sorry we couldn't be helpful. Help us improve this article with your feedback.