コンテンツにスキップ

elements.LabelText

概要

サーバスクリプトでボタンやメニューの表示名を変更します。

制限事項

  1. 画面上部の「ナビゲーションメニュー」、画面下部の「コマンドボタン」、プロセスで追加したボタンの表示名を変更可能です。
  2. 戻るボタンには適用できません。

構文

elements.LabelText(key, labelText)

パラメータ

パラメータ 型 必須 概要
key string ○ HTMLのID属性
labelText string ○ 文字列

戻り値

戻り値はありません。

使用例

以下の例では、更新ボタンの表示名を「アップデート」に変更します。

JavaScript
elements.LabelText('UpdateCommand','アップデート');

サンプルコード

1. プロセスのボタンのラベルを今日の日付で設定する。

プロセスで設定したボタンのラベルを、"{今日の日付}のデータ取得"とします。

実務での使いどころ

「本日分のデータ取得」のように、ボタンを押す日によって対象が変わる処理で、押す前に対象の日付をボタンの上で確かめられるようにしたいときに使えます。日付の取り違えによる誤操作を防げます。

JavaScript
const dateFormat = (input) => {
    if (!input) return '';
    // 返却値は文字列であるため、new Date()する
    const date = new Date(input);
    const y = date.getFullYear();
    const m = String(date.getMonth() + 1);
    const d = String(date.getDate());
    const dateTime = `${y}年${m}月${d}日`;
    return dateTime;
};
elements.LabelText('Process_1', `${dateFormat(utilities.Today())}のデータ取得`);
2. 「承認依頼」のボタンに、送り先の承認者の名前を出す

申請のレコードを開いたとき、プロセス「承認依頼」のボタンのラベルを「承認依頼(〇〇さんへ)」にします。承認者が選ばれていないときは「承認依頼(承認者が未設定です)」にします。

実務での使いどころ

稟議・購買・休暇の申請で、承認者を選び間違えたまま依頼する事故を防ぎたいときに使えます。押す前に、ボタンの上で送り先を確かめられます。プロセスのボタンの名前は、テーブルの管理で決めた固定の文字列で、レコードの値によって変えることはできません。

事前準備

1:「稟議申請」テーブル(記録テーブル)で、以下の項目を有効化してください。

項目コード 内容
分類C(ClassC) 承認者。選択肢一覧に[[Users]]を設定する

2:プロセス「承認依頼」を作成し、IDを控えます(IDが1なら、ボタンのIDはProcess_1)。

3:スクリプトを登録します。

3-1:「テーブルの管理 > サーバスクリプト」タブで「新規作成」を選択する。
 3-2:タイトル: 任意の名前(例:labelTextApproverName)
 3-3:スクリプト: 下記サンプルコードを貼り付け、REQUEST_BUTTON_IDを2のボタンのIDにする
 3-4:条件: 「画面表示の前」にチェック

JavaScript

条件:画面表示の前

// 「承認依頼」のプロセスのボタンのID(プロセスの ID が 1 なら Process_1)
const REQUEST_BUTTON_ID = 'Process_1';
// 承認者の項目(選択肢一覧に [[Users]])
const APPROVER_COLUMN = 'ClassC';

// 申請を開いたとき、「承認依頼」のボタンに、送り先の承認者の名前を出す
function showApproverOnButton() {
    const approverId = Number(model[APPROVER_COLUMN]);
    if (!approverId) {
        elements.LabelText(REQUEST_BUTTON_ID, '承認依頼(承認者が未設定です)');
        return;
    }
    const approver = users.Get(approverId);
    if (approver) {
        elements.LabelText(REQUEST_BUTTON_ID, `承認依頼(${approver.Name}さんへ)`);
    }
}

showApproverOnButton();

注記

  • ラベルは画面を開いたときに決まります。承認者を選び直したときは、更新してから画面を開き直すと、ボタンの名前が変わります。

関連情報