在報表中使用參數

發行︰ 2017年1月

適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

在使用者執行報表時，向使用者提示一個值或一組值，就可以在報表中使用參數來控制擷取的資料。 資料集查詢只會擷取使用者要求的資料。 您也可以在不會提示使用者輸入，但是可以用於作業 (例如資料篩選和動態鑽研) 的報表中新增隱藏和特殊參數。

本主題內容

新增參數

隱藏的參數

新增參數

您可以將參數新增至報表以定義報表的個別參數、透過查詢傳遞資訊，或提供使用者設定的存取權，例如 CRM_CurrencySymbol 和 CRM_CurrencyPositivePattern 參數。

<ReportParameter> (英文) 是報表定義 (RDL) 檔中的一個元素，用來描述報表中的個別參數。<QueryParameter> (英文) 包含隨查詢傳遞至資料來源的個別參數的相關資訊。 下列 XML 程式碼取自 [帳戶摘要] 報表的 RDL 檔，會示範如何使用 ReportParameter 和 QueryParameter 參數。

<ReportParameter Name="CRM_FilteredAccount">
  <DataType>String</DataType>
    <Nullable>true</Nullable>
    <DefaultValue>
      <Values>
         <Value>select * from FilteredAccount</Value>
      </Values>
    </DefaultValue>
    <AllowBlank>true</AllowBlank>
    <Prompt>CRM_FilteredAccount</Prompt>
</ReportParameter>

<Query>
   <rd:UseGenericDesigner>true</rd:UseGenericDesigner>
   <CommandText>declare @sql as nVarchar(max)
      set @sql = '
      SELECT top 10 CAST(accountid as nvarchar(100)) as AccountID,
      name, '''' as None
      FROM (' + @FilteredAccount + ') as fa'
      exec(@sql)
   </CommandText>
   <QueryParameters>
      <QueryParameter Name="@FilteredAccount">
         <Value>=Parameters!FilteredAccount.Value</Value>
      </QueryParameter>
   </QueryParameters>
   <DataSourceName>CRM</DataSourceName>
</Query>

下列範例示範如何在 Fetch 報表中使用 QueryParameter 和 ReportParameter 參數。

<ReportParameter Name="FilteredAccount">
      <DataType>String</DataType>
      <Prompt>Filtered Account</Prompt>
            <DefaultValue>
                  <Values>
                        <Value>
                              <fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">
                              <entity name="account">
                              <all-attributes/>
                              </entity>
                              </fetch>
                        </Value>
                  </Values>
            </DefaultValue>
    </ReportParameter>

<Query>
        <DataSourceName>DataSource1</DataSourceName>
        <CommandText>
                  <fetch> 
                  <entity name="account" enableprefiltering="true" prefilterparametername="FilteredAccount">
                  <attribute name="accountid" />
                  <attribute name="name" />
                  </entity>
                  </fetch>
            </CommandText>
        <QueryParameters>
          <QueryParameter Name="FilteredAccount">
            <Value>=Parameters!FilteredAccount.Value</Value>
          </QueryParameter>
        </QueryParameters>
        <rd:UseGenericDesigner>true</rd:UseGenericDesigner>
      </Query>

隱藏的參數

Microsoft Visual Studio 中的報表設計師內建隱藏參數的支援。 此外，您可以在 Microsoft Dynamics 365 報表中新增 CRM_ prefix 至參數名稱，藉此隱藏參數。 根據預設，報表透過 Microsoft Dynamics 365 發行時，具有 CRM_ prefix 的參數會隱藏。 當您執行報表時，不會提示您輸入隱藏參數的參數值。

特殊參數

下表顯示可以在報表中使用的特殊隱藏參數。

您必須先在報表中建立所有參數，才能參考這些參數。 這些特殊參數的值會在您執行報表時，由 Microsoft Dynamics 365 填入。

其他格式參數

下表包含可以在報表中使用的其他參數。 其中包含可讓您存取使用者數字設定資訊的參數。 您可以使用這些值來格式化和顯示數值。 這些參數類似 NumberFormatInfo 類別 中指定的值。 根據使用者設定，使用這些參數在自訂報表中格式化資料。

另請參閱

Dynamics 365 的報表與分析
使用 SQL 報表 (僅限 Dynamics 365 內部部署)
發行報表

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權