Użyj parametrów w raportach

Artykuł
03/22/2023

Parametry są używane w raportach w celu kontrolowania pobranych danych przez monitowanie użytkownika o wartość lub zbiór wartości, gdy użytkownik uruchamia raport. Zapytanie zestaw danych pobiera tylko dane, których użytkownik zażąda. Można również dodać parametry ukryte i specjalne w raportach, które nie kierują do użytkownika monitu o wprowadzenie danych, ale można ich używać dla operacji takich jak filtrowanie danych i dynamiczne raporty szczegółowe.

Uwaga

Maksymalna długość wartości parametrów, które są przekazywane z Microsoft Dynamics 365 Customer Engagement (on-premises) to 2000 znaków. Na przykład, jeśli uruchamiasz raport i tworzysz filtr danych za pomocą interfejsu użytkownika Szukanie zaawansowane, wynikowe wyrażenie filtru przekazywane do parametru filtru nie może przekraczać 2000 znaków. Nie istnieje ograniczenie maksymalnej liczby parametrów, które można określić. Jednak może być koniecznym ograniczenie długości ciągu w wierszu adres URL oraz liczby parametrów w celu spełnienia wymagań określonej przeglądarki.

Dodawanie parametrów

Możesz dodać parametry do raportu, aby zdefiniować poszczególne parametry raportu, przekazać informacje za pomocą zapytania lub zapewnić dostęp do ustawień użytkownika, takich jak CRM_CurrencySymbol i CRM_CurrencyPositivePattern.

<ReportParameter > jest elementem w pliku definicji raportu (RDL), który jest używany do opisywania poszczególnych parametrów w raporcie. <QueryParameter > zawiera informacje o poszczególnych parametrach, które są przekazywane do źródła danych w ramach zapytania. Poniższy kod XML z pliku RDL raportu Podsumowanie Konta pokazuje, jak używać parametrów ReportParameter 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>

Poniżej przedstawiono sposób korzystania z parametrów QueryParameter i ReportParameter w raporcie opartym na języku 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>

Ukryte parametry

Projektant raportów w Visual Studio ma wbudowaną obsługę ukrytych parametrów. Dodatkowo możesz ukrywać parametry, dodając prefiks CRM_ do nazwy parametru w raporcie. Domyślnie parametry z prefiksem CRM_ są ukryte podczas publikowania raportu. Po uruchomieniu raportu nie zostanie wyświetlony monit o wprowadzanie wartości parametrów dla ukrytych parametrów.

Specjalne parametry

W poniższej tabeli przedstawiono specjalne ukryte parametry, których można użyć w raportach.

Parametr	Opis
`CRM_FilterText`	Zawiera wartość tekstu filtr, który użytkownik raportu tworzy interaktywnie w Przeglądarka raportu po uruchomieniu raportu. Parametr znajduje się w polu tekstowym podsumowanie filtru, które znajduje się w nagłówku raportu. Wartość początkową ustawiono na filtr domyślny.
`CRM_URL`	Ustaw na adres URL aplikacji. Użyj tego parametru podczas przechodzenia do szczegółów .
`CRM_FilteredEntity`	Użyj wyrażenia zapytania, aby włączyć wstępne filtrowanie danych (za pośrednictwem Szukania zaawansowanego).

Aby można było odwoływać się do parametrów w raporcie, należy je wcześniej utworzyć. Wartości tych parametrów specjalnych zostaną wypełnione przez Customer Engagement (on-premises) po uruchomieniu raportu.

Dodatkowe parametry formatu

W poniższej tabeli przedstawiono dodatkowe parametry, których można użyć w raportach. Są między nimi parametry, które zapewniają dostęp do informacji ustawień użytkownika dla Wartości liczbowych. Wartości tych można użyć do formatowania i wyświetlania wartości liczbowych. Parametry te są podobne do wartości określonych w klasa NumberFormatInfo. Użyj tych parametrów w raportach niestandardowych, aby sformatować dane według ustawień użytkownika.

