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

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

नोट

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

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

आप रिपोर्ट के व्यक्तिगत पैरामीटर को परिभाषित करने, किसी क्वेरी के माध्यम से जानकारी पास करने, या उपयोगकर्ता सेटिंग, जैसे CRM_CurrencySymbol और CRM_CurrencyPositivePattern पैरामीटर तक पहुंच प्रदान करने के लिए रिपोर्ट में पैरामीटर जोड़ सकते हैं।

<रिपोर्ट पैरामीटर > रिपोर्ट परिभाषा (RDL) फ़ाइल में एक तत्व है जिसका उपयोग रिपोर्ट में एक व्यक्तिगत पैरामीटर का वर्णन करने के लिए किया जाता है। <क्वेरी पैरामीटर > में एक व्यक्तिगत पैरामीटर के बारे में जानकारी होती है जिसे क्वेरी के भाग के रूप में डेटा स्रोत को पास किया जाता है। खाता सारांश रिपोर्ट की RDL फ़ाइल से लिया गया निम्नलिखित XML कोड दर्शाता है कि ReportParameter और 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>  

निम्न उदाहरण दिखाते हैं कि QueryParameter और ReportParameter आधारित रिपोर्ट में पैरामीटर का उपयोग कैसे करें। 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	सप्ताह का पहला दिन जिसका उपयोग ग्राहक सहभागिता में किया जाता है.
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	उन घंटों के लिए निर्दिष्टकर्ता, जो "post meridiem" (PM) होते हैं.
CRM_ShortDatePattern	छोटे दिनांक मान के लिए स्वरूप प्रतिमान, जो "d" स्‍वरूप प्रतिमान के साथ संबद्ध है.
CRM_LongDatePattern	लंबे दिनांक मान के लिए स्वरूप प्रतिमान, जो "D" स्‍वरूप प्रतिमान के साथ संबद्ध है.
CRM_ShortTimePattern	छोटी समय मान के लिए स्वरूप प्रतिमान, जो "t" स्‍वरूप प्रतिमान के साथ संबद्ध है.
CRM_MonthDayPattern	माह और दिन के मानों के लिए स्वरूप प्रतिमान जो "m" और "M" स्वरूप प्रतिमान से संबद्ध है.

इसे भी देखें

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