Create translation sets and links

A translation set is a list of translation mappings between two value sets. Learn more about translation sets.

• All environment users can view translation sets. However, a user must be assigned to an engineer or a support role to manage translation sets. Learn about user roles.
• You must have already defined two value sets either in the Redox dashboard or in a CSV file (must have at least 25 defined values) to create a translation set. Learn how to create value sets.

A translation set is bi-directional by default. This means the values can be translated in either direction: FROM-TO or TO-FROM. When you map more than one value to the same value, the translation set becomes uni-directional. A uni-directional translation set can only be linked going FROM - TO. Learn more about directionality.

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 opens. Click the Translation sets tab.
5. Any existing translation sets in the environment display. To see details of a specific translation set, click the three-dots icon.
6. From the drop-down menu, click the View option.
7. The translation set’s details page opens.

Follow the instructions to view existing translation sets.

On the Translation sets tab, click the Create translation set button to open the wizard. The instructions below take you through each step of the wizard.

1. Enter a unique human-friendly name up to 500 characters (names must be unique within the environment). Then click the Next button.

   

1. You can either build translations from existing value sets in the Redox dashboard or import value sets with translations defined in a CSV file.

1. The default directionality and the selected value sets appear at the top of the tab.
2. From the drop-down fields, select the values to map to each other, then click the Add button.
3. Repeat the previous step for each translation you want to create (up to 5,000 translations). The translations appear in the table.

   "In use" values and directionality

   An “in use” label appears next to any FROM value that has already been selected. You can’t map a FROM value more than once. However, you can map multiple FROM values to the same TO value. This changes the directionality to uni-directional.

   
4. Translation sets are case sensitive by default. To change it, toggle the Case sensitive option to OFF. If you turn off case sensitivity, any value that matches a FROM value, regardless of casing, will be translated to the indicated TO value.

   

   Disabled case sensitive option

   You might see the case sensitive toggle disabled. This happens when:

   • There are at least two FROM values that would match without case sensitivity (e.g., WISCONSIN and wisconsin). Remove any conflicting FROM values to enable the case sensitive toggle.
   • The translation set has at least one TO-FROM link, and there are at least two TO values that would match without case sensitivity. Remove any TO-FROM links or duplicate TO values to enable the case sensitive toggle.

5. Review the table with your translations and make any changes.
   1. To edit a translation, click the pencil icon on the right. Select the correct values from one or both of the drop-down menus.

      
   2. To delete a translation, click the minus icon on the left. This only deletes one translation in the table, not the entire translation set.

      
6. Click the Create set button.

   
7. Follow the instructions to link the translation set to apply these translations to your traffic.

1. Follow the instructions to view existing translation sets.
2. Find the translation set you want to edit or delete. Click the three-dots icon.
3. From the drop-down menu, click the relevant option.
   1. Select the Edit option.

      Editing promoted assets

      You can’t edit production assets if they’ve been promoted from staging. First edit the asset in staging, then re-promote to production.

      1. 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.

      2. When you’re finished, click the Update set button.

         

         Inactive value sets

         A translation set may point to an inactive value set version. However, once you edit an active translation set, it will automatically point to the latest active version of value set(s). In other words, you can’t edit an active translation set with outdated value set(s).

         If you don’t want to use the active version(s) of value sets, you can cancel out of any edits to the translation set.

   2. Select the Delete option.
      1. A confirmation modal appears. Click the Delete button.
      2. The translation set is successfully deleted.

         

To apply a translation set to your traffic, you must link it to the relevant log processing stage.

1. Follow the instructions to view existing translation sets.
2. Find the translation set you want to link. Click the three-dots icon.
3. From the drop-down menu, click the View option.
4. The Settings page opens. Under the Links section, click the Link set button.

   
5. Follow the instructions to complete each step of the translation set wizard.

1. The translation set wizard opens. The Set name drop-down automatically populates with the translation set you selected on the previous screen.
2. If needed, select a different translation set from the drop-down.
3. Click the Next button.

1. For a bi-directional translation set, two options display for directionality. You must create two separate links—one for each direction—if you want a translation set to be applied in both directions. However, you can only create one link at a time. Select the radio button for the direction of this specific translation link.

   

   Uni-directional sets

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

