クエリーの作成

クエリーを作成するか開くと、クエリーは名前付きタブに表示されます。

クエリー・ウィザードを使用して、クエリーのパラメータおよび基準を定義します。ウィザードのコンテンツは、入力をサポートする「ソース」、「スタイル」、「フィルタ」および「列」タブにわたって編成されています。ウィザードのタブは入力を順番に収集するよう順序付けられていますが、任意のタブ間でナビゲートできます。

クエリーの作成の手順:

  1. 「ホーム」ページで、「クエリー」を選択します。

  2. 「新規クエリー」ツールバー・ボタンをクリックします。

  3. 「ソース」タブから、クエリーのバージョンまたはバージョン変数を選択します。

    「標準」、「ベースライン」または「時点」バージョンを選択できます。「バージョン」リストは、「標準」バージョンにデフォルト設定されています。「ベースライン」または「時点」バージョンを選択するには、「バージョン」リストの下の「標準」をクリックします。

  4. 次のいずれかのアクションを実行します。

    • グローバル・クエリーの場合は、次のステップに移動します。

    • ローカル・クエリーの場合は、省略ボタンをクリックし、階層および最上位ノードを選択し、「OK」をクリックします。

      注意:

      階層/最上位ノードの組合せを変更するには、「消去」をクリックし、ローカル・クエリー用のステップを繰り返します。

  5. 「スタイル」で、クエリー結果の表示方法を選択します。

    • リスト: 基準を満たすノードは動的リストとして返されます。

    • ノードをマーク: 基準を満たすノードは階層ツリー内でマークされます。

    • 両方: 基準を満たすノードは動的リストとして返され、階層内でマークされます。

    注意:

    グローバル・クエリーの場合、結果はリストとしてのみ返すことができます。

  6. オプション: 「ノードをマーク」または「両方」を選択した場合、「マークされているノードまで展開」を選択すると、階層が開いて展開され、マークされたノードが表示されます。

    注意:

    このオプションを適用できるのは、ローカル・クエリーに対してのみです。

  7. 「フィルタ」で、「追加」をクリックして基準行を挿入します。

  8. プロパティおよび演算子を選択し、基準行の値を入力し、[Enter]を押して行を保存します。

    注意:

    カッコを含めることにより、基準をグループ化したり、プロパティに継承値を含めるかどうかを定義できます。演算子の詳細は、「演算子の説明」を参照してください。

    ヒント:

    「編集」ボタンをクリックし、行を変更します。行を削除するには、「削除」ボタンをクリックします。行を移動するには、矢印をクリックします。

  9. 「包含オプション」から、クエリー結果に含めるノードを選択します。

    • 一致のみ: 基準を満たすノードのみを返します。

    • 一致と祖先: 基準を満たすすべてのノードとその祖先を返します。

    • 一致と子孫: 基準を満たすすべてのノードとその子孫を返します。

  10. オプション: ステップ9で「一致と祖先」または「一致と子孫」を選択した場合、デフォルトでは、「含める」オプションが選択され、基準を満たすノードが結果に含まれます。

  11. オプション: ステップ9で「一致と祖先」を選択した場合、「クエリーの最上位ノードの上の祖先を含める」を選択すると、最上位ノードの上にある祖先ノードを含めることができます。

    「クエリーの最上位ノードの上の祖先を含める」オプションに追加祖先が含まれるのは、クエリーに指定した最上位ノードにすべての祖先が含まれていなかった場合のみです(「一致と祖先」オプション)。このため、このオプションは子孫には影響しません(「一致と子孫」オプション)。

  12. 「列」タブを選択し、「カテゴリ」を選択します。

  13. クエリー結果で列として表示するプロパティを選択し、これらを「使用可能」から「選択済」に移動します。

    注意:

    列選択は単なるランタイム・パラメータであり、クエリーとともには保存されません。

    ヒント:

    「選択済」リストでは矢印を使用して列の位置を決定します。リスト内の最初のアイテムが第1列、リスト内の2番目のアイテムが第2列というように続きます。

  14. オプション: クエリー結果のフィルタ基準で参照されるプロパティを自動的に含めるには、「基準プロパティを含める」を選択します。

  15. 次のいずれかの操作を行います。

    • クエリーを保存するには、「保存」ボタンをクリックします。

      クエリーの名前、説明およびオブジェクト・アクセス・グループを定義するよう求められます。カスタム・オブジェクト・アクセス・グループまたは次のいずれかを選択します:

      • ユーザー--個別ユーザーのみが表示および実行できる個人オブジェクト。

      • 標準--すべてのユーザーが表示および実行できるパブリック・オブジェクト。標準クエリーを作成および変更できるのはデータ・マネージャ・ユーザーのみです。

      • システム--アプリケーション管理者の役割を持つユーザーのみが表示および実行できる制限オブジェクト。

    • クエリーを実行するには、「実行」ボタンをクリックします。