Verwenden von Parametern in Berichten

2025-05-21

Sie verwenden Parameter in Berichten, um die abgerufenen Daten zu steuern, indem Sie den Benutzer zur Eingabe eines Werts oder einer Reihe von Werten auffordern, wenn der Benutzer den Bericht ausführt. Die Datasetabfrage ruft nur die Daten ab, die vom Benutzer angefordert werden. Sie können den Berichten auch ausgeblendete und spezielle Parameter hinzufügen, die den Benutzer nicht zur Eingabe auffordern, aber für Vorgänge wie Datenfilterung und dynamischen Drillthrough verwendet werden können.

Hinweis

Die maximale Länge der Parameterwerte, die von Microsoft Dynamics 365 Customer Engagement (on-premises) übergeben werden, beträgt 2.000 Zeichen. Wenn Sie z. B. einen Bericht ausführen und einen Datenfilter über die Benutzeroberfläche der erweiterten Suche erstellen, darf der resultierende Filterausdruck, der an einen Filterparameter übergeben wird, 2.000 Zeichen nicht überschreiten. Es gibt keine Obergrenze für die Anzahl der Parameter, die Sie angeben können. Möglicherweise müssen Sie jedoch die Länge der Zeichenfolge in der URL-Zeile und die Anzahl der Parameter begrenzen, um die Anforderungen eines bestimmten Browsers zu erfüllen.

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 zu gewähren, z. B CRM_CurrencySymbol . und CRM_CurrencyPositivePattern Parameter.

Der <ReportParameter> ist ein Element in der Berichtsdefinitionsdatei (RDL), das verwendet wird, um einen einzelnen Parameter im Bericht zu beschreiben. Der <QueryParameter> enthält Informationen zu einem einzelnen Parameter, der als Teil einer Abfrage an die Datenquelle übergeben wird. Der folgende XML-Code aus der RDL-Datei des Berichts "Kontozusammenfassung" veranschaulicht die Verwendung der Parameter ReportParameter und 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>

Die folgenden Beispiele zeigen, wie die QueryParameter Parameter und ReportParameter 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>

Versteckte Parameter

Der Berichts-Designer in Visual Studio verfügt über eine integrierte Unterstützung für ausgeblendete Parameter. Darüber hinaus können Sie Parameter ausblenden, indem Sie dem Parameternamen in einem Bericht ein CRM_Präfix hinzufügen. Standardmäßig werden die Parameter mit dem Präfix CRM_ ausgeblendet, wenn der Bericht 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 speziellen ausgeblendeten Parameter aufgeführt, die Sie in Ihren Berichten verwenden können.

Parameter	BESCHREIBUNG
`CRM_FilterText`	Enthält den Wert des Filtertextes, den ein Berichtsbenutzer interaktiv im Berichts-Viewer erstellt, wenn der Benutzer einen Bericht ausführt. Der Parameter befindet sich in einem Textfeld für die Filterzusammenfassung, das sich in der Kopfzeile des Berichts befindet. Der Anfangswert wird auf den Standardfilter gesetzt.
`CRM_URL`	Stellen Sie die URL der App ein. Verwenden Sie diesen Parameter beim Drillthrough.
`CRM_FilteredEntity`	Verwenden Sie diese Option in einem Abfrageausdruck, um die Datenvorfilterung (über die erweiterte Suche) zu aktivieren.

Sie müssen alle Parameter in einem Bericht erstellen, bevor Sie auf sie verweisen können. Die Werte dieser speziellen Parameter werden von Customer Engagement (on-premises) ausgefüllt, wenn Sie den Bericht ausführen.

Zusätzliche Formatparameter

Die folgende Tabelle enthält zusätzliche Parameter, die Sie in den Berichten verwenden können. Darunter befinden sich Parameter, die den Zugriff auf die Informationen der Benutzernummern-Einstellungen bieten. Sie können diese Werte verwenden, um die numerischen Werte zu formatieren und anzuzeigen. Diese Parameter ähneln den Werten, die in der NumberFormatInfo-Klasse angegeben sind. Verwenden Sie diese Parameter in benutzerdefinierten Berichten, um die Daten gemäß den Benutzereinstellungen zu formatieren.

