ActiveReports使用教程：如何添加數(shù)據(jù)集

---

ActiveReports 是一款專注于 .NET 平臺的報表控件，全面滿足 HTML5、WinForm、ASP.NET、.NET Core、WPF 等平臺下的中國式復(fù)雜報表設(shè)計和跨平臺報表開發(fā)需求，作為專業(yè)的報表工具為全球超過 300,000 名開發(fā)者提供全面的報表解決方案。

點擊下載ActiveReports正式版

在Page報表或RDL報表中，將報表連接到數(shù)據(jù)源后，為了獲取要在報表中使用的字段列表，需要添加數(shù)據(jù)集。使用以下說明將數(shù)據(jù)集添加到報表中。

注意：CSV 數(shù)據(jù)源的數(shù)據(jù)集是在添加數(shù)據(jù)源時自動創(chuàng)建的。

這些步驟假定您已經(jīng)添加了Page Report / RDL Report模板并將其連接到數(shù)據(jù)源。

1、在“報表資源管理器”中，右鍵單擊數(shù)據(jù)源節(jié)點（默認(rèn)為DataSource1），然后選擇“添加數(shù)據(jù)集”選項或從“添加”按鈕中選擇“數(shù)據(jù)集...”。

2、在出現(xiàn)的“數(shù)據(jù)集” 對話框中，選擇“常規(guī)”頁面，然后輸入數(shù)據(jù)集的名稱。此名稱顯示為報表資源管理器中數(shù)據(jù)源圖標(biāo)的子節(jié)點。

3、在此對話框的“查詢”頁面上，從下拉列表中選擇“命令類型”。

• 文本-允許用戶在“查詢”框中輸入SQL查詢或XML路徑。
• StoredProcedure-允許用戶在“查詢”框中輸入存儲過程的名稱。
• TableDirect-允許用戶在“查詢”框中輸入表的名稱。

4、單擊“查詢”框上方右上角的“驗證數(shù)據(jù)集”圖標(biāo)以驗證查詢。

5、這些字段將自動添加到“數(shù)據(jù)集”對話框的“字段”頁面中。對于XML數(shù)據(jù)，請使用有效的XPath表達(dá)式在“字段”頁面上手動輸入字段。

6、您還可以在對話框的其他頁面上設(shè)置參數(shù)、過濾器和數(shù)據(jù)選項。

7、單擊確定按鈕關(guān)閉對話框。您的數(shù)據(jù)集和查詢字段在報告資源管理器中顯示為節(jié)點。

注意：如果您使用的是XML或JSON數(shù)據(jù)源提供程序，則必須使用“查詢”頁面上的XPath或JSONPath表達(dá)式提供XML路徑或JSON路徑，并在“數(shù)據(jù)集”對話框的“字段”頁面上生成字段。有關(guān)詳細(xì)信息，請參見以下示例。

XML數(shù)據(jù)的查詢和字段設(shè)置

連接字符串

xmldata連接字符串的示例

xmldata=<people>
  <person>
    <name>
      <given>John</given>
      <family>Doe</family>
    </name>
  </person>
  <person>
    <name>
      <given>Jane</given>
      <family>Smith</family>
    </name>
  </person>
</people>;

查詢頁面上的XMLPath

與查詢一起評估時，XMLPath表達(dá)式從XML數(shù)據(jù)源返回一個值。XML路徑用斜杠（/）表示，方括號（[]）表示元素集合上的迭代。

例如：/ people / person / name

您還可以使用XML數(shù)據(jù)集查詢生成器來構(gòu)建XMLPath。單擊“使用XML查詢設(shè)計器編輯”圖標(biāo)以打開“XML數(shù)據(jù)集查詢生成器”對話框，然后從樹節(jié)點中選擇XPath。

領(lǐng)域

設(shè)置查詢后，請使用包含以下名稱和值對的兩個字段來構(gòu)建Fields集合：

名稱：given； 值：given

名稱：family； 值：family

JSON數(shù)據(jù)的查詢和字段設(shè)置

連接字符串

JSON數(shù)據(jù)連接字符串的示例。

jsondoc=C:\Data\customers.json;schemadata={
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "address": {
      "type": "object",
      "properties": {
        "streetAddress": {
          "type": "string"
        },
        "city": {
          "type": "string"
        }
      },
      "required": [
        "streetAddress",
        "city"
      ]
    },
    "phoneNumber": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string"
          },
          "code": {
            "type": "integer"
          }
        },
        "required": [
          "location",
          "code"
        ]
      }
    }
  },
  "required": [
    "address",
    "phoneNumber"
  ]
}

查詢頁面上的JSONPath

與查詢一起評估時，JSONPath表達(dá)式從JSON數(shù)據(jù)源返回一個值。JSON路徑通常以點（.）表示，根對象為'$'。方括號（[]）表示元素的數(shù)組。

例如：$ .Customers [*]

您還可以使用JSON查詢構(gòu)建器構(gòu)建JSONPath，可以通過JSON查詢設(shè)計器圖標(biāo)編輯進(jìn)行訪問。JSON查詢構(gòu)建器顯示從JSON模式獲得的JSON數(shù)據(jù)的結(jié)構(gòu)。您可以從樹節(jié)點中選擇JSONPath。您還可以選擇創(chuàng)建多個數(shù)據(jù)集-只需選中“選擇多個節(jié)點”選項，然后選擇要添加為數(shù)據(jù)集的節(jié)點。

領(lǐng)域

設(shè)置查詢后，請使用包含以下名稱和值對的兩個字段來構(gòu)建Fields集合：

名稱：CompanyName； 值：CompanyName

名稱：ContactName； 值：ContactName

相關(guān)內(nèi)容推薦：

下載試用>>>

ActiveReports使用教程：如何連接到數(shù)據(jù)源

ActiveReports使用教程：如何在.Net Core 平臺中實現(xiàn) HTTP Handlers 功能

---

想要購買ActiveReports正版授權(quán)，或了解更多產(chǎn)品信息請點擊【咨詢在線客服】