レポートでのパラメーターの使用

公開日: 2016年11月

対象: Dynamics CRM 2015

レポートでパラメーターを使用して、ユーザーがレポートを実行するときに 1 つまたは一連の値の入力を求めることにより、取得するデータを制御します。 このデータセット クエリでは、ユーザーが要求するデータのみ取得します。 また、ユーザーに入力を求めず、データのフィルター処理や動的なドリルスルーなどの操作に使用可能な非表示のパラメーターおよび特殊なパラメーターをレポートに追加することもできます。

このトピックの内容

パラメーターの追加

非表示のパラメーター

パラメーターの追加

レポートの個々のパラメーターの定義、クエリを使用した情報の引き渡し、またはユーザー設定へのアクセス権の付与のためのパラメーター (CRM_CurrencySymbol パラメーターや CRM_CurrencyPositivePattern パラメーターなど) をレポートに追加できます。

<ReportParameter> は、レポートでの個々のパラメーターの記述に使用する、レポート定義 (RDL) ファイルの要素です。<QueryParameter> には、クエリの一部としてデータ ソースに渡す個々のパラメーターに関する情報が含まれています。 取引先企業の説明レポートの RDL ファイルから抜粋した次の XML コードは、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>

次の例は、QueryParameterベースのレポートでの ReportParameter パラメーターと Fetch パラメーターの使用方法を示しています。

<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 クラスで指定されている値と同様です。 これらのパラメーターをカスタム レポート内で使用することで、データをユーザー設定に従ってフォーマットできます。

関連項目

設置型用 CRM 2015 を使用してレポートを作成する
SQL ベースのレポートに関する作業 (CRM の設置型のみ)
レポートの公開

© 2016 Microsoft Corporation. All rights reserved. 著作権