エンコードされたクエリ文字列

エンコードされたクエリ文字列は、レコードリストの複雑なフィルターを表します。

エンコードされたクエリ文字列を使用して、 URL を使用したレコードまたはモジュールへの移動などの URL パラメーターの一部としてフィルターを含めたり、参照フィールドに選択できるデータを制限する 参照修飾子 として使用したりします。

エンコードされたクエリ文字列を作成するには、リストクエリを生成し、 それをリストフィルターからコピーします。代替手段は文字列を手動で作成することであるため、これは推奨される方法です。

エンコードされたクエリ文字列を手動で作成するには、関連するテーブルとフィールドの名前と 演算子を知っている必要があります。

表 : 1. エンコードされたクエリ文字列の例

タイトル	例
ブール値または文字列値の参照	ブールフィールドでクエリ文字列を作成するには、field=true または field=false の構文を使用します。たとえば、テーブル内のアクティブなレコードのみを返すには、次を使用します。 active=true 特定の文字列値を持つフィールドを持つクエリ文字列を作成するには、field=value という構文を使用します。たとえば、カテゴリがネットワークであるインシデントレコードを返すには、次を使用します。 category=network
参照フィールドの参照	別のテーブルの参照フィールドを参照するクエリ文字列を作成するには、構文 field_in_referenced_table=value を使用します。たとえば、インシデントフォームの [アサイン先 ] 参照フィールドの itil ロールを持つユーザーを返すには、次のように使用します。 roles=itil
選択リストの値の参照	選択リストオプションを参照するクエリ文字列を作成するには、選択リストフィールド=value の構文で、ラベルではなく選択リストの値を使用します。たとえば、選択リストの値が 1 で、ステータスが [インストール済み] の構成アイテム (CI) を返すには、次のようにします。 install_status=1 値のオプションを見つけるには、 スクリプティングの選択肢ラベルに関連付ける値 を参照してください。
複数の条件の使用	AND 演算子で結合された 2 つの条件を使用するには、field1=value1^field2=value2 の構文でカラット ^ 記号を使用します。たとえば、「itil」ロールを持つすべてのアクティブユーザーを返すには、次のように使用します。 active=true^roles=itil OR 演算子で結合された 2 つの条件を使用するには、field1=value1^ORfield1=value2 の構文で OR 付きのカラット記号を使用します。たとえば、「itil」または「admin」ロールを持つすべてのユーザーを返すには、次のように使用します。 roles=itil^ORroles=admin 1 つの条件が JavaScript 関数である複数の条件を追加するには、javascript:'field=value^' + function() という構文を使用します。この関数は、有効なクエリ文字列を生成するために、最初の文字列と連結できる文字列を返す必要があります。たとえば、すべてのアクティブなユーザーを返し、getGroupQualifier() 関数の条件を満たすには、次のようにします。 javascript:'active=true^' + getGroupQualifier()
値を順番にリストする	特定のフィールドでデータをソートするには、ORDERBY 条件を field1=value^ORDERBYfield2 の構文で使用します。 たとえば、曜日 [sys_cal_unit] テーブルから順番に曜日を返すには、次のようにします。 unit_name=day^ORDERBYvalue [曜日] テーブルで、unit_name は日、週、または月を指定するフィールドで、value は 1 (月曜日) から 7 (日曜日) までの各日の数値です。クエリ文字列は、曜日のリストを、月曜日を表す最小値から日曜日を表す最大値の順に返します。 注: 参照修飾子は ORDERBY 条件をサポートしていません。参照修飾子では、標準のリストコントロールを使用して参照ルックアップリストをソートできます。参照フィールドのオートコンプリートリストの順序を指定するには、ref_ac_order_by dictionary 属性を使用します。
関連リストクエリを含める	照会ステートメントの最後に、関連リスト情報を ^RLQUERY と ^ENDRLQUERY および数量で囲みます。たとえば、少なくとも 1 つの関連インシデントの問題を含む問題テーブルに対するクエリでは、次のように使用します。 ^RLQUERYincident.problem_id,>=1^ENDRLQUERY 関連テーブルで条件を指定することもできます。たとえば、関連するインシデントのうち少なくとも 1 つが「最重要」の優先度であるという条件を含めるには、次のように使用します。 ^RLQUERYincident.problem_id,>=1^priority=1^ENDRLQUERY 注: 関連リストクエリは、システムプロパティ リスト v3 で有効にする必要があります。[ 関連リストクエリ条件をフィルターから追加できるようにする (Allow related list query conditions to be added through the filter )] チェックボックスをオンにして有効にします。 リスト v2 を使用するリストの関連リストクエリーを作成できますが、ブレッドクラムで関連リスト条件を削除するまで、フィルター条件を変更することはできません。
検索用語クエリを含める	検索語をクエリに含めるには、予約変数 123TEXTQUERY321 を使用します。たとえば、「email」という検索用語を含む結果を返すには、このエンコードされたクエリ文字列を使用します。 123TEXTQUERY321=email
テキスト・インデックス・グループ・クエリーのインクルード	テキストインデックスグループをクエリに含めるには、予約変数 123TEXTINDEXGROUP321 を使用します。たとえば、テキストインデックスグループ [ts_index_group] テーブルのportal_index_groupテキストインデックスグループ内の結果を返すには、このエンコードされたクエリ文字列を使用します。 123TEXTINDEXGROUP321=portal_index_group

• エンコードされたクエリ文字列をフィルターで生成
  任意のリストのフィルターを使用してエンコードされたクエリ文字列を生成し、その文字列を URL クエリまたは参照修飾子に貼り付けることができます。