ใช้พารามิเตอร์ในรายงาน

คุณสามารถใช้พารามิเตอร์ในรายงานเพื่อควบคุมข้อมูลที่ได้รับโดยการพร้อมท์ผู้ใช้สำหรับค่าต่างๆ เมื่อผู้ใช้เรียกใช้รายงาน การสอบถามข้อมูลจะรับเฉพาะข้อมูลที่ถูกร้องขอโดยผู้ใช้เท่านั้น คุณยังสามารถเพิ่มพารามิเตอร์ลับและพารามิเตอร์พิเศษที่จะไม่มีการพร้อมท์ผู้ใช้ให้ป้อนข้อมูลลงในรายงานได้ แต่พารามิเตอร์เหล่านั้นสามารถใช้เพื่อการดำเนินการต่างๆ เช่นการกรองข้อมูลและการลงรายละเอียดแบบไดนามิกได้

หมายเหตุ

ความยาวสูงสุดของค่าพารามิเตอร์ที่จะถูกส่งผ่านจาก Microsoft Dynamics 365 Customer Engagement (on-premises) คือ 2,000 อักขระ ตัวอย่างเช่น ถ้าคุณเรียกใช้รายงานและสร้างตัวกรองข้อมูลผ่านส่วนติดต่อผู้ใช้ การค้นหาขั้นสูง ผลลัพธ์ตัวกรองที่ถูกส่งผ่านไปถึงพารามิเตอร์ตัวกรองไม่สามารถมากกว่า 2,000 อักขระได้ ไม่มีข้อจำกัดจำนวนสูงสุดของพารามิเตอร์ที่คุณสามารถระบุ อย่างไรก็ตาม คุณอาจต้องจำกัดความยาวของสตริงบนบรรทัด URL และจำนวนพารามอเตอร์เพื่อให้เป็นไปตามข้อกำหนดของเบราว์เซอร์เฉพาะ

การเพิ่มพารามิเตอร์

คุณสามารถเพิ่มพารามิเตอร์ไปที่รายงานเพื่อกำหนดพารามิเตอร์เฉพาะตัวของรายงาน ส่งผ่านข้อมูลผ่านการสอบถาม หรือมอบการเข้าถึงการตั้งค่าผู้ใช้ เช่นพารามิเตอร์ CRM_CurrencySymbol และ CRM_CurrencyPositivePattern

<ReportParameter> เป็นองค์ประกอบในแฟ้มกำหนดของรายงาน (RDL) ที่จะถูกใช้เพื่ออธิบายพารามิเตอร์เฉพาะตัวในรายงาน <QueryParameter> ประกอบด้วยข้อมูลเกี่ยวกับพารามิเตอร์เฉพาะตัวที่ถูกส่งผ่านไปที่แหล่งข้อมูล ซึ่งเป็นส่วนหนึ่งของการสอบถาม รหัส XML ต่อไปนี้ถูกนำมาจากแฟ้ม RDL ของรายงานสรุปข้อมูลลูกค้าองค์กร ซึ่งแสดงถึงวิธีใช้พารามิเตอร์ 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 Class ใช้พารามิเตอร์เหล่านี้ในรายงานแบบกำหนดเองเพื่อจัดรูปแบบข้อมูลตามการตั้งค่าของผู้ใช้

พารามิเตอร์	คำอธิบาย
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	ตัวออกแบบสำหรับชั่วโมงที่เป็น "post meridiem" (PM)
CRM_ShortDatePattern	รูปแบบการจัดรูปแบบสำหรับค่าวันที่แบบสั้นที่เกี่ยวข้องกับรูปแบบการจัดรูปแบบ "d"
CRM_LongDatePattern	รูปแบบการจัดรูปแบบสำหรับค่าวันที่แบบยาวที่เกี่ยวข้องกับรูปแบบการจัดรูปแบบ "D"
CRM_ShortTimePattern	รูปแบบการจัดรูปแบบสำหรับค่าเวลาแบบสั้นที่เกี่ยวข้องกับรูปแบบการจัดรูปแบบ "t"
CRM_MonthDayPattern	รูปแบบการจัดรูปแบบสำหรับค่าเดือนและวันที่เกี่ยวข้องกับรูปแบบการจัดรูปแบบ "m" และ "M"

ดูเพิ่มเติม

คู่มือการรายงานและการวิเคราะห์
เผยแพร่รายงาน