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

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

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

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

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

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

タイトル	例
ブール値または文字列値の参照	ブールフィールドにクエリ文字列を作成するには、field=true または field=false という構文を使用します。たとえば、テーブル内のアクティブなレコードのみを返すには、次のようになります。 active=true 特定の文字列値を持つフィールドを使用してクエリ文字列を作成するには、field=value という構文を使用します。たとえば、カテゴリがネットワークであるインシデントレコードを返すには、次のように使用します。 category=network
参照フィールドを参照	別のテーブルの参照フィールドを参照するクエリ文字列を作成するには、field_in_referenced_table=value という構文を使用します。たとえば、インシデントフォームの [アサイン先 ] 参照フィールドで itil ロールを持つユーザーを返すには、次のようにします。 Assigned_to.roles=itil
選択リスト値の参照	選択リストオプションを参照するクエリ文字列を作成するには、ラベルではなく選択リストの値を、choice list field=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 LIKE 演算子で条件を使用するには、syntax:fieldLIKEsubstring を使用します。たとえば、文字列「it」を含むロールを持つすべてのユーザーを返すには、次のようにします。 rolesLIKEit IN 演算子で条件を使用するには、fieldINvalue1,value2,value3 という構文を使用します。たとえば、「itil」、「admin」、「user」のいずれかのロールを持つすべてのユーザーを返すには、次のようにします。 rolesINitil,admin,user 1 つの条件が JavaScript 関数である複数の条件を追加するには、javascript:'field=value^' + function() という構文を使用します。この関数は、有効なクエリ文字列を生成するために最初の文字列と連結できる文字列を返す必要があります。たとえば、すべてのアクティブユーザーを返し、getGroupQualifier() 関数の条件を満たすには、次のようにします。 javascript:'active=true^' + getGroupQualifier()
値を順番にリスト	特定のフィールドでデータをソートするには、field1=value^ORDERBYfield2 の構文で ORDERBY 条件を使用します。 たとえば、曜日 [sys_cal_unit] テーブルから曜日を順番に返すには、次のようにします。 unit_name=day^ORDERBYvalue 曜日テーブルでは、unit_nameは日、週、または月を指定するフィールドであり、値は 1 (月曜日) から 7 (日曜日) までの各日の数値です。クエリー文字列は、月曜日を表す最小値から日曜日を表す最大値までの順に曜日のリストを返します。 注: 参照修飾子は ORDERBY 条件をサポートしていません。参照修飾子では、標準のリストコントロールを使用して参照ルックアップリストをソートできます。参照フィールドのオートコンプリートリストの順序を指定するには、ref_ac_order_by辞書属性を使用します。
関連リストクエリを含める	クエリステートメントの最後に、関連リスト情報を ^RLQUERY と ^ENDRLQUERY と数量で囲みます。たとえば、少なくとも 1 つの関連インシデントに関する問題を含む問題テーブルのクエリでは、次のようにします。 ^RLQUERYincident.problem_id,>=1^ENDRLQUERY 関連するテーブルで条件を指定することもできます。たとえば、少なくとも 1 つの関連インシデントが重要な優先度であるという条件を含めるには、次のようにします。 ^RLQUERYincident.problem_id,>=1,priority=1^ENDRLQUERY 注: 関連リストクエリは、システムプロパティ リスト v3 で有効にする必要があります。[ フィルターを使用して追加する関連リストクエリ条件を許可] チェックボックスをオンにして有効にします。 リスト v2 を使用するリストの関連リストクエリをビルドすることはできますが、ブレッドクラムで関連リスト条件を削除するまでフィルター条件を変更することはできません。
検索用語クエリを含める	クエリに検索用語を含めるには、123TEXTQUERY321 予約済み変数を使用します。たとえば、「email」検索用語を含む結果を返すには、このエンコードされたクエリ文字列を使用します。 123TEXTQUERY321=email
テキストインデックスグループクエリを含める	テキストインデックスグループをクエリーに含めるには、123TEXTINDEXGROUP321 予約済み変数を使用します。たとえば、テキストインデックスグループ [ts_index_group] テーブルのportal_index_groupテキストインデックスグループ内の結果を返すには、このエンコードされたクエリ文字列を使用します。 123TEXTINDEXGROUP321=portal_index_group

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