Rational RequisitePro
をデータ・ソースとして使用したテンプレートの設計
レポートの設計担当者は、Document Studio を使用して、データ・ソース・スキーマをインポートし、レポート・テンプレートを作成することができます。
始める前に
ヒント:
Rational® Publishing Engine
のインストールには、一連のサンプル・レポートが組み込まれています。文書の発行を開始する前に、この文書生成シナリオの例を検討できます。『
REST サンプル・テンプレートの作成
』を参照してください。
Rational Publishing Engine
を使用してデータを抽出するための
Rational RequisitePro®
の要件に習熟します。
このタスクについて
データは、REST API を使用して抽出されます。 このインターフェースはデータ・ソース・アプリケーションによってインストールおよび実装され、
Rational Publishing Engine
から独立して動作します。 データ・ソースの REST API について詳しくは、データ・ソースの資料を参照してください。
手順
テンプレート開発プロセスの概要を確認するには、『
文書テンプレートの設計
』を参照してください。
文書の構造と、含めるデータについての計画を開始します。 例えば、最終的な文書を 1 テンプレートから生成するか、またはそれぞれに再使用可能なコンテンツ部分が含まれている複数のテンプレート・ファイルから生成するかどうかを決めます。
Document Studio アプリケーションで、
文書テンプレートを作成します
。
データ・ソース・スキーマを文書テンプレートに追加します。
Rational RequisitePro
では、基本 URL をアプリケーションに入力することでデータ・ソース・スキーマをディスカバーできます。
Document Studio で、
「データ」
>
「スキーマ・ディスカバリー」
>
「REST スキーマ・ディスカバリー」
をクリックします。
データ・ソースの
「名前」
を入力します。
データ・ソースの
「説明」
を入力します。
リソースの
「基本 URL」
を指定します。
リストから
「認証タイプ」
を選択します。
データ・サービスによって提供される
Rational RequisitePro
アダプターには、
Basic
認証を指定する必要があります。タイプを選択しない場合、各タイプは正しいタイプが検出されるまでテストされますが、これによって文書生成時間が増える可能性があります。
リソースがセキュア・サーバーにある場合、
「ユーザー名」
を指定します。
リソースがセキュア・サーバーにある場合、
「パスワード」
を指定します。
「次へ」
をクリックします。
入力した基本 URL には
?metadata=schema
が自動的に付加されます。
「終了」
をクリックします。
選択したデータ・ソース・スキーマは「データ・ソース・スキーマ」ビューに表示されます。
エレメントをテンプレートに追加します。
Rational Publishing Engine
には、文書の構成に使用できる一連の包括的なテンプレート・エレメントが備わっています。テンプレート・コンテンツ・エディターに要素をドラッグできます。例えば、複数の段落を保持するコンテナー・エレメントを追加できます。 各段落は、それを特定のデータのみと関連付けるテスト条件によって制御できます。 詳しくは、『
「パレット」ビューのテンプレート・エレメント
』および『
テンプレートへのエレメントの追加
』を参照してください。
照会
、
属性
、および
変数
を使用して、テンプレートにデータを追加します。これらの項目は、レポートに生成される情報の内容を指定します。
出力での表示方法を制御する
フォーマット設定とスタイル設定
をエレメントに追加します。
レポートにプルするデータを絞り込む
フィルター
を作成します。
一般的なデータ・ソース URI の詳細バージョンであるフィルターを使用してデータの特定サブセットを指すことで、レポート生成時に
Rational Publishing Engine
がデータ・ソースから必要以上の情報を取得しないようにすることができます。これらのフィルターには、テンプレートで参照される必要なデータをすべて取得するために十分な条件が設定されている必要があります。そうでない場合、不完全なデータが含まれるレポートが生成されます。
レポート可能 REST v1 ネイティブ・フィルターでは、テキストを大括弧 [] で囲んで入力するだけで済みます。残りのフィルターは、
Rational Publishing Engine
によって生成されます。
以下のレポート可能 REST v1 ネイティブ・フィルターの例は、
Rational RequisitePro
PRRequirements
スキーマを、
Stability='High'
を使用して取り出します。
フィルター式を
Appliances
の下のノードに追加します。これにより特定の製造元により製造された装置のみが選択されます。
fields=Project/Requirements/PRRequirement[Stability = 'High']/(Stability|FullTag|Priority|Status)
レポート内でデータを編成する
ソート
を作成します。
Rational RequisitePro
はネイティブ・ソートの使用をサポートしません。 代わりに、ソートを
Rational RequisitePro
で作成できます。
表を作成して、データを入力します。
データをソートします。
ビューを作成
し、データをそれに保存します。
データ・ソース・スキーマとして使用するビューを
Rational Publishing Engine
でエクスポートします。 レポート作成データ・サービス・アプリケーションはビューを自動的に検出します。
データ・ソース・スキーマを
Rational Publishing Engine
テンプレートに追加します。
Rational Publishing Engine
出力で生成された
Rational RequisitePro
データは、ビューからのソートを保持します。ただし一部のネストされたデータは、ネストされているとおりに表示されない場合があります。
例: Rational RequisitePro データ・ソース・スキーマを使用する再帰レベルおよび再帰セグメント
Rational Publishing Engine
でインストールされたサンプル (
RPE_HOME¥source¥XML¥examples¥RequisitePro.xsd
) で使用できる
IBM Rational RequisitePro
スキーマの
PRRequirement
照会を使用して、ソフトウェア要件のリストを表示できます。
例: Rational RequisitePro を使用したスタイル見出しのスクリプト式の作成
この例では
RequisitePro.xsd
汎用 XML スキーマを使用しています。これには
PRRequirement
照会に
Level
属性が含まれています。
前のトピック:
Rational RequisitePro と Rational Publishing Engine の統合の構成
次のトピック:
Rational RequisitePro をデータ・ソースとして使用した文書の生成
関連概念
:
SoDA テンプレートの
Rational Publishing Engine
へのマイグレーション
関連情報
:
DeveloperWorks の
Rational Publishing Engine
のコミュニティー・チュートリアルおよびシナリオ
フィードバック