Verwenden von Parametern in Berichten

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Sie können Parameter in Berichten verwenden, um die Daten zu steuern, die abgerufen werden, indem Sie den einen Benutzer auffordern, einen Wert oder einen Satz von Werten anzugeben, wenn der Benutzer den Bericht ausführt. Die Datasetabfrage ruft nur die Daten ab, die vom Benutzer angefordert werden. Sie können auch ausgeblendete und spezielle Parameter in den Berichten hinzufügen, die den Benutzer nicht zu einer Eingabe auffordern, jedoch für Vorgänge wie Datenfilterung und dynamisches Drillthrough verwendet werden können.

In diesem Thema

Hinzufügen von Parametern

Ausgeblendete Parameter

Hinzufügen von Parametern

Sie können einem Bericht Parameter hinzufügen, um die einzelnen Parameter eines Berichts zu definieren, Informationen über eine Abfrage zu übergeben, oder Zugriff auf Benutzereinstellungen wie CRM_CurrencySymbol- und CRM_CurrencyPositivePattern-Parameter zu ermöglichen.

Der <ReportParameter> ist ein Element in der Datei Berichtsdefinitions (rdl)-, die verwendet wird, um einen Parameter im jeweiligen Bericht zu beschreiben. Der <QueryParameter> enthält Informationen zu einem einzelnen zur Parameter, der der Datenquelle als Teil einer Abfrage übergeben werden kann. Der folgende XML-Code aus der RDL-Datei des Firmenzusammenfassungsberichts zeigt, wie die gesammelten ReportParameter- und QueryParameter-Parameter verwendet werden.

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

Die folgenden Beispiele veranschaulichen, wie die QueryParameter und ReportParameter-Parameter in einem Fetch-basierten Bericht verwendet werden.

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

Ausgeblendete Parameter

Der Berichtsdesigner in Microsoft Visual Studio besitzt integrierte Unterstützung für ausgeblendete Parameter. Darüber hinaus können Sie Parameter ausblenden, indem Sie dem Parameternamen ein CRM_ prefix in einem Microsoft Dynamics 365-Bericht hinzufügen. Standardmäßig werden die Parameter mit einem CRM_ prefix ausgeblendet, wenn der Bericht über Microsoft Dynamics 365 veröffentlicht wird. Wenn Sie den Bericht ausführen, werden Sie nicht aufgefordert, Parameterwerte für die ausgeblendeten Parameter einzugeben.

Spezielle Parameter

In der folgenden Tabelle sind die Speicherorte speziellen ausgeblendeten Parameter dargestellt, die Sie in Berichten den verwenden können.

Sie müssen alle Parameter in einem Bericht erstellen, bevor Sie auf sie verweisen können. Die Werte dieser speziellen Parameter werden von Microsoft Dynamics 365 ausgefüllt, wenn Sie den Bericht ausführen.

Zusätzliche Formatparameter

Die folgenden Tabelle enthält zusätzliche Parameter, die Sie in den Berichten verwenden können. Unter diesen gibt es Parameter, die Zugriff auf die Zahleneinstellungsinformationen der Benutzer gewährt. Sie können diese Werte verwenden, um die numerischen Werte zu formatieren und anzuzeigen. Diese Parameter sind vergleichbar mit den Werten, die in der NumberFormatInfo-Klasse angegeben wurden. Verwenden Sie diese Parameter in benutzerdefinierten Berichten, um die Daten entsprechend den Benutzereinstellungen zu formatieren.

Siehe auch

Berichterstellung und Analyse mit Dynamics 365
Verwenden von SQL-basierten Berichten (Dynamics 365 nur in der lokalen Version)
Veröffentlichen von Berichten

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright