スタンドアロンクライアントメソッド

スタンドアロン クライアント メソッドは、reflistOpen などのクライアント JavaScript 内で使用できるメソッドですが、クラスや API の一部ではありません。

これらのメソッドには、使用する前にコンストラクターやその他の種類のインスタンス化を行うことなく、クライアントスクリプト内で直接アクセスできます。

スタンドアロン - reflistOpen (文字列 target、文字列 elementName、文字列 refTableName、文字列依存、文字列 useQBE、文字列 refQualElements、文字列 additionalQual、文字列 parentID、文字列 forceReference、文字列 ignoreTargetValue)

標準のポップアップウィンドウに参照フィールドデータを表示します。この方法は、UI 16 フォームで参照フィールドの横にある虫眼鏡アイコンを選択するときによく使用されます。

たとえば、このメソッドを使用すると、特定のクエリ条件のセットの参照フィールドデータを表示できます。

同様に、このメソッドを使用して、ユーザーが表示する参照フィールドデータを選択するための独自のクエリ条件のセットを入力できる検索フォームを表示できます。

標準ポップアップで URL を開くときに、URL の長さが TinyURL の長さ (デフォルトでは 1024) より大きい場合、次のように URL が TinyURL に変換されます。

"sys_user_list.do?sysparm_tiny=7ea02c4ff8a8b510f877c74d78b60460" です。

注:

reflistOpen() はワークスペースクライアントスクリプトではサポートされていません。代わりに g_modal.showFrame() メソッドを使用してください。

表 : 1. パラメーター

名前	タイプ	説明
target	文字列	フォームターゲット参照フィールド ID。 たとえば、 caller_id パラメーターのターゲット参照フィールド ID は incident.caller_idです。
elementName	文字列	フォーム参照フィールドの要素名。 例: caller_id
refTableName	文字列	フォーム参照フィールドにマップする参照テーブル。 たとえば、参照フィールド caller_id の場合、sys_user が参照テーブルです。この場合、値 sys_user を渡します。
dependent	文字列	指定された target 要素の構成済み依存フィールド。 詳細については、「Make a field dependent」を参照してください。
QBE を使用	文字列	ポップアップウィンドウで返す情報のタイプを示すフラグ。 有効な値： true:検索ボタン付きのクエリフォームを表示します。 false:クエリ結果を表示します。 デフォルト値：false
refQualElement	文字列	指定された target 要素の構成済み参照修飾子。この関数は、指定された参照修飾子を URL に追加し、フィルタリングされた結果のみをポップアップウィンドウに表示します。参照修飾子を含めない場合は、空の文字列を渡します。 参照修飾子の詳細については、「 Reference qualifiers」を参照してください。
additionalQual	文字列	オプション。ポップアップウィンドウに表示される結果をフィルタリングするために使用する追加の修飾子クエリ。 たとえば、インシデントの caller_id 参照フィールドの場合、ユーザーの sys_id sys_id=62826bf03710200044e0bfc8bcbe5df1 を渡すことができます。 この関数はユーザー [sys_user] テーブルをフィルタリングし、フィルタリングされた結果をポップアップウィンドウに表示します。
parentID	文字列	オプション。現在は内部パラメータのみで、値を渡す必要はありません。
forceReference	文字列	オプション。現在は内部パラメータのみで、値を渡す必要はありません。
ignoreTargetValue	文字列	オプション。現在は内部パラメータのみで、値を渡す必要はありません。

表 : 2. 返される内容

タイプ	説明
ポップアップウィンドウ	返された参照フィールドデータを標準のポップアップウィンドウに表示します。

次の例は、このメソッドを呼び出して、インシデントテーブルのポップアップウィンドウに発信者フィールドデータを表示する方法を示しています (上の最初の画像)。

function onChange(control, oldValue, newValue, isLoading, isTemplate) {
   if (isLoading || newValue === '') {
      return;
   }

   reflistOpen('incident.caller_id', 'caller_id', 'sys_user','company', 'false', '');
}

次の例は、この同じクライアントスクリプトを呼び出す方法を示していますが、 useQBE = true を使用して、ポップアップウィンドウ内に検索ボタンと関連する検索条件が表示されます (上の 2 番目の画像)。

function onChange(control, oldValue, newValue, isLoading, isTemplate) {
   if (isLoading || newValue === '') {
      return;
   }

   //  Type appropriate comment here, and begin script below
   reflistOpen('incident.caller_id', 'caller_id', 'sys_user','company', 'true', '');
}