レポートの設計担当者は、Document Studio を使用して、データ・ソース・スキーマをインポートし、レポート・テンプレートを作成することができます。
手順
- テンプレート開発プロセスの概要を確認するには、『文書テンプレートの設計』を参照してください。 文書の構造と、含めるデータについての計画を開始します。 例えば、最終的な文書を 1 テンプレートから生成するか、またはそれぞれに再使用可能なコンテンツ部分が含まれている複数のテンプレート・ファイルから生成するかどうかを決めます。
- Document Studio アプリケーションで、文書テンプレートを作成します。
- データ・ソースからのデータ・ソース・スキーマを識別します。 Rational® DOORS® Web Access のコレクションから特定のデータ部分を追加したり、既知の URL を使用して単一リソースにアクセスしたりするには、オープン・モジュールからオブジェクト URL を右クリックし、「URL のコピー」をクリックします。
常にこのスキーマを使用して、Rational DOORS Web Access からテンプレート内の特定のデータ部分用にスキーマを動的に構成します。
- 例: https://server:port/dwa/rm/urn:rational::object_number
- データ・ソース・スキーマを文書テンプレートに追加します。 Rational DOORS Web Access の場合、以下のステップを実行できます。
- Document Studio で、をクリックします。
- 「スキーマ・タイプ」で、リストからスキーマのタイプを選択します。 Rational DOORS Web Access の場合、「汎用 XML」を選択します。
- 「スキーマ・ファイル」フィールドで、データ・ソース・スキーマとして識別した URL に貼り付けます。
- 「データ・ソース ID」フィールドで、テンプレート内のデータ・ソースの名前を入力します。 「次へ」をクリックします。
- リソースがセキュア・サーバーにある場合、「ユーザー名」を指定します。
- リソースがセキュア・サーバーにある場合、「パスワード」を指定します。
- リストから「認証タイプ」を選択します。 Rational DOORS Web Access の場合、認証タイプは OAuth-OSLC です。
OAuth-OSLC を選択しない場合、各認証タイプは正しいタイプが検出されるまでテストされますが、これによって文書生成時間が増える可能性があります。
- エレメントをテンプレートに追加します。 Rational Publishing Engine には、文書の構成に使用できる一連の包括的なテンプレート・エレメントが備わっています。テンプレート・コンテンツ・エディターに要素をドラッグできます。例えば、複数の段落を保持するコンテナー・エレメントを追加できます。
各段落は、それを特定のデータのみと関連付けるテスト条件によって制御できます。
詳しくは、『「パレット」ビューのテンプレート・エレメント』および『テンプレートへのエレメントの追加』を参照してください。
- 照会、属性、および変数を使用して、テンプレートにデータを追加します。これらの項目は、レポートに生成される情報の内容を指定します。
- 出力での表示方法を制御するフォーマット設定とスタイル設定をエレメントに追加します。
- レポートにプルするデータを絞り込むフィルターを作成します。 一般的なデータ・ソース URI の詳細バージョンであるフィルターを使用してデータの特定サブセットを指すことで、レポート生成時に Rational Publishing Engine がデータ・ソースから必要以上の情報を取得しないようにすることができます。これらのフィルターには、テンプレートで参照される必要なデータをすべて取得するために十分な条件が設定されている必要があります。そうでない場合、不完全なデータが含まれるレポートが生成されます。
- レポート内でデータを編成するソートを作成します。