ドックレットおよび変数について

レポート・パッケージは、ドックレット、リファレンス・ドックレット、参照ファイルおよびサプリメンタル・ドックレットというサブコンポーネントで構成されます。また、変数をリファレンス・ドックレットおよび参照ファイルから導出できます。

ドックレット

ドックレットには、Narrative Reportingレポート・パッケージで作成しているレポートに必要なコンテンツが含まれます。レポート・パッケージは、1つ以上のドックレットで構成できます。Wordベースのレポート・パッケージにはWordベースのドックレット、PowerPointベースのレポート・パッケージにはPowerPointベースのドックレットが含まれます。PDFベースのレポート・パッケージには、WordおよびExcelベースのドックレットがPDFファイルとともに含まれますが、文書作成できるのはWordおよびExcelのドックレットのみです。

ドックレットは、すべての文書作成フェーズ、レビュー・フェーズ、サインオフおよびレポートの公開を含め、レポート・パッケージ・ワークフローに全面的に関与します。
リファレンス・ドックレット

リファレンス・ドックレットは、Excelファイルの名前付き範囲や、Reportsから作成され、レポート・パッケージ内の1つ以上のドックレットによって消費されるチャートやグラフなどのコンテンツを格納するためのコンテナとして使用できます。

Excelベースのリファレンス・ドックレットは、Oracle Smart View for Officeグリッドまたはフォームなどのコンテンツや静的Excelコンテンツを使用したサポート・ファイルにもなるExcelファイルで、登録してWordベースのドックレットに直接埋め込むことができます。Excelの「名前の管理」を使用して埋込み可能なコンテンツを指定し、Smart Viewで名前付き範囲を登録します。

Reportsベースのリファレンス・ドックレットは、Narrative Reporting Webインタフェースで作成され、使用可能なコンテンツとして登録された表およびチャートで構成されます。

いずれかのタイプのリファレンス・ドックレットからもWordベースのドックレットにコンテンツを直接埋め込むことができます。埋込みプロセスを使用すると、コンテンツのレイアウトおよびフォーマットがソース・リファレンス・ドックレットと同様にターゲット・ドックレットで維持されます。

ExcelベースとReportsベースの両方のリファレンス・ドックレットを、Wordベースのレポート・パッケージに含めることができます。埋込みコンテンツは結合されたレポートにマージされ、レビュー・フェーズ中にコメントできます。

Smart Viewで、Excelベースのリファレンス・ドックレットは、次のような文書作成フェーズのコンテンツ管理およびワークフロー機能をサポートします。
- リファレンス・ドックレットのチェックアウト、変更、アップロード、チェックイン、承認のための提出、承認または却下を行うことができます。
- 埋込みコンテンツが含まれるWordベースのドックレットのチェックアウト、変更、アップロード、チェックイン、承認のための提出、承認または却下を行うことができます。
- 埋込みコンテンツは、リファレンス・ドックレットの名前付き範囲に行われた更新と同期できます。
- 埋込みコンテンツをリフレッシュできます。
Reportsベースのリファレンス・ドックレットのワークフローは、Narrative Reporting Webインタフェースで管理されますが、文書作成フェーズのこれらのコンテンツ管理およびワークフロー機能は、次のようにSmart Viewでサポートされます。
- 埋込みコンテンツが含まれるWordベースのドックレットのチェックアウト、変更、アップロード、チェックイン、承認のための提出、承認または却下を行うことができます。
- 埋込みコンテンツは、リファレンス・ドックレットの名前付き範囲に行われた更新と同期できます。
- 埋込みコンテンツをリフレッシュできます。
リファレンス・ドックレット自体はレビュー・フェーズまたはサインオフ・フェーズでコメントに使用できないことに注意してください。ただし、ドックレットではリファレンス・ドックレットをソースとした埋込みコンテンツにコメントでき、その埋込みコンテンツは公開された最終レポートに含まれます。
参照ファイル

