このページを共有

# ［Excel レポート クエリ ビルダ ］ダイアログ・ボックス

このダイアログ・ボックスでは、SQL クエリを作成できます。

アクセス方法 | ALM サイドバーの［ダッシュボード］の下で、［アナリシス ビュー］を選択します。 アナリシス・ツリーを展開し、Excel レポートを選択します。 ［設定］タブにある［クエリ］タブをクリックし、［クエリ ビルダ］ボタンをクリックします。
重要な情報 | データベースの整合性が確保されるように、プロジェクト・データベースからデータを抽出するクエリだけを実行する必要があります。詳細については、「 データベースの保護」を参照してください。 SQL クエリにパラメータを含めることができます。詳細については、「SQL クエリのパラメータ」を参照してください。
関連タスク | 「Excel レポートを生成する方法」
参照情報 | 「Excel レポートの概要」 「SQL クエリのパラメータ」

SQL エディタ領域

次にユーザ・インタフェースの要素について説明します (ラベルのない要素は、山括弧で囲んで表記してあります) 。

UI 要素 | 説明
--- | ---
| クエリの追加: 新しいクエリを作成できます。「Query ＜番号＞」という標準設定の名前の新しいタブがクエリ・ビルダに追加されます。 レポートを生成すると、各クエリの結果が別々の Excel ワークシートに表示されます。
| 削除: 選択したクエリを削除します。
| クエリ名の変更: 現在のクエリの名前を変更できます。 注: クエリで抽出されたデータが含まれている Excel ワークシートは、クエリと同じ名前になります。
| テスト・クエリ: クエリの最初の 10 個の結果を［クエリ結果］タブに表示します。クエリにパラメータが含まれている場合は、パラメータの標準設定値が使用されます。
| クエリの実行: クエリの結果を［クエリ結果］タブに表示します。クエリにパラメータが含まれている場合は、値の入力を求められます。
| データベースの種類: プロジェクト・データベースに使用されるデータベースの種類を表示します。 SQL クエリは、プロジェクト・データベースの種類で使用される構文を使って作成する必要があります。
| 検索: 検索ボックスに入力したテキストをクエリから検索します。 ヒント: ［検索］ボタンをもう一度クリックすると、次のテキストを検索できます。
<SQL エディタ> | Excel レポートに抽出されるデータ・セットを定義する SQL クエリが表示されます。 注: プロジェクト・エンティティの間は、カンマで区切ります。 構文の例外: 「`@`」と「`¥`」には特別な意味があり、プロジェクト・データベースに対して SQL クエリを実行する際、文字どおりに解釈されません。これらが文字どおりに解釈されるようにするには、「`@`」を「`¥@`」に、「`¥`」を「`¥¥`」に置き換える必要があります。たとえば、ALM データベースに対して `SELECT * FROM BUG WHERE BUG.BG_SUMMARY = '@parameter@'` というステートメントを文字どおりに実行するには、`SELECT * FROM BUG WHERE BUG.BG_SUMMARY = '\@parameter\@'` と入力する必要があります。Excel レポートに抽出されるデータ・セットを定義する SQL クエリが表示されます。
コピー/貼り付け | 選択したテキストを SQL エディタの別の場所にコピーします。 利用場所: クエリ・エディタの右クリック・メニュー
切り取り/貼り付け | 選択したテキストを SQL エディタの別の場所に移動します。 利用場所: クエリ・エディタの右クリック・メニュー

［エンティティ］表示枠

クエリに追加できる ALM データベース・フィールドおよびエンティティのリストが含まれています。

次にユーザ・インタフェース要素について説明します。

UI 要素 | 説明
--- | ---
| エンティティをクエリに追加: 選択したプロジェクト・エンティティを SQL クエリに追加します。エンティティはカーソル位置に挿入されます。 エンティティ・タイトルで定義されたカラム・エイリアス付きでプロジェクト・エンティティを追加するには、［エンティティをクエリに追加］の矢印をクリックし、［エンティティをクエリに追加 (エンティティのタイトルをエイリアスとして使用) ］を選択します。 利用場所: ［エンティティ］表示枠
| エンティティ・ビュー: ［エンティティ］表示枠内のフィールドとエンティティを、名前順、データベースのカラム名順、あるいはその両方の順序で表示できます。 利用場所: ［エンティティ］表示枠

［クエリ パラメータ］タブ

クエリに利用できるパラメータのリストが表示されます。

次にユーザ・インタフェース要素について説明します。

UI 要素 | 説明
--- | ---
| パラメータをクエリに追加: 選択したパラメータを SQL クエリに追加します。パラメータはカーソル位置に挿入されます。 注: テキスト値を示すパラメータの場合は、［SQL］表示枠で、パラメータを囲むように手動で一重引用符 (') を追加する必要があります。たとえば、［SQL］表示枠に `WHERE BUG.BG_DETECTED_BY = @name@` という句が含まれている場合、`@name@` というテキストを `'@name@'` にする必要があります。 利用場所: ［クエリ パラメータ］タブ
| 新規クエリ・パラメータ: ［新規クエリ パラメータ］ダイアログ・ボックスが開き、パラメータのグリッドにパラメータを追加できます。詳細については、「［新規クエリ パラメータ］/［クエリ パラメータの編集］ダイアログ・ボックス」を参照してください。 利用場所: ［クエリ パラメータ］タブ
| クエリ・パラメータの編集: ［クエリ パラメータの編集］ダイアログ・ボックスが開き、選択したパラメータを編集できます。詳細については、「［新規クエリ パラメータ］/［クエリ パラメータの編集］ダイアログ・ボックス」を参照してください。 利用場所: ［クエリ パラメータ］タブ
| クエリ・パラメータの削除: 選択したパラメータをパラメータのグリッドから削除します。 注意: レポートのクエリで使用されているパラメータを削除すると、そのパラメータが含まれているクエリが有効ではなくなります。 利用場所: ［クエリ パラメータ］タブ

［クエリ結果］タブ

SQL クエリのプレビュー結果を表示します。

https://admhelp.microfocus.com ALM 8942
検索結果の改善のヒント... ALM ヘルプセンター ALM ヘルプセンター ALM ヘルプ 16.00 すべてローカル・ヘルプセンターの表示オンライン・ヘルプセンターの表示戻るブラウザ履歴で元に戻る進むブラウザ履歴で前に進む検索の強調表示を解除次のトピック次のトピックに移動前のトピック前のトピックに移動現在のトピックを印刷バージョン: