GlideQueryCondition - グローバル

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：5分

    • GlideQueryCondition API は、現在の条件に追加できる追加の AND または OR 条件を提供し、複雑なクエリをビルドできるようにします。

    次のような複雑なクエリを構築します。
    category='hardware' OR category='software' AND priority='2' AND priority='1'

    addCondition() の場合、暗黙的な AND が追加されます。

    このクラスにはコンストラクターがありません。GlideQueryCondition オブジェクトは、次のメソッドによって返されます。
    • addActiveQuery()
    • addInactiveQuery()
    • addJoinQuery()
    • addNotNullQuery()
    • addNullQuery()
    • addQuery()

    AND および OR クエリーの複雑なセットがある場合は、すべての条件を含む単一のエンコードクエリーを使用すると、クエリーの作成が簡単になります。クエリの作成を簡略化するには、リストビューでクエリを作成し、クエリを右クリックして、[ クエリのコピー] を選択します。結果セットを返す単一のエンコードされたクエリ文字列を作成します。その文字列を addEncodedQuery() メソッド呼び出しのパラメーターとして使用します。

    クエリを本番インスタンスに展開する前に、必ず準本番インスタンスでテストしてください。無効なフィールド名を含めるなど、エンコードされたクエリが正しく構築されていないと、無効なクエリが生成されます。無効なクエリが実行されると、クエリ条件の無効な部分が削除され、結果はクエリの有効な部分に基づいており、テーブルのすべてのレコードが返される場合があります。無効なクエリ結果で insert()、update()、deleteRecord()、または deleteMultiple() メソッドを使用すると、データが失われる可能性があります。

    glide.invalid_query.returns_no_rows システムプロパティを true に設定すると、無効なエンコードクエリを含むクエリがレコードを返さないようにすることができます。場合によっては、 glide.invalid_query.returns_no_rows が true に設定されていても、クエリは API 結果のレコードを返すことがあります。これは、無効なクエリ用語が WHERE 演算子で使用されているクエリで発生します。このようなクエリでは、WHERE 演算子は無効な用語を無視しますが、クエリ ステートメントの残りの部分を解釈して返します。このシステムプロパティとその機能の詳細については、「 Available system properties」を参照してください。

    GlideQueryCondition - addCondition(文字列名, 文字列演算子, オブジェクト値)

    現在の条件に AND 条件を追加します。

    表 : 1. パラメーター
    名前 タイプ 説明
    名前 文字列 フィールドの名前。
    演算子 文字列 (オプション)クエリの演算子。演算子を指定しない場合、条件は等号演算子を使用します。
    値 オブジェクト クエリ対象の値。
    表 : 2. 戻り値
    タイプ 説明
    GlideQueryCondition GlideRecord に追加された GlideQueryConditon への参照。 
    var now_GR = new GlideRecord('incident');
var qc = now_GR.addQuery('category', 'Hardware');
qc.addCondition('category', 'Network');
now_GR.addQuery('number','INC0000003');
now_GR.next();
now_GR.number;
gs.info(now_GR.getEncodedQuery());

    スコープ対象と同等のもの

    スコープ対象のアプリケーションで addCondition() メソッドを使用するには、対応するスコープ対象のメソッド addCondition() を使用します。

    GlideQueryCondition - addOrCondition(文字列名, 文字列演算子, オブジェクト値)

    2 つまたは 3 つのパラメーターの OR 条件を既存の GlideQueryCondition に追加します。

    addOrCondition() は、addQuery() メソッドのいずれかと連携して動作し、 addQuery() を使用して以前に構築されたクエリに指定されたクエリパラメーターを指定します。

    addOrCondition() は通常、3 つのパラメーターで呼び出されます。テーブルフィールド、演算子、および比較値。qc.addOrCondition('category', 'software');のように、テーブルフィールドと比較値の2つのパラメータのみで呼び出すことができます。この場合の演算子は「等しい」と見なされます。

    表 : 3. パラメーター
    名前 タイプ 説明
    名前 文字列 フィールド名
    演算子 文字列 (オプション)クエリ演算子。使用可能な値は、 値 パラメーターのデータタイプによって異なります。
    番号:
    • =
    • !=
    • >
    • >=
    • <
    • <=
    文字列 (大文字である必要があります):
    • =
    • !=
    • IN
    • STARTSWITH
    • ENDSWITH
    • 次の値を含む
    • 次の値を含まない
    値 オブジェクト クエリ対象の値 (大文字と小文字は区別されません)。
    注:
    渡されるすべての配列には、少なくとも 2 つの要素が含まれている必要があります。単一要素アレイはサポートされていません。
    表 : 4. 戻り値
    タイプ 説明
    GlideQueryCondition GlideRecord に追加された GlideQueryConditon への参照。 
    var now_GR = new GlideRecord('incident');
var qc = now_GR.addQuery('category', 'Hardware');
qc.addOrCondition('category', 'Network');
now_GR.addQuery('number','INC0000003');
now_GR.next();
now_GR.number;
gs.info(now_GR.getEncodedQuery());

    (state < 3 OR state > 5) AND (priority = 1 OR priority = 5) などの AND/OR ステートメントをグループ化するには、次のようなコードを使用します。

    var myObj = new GlideRecord('incident');
var q1 = myObj.addQuery('state', '<', 3);
q1.addOrCondition('state', '>', 5);
var q2 = myObj.addQuery('priority', 1);
q2.addOrCondition('priority', 5);
myObj.query();

    スコープ対象と同等のもの

    スコープ対象のアプリケーションで addOrCondition() メソッドを使用するには、対応するスコープ対象のメソッド addOrCondition() を使用します。