参照ファイルとは、Wordドックレットに埋め込むことができるレポート・コンテンツが含まれるExcelワークブックです。参照ファイルは、ドックレット、リファレンス・ドックレットおよびサプリメンタル・ドックレットとは異なり、レポート・パッケージの一部として示されません。かわりに、参照ファイルのコンテンツをWordドックレットに埋め込むと、その参照ファイルは、ドックレットのプロパティの一部になります。ターゲットWordドックレットをチェックアウトすると、Narrative Reportingでは、参照ファイルに行った変更が追跡されます。そのため、ターゲットWordドックレットに埋め込んだコンテンツをリフレッシュできます。

参照ファイル自体はレビュー・フェーズまたはサインオフ・フェーズでコメントに使用できないことに注意してください。ただし、Wordドックレットでは参照ファイルをソースとした埋込みコンテンツにコメントでき、その埋込みコンテンツは公開された最終レポートに含まれます。
サプリメンタル・ドックレット

サプリメンタル・ドックレットは、ソースおよびサポート・ファイルなどのレポート全体の開発を支援するドキュメントです。サプリメンタル・ドックレットは、Excel、Word、PowerPointなどのOfficeファイル・タイプあるいはPDF、TXT、ZIPなどのOffice以外のファイル・タイプにすることができます。サプリメンタル・ドックレットのコンテンツは、結合されたレポートにマージされません。

どのファイル・タイプのサプリメンタル・ドックレットも、WordベースとPowerPointベースの両方のレポート・パッケージに含めることができます。たとえば、Wordベースのサプリメンタル・ドックレットをWordベースまたはPowerPointベースのレポート・パッケージに含めることができます。

Smart Viewで、サプリメンタル・ドックレットは、次のような文書作成フェーズのコンテンツ管理およびワークフロー機能をサポートします。
- Officeベースのサプリメンタル・ドックレットのチェックアウト、変更、アップロード、チェックイン、承認のための提出、承認または却下を行うことができます。
- Office以外のファイル・タイプのサプリメンタル・ドックレットの場合、Smart Viewでは、割り当てられた文書作成者が簡単にファイルにアクセスし、ダウンロードして表示できます。ただし、チェックアウト、アップロード、チェックインなどのファイルとのその他のやり取りは、Narrative Reporting Webインタフェースを介して実行する必要があります。
どのファイル・タイプのサプリメンタル・ドックレットもレビュー・フェーズまたはサインオフ・フェーズでコメントに使用できないため、公開された最終レポートに含まれないことに注意してください。
変数

レポート・パッケージ変数を使用すると、共通のテキスト、数値、日付およびレポート・パッケージ全体でドックレットに表示されるデータを一元的に管理できます。変数は、リファレンス・ドックレットからWordドックレットへのExcelデータの挿入など、ドックレット間でのコンテンツの参照にも使用できます。

使用できる変数は次の2つのタイプです。
- 静的変数では、日付ラベルやセット値など、ユーザーによって定義された静的な入力を使用します(これはレポート・パッケージ全体で使用可能です)。これらの静的変数は簡単に更新でき、変数値のすべてのドックレット・インスタンスにその変更が反映されます。静的変数を使用すると、共通の日付、数値およびテキストをレポート・パッケージ・ドキュメント・コンテンツ全体で一元的に管理できます。
- 参照変数は、レポート・パッケージ内の別のドックレットをソースとして参照し、変数の値(Wordの段落またはExcelのセル値の中にあるテキストなど)を選択することで作成されます。その後ソース・ドキュメントが更新された場合、その変更は、レポート・パッケージ内の変数の挿入済インスタンスで自動的に更新されます。参照変数を使用すると、Excelのセル値をWordドックレットの段落に挿入したり、データの正確性を向上させるためにExcel式を作成してクロスフッティング・ルールを実装したり、レポート・ナラティブのための指示的な語句("増加"、"減少"など)を作成できます。