2. Click the Select subscription link.
3. A modal opens with the subscriptions in your environment. Use the Search field or the Connection drop-down to narrow down the available options. Or, use the page options at the bottom of the modal to navigate through the pages.
4. Select the radio button of the subscription you want to link a translation set to, then click the Select Subscription button.

   
5. An edit option appears underneath the selected subscription. In the When drop-down, select the appropriate processing location to link the translation set to. Learn more about log processing stages.

   Links and processing stages

   You can link a translation set to up to four log stages, depending on whether your organization owns both sides of the subscription (i.e., both the source and destination).

   • If your organization owns both sides of the subscription, you can link a translation set to any of the pre-processing or post-processing stages, whether inbound or outbound.
   • If your organization owns only one side of the subscription, you can link a translation set to the two log stages you own. For example, if you own the source side of the subscription, you can link a translation set to the post-processing stages, whether inbound or outbound.

6. Click the Next button.

   

1. From the Field Path drop-down, select the field you want to link the translation set to.
2. A modal 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.
3. 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 modal, under Field Values, the value that displays is the one found at the field path you selected.

      No Redox validation

      Redox doesn’t validate the translation set link. But this step gives you an idea of whether you selected the right field path by using an existing log payload.

4. Click the Select Path button on the bottom right of the modal.

   
5. To add another field path, click the plus button to the right of the drop-down field. Repeat the field path steps for as many field paths you want to include in the translation set link. This is what allows a translation set to alter multiple values in one data payload at a time.

   
6. Review the information for the link. To edit any details, click the Previous button. Otherwise, click the Create Link button.
7. The new link appears in the table and automatically applies to the linked subscription’s traffic.

   

   Operation details in logs

   If a log has used any custom operations, 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

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

1. Follow the instructions to view existing translation sets.
2. Find the translation set you want to link. Click the three-dots icon.
3. From the drop-down menu, click the View option.
4. The Settings page opens. Under the Links section, find the link you want to edit or delete. Click the three-dots icon.
5. 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 modal opens to confirm. You can delete a translation set link that’s in use. Logs will still process, but without the translation set link, no translation will occur.

6. If you clicked the Edit button, the translation set wizard opens. Edit any of the details, then navigate through the wizard and click the Update Link button.

   

After testing in staging, you can promote a translation set to production. Learn more about promoting assets.

1. Log in to the Redox dashboard.
2. From the Environments drop-down, select the Staging environment.

   
3. From the side nav menu, click the Operations drop-down.
4. The Operations options expand. Click the Translations option.

   
5. By default, the Value sets tab opens. Click on the Translation sets tab.
6. The list of existing translation sets displays. Find the translation set you want to promote. Click the three-dots icon.
7. From the drop-down menu, click the View option.
8. The Settings page opens. Click the Promote button.
9. A modal appears to confirm that you’re exiting staging and proceeding to production. Click the Proceed button. Otherwise, click the Cancel button to discard the promotion.

   
10. The Settings page in the production environment opens.
    1. To make any changes to the translation set, click the Go to Staging button.

       
    2. A modal appears to confirm that you want to switch environments. Click the Proceed button to continue.
    3. The translation set settings page opens in the staging environment. Follow the instructions to edit a translation set.
    4. Once changes are successfully made, re-promote the translation set to keep the assets in sync across environments.
11. Next, add link(s) to subscriptions to apply the translation set in your production environment.

You can restore a version of a translation set that’s not currently in use. This can be helpful when troubleshooting to see where an error might have been introduced or to resolve an error by using a version that worked previously.

1. Follow the instructions for viewing existing translation sets.
2. From the list of existing translation sets, click on the translation set you want to restore.
3. The Settings page opens. Click the Restore button.

   
4. A modal appears to restore a version. From the drop-down, select a version to restore.

   Restore notes

   Restoring means activating a version that’s not in use. That means you can go backwards or forwards a version. However, you can’t restore a version that’s already in use.

5. The diff view shows what’s different between the current and selected version. Review the differences, then click the Restore button.

   Versions after editing

   If you edit an asset after restoring a previously used version, a new version is created.

   For example, let’s say you were on version 3 and you restore version 2. Then you make and save edits to version 2. This creates version 4 of the asset. At that point, you can still restore to version 3 at any time.

   
6. For promoted assets, restoring a version only applies to the current environment. If you restore a version in staging, you might need to re-promote the asset if you want to apply it to production as well.

   What happens to value sets?

   If a restored translation set points to an inactive value set version, the restored translation set will continue to use the inactive value set(s). Translations will still process as defined by the inactive value set(s).

   However, once you edit an active translation set, it automatically points to the latest active version of value set(s). In other words, you can’t edit an active translation set with outdated value set(s).