文書テンプレート

文書テンプレートは、文書を生成するための雛形です。 テンプレートでは、データ・ソースから抽出するデータの内容と形式が定義されます。

文書テンプレートは、.dta (Document Template Archive) という拡張子を持つ独立型のアーカイブ・ファイルです。テンプレートは、共有、移動、およびコピーできます。旧バージョンの IBM® Rational® Publishing Engine で作成された文書テンプレートは最新バージョンでも使用できます。ただし、データ・プロバイダーが最新バージョンの Rational Publishing Engine のテンプレート構造をサポートしていない場合は、旧バージョンの Rational Publishing Engine のテンプレート構造を使用するようにテンプレート・バージョンを設定できます。

文書テンプレートには、静的コンテンツと動的コンテンツの両方を追加できます。 静的コンテンツとは、テンプレートの設計時に提供されるテキストやイメージ などです。動的コンテンツとは、文書の生成時にデータ・ソースから取得されるデータです。テンプレートでは形式情報も定義されますが、一部のデータではデータ・ソースからそのデータ内に埋め込まれた形式情報が保持されることがあります。

文書テンプレートには以下を含めることができます。

テンプレート内のデータ・ソース・スキーマ

テンプレートを定義するときには、静的データではなく、スキーマと呼ばれるデータ構造の定義を使用します。これにより、定義元データ・ソースの構造と一致する構造を持つ任意のデータ・ソースにテンプレートを適用できるようになります。テンプレートには、任意の数のデータ・ソース・スキーマを含めることができます。

データ・ソースが データ・ソース・スキーマと完全に一致しない場合、Rational Publishing Engine は、そのスキーマと一致する要素を処理して、 クリティカルではないエラーを無視します。 例えば、Rational DOORS®status 属性がテンプレートで使用されており、実際のデータ・ソース (DOORS モジュール) にこの属性が含まれていない場合、デフォルトでは文書生成が続行されます。

Rational Publishing Engine は、IBM Rational DOORSIBM Rational Tau、Rational REST データ・ソースなどのいくつかのデータ・ソース・タイプ用のスキーマを作成または取得するためのメカニズムを提供します。標準のスキーマ定義について詳しくは、http://www.w3.org/XML/Schema を参照してください。サード・パーティー・アプリケーションを使用して、 XML データからスキーマを作成できます。

テンプレートの再使用

ローカル、リモート、またはセントラル管理コンポーネントに保管されているテンプレートから、テンプレート構造を再使用することができます。新規テンプレートの作成後、インポートするテンプレートが他のテンプレートを参照していない場合、作業中のマスター・テンプレートにテンプレート全体をインポートできます。一般的に 再利用する、ヘッダーやフッターなどの文書のセクションのスニペットを 作成します。

テンプレートをインポートするときには、動的に参照するか、 または物理的に組み込むことができます。テンプレートまたはインクルード・ファイルを 動的に参照する場合、テンプレートを生成する出力タイプによって、 出力を生成するときに、そのテンプレートまたはファイルへのリンクを追加するかまたは インポートされたテンプレートのコンテンツをロードします。 テンプレートまたはファイルを物理的に組み込む場合は、実行時ではなく、マスター・テンプレートに直にコンテンツを インポートします。

マスター・テンプレートと参照または組み込んでいるテンプレートの 間に競合がある場合は、競合を解決するようにプロンプトが 出されます。例えば、競合には、異なるデータ・ソース・スキーマが 含まれる場合があります。データ・ソース・スキーマが異なる場合は、インポートされたテンプレートのスキーマをマスター・テンプレートに追加することによって、 競合を解決することができます。

デフォルトの文書仕様

すべてのテンプレートは、デフォルトで空白の文書仕様に関連付けられています。Document Studio アプリケーションから、テンプレートをプレビューまたは発行するときに、 この空白の文書仕様をカスタマイズするか、またはカスタマイズせずに使用して 出力を生成できます。Document Studio は、テンプレートを 開くときまたは保存するときに、デフォルトの文書仕様とテンプレートを 同期させます。

フィードバック