Language Admin

Learn how to add and edit languages for your tenant(s)

The Reporting Hub is a multi-language application and can be configured to any language. While the application will be installed with English as its default language, you can change the language of your tenant in two easy steps:

See below for a detailed walk-through of each step.

Adding & Editing Language Tags

  1. Select your profile picture or name to access the Admin Settings menu.

  2. Select App Settings.

  3. Select the Language Editor tab.

  4. From the drop-down menu, select Add Language.

    Selecting Add Language from the dropdown
  5. The Add New Language pop-up will appear, prompting you to enter both a Language Code and a Language Name. In the first box, you will need to enter a two-letter ISO 639-1 code. (A full list of ISO 639-1 codes can be found here.) For example, if you want to add Spanish as an option, your ISO 639-1 code will be es. In the second box, type the language name you want displayed on your drop-down menu. Then, select Add New Language.

    Add new language screen
  6. From the drop-down menu, select the language you’ve added. This will bring up a list of every language tag associated with the Reporting Hub interface.

  7. To change these tags to the language you’ve selected, click the Options button beside the dropdown and then Translate missing words. This may take several minutes.

    Translate missing words
  8. Once the translation is complete, look over the tags to make sure you’re satisfied with the results. Any language tag translation can be edited manually. To do so:

    1. In the row of the tag you want to edit, select the Edit icon () from the right-hand column.

      Selecting the edit icon of the first language tag
    2. Enter your preferred translation, and click Save.

      Editing a language tag
  9. Any language you’ve added can be deleted by: selecting it from the dropdown list, then selecting Options, and then Delete Selected Language.

    Delete selected language

Selecting a Tenant Language

Note: To change the language settings for your sub-tenants, you'll need either an Enterprise or Commercial-tier subscription.

Once you’ve added a language using the Language Tags Editor, you’re ready to change the language of your Reporting Hub display.

  1. Select your profile picture or name to access the Admin Settings menu.

  2. Select App Settings.

  3. Select the Tenant Admin tab.

  4. From the list of tenants, select the ellipsis (...) next to the tenant you want to edit and then select Edit.

  5. In the Edit Tenant menu, select your preferred language from the Language dropdown.

    Selecting a tenant language in the Edit Tenant menu
  6. Select Save.

Translating Missing Words After an App Update

New language tags may be added to the Reporting Hub as we update and add new features. These tags will not automatically be translated to whichever languages you have added to your Language Editor, and so you may be missing translations after an update.

For example, we added the Icelandic language to our Language Editor before several major updates. Hence, we are missing several translations for page tags; you can see where there are blanks under the Icelandic header.

Missing translations

Translate Missing Words

  1. Select the language you'd like to translate the missing phrases for from the Language dropdown.

  2. Select Options.

  3. Select Translate missing words. It may take several minutes to obtain the translations, depending on how many translations are missing.

    Translate missing words
  4. The missing translations have been added. Any tags you've manually edited will not be overwritten.

    Missing translations have been added

Configuring Translator Endpoints

By default, the Reporting Hub will use the public endpoint for calling Translator Service APIs. If your Translator uses a private endpoint, you'll have to add it to your Reporting Hub's app settings.

  1. Copy your Translator's private endpoint from the Azure portal.

    1. You can find it by navigating to your Translator service and selecting Keys and Endpoint under Resource Management.

    2. Under Web API, copy the value for Text Translation.

  2. In the Azure portal, navigate to your App Services list; you can use the search bar at the top of the page.

  3. From the list of App Services, select your Reporting Hub app service.

    1. If you deployed your Reporting Hub app to a specific slot on your app service, then expand the Deployment menu in the left menu pane; select Deployment slots; and select the desired slot.

  4. On the left menu, expand the Development Tools menu and select Advanced Tools.

  5. Select Go -> and Kudu tools will open in a new tab.

  6. On the Kudu page, in the top menu, select Tools and Zip Push Deploy.

  7. Scroll down in the file list and find appsettings.json. Select the pencil icon next to it.

  8. In the text editor on the page, find "translatorurl" and replace the text beside it with the private endpoint value from step 1. Ensure the value is inside quotation marks.

  9. Select Save.

Last updated