Parametrien käyttäminen raporteissa

Artikkeli
12/13/2024

Voit käyttää raporteissa parametrejä valvomaan käyttäjän noutamia tietoja ohjaamalla käyttäjää arvoihin tai arvojoukkoon, kun käyttäjä suorittaa raportin. Tietojoukon kysely palauttaa vain ne tiedot, jotka käyttäjä on pyytänyt. Voit myös lisätä piilotetut ja erityiset parametrit, jotka eivät kehota käyttäjää toimiin, mutta joita voi käyttää toimintoihin, kuten tietojen suodattaminen ja dynaaminen porautuminen.

Muistiinpano

Parametriarvojen, jotka siirretään, enimmäispituus Microsoft Dynamics 365 Customer Engagement (on-premises) on 2 000 merkkiä. Jos esim. suoritat raportin ja luot tietojen suodattimen Erikoishaku-toiminnon käyttöliittymän kautta, suodatinlauseke joka välitetään suodattimen parametriin voi olla enintään 2 000 merkkiä. Määritettävien parametrien lukumäärällä ei ole rajoitteita. Sinun voi kuitenkin pitää rajoittaa URL-osoitteen rivin merkkijonon ja parametrien määrää tietyn selaimen vaatimusten takia.

Parametrien lisääminen

Voit lisätä raporttiin parametrejä raportin yksittäisten parametrien määrittämiseksi, siirtää tietoja kyselyn avulla tai antaa pääsyn Käyttäjäasetuksiin, kuten CRM_CurrencySymbol ja CRM_CurrencyPositivePattern parametrit.

<ReportParameter> on elementti raportin määritystiedostossa (RDL), jota käytetään kuvaamaan yksittäistä parametriä raportissa. <QueryParameter > sisältää tietoja yksittäisestä parametristä, joka välitetään tietolähteeseen kyselyn osana. Seuraavassa Asiakkuusyhteenveto-raportin RDL-tiedoston XML-koodin osoittaa, miten voi käyttää ReportParameter ja QueryParameter parametrit.

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

Seuraavissa esimerkeissä näytetään, miten QueryParameter ja ReportParameter parametrien Fetch perusteella tehtyä raporttia käytetään.

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

Piilotetut parametrit

Raporttien suunnitteluohjelma Visual Studio:ssa tukee piilotetut parametrit. Voit lisäksi piilottaa parametreja lisäämällä on CRM_-etuliitteen parametrin nimeen raportissa. Oletusarvoisestiparametrit, joilla on CRM_-etuliite, eivät ole näkyvissä, kun raportti julkaistaan. Kun raportti suoritetaan, ei sinua pyydetä antamaan piilotettujen parametrien arvoja.

Erityiset parametrit

Seuraavassa taulukossa on esitetty erityiset piilotetut parametrit, joita voi käyttää raporteissa.

Parametri	Kuvaus
`CRM_FilterText`	Arvo suodatintekstille, jonka raportin käyttäjä luo vuorovaikutteisesti raporttien katseluohjelmassa, kun käyttäjä suorittaa raportin. Parametri on Suodatinyhteenvetotekstiruudussa, joka sijaitsee raportin otsikossa. Ensimmäiseksi arvoksi on määritetty oletussuodatin.
`CRM_URL`	Määritä sovelluksen URL-osoitteeksi. Käytä tätä parametria porautumisessa.
`CRM_FilteredEntity`	Käytä kyselylauseketta tietojen suodattaminen etukäteen mahdollistamiseksi (Erikoishaku-toiminnon kautta).

Sinun on luotava raportin kaikki parametrit, ennen kuin niihin voi viitata. Erityisparametrien mittausarvot täyttää Customer Engagement (on-premises), kun suoritat raportin.

Lisämuotoparametrit

Seuraavassa taulukossa on lisäparametrit, joita voi käyttää raporteissa. Niiden joukossa on parametreja, joiden avulla pääsee käyttäjälukujen asetustietoihin. Voit käyttää näitä arvoja numeeristen arvojen muotoiluun ja näyttämiseen. Nämä parametrit ovat muutoin samanlaisia kuin NumberFormatInfo-luokan arvot. Näitä parametreja käyttämällä muokatuissa raporteissa voi muokata tiedot käyttäjäasetusten mukaisesti.

