Create and link a translation set

Last updated: Oct 8, 2024
DEVELOPER
IMPLEMENTATION

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

Typically, a project manager or engineer will create and link any translation sets during an implementation project with a new connection. This article contains instructions for creating and managing translation sets in the dashboard. Alternatively, you can create and manage translation sets with the Redox Platform API.

Create a translation set

  1. Navigate to the Operations page in the Redox dashboard.
  2. By default, the Value sets tab displays. Click the Translation sets tab.
  3. Any defined translation sets appear on the page. Click the Create translation set button.
  4. The translation set wizard opens. Enter the translation set name, then click the Next button.
  5. Next, the Setup details tab opens. You can either:

Edit or delete a translation set

  1. Navigate to the Operations page in the dashboard.
  2. By default, the Value sets tab displays. Click the Translation sets tab.
  3. Any defined translation sets appear on the page. Find the translation set you want to delete. Click the three-dots icon.
  4. From the drop-down menu, click the Delete option or click the Edit option.
  5. If you clicked the Edit option, the Details page opens. Modify the details on this page, or you can also delete the translation from this page, too.

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

  1. Navigate to the Operations page in the dashboard.
  2. By default, the Value sets tab displays. Click the Translation sets tab.
  3. Any defined translation sets appear on the page. Find the translation set you want to link. Click the three-dots icon.
  4. On the drop-down menu, click the View translation set option.
  5. The translation set's activity, details, and links display. Under the Links section, click the Link set button.
  6. The translation set wizard opens. From the Set name drop-down, select the translation set you want to link.
  7. Click the Next button.
  8. The Select subscription tab opens. If the translation set is bi-directional, two options display for directionality. Select the direction for this specific translation link. Remember, you can link a bi-directional translation to go in different directions with different links.
  9. Click the Select subscription link.
  10. 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.
  11. Click the Select Subscription button.
  12. After selecting a subscription, 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.
  13. Click the Next button.
  14. The Field paths section appears. Click the Select Field Path drop-down to view a list of fields.
  15. Select the field you want to link the translation set to.
  16. 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.
  17. 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.
  18. 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.
  19. Click the Select Path button on the bottom right of the dialog.
  20. To add another field path, click the plus button next to right of the drop-down field. Repeat steps 14 through 19 for as many field paths you want to include in the translation set link.
  21. Review the information for the link, then when you're ready. To edit any of the details, click the Previous button. If everything look good, click the Create Link button.
  22. The new link appears in the table, and it automatically takes effect on the related subscription.
  23. You can link the same translation set multiple times. To create another link, click the Link set button to repeat the process.
  1. Navigate to the Operations page in the dashboard.
  2. By default, the Value sets tab displays. Click the Translation sets tab.
  3. Any defined translation sets appear on the page. Find the translation set you want to edit. Click the three-dots icon.
  4. From the drop-down menu, click the View translation set option.
  5. The translation set's activity, details, and links display. Under the Links section, click the three-dots icon.
  6. From the drop-down menu, click the Delete option or click the Edit option.
  7. The translation set wizard opens. Edit any of the details, then click the Update Link button.