ร้องขอข้อมูลผลรวมย่อย

API ผลรวมและผลรวมย่อยอนุญาตให้วิชวลแบบกําหนดเองมีมุมมองข้อมูลเมทริกซ์เพื่อร้องขอข้อมูลผลรวมย่อยจากโฮสต์ Power BI คุณสามารถคํานวณผลรวมย่อยสําหรับชุดข้อมูลเมทริกซ์ทั้งหมด หรือระบุสําหรับแต่ละระดับของลําดับชั้นข้อมูลเมทริกซ์ (ดู รายงานตัวอย่างนี้)

หมายเหตุ

การร้องขอข้อมูลผลรวมย่อยได้รับการสนับสนุนจาก API เวอร์ชัน 2.6.0 เมื่อต้องการตรวจสอบเวอร์ชันที่คุณกําลังใช้ เรียกใช้ pbiviz -V คําสั่ง

ทุกครั้งที่วิชวลรีเฟรชข้อมูล จะส่ง คําขอดึงข้อมูล ไปยัง Backend ของ Power BI คําขอข้อมูลเหล่านี้มักจะใช้สําหรับค่าของเขตข้อมูลที่ผู้ใช้ลากลงในช่องเขตข้อมูลของวิชวล บางครั้งวิชวลต้องการการรวม/ผลรวมย่อยอื่น ๆ (ตัวอย่างเช่น ผลรวม จํานวนนับ) ที่นําไปใช้กับเขตข้อมูลเหล่านี้ API กําหนดคิวรีข้อมูลขาออกเพื่อร้องขอข้อมูลการรวม/ผลรวมย่อยเพิ่มเติม เนื่องจากการคํานวณเหล่านี้จะดําเนินการโดย Backend ของ Power BI จึงมีประสิทธิภาพสูงและสามารถใช้ได้กับชุดข้อมูลขนาดใหญ่

Screenshot of visual with subtotals row and columns highlighted.

API ผลรวมย่อย

API มี สวิตช์การกําหนดค่าบูลีน ต่อไปนี้สําหรับมุมมองข้อมูลแต่ละชนิด (ในขณะนี้เป็นเพียงเมทริกซ์):

  • rowSubtotals: ระบุว่าควรร้องขอข้อมูลผลรวมย่อยสําหรับเขตข้อมูลทั้งหมดในเขตข้อมูลแถวหรือไม่
  • rowSubtotalsPerLevel: ระบุว่าสามารถสลับข้อมูลผลรวมย่อยสําหรับแต่ละเขตข้อมูลในเขตข้อมูลของแถวได้หรือไม่
  • columnSubtotals: ระบุว่าควรร้องขอข้อมูลผลรวมย่อยสําหรับเขตข้อมูลทั้งหมดในเขตข้อมูลคอลัมน์หรือไม่
  • columnSubtotalsPerLevel: ระบุว่าสามารถสลับข้อมูลผลรวมย่อยสําหรับแต่ละเขตข้อมูลในเขตข้อมูลคอลัมน์ได้หรือไม่
  • levelSubtotalEnabled: ไม่เหมือนกับคุณสมบัติอื่น ๆ ทั้งหมด คุณสมบัตินี้จะถูกนําไปใช้กับแต่ละแถว/คอลัมน์ คุณสมบัตินี้จะระบุว่ามีการร้องขอผลรวมย่อยสําหรับแถว/คอลัมน์หรือไม่

สวิตช์แต่ละรายการข้างต้นจะได้รับการกําหนดค่าตามคุณสมบัติที่เกี่ยวข้องในบานหน้าต่างคุณสมบัติและค่าเริ่มต้น

วิธีการใช้ API ผลรวมย่อย

ไฟล์ JSON ความสามารถของวิ ชวล จะต้อง:

  • ระบุคุณสมบัติแต่ละอย่างของการสลับแผนที่ไปเป็น
  • ระบุค่าเริ่มต้นที่จะใช้หากไม่ได้กําหนดคุณสมบัติ

สวิตช์ทั้งหมดจะมีลักษณะดังนี้:

    "rowSubtotals": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "rowSubtotals" 
                }, 
                "defaultValue": true 
            },

ตัวอย่างเช่น ข้างต้นจะระบุว่ามีการเปิดใช้งานผลรวมย่อยของแถวโดยคุณสมบัติ "rowSubtotals" ในออบเจ็กต์ "SubTotals" ซึ่งมีค่าเริ่มต้นเป็น "true"

API จะเปิดใช้งานโดยอัตโนมัติสําหรับวิชวลเมื่อใดก็ตามที่โครงสร้างผลรวมย่อยและการแมปสลับทั้งหมดได้รับการกําหนดในไฟล์ JSON ความสามารถ

ด้านล่างนี้คือตัวอย่างของการกําหนดค่า API ที่สมบูรณ์ในไฟล์ JSON ความสามารถ (ที่คัดลอกจากวิชวลตัวอย่าง API):

"subtotals": { 
        "matrix": { 
            "rowSubtotals": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "rowSubtotals" 
                }, 
                "defaultValue": true 
            }, 
            "rowSubtotalsPerLevel": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "perRowLevel" 
                }, 
                "defaultValue": false 
            }, 
            "columnSubtotals": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "columnSubtotals" 
                }, 
                "defaultValue": true 
            }, 
            "columnSubtotalsPerLevel": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "perColumnLevel" 
                }, 
                "defaultValue": false 
            }, 
            "levelSubtotalEnabled": { 
                "propertyIdentifier": { 
                    "objectName": "subTotals", 
                    "propertyName": "levelSubtotalEnabled" 
                }, 
                "defaultValue": true 
            } 
        } 
    }

สิ่งสําคัญคือฟังก์ชัน enumerateProperities() ของวิชวลจะสอดคล้องกับค่าเริ่มต้นที่ระบุไว้ในความสามารถ ในเวลาเดียวกัน ตรรกะการกําหนดเองจะทํางานตามค่าเริ่มต้นที่ระบุไว้ในความสามารถ (เนื่องจากไม่มีวัตถุในมุมมองข้อมูล) ทั้งสองต้องถูกจัดแนว มิฉะนั้น การกําหนดค่าผลรวมย่อยจริงอาจแตกต่างจากการรับรู้ของผู้ใช้

ดู รายงานตัวอย่าง นี้ในโฟลเดอร์ DOC

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

Subtotals drop-down menu

ขั้นตอนถัดไป