Utilitzar paràmetres als informes

2025-05-12

Utilitzeu paràmetres als informes per controlar les dades recuperades demanant a l'usuari un valor o un conjunt de valors quan l'usuari executa l'informe. La consulta del conjunt de dades només recupera les dades sol·licitades per l'usuari. També podeu afegir paràmetres ocults i especials als informes que no demanen a l'usuari l'entrada, però que es poden utilitzar per a operacions com ara el filtratge de dades i l'exploració dinàmica.

Nota

La longitud màxima dels valors de paràmetre que es passen des del Microsoft Dynamics 365 Customer Engagement (on-premises) és de 2.000 caràcters. Per exemple, si executeu un informe i creeu un filtre de dades a través de la interfície d'usuari de Cerca avançada , l'expressió de filtre resultant que es passa a un paràmetre de filtre no pot superar els 2.000 caràcters. No hi ha cap límit màxim en el nombre de paràmetres que podeu especificar. Tanmateix, és possible que hàgiu de limitar la longitud de la cadena a la línia d'URL i el nombre de paràmetres per complir els requisits d'un navegador concret.

Afegir paràmetres

Podeu afegir paràmetres a un informe per definir els paràmetres individuals d'un informe, passar informació a través d'una consulta o proporcionar accés a la configuració de l'usuari, com ara CRM_CurrencySymbol i CRM_CurrencyPositivePattern paràmetres.

ReportParameter<> és un element del fitxer de definició d'informe (RDL) que s'utilitza per descriure un paràmetre individual de l'informe. QueryParameter<> conté informació sobre un paràmetre individual que es passa a la font de dades com a part d'una consulta. El codi XML següent extret del fitxer RDL de l'informe Resum del compte mostra com utilitzar els ReportParameter paràmetres i 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>

Els exemples següents mostren com utilitzar els QueryParameter paràmetres i ReportParameter en un Fetch informe basat.

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

Paràmetres ocults

El dissenyador d'informes de Visual Studio té suport integrat per a paràmetres ocults. A més, podeu amagar els paràmetres afegint un prefix CRM_ al nom del paràmetre d'un informe. Per defecte, els paràmetres amb un prefix CRM_ s'amaguen quan es publica l'informe. Quan executeu l'informe, no se us demanarà que introduïu valors de paràmetre per als paràmetres ocults.

Paràmetres especials

A la taula següent es mostren els paràmetres ocults especials que podeu utilitzar als informes.

Paràmetre	Descripció
`CRM_FilterText`	Conté el valor del text del filtre que un usuari de l'informe crea de manera interactiva al Visualitzador d'informes quan executa un informe. El paràmetre es troba en un quadre de text de resum del filtre que es troba a la capçalera de l'informe. El valor inicial s'estableix al filtre per defecte.
`CRM_URL`	Definiu-lo a l'URL de l'aplicació. Utilitzeu aquest paràmetre quan perforeu.
`CRM_FilteredEntity`	Utilitzeu-lo en una expressió de consulta per habilitar el filtratge previ de dades (mitjançant la cerca avançada).

Heu de crear tots els paràmetres d'un informe per poder consultar-los. Els valors d'aquests paràmetres especials els emplena el Customer Engagement (on-premises) quan executeu l'informe.

Paràmetres de format addicionals

La taula següent conté paràmetres addicionals que podeu utilitzar als informes. Entre ells hi ha paràmetres que proporcionen accés a la informació de configuració del número d'usuari. Podeu utilitzar aquests valors per formatar i visualitzar els valors numèrics. Aquests paràmetres són similars als valors especificats a la classe NumberFormatInfo. Utilitzeu aquests paràmetres en informes personalitzats per formatar les dades segons la configuració de l'usuari.

Paràmetre	Descripció
`CRM_FullName`	Nom complet de l'usuari en nom del qual s'executa l'informe.
`CRM_UserTimeZone`	Nom de la zona horària de l'usuari, per exemple, hora estàndard del Pacífic.
`CRM_UILanguageId`	Configuració regional actual (LCID) de l'usuari.
`CRM_YearStartWeekCode`	La primera setmana de l'any que s'utilitza a les aplicacions del Dynamics 365 for Customer Engagement.
`CRM_WeekStartDayCode`	El primer dia de la setmana que s'utilitza al Customer Engagement.
`CRM_FiscalCalendarStart`	Data d'inici de l'exercici fiscal que s'utilitza al Customer Engagement.
`CRM_FiscalPeriodType`	Especifica com es divideix l'exercici fiscal: trimestral, mensual, anual, etc.
`CRM_FiscalYearDisplayCode`	Especifica si el nom de l'exercici es mostra en funció de quan comença o acaba l'exercici.
`CRM_FiscalYearPeriodConnect`	Especifica com es connecten l'exercici i el període fiscal quan es mostren junts.
`CRM_FiscalYearFormat`	Especifica com es mostrarà el nom de l'exercici.
`CRM_FiscalPeriodFormat`	Especifica com es mostrarà el període fiscal.
`CRM_FiscalYearPrefixFormat`	Especifica si s'adjunta un prefix a l'exercici quan es mostra.
`CRM_FiscalYearSuffixFormat`	Especifica si s'adjunta un sufix a l'exercici quan es mostra.
`CRM_CurrencyDecimalPrecision`	La precisió decimal de la moneda.
`CRM_CurrencySymbol`	El símbol de moneda de l'organització.
`CRM_CurrencyPositivePattern`	Patró de format per a valors de moneda positius.
`CRM_CurrencyNegativePattern`	Patró de format per als valors de moneda negatius.
`CRM_NumberDecimalDigits`	El nombre de decimals que s'utilitzaran en valors numèrics.
`CRM_NumberDecimalSeperator`	La cadena que s'utilitza com a separador decimal en valors numèrics.
`CRM_NumberNegativePattern`	Patró de format per a valors numèrics negatius.
`CRM_NumberGroupSizes`	El nombre de dígits de cada grup a l'esquerra del decimal en valors numèrics.
`CRM_NumberGroupSeperator`	La cadena que separa els grups de dígits a l'esquerra del decimal en valors numèrics.
`CRM_DateSeparator`	La cadena que separa els components d'una data, com ara l'any, el mes i el dia.
`CRM_TimeSeparator`	La cadena que separa els components del temps, com ara l'hora, els minuts i els segons.
`CRM_AMDesignator`	La cadena que separa els components del temps, com ara l'hora, els minuts i els segons
`CRM_PMDesignator`	El designador de les hores que són "post meridiem" (PM).
`CRM_ShortDatePattern`	Patró de format d'un valor de data curta associat amb el patró de format "d".
`CRM_LongDatePattern`	Patró de format d'un valor de data llarga associat amb el patró de format "D".
`CRM_ShortTimePattern`	Patró de format per a un valor de temps curt que s'associa amb el patró de format "t".
`CRM_MonthDayPattern`	Patró de format per als valors de mes i dia associats amb els patrons de format "m" i "M".

Consulteu també

Guia d'informes i anàlisis
Publicar informes