データ フィード XML 構文

データ ペイロードについて

XML 構文を詳細に検討する前に、インポート操作の後、PowerPivot ワークスペースにデータがどのように示されるかを視覚的に把握すると効果的です。PowerPivot データ ソースは、見慣れたグリッド レイアウトの行と列に配置された表形式のデータで構成されます。構造化した Atom 1.0 データをインポートすると、結果セットには、どの Atom フィードにも存在する組み込みデータ要素、およびアナリストが使用するビジネスまたは産業データを含むカスタム データが含まれます。組み込み Atom データ要素 (太字で表示)、および社内の人事部のデータベースのデータの表示に使用するカスタム データ要素 (斜体で表示) を示す次の例を考えてみましょう。

上の例により、次の要点を説明できます。

• 組み込みフィールドは結果セットの一部に含めることができます。id、title、updated などのフィールドは、Atom 1.0 構文で指定され、フィードの必須部分です。ただし、"Include Atom Elements" というデータ フィード接続パラメーターを使用すると、フィールドを含めたり除外したりできます。このパラメーターを構成する方法により、フィードのインポート後、PowerPivot ワークスペースに表示されるフィールドが決まります。フィードをインポートした後は、データ ソースのコンテキストで意味のない Atom フィールドを削除できます。

• カスタム コンテンツ フィールドを使用すると、PowerPivot ブックで役立つデータを返すことができます。ほとんどの場合、ペイロード内のデータの大半がカスタム コンテンツです。

ペイロードの例の XML 構造

Atom 1.0 データ フィードには、XML 表形式データが含まれます。このデータには、組み込み要素とカスタム コンテンツ要素の組み合わせが含まれています。組み込み要素は、処理に必要なメタデータを提供します。カスタム データには、フィードで使用可能にするビジネス データが含まれます。表形式のデータセットの各行には、ビルトイン要素とカスタム要素の両方が含まれます。

以下の例では、前の例の 2 行のデータを提供する単純な Atom 1/0 データ ドキュメントを示しています。組み込み Atom 要素は、太字で示されています。

<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <title type="text">Departments</title>
  <id>http://Adventure-works:8080/AW/AWDataService.svc/Department</id>
  <updated>2008-04-18T18:16:30Z</updated>
  <entry>
     <id>http://AW:8080/AWDept/AWDataService.svc/Dept(1)</id>
     <title type="text">Marketing department</title>
     <updated>2008-04-18T18:16:30Z</updated>
     <content type="application/xml">
     <d:headcount type="int">15</d:headcount>
     <d:openpositions type="int">2</d:openpositions>
     <d:yrsinposition type="int">1.5</d:yrsinposition>
     </content>
  </entry>
  <entry>
     <id>http://AW:8080/AWDept/AWDataService.svc/Dept(2)</id>
     <title type="text">Production department</title>
     <updated>2008-04-18T18:16:30Z</updated>
     <content type="application/xml">
     <d:headcount type="int">26</d:headcount>
     <d:openpositions type="int">3</d:openpositions>
     <d:yrsinposition type="int">4</d:yrsinposition>
     </content>
  </entry>
</feed>

XML リファレンス

データまたは Web サービスは、<feed>、<entry> および <content> データ構造を含む適切な形式の XML ドキュメントを返す必要があります。これらの要素は、データ フィードのインポート後に PowerPivot ワークスペースに表示されるテーブル構造、行構造、データ値にマップします。

Atom 標準には、XML ペイロードを使用するクライアントへスキーマ情報を渡すための規定は含まれていません。しかし、クライアント アプリケーションにデータ定義を提供する実際的な方法は、データ属性を XML 属性として指定することです。データ型に関するスキーマ情報、フォーマット、その他の列属性は、XML データ要素に埋め込まれた記述に基づき生成されます。各要素の属性は、列に格納されるデータが数値データかテキスト データかを決定します。

Feed 要素

<feed xmlns="http://www.w3.org/2005/Atom">
   <title type="text">My Table Name</title>
   <id>http://UniversalResourceIdentifier/identifiesthisfeed</id>
   <updated>2008-10-31:09:23:34:1832</updated>
   <entry />
</feed>

Entry 要素

<entry>
   <id>http://AW:8080/AW/AWDataService.svc/Department(1)</id>
   <title type="text" />
   <updated>2008-04-18T18:16:30Z</updated>
   <content />   ;* contains data
</entry>

     <content type="application/xml">
     <d:headcount type="int">15</d:headcount>
     <d:openpositions type="int">2</d:openpositions>
     <d:yrsinposition type="int">1.5</d:yrsinposition>
     </content>