แชร์ผ่าน

ภาษานิยามรายงาน (RDL)

  • บทความ

นําไปใช้กับ: Power BI Report Builder Power BI Desktop

Report Definition Language (RDL) เป็นการแสดง XML ของข้อกําหนดของรายงานที่มีการแบ่งหน้า ข้อกําหนดของรายงานประกอบด้วยข้อมูลเรียกและเค้าโครงข้อมูลสําหรับรายงาน RDL ประกอบด้วยองค์ประกอบ XML ที่ตรงกับไวยากรณ์ XML ที่สร้างขึ้นสําหรับ Power BI คุณสามารถเพิ่มฟังก์ชันแบบกําหนดเองของคุณเองเพื่อควบคุมค่า รูปแบบ และการจัดรูปแบบหน่วยข้อมูลของรายงานโดยการเข้าถึงบล็อกโค้ดภายในไฟล์ข้อกําหนดของรายงาน

RDL ส่งเสริมการทํางานร่วมกันของผลิตภัณฑ์การรายงานเชิงพาณิชย์โดยการกําหนดสคีมาทั่วไปที่เปิดใช้งานการแลกเปลี่ยนข้อกําหนดของรายงาน โพรโทคอลหรืออินเทอร์เฟซทางโปรแกรมที่ทํางานกับ XML สามารถใช้กับ RDL ได้ RDL คือ:

  • เค้าร่าง XML สําหรับข้อกําหนดของรายงาน
  • รูปแบบการแลกเปลี่ยนสําหรับธุรกิจและบุคคลที่สาม
  • สคีมาที่สามารถขยายได้และเปิดที่สนับสนุนเนมสเปซเพิ่มเติมและองค์ประกอบแบบกําหนดเอง

ข้อมูลจําเพาะของ RDL

เมื่อต้องการดาวน์โหลดข้อกําหนดสําหรับเวอร์ชัน Schema เฉพาะ ดู ข้อกําหนดของภาษาข้อกําหนดของรายงาน

ข้อกําหนดเค้าร่าง XML ของ RDL

แฟ้มข้อกําหนดรายงานภาษา (RDL) ได้รับการตรวจสอบโดยใช้แฟ้มข้อกําหนดของ XML Schema (XSD) Schema จะกําหนดกฎสําหรับตําแหน่งที่องค์ประกอบ RDL สามารถเกิดขึ้นได้ในไฟล์ .rdl องค์ประกอบประกอบด้วยชนิดข้อมูลและคาร์ดินาลลิตี้ นั่นคือจํานวนครั้งการปรากฏที่ได้รับอนุญาต องค์ประกอบอาจเป็นแบบง่ายหรือซับซ้อนก็ได้ องค์ประกอบอย่างง่ายไม่มีองค์ประกอบย่อยหรือแอตทริบิวต์ย่อย องค์ประกอบที่ซับซ้อนมีโหนดลูก และเลือกแอตทริบิวต์ได้

ตัวอย่างเช่น schema ประกอบด้วยองค์ประกอบ RDL ReportParameters ซึ่งเป็นชนิดที่ซับซ้อน ReportParametersType ตามแบบแผน ชนิดที่ซับซ้อนสําหรับองค์ประกอบคือชื่อขององค์ประกอบตามด้วยชนิดคํา องค์ประกอบ ReportParameters สามารถมีได้โดยองค์ประกอบรายงาน (ชนิดที่ซับซ้อน) และสามารถมีองค์ประกอบ ReportParameter ได้ ReportParameterType เป็นชนิดแบบง่ายที่สามารถมีได้เพียงหนึ่งค่าต่อไปนี้เท่านั้น: บูลีน วันที่เวลา จํานวนเต็ม เลขทศนิยม หรือสตริง สําหรับข้อมูลเพิ่มเติมเกี่ยวกับชนิดข้อมูล XML Schema ดู ที่ XML Schema ตอนที่ 2: ชนิดข้อมูลรุ่นที่สอง

การสร้าง RDL

เนื่องจากลักษณะแบบเปิดและขยายได้ของ RDL จึงสามารถสร้างเครื่องมือและแอปพลิเคชันที่หลากหลายซึ่งสร้าง RDL ตาม SCHEMA ของ XML

ตัวสร้างรายงานใน Power BI เป็นวิธีที่เหมาะสมในการสร้างรายงานที่มีการแบ่งหน้าของ RDL

