Create translation sets and links

A translation set is a list of individual translations, which map two values to each other. Learn about translation sets.

1. Log in to the Redox dashboard.
2. From the side nav menu, click the Operations drop-down.
3. The Operations options expand. Click the Translations option.

   
4. By default, the Value sets tab displays. Click the Translation sets tab.
5. Any defined translation sets appear on the page.
6. To see details of a specific translation set, click the three-dots icon.
7. From the drop-down menu, click the View option.
8. The translation set's details appear.

1. Review any translation sets in the environment on the Translation sets tab. Click the Create translation set button.
2. The translation set wizard opens. Enter the translation set name, then click the Next button.

   Name requirements

   A translation set name can't exceed 500 characters. Also, the name must be unique for each environment. In other words, staging and production environments can't have the same names for translation sets.

   The name appears as the column title for the translation set table.

   
3. Next, the Setup details tab opens. You can either:

1. Review any translation sets in the environment on the Translation sets tab. Find the translation set you want to edit. Click the three-dots icon.
2. From the drop-down menu, click the Edit option.
3. The translation set wizard opens. Add, edit, or delete translations in the set.

   Edit values in a translation

   Remember to edit a value set first if you need to edit specific values in a translation. Learn how to edit a value set.

   Changing directionality

   A translation set is bi-directional by default. However, a bi-directional set changes to uni-directional if you add at least two mappings with the same TO value. You must remove any TO-FROM links first, though, since you can't have TO-FROM links with duplicate TO values.

   To change a uni-directional set back to bi-directional, you must remove all mappings with duplicate TO values.

4. When you're finished, click the Update set button.

   

1. Review any translation sets in the environment on the Translation sets tab. Find the translation set you want to delete. Click the three-dots icon.
2. From the drop-down menu, click the Delete option.

   Deleting a translation set

   You may not delete a translation set that's in use. Remove any links first to successfully delete a translation set.

3. A confirmation modal appears. Click the Delete button.
4. The translation set is successfully deleted.

   

To use a translation set, you must link it to the relevant stage of log processing (i.e., REQUEST and RESPOND or SEND and RECEIVE).

1. Review any translation sets in the environment on the Translation sets tab. Find the translation set you want to link. Click the three-dots icon.
2. From the drop-down menu, click the View option.
3. The translation set's activity and details display. Under the Links section, click the Link set button.

   Uni-directional sets

   You can't link a uni-directional translation set in the TO-FROM direction.

4. The translation set wizard opens. The Set name drop-down automatically populates with the translation set you selected on the previous screen. Or, you can select a different translation set from the drop-down.

   
5. Click the Next button.
6. The Select subscription tab opens. If the translation set is bi-directional, two options display for directionality. Select the radio button for the direction of this specific translation link.

   

   Two links for bi-directional translation set

   If you do want a translation set to be bi-directional, you’ll need to create two separate links, one for each direction. However, you can only create one link at a time.

   A note about directionality

   Technically, a translation set is bi-directional by default, so the value sets could be either FROM or TO values. The directionality only changes to uni-directional when you add at least two mappings with the same TO value from the drop-down on the right.

   You can link bi-directional translation sets either FROM-TO or TO-FROM. However, you can only link uni-directional sets FROM-TO. Learn more about directionality.

7. Next, click the Select subscription link.
8. A dialog box opens with the subscriptions in your environment. Use the Search field or the Connection drop-down to narrow down the available options. If needed, use the page options at the bottom of the dialog to navigate through the pages. Then select the radio button of the subscription you want to link a translation set to.
9. Click the Select Subscription button.

   
10. After selecting a subscription, an edit option and the available stages in the log processing display. If your organization doesn't own a processing stage, the location is grayed out. From the When drop-down, select the processing stage (i.e., REQUEST, RECEIVE, RESPOND) to link the translation set to.
11. Click the Next button.

    
12. The Field paths section appears. Click the Select Field Path drop-down to view a list of fields.
13. Select the field you want to link the translation set to.
14. A dialog opens for testing the field path and value. You can change your selection by clicking the Field Path drop-down again to view a list of fields.
15. Once you have the correct path, use the validation tools to test your choice. Or, if you don't want to test, you can skip and proceed to the next step.
    1. Find a log payload for the subscription you want to translate. Learn more about searching for logs.
    2. Copy and paste the log payload into the Test Message section.
    3. On the right side of the dialog, under Field Values, the value that displays is the one found at the field path you selected.

       No Redox validation

       Keep in mind that Redox doesn't validate the translation set link. But it does give you an idea of whether you selected the right field path by using an existing log payload.

16. Click the Select Path button on the bottom right of the dialog.

    
17. To add another field path, click the plus button next to right of the drop-down field. Repeat steps 12 through 16 for as many field paths you want to include in the translation set link.

    
18. Review the information for the link, then when you're ready. To edit any of the details, click the Previous button. If everything looks good, click the Create Link button.
19. The new link appears in the table, and it automatically takes effect on the related subscription.

    

    Operation details in logs

    If a log has undergone filtering or translation, you can view the related operation details when you click the related processing stage.

    Learn about data operations and:

    • log details for filters
    • log details for translation sets
    • log details for config modifiers (beta feature)

20. You can link the same translation set multiple times. To create another link, click the Link set button to repeat the process.

1. Review any translation sets in the environment on the Translation sets tab. Find the translation set you want to link. Click the three-dots icon.
2. From the drop-down menu, click the View option.
3. The translation set's activity and details display. Under the Links section, find the link you want to edit or delete. Click the three-dots icon.
4. From the drop-down menu, click the Delete option or click the Edit option.

   Deleting a translation set link

   If you click the Delete button, a dialog opens to confirm. You may delete a translation set link that's in use. Logs will still process, but without the translation set link, no translation will happen.

5. The translation set wizard opens. Edit any of the details, then click the Update Link button.