Parametr	Opis
`CRM_FullName`	Imię i nazwisko użytkownika, na rzecz którego raport jest uruchomiony.
`CRM_UserTimeZone`	Nazwa strefy czasowej użytkownika, na przykład pacyficzny czas standardowy.
`CRM_UILanguageId`	Bieżące ustawienia regionalne (LCID) użytkownika.
`CRM_YearStartWeekCode`	Pierwsze tydzień roku używanego w aplikacjach Dynamics 365 for Customer Engagement.
`CRM_WeekStartDayCode`	Pierwszy dzień w tygodniu, który jest używany w Customer Engagement.
`CRM_FiscalCalendarStart`	Data rozpoczęcia roku obrachunkowego, który jest używany w Customer Engagement.
`CRM_FiscalPeriodType`	Określa sposób podziału roku obrachunkowego - kwartalnie, miesięcznie, rocznie i tak dalej.
`CRM_FiscalYearDisplayCode`	Określa, czy nazwa roku obrachunkowego jest wyświetlana na podstawie daty rozpoczęcia, czy na podstawie daty zakończenia roku obrachunkowego.
`CRM_FiscalYearPeriodConnect`	Określa sposób łączenia roku obrachunkowego i okresu obrachunkowego, gdy są wyświetlane razem.
`CRM_FiscalYearFormat`	Określa, jak będzie wyświetlana nazwa roku obrachunkowego.
`CRM_FiscalPeriodFormat`	Określa, jak będzie wyświetlany okres obrachunkowy.
`CRM_FiscalYearPrefixFormat`	Określa, czy prefiks jest dołączany do roku obrachunkowego, gdy jest on wyświetlany.
`CRM_FiscalYearSuffixFormat`	Określa, czy sufiks jest dołączany do roku obrachunkowego, gdy jest on wyświetlany.
`CRM_CurrencyDecimalPrecision`	Dokładność liczby miejsc po przecinku dla waluty.
`CRM_CurrencySymbol`	Symbol waluty w organizacji.
`CRM_CurrencyPositivePattern`	Format dodatnich wartości waluty.
`CRM_CurrencyNegativePattern`	Format ujemnych wartości waluty.
`CRM_NumberDecimalDigits`	Liczba miejsc dziesiętnych wykorzystywanych w wartościach liczbowych.
`CRM_NumberDecimalSeperator`	Ciąg, który jest używany jako separator dziesiętny w wartościach liczbowych.
`CRM_NumberNegativePattern`	Format ujemnych wartości liczbowych.
`CRM_NumberGroupSizes`	Liczba cyfr w każdej grupie na lewo od przecinka wartości liczbowych.
`CRM_NumberGroupSeperator`	Ciąg, który oddziela grupy cyfr w grupie na lewo od przecinka wartości liczbowych.
`CRM_DateSeparator`	Ciąg, który oddziela składniki daty, takie jak rok, miesiąc i dzień.
`CRM_TimeSeparator`	Ciąg, który oddziela składniki godziny, takie jak godzina, minuty i sekundy.
`CRM_AMDesignator`	Ciąg, który oddziela składniki godziny, takie jak godzina, minuty i sekundy
`CRM_PMDesignator`	Określenie godzin, które są "post meridiem" (PM).
`CRM_ShortDatePattern`	Format wartości Data krótka skojarzony z formatem "d".
`CRM_LongDatePattern`	Format wartości Data długa skojarzony z formatem "D".
`CRM_ShortTimePattern`	Format wartości Godzina krótka skojarzony z formatem "t".
`CRM_MonthDayPattern`	Format wartości miesiąc i dzień, które są skojarzone z formatem "m" i "M".

Zobacz także

Raportowanie i Przewodnik sporządzania analiz
Publikuj raporty

Udostępnij za pośrednictwem