書付

dRofusからXMLを取得し、データソースを割り当てます。

レポートをPublisherで作成する場合、最初に行わなければならないことは、データ・ソースを割り当てることです。データソースはdRofusのデータを含むXMLファイルです。
サンプルパックに含まれるサンプルXMLファイルを使用するか、dRofusから生成することができます。特定のプロジェクトのレポートを作成する場合、
XMLファイル内のデータがそのプロジェクトに特有である可能性があるため、dRofusから生成することが有益です。dRofusの "Reports and exports (リポートとエクスポート)"から、
新しいレポートで使用したいデータと類似している、または含まれているレポートを見つけます。必要なデータを選択し、オプションを設定します。
その他のオプション (options)→ フォーマット (Format) で XML に設定します：

いくつかのオプションは、取得するデータ (例：どの部屋) を制限し、またいくつかは、各部屋のためにエクスポートするXMLを定義することにご注意ください。 
例えば、"With pictures (画像付き)" オプションがチェックされていない限り、画像はXMLの一部にはなりません。また、現在のアイテムにその属性に関するデータが存在しない限り、
すべてのXML属性が含まれるわけではないことをご注意下さい。例えば、もしプロジェクトに余分な部屋のコアフィールドがある場合、その属性は実際にその値がある部屋だけに含まれます。 
そのため、レポートをデザインする際には、xmlをデータベースの一部のみに限定し、レポートに必要なデータをすべて含めることをお勧めします。 
正しいプレビューを得るためには、部屋など少なくとも2つのアイテムをデータに含めることをお勧めします。
ファイルを保存し、 Publisherで "Home (ホーム)" → "Assign Data Source (データソースの割り当て)"を選択し、"Data Source (データソース)"でXMLファイルを参照します。
XMLデータは、下図のようにデータ・ソース・ペイン(3)(デフォルトは右)に表示されます。 
これで、データソース(3)からドキュメント/ページ(1)にデータをドラッグ＆ドロップすることで、レポートの作成を開始できます。

Google Chromeユーザーへの重要なお知らせです： chrome バージョン15以下ではバグがあるため、このレポートを実行するたびにdrofus.xmlファイルをダウンロードフォルダから削除するか、オプション（）→Under the Bonnet→Downloadsで "Ask where to save each file before downloading (ダウンロードする前に、各ファイルの保存場所を尋ねる)" に、
チェックが入っていることを確認する必要があります。バージョン16 (現在ベータ版) では、これは必要ありません。

XF Designerは以下の重要な要素で構成されています：

1. The document (ドキュメント)：これはドキュメントのデザインを表示し、ワードプロセッシングツールと直接同様に編集できます。
2. Navigation bar (ナビゲーションバー)：ドキュメント内で現在選択されている要素/セクションを表示し、
要素に小さなスペースまたは見えないスペースがある場合、1 を使用するよりも簡単な方法で要素に移動できます。
3. Data source (データソース)：データソースのデータを閲覧したり、ドキュメントにドラッグ＆ドロップすることができます。
ここではページレイアウトとページセットも確認できます。ページセットを見るには、表示→表示/非表示の "ページ分割 (ページネーション)"オプションをチェックしてください。
4. Properties pane (プロパティ・ペイン)：1 または 2 で選択した要素の詳細プロパティ。
5. Ribbon menu (リボンメニュー)

まず最初にしたいことのひとつは、ページレイアウトの設定とヘッダーとフッターの作成だと思います。
これは "ページレイアウト (Page Layout )"リボンで行います。ビルディングブロックを使用して、複数のレポートで同じヘッダー/フッターを作成することもできます。

XMLデータに基づいてレポートを作成する際の基本は、XPathの基本を理解することです。XPath は XML ドキュメントの一部を記述するために使用される構文であり、
必要なデータへのパスとして考えることができます。ドキュメント内のすべての部屋のようなノードのセット、部屋の部屋名属性のような特定の属性、
その他多くのバリエーションを参照することができます。
XF Designerがこれらの式のほとんどを作成する手助けをしてくれますが、ある程度理解しておくことをお勧めします。
より高度なレポート/タスクの中には、いくつかの式を手動で編集する必要があるものもあります。

複数のノードを参照する場合は、ノード・セットを参照。 右の画像例では、次のように表現されています。 /drofus-xml/room-container/room 部屋コンテナ・ノードの下にあるすべての部屋ノード（この場合は2部屋）を参照。 この種類のXPath式は、XMLの各部屋に対して何かをしたいときに使います。 特定の属性値を取得したい場合、 例えば、プロジェクト名属性の値など。 /drofus-xml/property-set/@project_name また、テストや その他の演算に使える関数もあります：例えば、sum、countなど 表現： count(/drofus-xml/room-container/room) このドキュメントの部屋数 2 を返します。