共用方式為

  • 發行項

資料摘要 XML 語法

將 XML 資料移入 PowerPivot 活頁簿的其中一種方法是建立資料服務或 Web 應用程式，以 PowerPivot for Excel 中容易取用的格式和結構串流 XML 資料。PowerPivot for Excel 包含內建的資料摘要讀取器，這個讀取器可以剖析符合 RFC4287 中所述之 Atom 1.0 資料新聞訂閱方式格式的 XML 結構。 

您可以使用各種工具和應用程式產生資料摘要，但是以 ADO.NET Data Services 3.5.1 Atom 格式建立資料服務的程式設計人員將會建立在 PowerPivot for Excel 中完整支援的摘要。下列產品與技術支援以 ADO.NET Atom 格式產生的 Atom 摘要：

  • ADO.NET Data Services

  • Windows Communication Foundation (WCF)

  • SharePoint 2010 Atom 摘要

  • SQL Server 2008 R2 Reporting Services Atom 摘要

使用其他工具或方法的程式設計人員將需要知道如何建構有效的 XML 回應，讓內建至 PowerPivot for Excel 的資料摘要讀取器可以處理這些回應。 本主題描述 PowerPivot 活頁簿支援的部分 Atom 1.0 語法。

如需有關如何使用 ADO.NET Data Services 從資料來源產生資料摘要的詳細資訊，請參閱 Microsoft 網站上的＜使用 ADO.NET Data Services＞(英文) 和＜原子格式 (ADO.NET 資料服務架構)＞。

將資料裝載圖像化

在全力投入 XML 語法的詳細資料之前，將匯入作業之後的資料本身呈現在 PowerPivot 活頁簿中的方式視覺化很有幫助。PowerPivot 資料來源是由熟悉的格線配置中排列成資料列和資料行的表格式資料所組成。當您匯入結構化的 Atom 1.0 資料時，結果集會包含在所有 Atom 摘要中呈現的內建資料元素，以及內含分析人員要使用之商業或產業資料的自訂資料。請設想下列範例，此範例會以粗體顯示內建的 Atom 資料元素，並以斜體顯示從內部人力資源資料庫呈現資料所使用的自訂資料元素。

id

title

updated

headcount

Open positions

Avg. Years in Dept

http://AW:8080/AWDept/AWDataService.svc/Dept(1)

Marketing department

2008-04-18T18:16:30Z

15

2

1.5

http://AW:8080/AWDept/AWDataService.svc/Dept(2)

Production department

2008-04-18T18:16:30Z

26

3

4

以上範例可用來說明下列重點：

  • 內建的欄位必須是結果集的一部分。諸如 id、title 和 updated 等欄位是以 Atom 1.0 語法指定，而且是摘要的必要部分。不過，您可以使用名稱為 "Include Atom Elements" 的資料摘要連接參數來加入或排除欄位。根據您設定參數的方式，在匯入摘要之後，使用者可能可以在 PowerPivot 工作空間中看到這些欄位。匯入摘要之後，如果 Atom 欄位在資料來源內容中沒有意義，則使用者可以刪除它們。

  • 自訂內容欄位可以用來傳回可用於 PowerPivot 活頁簿的任何資料。在多數情況下，裝載中的大部分資料都是由自訂內容所組成。

裝載範例的 XML 結構

Atom 1.0 資料摘要內含的 XML 表格式資料包含內建元素與自訂內容元素的組合。內建元素會提供用於處理的基本中繼資料。自訂資料則包含您要在摘要中使用的商業資料。表格式資料集中的每個資料列都包含內建和自訂的元素。

下列範例說明的簡易 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 服務必須傳回正確格式的 XML 文件，其中包含 <feed>、<entry> 和 <content> 資料結構。在資料摘要匯入之後，這些元素會對應到出現在 PowerPivot 工作空間之資料表中的資料表結構、資料列結構與資料值。

Atom 標準不包含提供將結構描述資訊傳遞到取用 XML 裝載之用戶端的功能。不過，確認是否將資料定義提供給用戶端應用程式的其中一個實用方法是將資料屬性指定為 XML 屬性。關於資料類型、格式和其他資料行屬性的結構描述資訊，會根據內嵌在 XML 資料元素中的描述產生。每個元素的屬性都會決定資料行是包含數值或文字資料。

