ส่งออกรายงานที่มีการแบ่งหน้า Power BI ไปยัง XML (ตัวสร้างรายงาน Power BI)
นําไปใช้กับ: 
Power BI Report Builder 
Power BI Desktop
ส่วนขยายการแสดงผล XML ส่งกลับรายงานที่มีการแบ่งหน้าของ Power BI ในรูปแบบ XML สคีมาสําหรับ XML ของรายงานจะเป็นแบบเฉพาะเจาะจงกับรายงาน และประกอบด้วยข้อมูลเท่านั้น ไม่มีการแสดงข้อมูลเค้าโครง และการแบ่งหน้าไม่ถูกรักษาไว้โดยส่วนขยายการแสดงผล XML XML ที่สร้างขึ้นโดยส่วนขยายนี้สามารถนําเข้าลงในฐานข้อมูล ใช้เป็นข้อความข้อมูล XML หรือส่งไปยังแอปพลิเคชันแบบกําหนดเอง
หมายเหตุ
คุณสามารถสร้างและแก้ไขไฟล์ข้อกําหนดของรายงานที่มีการแบ่งหน้า (.rdl) ในตัวสร้างรายงาน Power BI ได้
รายการรายงาน
ตารางต่อไปนี้อธิบายวิธีแสดงรายการของรายงาน
| รายการ | ลักษณะการทํางานของการแสดงผล |
|---|---|
| รายงาน | แสดงเป็นองค์ประกอบระดับบนสุดของเอกสาร XML |
| ขอบเขตข้อมูล | แสดงเป็นองค์ประกอบภายในองค์ประกอบสําหรับคอนเทนเนอร์ ขอบเขตข้อมูลประกอบด้วยตาราง เมทริกซ์ และรายการที่แสดงข้อมูลเป็นข้อความและแผนภูมิ แถบข้อมูล เส้นแบบประกายไฟ เกจ และตัวบ่งชี้ที่แสดงข้อมูลเป็นภาพ |
| ส่วนกลุ่มและรายละเอียด | แต่ละอินสแตนซ์จะแสดงเป็นองค์ประกอบภายในองค์ประกอบสําหรับคอนเทนเนอร์ |
| Text box | แสดงเป็นแอตทริบิวต์หรือองค์ประกอบภายในคอนเทนเนอร์ |
| สี่เหลี่ยมผืนผ้า | แสดงเป็นองค์ประกอบภายในคอนเทนเนอร์ |
| กลุ่มคอลัมน์เมทริกซ์ | แสดงเป็นองค์ประกอบภายในกลุ่มแถว |
| แผนที่ | แสดงเป็นองค์ประกอบภายในองค์ประกอบสําหรับคอนเทนเนอร์ เลเยอร์แผนที่เป็นองค์ประกอบย่อยของแผนที่ และแต่ละเลเยอร์แผนที่ประกอบด้วยองค์ประกอบสําหรับสมาชิกแผนที่และแอตทริบิวต์ของสมาชิกแผนที่ |
| แผนภูมิ | แสดงเป็นองค์ประกอบภายในองค์ประกอบสําหรับคอนเทนเนอร์ ชุดข้อมูลเป็นองค์ประกอบย่อยของแผนภูมิ และประเภทเป็นองค์ประกอบลูกของชุดข้อมูล แสดงป้ายชื่อแผนภูมิทั้งหมดสําหรับแต่ละค่าแผนภูมิ ป้ายชื่อและค่าจะถูกรวมเป็นแอตทริบิวต์ |
| แถบข้อมูล | แสดงเป็นองค์ประกอบภายในองค์ประกอบสําหรับคอนเทนเนอร์ คล้ายกับแผนภูมิ โดยทั่วไปแล้ว แถบข้อมูลไม่มีลําดับชั้นหรือป้ายชื่อ ค่าเท่านั้น |
| เส้นแบบประกายไฟ | แสดงเป็นองค์ประกอบภายในองค์ประกอบสําหรับคอนเทนเนอร์ คล้ายกับแผนภูมิ โดยทั่วไปแล้ว เส้นแบบประกายไฟจะไม่มีลําดับชั้นหรือป้ายชื่อ ค่าเท่านั้น |
| ตัววัด | แสดงเป็นองค์ประกอบภายในองค์ประกอบสําหรับคอนเทนเนอร์ แสดงเป็นองค์ประกอบเดียวที่มีค่าต่ําสุดและสูงสุดของสเกล ค่าเริ่มต้นและสิ้นสุดของช่วง และค่าของตัวชี้เป็นแอตทริบิวต์ |
| ตัวชี้วัด | แสดงเป็นองค์ประกอบภายในองค์ประกอบสําหรับคอนเทนเนอร์ คล้ายกับตัววัด แสดงเป็นองค์ประกอบเดียวกับชื่อสถานะที่ใช้งานอยู่ สถานะที่พร้อมใช้งาน และค่าข้อมูลเป็นแอตทริบิวต์ |
รายงานที่แสดงโดยใช้ส่วนขยายการแสดงผล XML ยังเป็นไปตามกฎเหล่านี้:
องค์ประกอบ XML และแอตทริบิวต์ถูกแสดงตามลําดับที่ปรากฏในข้อกําหนดของรายงาน
การแบ่งหน้าจะถูกละเว้น
ส่วนหัวและส่วนท้ายของหน้าจะไม่แสดง
รายการที่ซ่อนอยู่ที่ไม่สามารถมองเห็นได้โดยการสลับจะไม่แสดงผล รายการในขั้นต้นและรายการที่ซ่อนอยู่ที่สามารถทําให้มองเห็นได้ผ่านการสลับจะถูกแสดง
รูปภาพ เส้น และรายการ รายงานแบบกําหนดเองจะถูกละเว้น
ชนิดข้อมูล
องค์ประกอบกล่องข้อความหรือแอตทริบิวต์ถูกกําหนดชนิดข้อมูล XSD โดยยึดตามค่าที่กล่องข้อความแสดง
| ถ้าค่าของกล่องข้อความทั้งหมดเป็น | ชนิดข้อมูลที่กําหนดคือ |
|---|---|
| Int16, Int32, Int64, UInt16, UInt32, UInt64, Byte, SByte | xsd:จํานวนเต็ม |
| ทศนิยม (หรือ ทศนิยม และชนิดข้อมูลจํานวนเต็มหรือไบต์) | xsd:ทศนิยม |
| เลขทศนิยม (หรือ ทศนิยม และชนิดข้อมูลจํานวนเต็มหรือไบต์) | xsd:float |
| คู่ (หรือ ทศนิยม และชนิดข้อมูลจํานวนเต็มหรือไบต์) | xsd:คู่ |
| วันที่เวลา หรือ ค่าชดเชยวันที่เวลา | xsd:dateTime |
| Time | xsd:string |
| บูลีน | xsd:บูลีน |
| String, Char | xsd:string |
| อื่นๆ | xsd:string |
กฎการแสดงภาพแบบเฉพาะ XML
ส่วนต่อไปนี้อธิบายวิธีการที่ส่วนขยายการแสดงผล XML แปลหน่วยข้อมูลภายในรายงาน
เนื้อความรายงาน
รายงานจะแสดงเป็นองค์ประกอบรากของเอกสาร XML ชื่อขององค์ประกอบมาจากคุณสมบัติ DataElementName ที่ตั้งค่าในบานหน้าต่าง คุณสมบัติ
ข้อกําหนดของเนมสเปซ XML และแอตทริบิวต์การอ้างอิงสคีมาจะรวมอยู่ในองค์ประกอบรายงานด้วย ตัวแปรจะถูกระบุไว้ในชนิดของใบหน้าเป็นตัวหนา:
<xmlns รายงาน="SchemaName" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="SchemaNameReportURL&rc%3aSchema=true" Name="ReportName">
ค่าสําหรับตัวแปรมีดังนี้:
| ชื่อ | ค่า |
|---|---|
| รายงาน | Report.DataElementName |
| ReportURL | URL เข้ารหัส URL แบบสัมบูรณ์ไปยังรายงานบนเซิร์ฟเวอร์ |
| ชื่อ Schema | Report.SchemaName ถ้าเป็น null ให้ Report.Name ถ้ามีการใช้งาน Report.Name มันจะถูกเข้ารหัสด้วย XmlConvert.EncodeLocalName ก่อน |
| ReportName | ชื่อของรายงาน |
กล่องข้อความ
กล่องข้อความจะแสดงเป็นองค์ประกอบหรือแอตทริบิวต์ตามคุณสมบัติ DataElementStyle RDL ชื่อขององค์ประกอบหรือแอตทริบิวต์มาจากคุณสมบัติ TextBox.DataElementName RDL
แผนภูมิ แถบข้อมูล และเส้นแบบประกายไฟ
แผนภูมิ แถบข้อมูล และเส้นแบบประกายไฟจะแสดงใน XML มีการจัดโครงสร้างข้อมูล
ตัววัดและตัวบ่งชี้
ตัววัดและตัวบ่งชี้จะแสดงใน XML มีการจัดโครงสร้างข้อมูล
รายงานย่อย
รายงานย่อยจะแสดงเป็นองค์ประกอบ ชื่อขององค์ประกอบจะถูกนํามาจากคุณสมบัติ DataElementName RDL การตั้งค่าคุณสมบัติ TextBoxesAsElements ของรายงานจะแทนที่ค่าของรายงานย่อย ไม่มีการเพิ่มแอตทริบิวต์ Namespace และ XSLT ไปยังองค์ประกอบรายงานย่อย
รูปสี่เหลี่ยมผืนผ้า
สี่เหลี่ยมผืนผ้าจะแสดงเป็นองค์ประกอบ ชื่อขององค์ประกอบจะถูกนํามาจากคุณสมบัติ DataElementName RDL
รายการรายงานแบบกําหนดเอง
CustomReportItems (CRI) จะไม่สามารถมองเห็นส่วนขยายการแสดงผลได้ หากมีรายการรายงานแบบกําหนดเองในรายงาน ส่วนขยายการแสดงผลจะแสดงเป็นรายการรายงานแบบเดิม
รูปภาพ
ไม่มีการแสดงรูปภาพ
รายการ
รายการจะไม่แสดง
ตาราง เมทริกซ์ และรายการ
ตาราง เมทริกซ์ และรายการจะถูกแสดงเป็นองค์ประกอบ ชื่อขององค์ประกอบมาจากคุณสมบัติ Tablix DataElementName RDL
แถวและคอลัมน์
คอลัมน์จะแสดงภายในแถว
มุม Tablix
ไม่มีการแสดงผลมุม แสดงเฉพาะเนื้อหาของมุมเท่านั้น
เซลล์ Tablix
เซลล์ Tablix จะแสดงเป็นองค์ประกอบ ชื่อขององค์ประกอบจะถูกนํามาจากคุณสมบัติ DataElementName RDL ของเซลล์
ผลรวมย่อยอัตโนมัติ
ไม่แสดงผลรวมย่อยอัตโนมัติ Tablix
รายการแถวและคอลัมน์ที่ไม่ซ้ํากับกลุ่ม
หน่วยข้อมูลที่ไม่ซ้ํากับกลุ่ม เช่น ป้ายชื่อ ผลรวมย่อย และผลรวมจะแสดงเป็นองค์ประกอบ ชื่อขององค์ประกอบมาจากคุณสมบัติ TablixMember.DataElementName RDL
คุณสมบัติ TablixMember.DataElementOutput RDL ควบคุมว่าจะแสดงรายการที่ไม่ซ้ําหรือไม่
ถ้าไม่มีคุณสมบัติ DataElementName ของสมาชิก Tablix ชื่อสําหรับรายการที่ไม่ใช่การทําซ้ําจะถูกสร้างขึ้นแบบไดนามิกในฟอร์มนี้:
RowX สําหรับแถวที่ไม่ซ้ํา ซึ่ง X เป็นดัชนีแถวที่ยึดตามศูนย์ภายในพาเรนต์ปัจจุบัน
ColumnY สําหรับการไม่ทําซ้ําคอลัมน์ โดยที่ Y ix เป็นดัชนีคอลัมน์ที่ยึดตามศูนย์ภายในพาเรนต์ปัจจุบัน
ส่วนหัวที่ไม่ซ้ําจะแสดงเป็นข้อมูลรองของแถวหรือคอลัมน์ที่ไม่ซ้ํากับกลุ่ม
ถ้าสมาชิกที่ไม่ซ้ําไม่มีเซลล์ Tablix ที่สอดคล้องกัน จะไม่แสดง ซึ่งอาจเกิดขึ้นในกรณีของเซลล์ Tablix ที่ครอบคลุมมากกว่าหนึ่งคอลัมน์
แถวและคอลัมน์ที่ทําซ้ํากับกลุ่ม
แถวและคอลัมน์ที่ทําซ้ําภายในกลุ่มจะถูกแสดงตามกฎ Tablix.DataElementOutput ชื่อสําหรับองค์ประกอบ จะถูกนํามาจากคุณสมบัติ DataElementName
แต่ละค่าที่ไม่ซ้ํากันภายในกลุ่มจะแสดงเป็นองค์ประกอบย่อยของกลุ่ม ชื่อสําหรับองค์ประกอบจะถูกนํามาจากคุณสมบัติ Group.DataElementName
หากค่าคุณสมบัติ DataElementOutput เท่ากับเอาต์พุต ส่วนหัวของรายการที่ซ้ํากันจะแสดงเป็นรายการย่อยขององค์ประกอบรายละเอียด
รูปแบบแบบกําหนดเองและการแปลง XSL
ไฟล์ XML ที่สร้างขึ้นโดยส่วนขยายการแสดงผล XML สามารถแปลงเป็นรูปแบบเกือบทุกรูปแบบได้โดยใช้ XSL Transformations (XSLT) ฟังก์ชันนี้สามารถใช้ในการสร้างข้อมูลในรูปแบบที่ยังไม่ได้รับการสนับสนุนโดยส่วนขยายการแสดงผลที่มีอยู่ พิจารณาใช้ส่วนขยายการแสดงผล XML และ XSLT ก่อนที่จะพยายามสร้างส่วนขยายการแสดงผลของคุณเอง
ชื่อที่ซ้ํากัน
ถ้ามีชื่อองค์ประกอบข้อมูลที่ซ้ํากันภายในขอบเขตเดียวกัน ตัวแสดงผลจะแสดงข้อความแสดงข้อผิดพลาด
การแปลง XSLT
ตัวแสดงผล XML สามารถใช้การแปลง XSLT ฝั่งเซิร์ฟเวอร์กับข้อมูล XML ต้นฉบับได้ เมื่อมีการใช้ XSLT ตัวแสดงผลจะแสดงเนื้อหาที่แปลงแล้วแทนที่จะเป็นข้อมูล XML ต้นฉบับ การแปลงเกิดขึ้นบนเซิร์ฟเวอร์ ไม่ใช่บนไคลเอ็นต์
XSLT ที่จะนําไปใช้กับเอาต์พุตจะถูกกําหนดในไฟล์ข้อกําหนดของรายงานด้วยคุณสมบัติ DataTransform ของรายงานหรือด้วยพารามิเตอร์ XSLT DeviceInfo ถ้ามีการตั้งค่าใดค่าหนึ่งเหล่านี้ การแปลงจะเกิดขึ้นในแต่ละครั้งที่มีการใช้ตัวแสดงผล XML เมื่อใช้การสมัครใช้งาน ต้องกําหนด XSLT ในคุณสมบัติ RDL DataTransform
ถ้ามีการระบุไฟล์ XSLT โดยทั้งคุณสมบัติข้อกําหนด DataTransform และการตั้งค่าข้อมูลอุปกรณ์ XSLT ที่ระบุใน DataTransform จะเกิดขึ้นก่อน ตามด้วย XSLT ที่ตั้งค่าโดยการตั้งค่าข้อมูลอุปกรณ์
ไฟล์ XSLT ควรพร้อมใช้งานผ่านอินเทอร์เน็ตผ่าน https โดยไม่จําเป็นต้องมีการรับรองความถูกต้อง
การตั้งค่าข้อมูลอุปกรณ์
คุณสามารถเปลี่ยนการตั้งค่าเริ่มต้นบางอย่างสําหรับการแสดงผลนี้ได้โดยการเปลี่ยนการตั้งค่าข้อมูลอุปกรณ์ รวมถึงการตั้งค่าต่อไปนี้:
การแปลงข้อมูล (XSLT) ที่จะนําไปใช้กับ XML
ชนิด MIME ของเอกสาร XML
จะใช้สตริงรูปแบบกับข้อมูลหรือไม่
จะเยื้องเอาต์พุต XML หรือไม่
จะรวมชื่อเค้าร่าง XML หรือไม่
การเข้ารหัสสําหรับเอกสาร XML
นามสกุลแฟ้มของเอกสาร XML
สําหรับข้อมูลเพิ่มเติม ให้ดู การตั้งค่าข้อมูลอุปกรณ์ XML