Използване на параметри в отчети

Можете да използвате параметри в отчетите за управление на данните, извлечени чрез подкана към потребителя за въвеждане на стойност или набор от стойности, когато потребителят стартира отчета. Заявката за набор от данни извлича само данните, които са поискани от потребителя. Можете да добавите също скрити и специални параметри в отчетите, които не подканват потребителя за въвеждане, но могат да се използват за операции, като филтриране на данни и динамично детайлизиране.

Бележка

Максималната дължина на стойностите на параметрите, които се подават от Microsoft Dynamics 365 Customer Engagement (on-premises), е 2000 знака. Ако например изпълните отчет и създадете филтър за данни чрез потребителския интерфейс за разширено търсене , полученият израз за филтър, който се подава на параметър на филтър, не може да надвишава 2000 знака. Няма максимално ограничение на броя на параметрите, които можете да указвате. Възможно е обаче да се наложи да ограничите дължината на низа на реда на URL адреса и броя на параметрите, за да отговарят на изискванията на конкретен браузър.

Добавяне на параметри

Можете да добавяте параметри към отчет, за да дефинирате отделни параметри на отчета, да предавате информация чрез заявка или да предоставяте достъп до потребителски настройки, като например CRM_CurrencySymbol и CRM_CurrencyPositivePattern параметри.

<ReportParameter> е елемент във файла за дефиниция на отчет (RDL), който се използва за описание на отделен параметър в отчета. Параметърът <QueryParameter> съдържа информация за отделен параметър, който се подава на източник на данни като част от заявка. Следният XML код, взет от RDL файла на отчета за обобщение на акаунта, показва как да използвате параметрите и ReportParameterQueryParameter .

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

Следващите примери показват как да използвате параметрите и QueryParameterReportParameter в 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>  

Скрити параметри

Проектантът на отчети в Visual Studio има вградена поддръжка за скрити параметри. В допълнение, можете да скриете параметри чрез добавяне на префикс CRM_ към името на параметъра в отчет. По подразбиране параметрите с префикс CRM_ са скрити, когато отчетът се публикува. Когато стартирате отчета, няма да получите подкана за въвеждане на стойности на параметри за скритите параметри.

Специални параметри

Следната таблица показва специалните скрити параметри, които можете да използвате във вашите отчети.

Параметър	Описание
CRM_FilterText	Съдържа стойността на текста на филтъра, който потребител на отчет интерактивно създава във визуализатора на отчети, когато стартира отчет. Параметърът е в поле за обобщен текст на филтъра, което се намира в заглавката на отчета. Първоначалната стойност е зададена на филтъра по подразбиране.
CRM_URL	Задава се към URL адреса на приложението. Използвайте този параметър, когато детайлизирате.
CRM_FilteredEntity	Използвайте в израз за заявка, за да разрешите предварителното филтриране на данни (чрез разширено търсене).

Трябва да създадете всички параметри в отчет, преди да можете да препращате към тях. Стойностите на тези специални параметри се попълват от Customer Engagement (on-premises), когато стартирате отчета.

Допълнителни параметри на формат

Следната таблица съдържа допълнителни параметри, които можете да използвате в отчетите. Сред тях има параметри, които предоставят достъп до информация за потребителските настройки за числа. Можете да използвате тези стойности, за да форматирате и показвате числовите стойности. Тези параметри са подобни на стойностите , зададени в класа NumberFormatInfo. Използвайте тези параметри в персонализирани отчети, за да форматирате данните според потребителските настройки.

Параметър	Описание
CRM_FullName	Пълното име на потребителя, от чието име се стартира отчетът.
CRM_UserTimeZone	Часовата зона на потребителя, например Тихоокеанско стандартно време.
CRM_UILanguageId	Текущата езикова променлива (LCID) на потребителя.
CRM_YearStartWeekCode	Първата седмица на годината, която се използва в приложенията на Dynamics 365 for Customer Engagement.
CRM_WeekStartDayCode	Първият ден от седмицата, който се използва в Customer Engagement.
CRM_FiscalCalendarStart	Началната дата за финансова година, която се използва в "Ангажиране на клиенти".
CRM_FiscalPeriodType	Указва как е разделена финансовата година – на тримесечия, месеци, години и т.н.
CRM_FiscalYearDisplayCode	Указва дали да се показва името на финансовата година въз основа на това кога започва или кога завършва тя.
CRM_FiscalYearPeriodConnect	Указва как са свързани финансовата година и финансовият период, когато се показват заедно.
CRM_FiscalYearFormat	Указва как ще се показва името на финансовата година.
CRM_FiscalPeriodFormat	Указва как ще се показва финансовият период.
CRM_FiscalYearPrefixFormat	Указва дали да се прикрепи префикс към финансовата година, когато тя се показва.
CRM_FiscalYearSuffixFormat	Указва дали да се прикрепи суфикс към финансовата година, когато тя се показва.
CRM_CurrencyDecimalPrecision	Точността по десетичен знак на валута
CRM_CurrencySymbol	Валутният знак на организацията.
CRM_CurrencyPositivePattern	Шаблон на формата за положителни валутни стойности.
CRM_CurrencyNegativePattern	Шаблон на формата за отрицателни валутни стойности.
CRM_NumberDecimalDigits	Броят на цифрите след десетичния знак, който да се използва в числови стойности.
CRM_NumberDecimalSeperator	Низът, който се използва като десетичен разделител в числови стойности.
CRM_NumberNegativePattern	Шаблон на формата за отрицателни числови стойности.
CRM_NumberGroupSizes	Броят на цифрите във всяка група отляво на десетичния знак в числови стойности.
CRM_NumberGroupSeperator	Низът, който разделя групите цифри отляво на десетичния знак в числови стойности.
CRM_DateSeparator	Низът, който разделя компонентите на датата, като година, месец и ден.
CRM_TimeSeparator	Низът, който разделя компонентите на часа, като час, минути и секунди.
CRM_AMDesignator	Низът, който разделя компонентите на часа, като час, минути и секунди
CRM_PMDesignator	Обозначител за часовете, които са след обяд (PM).
CRM_ShortDatePattern	Шаблонът на формат за стойност на кратка дата, която е свързана с шаблона на формат „d“.
CRM_LongDatePattern	Шаблонът на формат за стойност на дълга дата, която е свързана с шаблона на формат „D“.
CRM_ShortTimePattern	Шаблонът на формат за стойност на кратък час, която е свързана с шаблона на формат „t“.
CRM_MonthDayPattern	Шаблонът на формат за стойности на месец и ден, които са свързани с шаблоните на формат „m“ и „M“.

Вижте също

Ръководство за отчитане и анализ
Публикуване на отчети