Parameter	BESCHREIBUNG
`CRM_FullName`	Der vollständige Name des Benutzers, in dessen Namen der Bericht ausgeführt wird.
`CRM_UserTimeZone`	Der Name der Zeitzone des Benutzers, z. B. Pacific Standard Time.
`CRM_UILanguageId`	Aktuelles Gebietsschema des Benutzers (LCID).
`CRM_YearStartWeekCode`	Die erste Woche des Jahres, die in Dynamics 365 for Customer Engagement-Apps verwendet wird.
`CRM_WeekStartDayCode`	Der erste Tag der Woche, der in Customer Engagement verwendet wird.
`CRM_FiscalCalendarStart`	Das Startdatum für das Geschäftsjahr, das in Customer Engagement verwendet wird.
`CRM_FiscalPeriodType`	Gibt an, wie das Geschäftsjahr unterteilt wird: Vierteljährlich, Monatlich, Jährlich usw.
`CRM_FiscalYearDisplayCode`	Gibt an, ob der Name des Geschäftsjahres basierend darauf angezeigt wird, wann das Geschäftsjahr beginnt oder endet.
`CRM_FiscalYearPeriodConnect`	Gibt an, wie das Geschäftsjahr und die Geschäftsperiode miteinander verbunden sind, wenn sie zusammen angezeigt werden.
`CRM_FiscalYearFormat`	Gibt an, wie der Name des Geschäftsjahres angezeigt wird.
`CRM_FiscalPeriodFormat`	Gibt an, wie der Abrechnungszeitraum angezeigt wird.
`CRM_FiscalYearPrefixFormat`	Gibt an, ob ein Präfix an das Geschäftsjahr angehängt wird, wenn es angezeigt wird.
`CRM_FiscalYearSuffixFormat`	Gibt an, ob ein Suffix an das Geschäftsjahr angehängt wird, wenn es angezeigt wird.
`CRM_CurrencyDecimalPrecision`	Die Dezimalgenauigkeit der Währung.
`CRM_CurrencySymbol`	Das Währungssymbol der Organisation.
`CRM_CurrencyPositivePattern`	Das Formatmuster für positive Währungswerte.
`CRM_CurrencyNegativePattern`	Das Formatmuster für negative Währungswerte.
`CRM_NumberDecimalDigits`	Die Anzahl der Dezimalstellen, die in numerischen Werten verwendet werden sollen.
`CRM_NumberDecimalSeperator`	Die Zeichenfolge, die als Dezimaltrennzeichen in numerischen Werten verwendet wird.
`CRM_NumberNegativePattern`	Das Formatmuster für negative numerische Werte.
`CRM_NumberGroupSizes`	Die Anzahl der Ziffern in jeder Gruppe links von der Dezimalstelle in numerischen Werten.
`CRM_NumberGroupSeperator`	Die Zeichenfolge, die Gruppen von Ziffern links von der Dezimalstelle in numerischen Werten trennt.
`CRM_DateSeparator`	Die Zeichenfolge, die die Komponenten eines Datums trennt, z. B. Jahr, Monat und Tag.
`CRM_TimeSeparator`	Die Zeichenfolge, die die Komponenten der Zeit trennt, z. B. Stunde, Minuten und Sekunden.
`CRM_AMDesignator`	Die Zeichenfolge, die die Komponenten der Zeit trennt, z. B. Stunde, Minuten und Sekunden
`CRM_PMDesignator`	Der Bezeichner für Stunden, die "post meridiem" (PM) sind.
`CRM_ShortDatePattern`	Das Formatmuster für einen kurzen Datumswert, der dem Formatmuster "d" zugeordnet ist.
`CRM_LongDatePattern`	Das Formatierungsmuster für einen langen Datumswert, der dem Formatmuster "D" zugeordnet ist.
`CRM_ShortTimePattern`	Das Formatierungsmuster für einen kurzen Zeitwert, der dem Formatmuster "t" zugeordnet ist.
`CRM_MonthDayPattern`	Das Formatmuster für Monats- und Tagswerte, die den "m"- und "M"-Formatmustern zugeordnet sind.

Siehe auch

Handbuch zu Berichterstellung und Analyse
Veröffentlichen von Berichten