หนึ่งในวิธีที่ง่ายที่สุดในการสร้าง RDL จากแอปพลิเคชันคือการใช้คลาส Microsoft .NET Framework ของ System.Xml namespace และ System.Linq namespace ระดับชั้นหนึ่งโดยเฉพาะอย่างยิ่ง คลาส XmlTextWriter สามารถใช้เพื่อเขียน RDL ได้ ด้วย XmlTextWriter คุณสามารถสร้างข้อกําหนดของรายงานที่สมบูรณ์ตั้งแต่ต้นจนจบในแอปพลิเคชัน .NET Framework ใดก็ได้ นักพัฒนายังสามารถขยาย RDL โดยการเพิ่มรายการรายงานแบบกําหนดเองด้วยคุณสมบัติแบบกําหนดเอง สําหรับข้อมูลเพิ่มเติมเกี่ยวกับ คลาส XmlTextWriter และ System.Xml namespace ให้ดู คู่มือสําหรับนักพัฒนา Microsoft .NET Framework สําหรับข้อมูลเพิ่มเติมเกี่ยวกับ Language-Integrated Query (LINQ) ให้ค้นหา "LINQ กับ XML" บน MSDN

ส่วนขยายของแฟ้มมาตรฐานสําหรับแฟ้มข้อกําหนดของรายงานคือ .rdl ชนิด MIME คือ ข้อความ/xml

ชนิด RDL

ตารางต่อไปนี้แสดงรายการชนิดที่ใช้ในองค์ประกอบ RDL และแอตทริบิวต์

ชนิด คำอธิบาย
ไบ นารี คุณสมบัติที่มีค่าไบนารีที่เข้ารหัส base-64
บูลีน คุณสมบัติที่มี true หรือ false เป็นค่าของวัตถุ เว้นแต่จะมีการระบุเป็นอย่างอื่น ค่าของวัตถุบูลีนที่เลือกได้ที่ไม่ได้ระบุจะเป็นเท็จ
วันที่ คุณสมบัติที่มีค่าวันที่หรือวันที่เวลาที่ระบุอย่างสมบูรณ์ในรูปแบบวันที่ ISO8601: YYYY-MM-DD[THH:MM[:SS[ S]]].
Enum คุณสมบัติที่มีค่าข้อความสตริงที่ต้องเป็นรายการของค่าที่กําหนดไว้
ลอย คุณสมบัติที่มีค่าลอยตัว จุด (.) ใช้เป็นตัวคั่นทศนิยมที่เลือกได้
เลขจำนวนเต็ม คุณสมบัติที่มีค่าจํานวนเต็ม (int32)
ภาษา คุณสมบัติที่มีค่าข้อความที่มีโค้ดภาษาและวัฒนธรรม เช่น "en-us" สําหรับภาษาอังกฤษแบบสหรัฐอเมริกา ค่าต้องเป็นภาษาเฉพาะหรือภาษากลางที่กําหนดภาษาเริ่มต้นใน Microsoft .NET Framework
ชื่อ คุณสมบัติที่มีค่าข้อความสตริง ชื่อต้องไม่ซ้ํากันภายใน namespace ของรายการ ถ้าไม่ได้ระบุ namespace สําหรับรายการคือด้านในสุดที่มีวัตถุที่มีชื่อ
NormalizedString คุณสมบัติที่มีค่าข้อความสตริงที่ตามปกติ
ขนาด องค์ประกอบขนาดต้องมีตัวเลข (โดยมีอักขระมหัพภาคที่ใช้เป็นตัวคั่นทศนิยมที่เลือกได้) ตัวเลขจะต้องตามด้วยตัวออกแบบสําหรับหน่วยความยาว CSS เช่น cm, mm, in, pt หรือ pc ช่องว่างระหว่างตัวเลขและตัวออกแบบเป็นตัวเลือก สําหรับข้อมูลเพิ่มเติมเกี่ยวกับตัวกําหนดขนาด ดู ที่ ค่า CSS และ การอ้างอิงหน่วย

ใน RDL ค่าสูงสุดสําหรับ ขนาด คือ 160 นิ้ว ขนาดต่ําสุดคือ 0 in
เชือก คุณสมบัติที่มีค่าข้อความสตริง
UnsignedInt คุณสมบัติที่มีค่าจํานวนเต็มที่ไม่มีเครื่องหมาย (uint32)
ตัว แปร คุณสมบัติที่มีชนิด XML แบบธรรมดาใดๆ

ชนิดข้อมูล RDL

การแจงนับชนิดข้อมูลจะกําหนดชนิดข้อมูลของแอตทริบิวต์ นิพจน์ หรือพารามิเตอร์ใน RDL ตารางต่อไปนี้แสดงวิธีที่ชนิดข้อมูลรันไทม์ภาษา (CLR) ทั่วไปสอดคล้องกับชนิดข้อมูล RDL

CLR Type(s) ชนิดข้อมูลที่สอดคล้องกัน
Boolean Boolean
DateTime, DateTimeOffset Datetime
Int16, Int32, UInt16, Byte, SByte Integer
เดียว, คู่ Float
สตริง, Char, GUID, Timespan สตริง

เนื้อหาที่เกี่ยวข้อง