StandaloneClientMethod

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

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

スタンドアロン - reflistOpen (String target, String elementName, String refTableName, String dependent, String useQBE, String refQualElements, String additionalQual, String parentID, String forceReference, String 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', '');
}