Thank you for your feedback.
Form temporarily unavailable. Please try again or contact to submit your comments.
  • Madrid
  • London
  • Kingston
  • Jakarta
  • Istanbul
  • Helsinki
  • Geneva
  • Store

Internationalize a widget

Log in to subscribe to topics and get notified when content changes.

Internationalize a widget

Use the ${} or gs.getMessage() syntax in widgets to tag strings for translation so you can localize your Service Portal content.

The ${} or gs.getMessage() searches in the messages table [sys_ui_message] in the platform to see what the translation would be.

Use the HTML template to internationalize strings in a widget. Type the following in an HTML template.

  <p>${This message will be internationalized.}</p>
  <p>However, this will NOT be.</p>

Writing text as ${message} is the equivalent of writing ${gs.getMessage("message")} in other parts of the system, but written as a more legible shorthand.

Note: In some cases, the translation might have quotes or double quotes on it. That could lead to JavaScript errors if you are using the ${} syntax in the client script. The safest way to fetch a translated message is to do it in the server script. Then, assign the value to a client-side Angular binding.

Translating strings in the client script

function() {
  var c =this;
  c.message="${This message will be internationalized}";
HTML template:
  <!-- The output of this text will be internationalized. -->

Translating strings in the server script

Use the server script to translate schema options and other values during server-side runtime.

Server script
function() {  
  data.message=gs.getMessage("this message contains 'quotes'");
  //You can also translate schema options using the server script
  //For example, data.message=gs.getMessage(options.title);
HTML template