Create a UI action for the custom artifact

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read

    • Create a UI action to request translations for the custom artifact.

    Before you begin

    Role required: localization_admin

    Procedure

    1. Navigate to the custom artifact table.
      Find the table using its table name. For example, [sys_cs_topic] is the table name for Virtual Agent topics.
    2. Click the hamburger icon (Hamburger icon) at any of the columns and navigate to Configure UI Actions.
    3. Click New.
    4. In the UI Actions form, fill in the fields.
      Table 1. UI Action form fields
      Field Description
      Name Name for the UI action.

      For example, Request Translations.
      Client Option to execute the script in the user's browser. When enabled, the Onclick field appears above the Condition field.
      Condition Condition to decide when to show this UI action.
      Onclick Provide the JavaScript function name as:
      renderLanguagePickerModal();
      Script Option to execute the script to run the request translations function.
      The script varies for Form button and List choice.
      • Form Button
        function renderLanguagePickerModal() {

    var dlg = new GlideModal("sn_lf_language_picker");
    dlg.setTitle(getMessage("Request Translations"));
    dlg.setPreference("sys_id", g_form.getUniqueValue());
    dlg.setPreference("artifact_config_internal_name", "catalog_item");
    dlg.setPreference("request_type", "form");
    dlg.setPreference("focusTrap", true);
    dlg.render();
}
      • List choice
        function renderLanguagePickerModal() {
    var sys_ids = g_list.getChecked();
    if (!sys_ids || sys_ids.length == 0)
        return;
    var dlg = new GlideModal("sn_lf_language_picker");
    dlg.setTitle(getMessage("Request Translations"));
    dlg.setPreference("sys_id", sys_ids);
    dlg.setPreference("artifact_config_internal_name", "catalog_item");
    dlg.setPreference("request_type", "list");
    dlg.setPreference("focusTrap", true);
    dlg.render();
}
      Form button Option to enable the UI action as a form button.
      List choice Option to enable the UI action in the choice list.
      Note:
      Configure the form to see all the fields. For more information, see Create a UI action.
    5. Click Submit.