StandaloneClientMethods

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

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

Standalone - reflistOpen(文字列 target, 文字列 elementName, 文字列 refTableName, 文字列 dependent, 文字列 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」を参照してください。
ティッカー	文字列	ポップアップウィンドウに返す情報のタイプを示すフラグ。 有効な値： 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', '');
}