रिपोर्ट में पैरामीटर का उपयोग करें

जब उपयोगकर्ता रिपोर्ट चलाता है, तो आप उपयोगकर्ता को मान या मानों के सेट के लिए संकेत देकर पुनर्प्राप्त डेटा को नियंत्रित करने के लिए रिपोर्ट में पैरामीटर्स का उपयोग करते हैं. डेटासेट क्वेरी केवल उपयोगकर्ता द्वारा अनुरोधित डेटा पुनर्प्राप्त करती है। आप रिपोर्ट में छिपे हुए और विशेष पैरामीटर भी जोड़ सकते हैं जो उपयोगकर्ता को इनपुट के लिए संकेत नहीं देते हैं, लेकिन डेटा फ़िल्टरिंग और डायनामिक ड्रिल-थ्रू जैसे कार्यों के लिए उपयोग किए जा सकते हैं।

नोट

Microsoft Dynamics 365 Customer Engagement (on-premises) से पास किए गए पैरामीटर मानों की अधिकतम लंबाई 2,000 वर्ण है. उदाहरण के लिए, यदि आप एक रिपोर्ट चलाते हैं और उन्नत खोज उपयोगकर्ता इंटरफ़ेस के माध्यम से डेटा फ़िल्टर बनाते हैं, तो फ़िल्टर पैरामीटर को पास किया गया परिणामी फ़िल्टर व्यंजक 2,000 वर्णों से अधिक नहीं हो सकता. आपके द्वारा निर्दिष्ट किए जा सकने वाले पैरामीटर्स की संख्या की कोई अधिकतम सीमा नहीं है. हालाँकि, आपको किसी विशेष ब्राउज़र की आवश्यकताओं को पूरा करने के लिए URL पंक्ति पर स्ट्रिंग की लंबाई और पैरामीटर की संख्या को सीमित करना पड़ सकता है।

पैरामीटर जोड़ना

आप रिपोर्ट के अलग-अलग पैरामीटर्स निर्धारित करने, क्वेरी के माध्यम से जानकारी पास करने या उपयोगकर्ता सेटिंग्स, जैसे और CRM_CurrencySymbolCRM_CurrencyPositivePattern पैरामीटर्स तक पहुँच प्रदान करने के लिए रिपोर्ट में पैरामीटर्स जोड़ सकते हैं.

<ReportParameter> रिपोर्ट परिभाषा (RDL) फ़ाइल में एक तत्व है जिसका उपयोग रिपोर्ट में किसी व्यक्तिगत पैरामीटर का वर्णन करने के लिए किया जाता है. <QueryParameter> में क्वेरी के भाग के रूप में डेटा स्रोत को दिए गए व्यक्तिगत पैरामीटर के बारे में जानकारी होती है. खाता सारांश रिपोर्ट की RDL फ़ाइल से लिया गया निम्न XML कोड प्रदर्शित करता है कि AND QueryParameter पैरामीटर का ReportParameter उपयोग कैसे करें.

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

निम्न उदाहरण किसी आधारित रिपोर्ट में Fetch AND ReportParameter पैरामीटर्स QueryParameter का उपयोग करने का तरीका दिखाते हैं.

<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	Customer Engagement में उपयोग किए जाने वाले वित्तीय वर्ष के प्रारंभ दिनांक.
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	घंटों के लिए डिज़ाइनर जो "पोस्ट मेरिडिम" (पीएम) हैं।
CRM_ShortDatePattern	"d" स्वरूप प्रतिमान से संबद्ध लघु दिनांक मान के लिए स्वरूप प्रतिमान.
CRM_LongDatePattern	किसी दीर्घ दिनांक मान के लिए स्वरूप प्रतिमान जो "D" स्वरूप प्रतिमान से संबद्ध है.
CRM_ShortTimePattern	"t" स्वरूप प्रतिमान के साथ संबद्ध अल्प समय मान के लिए स्वरूप प्रतिमान.
CRM_MonthDayPattern	महीने और दिन के मानों के लिए स्वरूप प्रतिमान, जो "m" और "M" स्वरूप प्रतिमानों से संबद्ध होते हैं.

भी देखें

रिपोर्टिंग और विश्लेषण मार्गदर्शिका
रिपोर्ट प्रकाशित करें