摘要元素

摘要元素是中繼資料和資料的容器。它會描述將在 PowerPivot 活頁簿中建立的資料表。下列範例說明 PowerPivot for Excel 所使用之摘要元素的語法。

<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>

語法

元素或屬性

必要項

描述

<feed xmlns= >

否

xmlns 屬性用於解決元素名稱衝突。例如，如果您有兩個 <id> 元素，您可以在識別每個元素的命名空間前加上一個前置詞，其中 <atom:id> 指的是內建的資料行，而 <adventureworks:id> 指的是 Adventure Works 資料集中的識別碼。

如果您需要釐清內建的 Atom 摘要與共用相同名稱的其他欄位，您可以將 Atom 命名空間加入至摘要元素 (xmlns="http://www.w3.org/2005/Atom")，然後使用 atom 前置詞來識別元素 (例如，atom:id、atom:title、atom:updated)。

<title>

是

包含文字字串的 title 元素。如同用於 PowerPivot 資料摘要中，它也會指定資料摘要匯入 PowerPivot for Excel 時會在 PowerPivot 工作空間中建立之資料表的名稱。

在執行階段，<title> 元素的值是從 SharePoint 網站的資料服務文件讀取。

<id>

是

id 元素會唯一並永久識別摘要的執行個體。此值是僅供內部使用的中繼資料。它不會出現在 PowerPivot 工作空間的資料表或 SharePoint 網站的應用程式頁面中。

在 PowerPivot 資料摘要中，為資料重新整理而比較相同摘要的未來和過去執行個體時，會使用這個值。

這個值必須是 URI 或 IRI。此值區分大小寫。

<updated>

是

updated 元素會指定修改資料摘要的日期或時間。此值是僅供內部使用的中繼資料。它不會出現在 PowerPivot 工作空間的資料表或 SharePoint 網站的應用程式頁面中。

在 PowerPivot 資料摘要中，為資料重新整理而比較相同摘要的未來和過去執行個體時，會使用這個值。

這個值必須是有效的日期時間戳記。

忽略之摘要的子元素

PowerPivot for Excel 會忽略針對 <entry> 元素使用 Atom 1.0 新聞訂閱方式格式定義的其他所有元素。包括下列項目：

<Category>

<Contributor>

<Generator>

<Icon>

<Link>

<Logo>

<Rights>

<Subtitle>

<extensionElement>

Entry 元素

<entry> 元素包含資料列。下列範例說明 PowerPivot for Excel 所使用之 <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>

語法

元素或屬性

必要項

描述

<id>

是

id 元素會唯一並永久識別資料列的執行個體。比較相同資料列的其他執行個體時 (通常是在資料重新整理期間)，會使用這個值。這個值會出現在 PowerPivot 資料表的資料列中。

這個值必須是 URI 或 IRI。此值區分大小寫。

<title>

是

title 元素會指定資料摘要匯入 PowerPivot for Excel 時會在 PowerPivot 資料表中建立之資料列的名稱。

您必須指定此元素，但它不需要值。例如，下列元素是有效的 Atom 1.0 語法：

<title type="text" />

<updated>

是

updated 元素會指定修改資料摘要的日期或時間。這個值會出現在 PowerPivot 工作空間的資料表或 SharePoint 網站的應用程式頁面中。

<content>

是

在 Atom 1.0 語法中不需要此元素，但在將資料傳入 PowerPivot 工作空間的資料表時則需要。因為它包含您要使用的自訂資料。

沒有定義資料結構的結構描述。結構描述會在匯入作業期間，根據屬性和元素動態產生。在每個 <content> 中，元素是用來衍生資料行名稱和資料類型的資訊。

衍生之自訂內容的結構描述

資料摘要包含當做完整文件處理的獨立資料。因此，沒有針對結構描述的個別查閱。但是，您必須將資料定義內嵌在 XML 結構本身之內。

請考慮來自上述範例中的下列 XML 片段。請注意，資料類型會指定為屬性。

     <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>

忽略之項目的子元素

PowerPivot for Excel 會忽略針對 <entry> 元素使用 Atom 1.0 新聞訂閱方式格式定義的其他所有元素。包括下列項目：

<Category>

<Contributor>

<連結>

<Published>

<權限>

<Source>

<Summary>

<extensionElement>