Udostępnij za pośrednictwem

Użyj parametrów w raportach

  • Artykuł

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