[ServiceNow] Reference Fieldに表示されるDisplay ValueをUserの選択言語で切り替える

はじめに

FormのReference fieldに表示される値は、Reference先のTableのDisplay fieldの値になります。Table定義で、特定のFieldがDisplay指定されていれば、そのField、あるいは、どのFieldもDisplay指定されていなければ、nameやu_nameフィールドがDisplay valueになります。

ここでは、英語以外のLanguage pluginがインストールされ、ユーザーがPreferred Languageを選択できる環境において、ユーザーが選択しているLanguageに合わせて、Reference fieldの表示する値も、その言語の値に自動的に切り替える方法をCompany tableを例に紹介します。

[参照] Display valueの設定方法とDisplayされるfieldの優先順位
https://docs.servicenow.com/bundle/vancouver-platform-administration/page/administer/field-administration/task/t_SelectTheDisplayValue.html

Table定義設定

まず、CompanyテーブのOOTBであるNameフィールドは、会社の英語名を入力する前提で、日本語名を入力するためのString fieldと英語名と日本語の両方を情報として保持するためのTranslated Text fieldを、次のように追加します。ここで、ポイントはTranslated Text fieldをDisplayに指定しておくことです。

• Name in Japanese (日本語名) Field
  

• Display Name (表示名) Field
  

Business Rule設定

次に、Nameフィールド（英語名）やName in Japanese（日本語名）フィールドが入力されたときに、Translated Text fieldに転記したり、Translated Text tableに対訳となる日本語名の値をもつレコードを追加・変更したりするBusiness Ruleを作成します。

1つ目のBusiness Ruleは、Before Insert/Updateで、Nameの値は、Display Nameに単純転記します。安全のため、Name in Japaneseが空だった場合は、Nameを転記して、英語名と日本語名を同一にします。

Script

(function executeRule(current, previous /*null when async*/ ) {

    // Add your code here
    current.u_display_name = current.name;
    if (!current.u_name_in_japanese) {
        current.u_name_in_japanese = current.name;
    }

})(current, previous);

2つ目のBusiness Ruleは、After Insert/Updateで、Name in Japaneseの入力値を、Translated Text tableに保持させます。値が初めて登録された場合と、既存の値が変更された場合の両方に対応させます。

Script

(function executeRule(current, previous /*null when async*/ ) {

    // Add your code here
    var tableName = current.getTableName();
    var diplayField = "u_display_name";
    var translationLang = "ja";
    var translatedValue = current.u_name_in_japanese;

    var grTX = new GlideRecord("sys_translated_text");
    grTX.addQuery("tablename", tableName);
    grTX.addQuery("fieldname", diplayField);
    grTX.addQuery("documentkey", current.sys_id);
    grTX.addQuery("language", translationLang);

    grTX.query();

    if (grTX.next()) {
        grTX.value = translatedValue;
        grTX.update();
    } else {
        grTX.initialize();
        grTX.tablename = tableName;
        grTX.fieldname = diplayField;
        grTX.documentkey = current.sys_id;
        grTX.language = translationLang;
        grTX.value = translatedValue;
        grTX.insert();
    }
})(current, previous);

結果の確認

事前に、Nameフィールド（英語名）やName in Japanese（日本語名）フィールドが入力されたCompanyレコードをいくつか用意します。

Abel Tuterを、そのうちのひとつに所属させます。英語環境だと、次のように見えます。Comapany fieldに会社の英語名が表示されてます。

日本語環境に切り替えると、Company fieldの値も日本語名に切り替わりました。

ついでに、中国語（簡体字）環境に切り替えると、Translated Text tableには中国語名の対訳が保持されていないため、代替として英語名が表示され、空になるようなことはありません。

なお、この表示切り替えは、Reference fieldの値を選択するList viewや、List typeのReference fieldの値を選択するSluchbucketでも有効です。ただし、List viewは、事前にDisplay Nameが表示されるようにList Layoutを変更して下さい。
日本語環境のSluchbucketの表示だけ、以下に示します。日本語以外の環境であれば、Sluchbucketの左右の選択区画に会社の英語名が表示されます。