Parametri	Kuvaus
`CRM_FullName`	Koko nimi käyttäjältä, jonka puolesta raportti suoritetaan.
`CRM_UserTimeZone`	Käyttäjän aikavyöhykenimi, esimerkiksi Tyynenmeren normaaliaika.
`CRM_UILanguageId`	Käyttäjän nykyinen kieli (LCID).
`CRM_YearStartWeekCode`	Dynamics 365 for Customer Engagement -sovelluksissa käytetyn vuoden ensimmäinen viikko.
`CRM_WeekStartDayCode`	Viikon ensimmäinen päivä, jota käytetään Customer Engagementissa.
`CRM_FiscalCalendarStart`	Tilikauden alkamispäivä, jota käytetään Customer Engagementissa.
`CRM_FiscalPeriodType`	Määrittää, kuinka tilikausi jaetaan – neljännesvuosittain, kuukausittain, vuosittain ja niin edelleen.
`CRM_FiscalYearDisplayCode`	Määritetään, onko tilikauden nimi tilikauden alkamis- vai päättymisajankohdan mukainen.
`CRM_FiscalYearPeriodConnect`	Määritys, miten tilikauden ja kirjanpitokauden nimet yhdistetään, kun ne näytetään yhdessä.
`CRM_FiscalYearFormat`	Määrittää, miten tilikauden nimi näytetään.
`CRM_FiscalPeriodFormat`	Määrittää miten, tilikausi näytetään.
`CRM_FiscalYearPrefixFormat`	Määrittää, onko tilikaudessa näkyvissä etuliite, kun se näytetään.
`CRM_FiscalYearSuffixFormat`	Määrittää, onko tilikaudessa näkyvissä jälkiliite, kun se näytetään.
`CRM_CurrencyDecimalPrecision`	Rahasummien desimaalien määrä.
`CRM_CurrencySymbol`	Organisaation rahayksikön tunnus.
`CRM_CurrencyPositivePattern`	Positiivisten rahasummien muodon malli.
`CRM_CurrencyNegativePattern`	Negatiivisten rahasummien muodon malli.
`CRM_NumberDecimalDigits`	Käytettävä numeeristen arvojen desimaalien määrä.
`CRM_NumberDecimalSeperator`	Merkkijono, jota käytetään desimaalierottimena numeerisissa arvoissa.
`CRM_NumberNegativePattern`	Negatiivisten numeeristen arvojen muodon malli.
`CRM_NumberGroupSizes`	Numeeristen arvojen kokonaislukujen määrä desimaalin vasemmalla puolella kussakin ryhmässä.
`CRM_NumberGroupSeperator`	Numeeristen arvojen desimaalin vasemmalla puolella oleva ryhmiä erottava merkkijono.
`CRM_DateSeparator`	Merkkijono, joka erottaa päivämäärän komponentit, kuten vuoden, kuukauden ja päivän.
`CRM_TimeSeparator`	Merkkijono, joka erottaa ajan komponentit, kuten tunnin, minuutit ja sekunnit.
`CRM_AMDesignator`	Merkkijono, joka erottaa ajan komponentit, kuten tunnin, minuutit ja sekunnit
`CRM_PMDesignator`	Iltapäivätuntien (”post meridiem” / PM) tunnus.
`CRM_ShortDatePattern`	Lyhyen päivämääräarvo muotomalli, joka on liitetty muotomalliin ”d”.
`CRM_LongDatePattern`	Pitkän päivämääräarvon muotomalli, joka on liitetty muotomalliin ”D”.
`CRM_ShortTimePattern`	Lyhyen aika-arvon muotomalli, joka on liitetty muotomalliin ”t”.
`CRM_MonthDayPattern`	Kuukausi- ja päiväarvomallit, jotka liittyvät ”m” ja ”M” -muotomalleihin.

Katso myös

Raportointi- ja analysointiopas
Julkaise raportteja

Jaa