แชร์ผ่าน

บันทึกการเปลี่ยนแปลง API ของวิชวล Power BI

  • บทความ

หน้านี้ประกอบด้วยข้อมูลสรุปสั้น ๆ ของเวอร์ชัน API ที่มีอยู่และสิ่งที่คาดหวังในเวอร์ชันที่กําลังจะมาถึง เวอร์ชันที่แสดงที่นี่ถือว่าเป็นเวอร์ชันที่เสถียรและไม่เปลี่ยนแปลง

API v5.10.0

  • DataViewMetadataColumn มีคุณสมบัติใหม่ที่เรียกว่าsourceFieldParameters คุณสมบัตินี้จะระบุว่าเขตข้อมูลปัจจุบันเป็นผลลัพธ์ของพารามิเตอร์เขตข้อมูลหรือไม่ ถ้าเขตข้อมูลเดียวสามารถมาจากหลายพารามิเตอร์เขตข้อมูล คุณสมบัตินี้แสดงรายการพารามิเตอร์เขตข้อมูลที่เกี่ยวข้องทั้งหมด
  • สนับสนุนเดสก์ท็อป มิถุนายน 2024

API v5.9.1

  • acquireAADTokenService: ปรับปรุงเพื่อสนับสนุนระบบคลาวด์ต่อไปนี้
    • ระบบคลาวด์เชิงพาณิชย์
    • ประเทศจีนคลาวด์
    • ชุมชน Cloud สําหรับส่วนราชการสหรัฐอเมริกา
    • ชุมชนภาครัฐของสหรัฐอเมริกา Cloud High
    • กระทรวงกลาโหมสหรัฐ

API v5.9.0

  • API ตัวกรองข้อมูลประจําตัวแบบลําดับชั้น: ช่วยให้คุณสามารถสร้างวิชวลที่ใช้เมทริกซ์การแมปข้อมูลเพื่อกรองข้อมูลตามจุดข้อมูลที่ใช้โครงสร้างลําดับชั้น ซึ่งจะเป็นประโยชน์สําหรับวิชวลแบบกําหนดเองที่ใช้แบบจําลองความหมายของคีย์แบบ group-on และต้องการกรองลําดับชั้นตามจุดข้อมูล
  • acquireAADTokenService: ขยายด้วยคุณสมบัติเพิ่มเติม
  • สนับสนุน Desktop มีนาคม 2024

API v5.8.0

  • API ที่เก็บข้อมูลภายใน: API ที่เก็บข้อมูลภายในเวอร์ชันใหม่ที่พร้อมใช้งานสําหรับวิชวลแบบกําหนดเองทั้งหมดและควบคุมโดยการตั้งค่าส่วนกลางที่เปิดอยู่ตามค่าเริ่มต้น ผู้ดูแลระบบสามารถปิดการตั้งค่าส่วนกลางเพื่อปิดใช้งานทั้ง API เดิมและ API เวอร์ชันใหม่
  • การสนับสนุนบนวัตถุสําหรับวิชวลแบบกําหนดเอง: เมื่อมีการสนับสนุนวัตถุสําหรับวิชวลแบบกําหนดเองเพื่อปรับประสบการณ์การใช้งานของผู้ใช้ให้เหมาะสมและมอบประสบการณ์การเขียนแบบรวมศูนย์ในแบบเดียวกับวิชวลแบบนอกกรอบ
  • สนับสนุนเดสก์ท็อปกุมภาพันธ์ 2024

API v5.7.0

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

API v5.4.0

  • ปรับปรุงการนําทางแป้นพิมพ์: ปรับปรุงการช่วยสําหรับการเข้าถึงและการใช้งานวิชวลของคุณ โดยการให้ตัวเลือกเพิ่มเติมสําหรับการโต้ตอบกับวิชวลโดยใช้แป้นพิมพ์
  • ตรวจหาการใช้ตัวกรองในรายงาน: ตรวจสอบว่ามีตัวกรองใด ๆ ที่นําไปใช้กับรายงานหรือไม่
  • สนับสนุน Desktop พฤษภาคม 2023

API v5.3.0

  • การแก้ไขการอัปเดตของ SelectionId สําหรับเมทริกซ์ dataView

    หมายเหตุ

    ข้อมูลหลักของ selectionId อาจเปลี่ยนแปลง ดังนั้น selectionId/identityIndex ที่ยังคงอยู่โดยใช้ API เวอร์ชันที่เก่ากว่าอาจไม่เกี่ยวข้องในวิชวลเมทริกซ์

  • downloadService: เพิ่มวิธีการ exportVisualsContentExtended ใหม่ที่ส่งกลับข้อมูลผลลัพธ์ที่ขยายแล้วของการดาวน์โหลด
  • สนับสนุน Desktop มีนาคม 2023

API v5.2.0

  • การลด ข้อมูลแบบกําหนดเอง - คุณลักษณะนี้ที่ เพิ่มลงในสคีมา capabilities.json อนุญาตให้ หน้าต่าง ดึงข้อมูลสามารถปรับเปลี่ยนแบบไดนามิกโดยรหัสวิชวลแบบกําหนดเองที่ผู้เขียนรายงานทํา
  • รองรับเดสก์ท็อป ธันวาคม 2565

API v5.1.0

  • การ เรียงลําดับแบบกําหนดเอง - ปรับปรุงการเรียงลําดับแบบกําหนดเองสําหรับตาราง
  • ผลรวมย่อย - ชนิดผลรวมย่อยใหม่ระบุว่าควรดึงผลรวมก่อนหรือหลังส่วนที่เหลือของข้อมูลหรือไม่
  • ตัวกรอง ข้อมูลเอกลักษณ์ - กรองข้อมูลตามประเภท
  • บานหน้าต่าง รูปแบบใหม่ - ออกแบบวิชวลแบบกําหนดเองที่สนับสนุนการออกแบบบานหน้าต่างรูปแบบใหม่
  • สนับสนุนเดสก์ท็อปตุลาคม 2022

API v4.7.0

  • API สิทธิ์การใช้งาน - ขาย จัดการ และบังคับใช้สิทธิการใช้งานโดยตรงผ่านตลาดการค้า
  • API การดูรายละเอียดแนวลึก - สร้างวิชวลที่สามารถทริกเกอร์การดําเนินการดูรายละเอียดแนวลึกได้โดยไม่ต้องมีการโต้ตอบกับผู้ใช้
  • สนับสนุนเดสก์ท็อป กรกฎาคม 2022

API v4.6.0

  • คุณสมบัติความสามารถใหม่: สิทธิพิเศษ และสิทธิพิเศษสองประการ:
    • การเข้าถึงเว็บ
    • ดาวน์โหลดไฟล์จากวิชวลแบบกําหนดเอง
  • เพิ่มสวิตช์ผู้ดูแลระบบผู้เช่าที่สอดคล้องกัน สองตัว
  • ดาวน์โหลด API เพื่ออนุญาตให้ดาวน์โหลดวิชวลไปยังไฟล์
  • สนับสนุนเดสก์ท็อป มิถุนายน 2022

API v4.2.0

API v3.8.0

  • สนับสนุน Desktop พฤษภาคม 2021 และรุ่นที่ใหม่กว่า

API v3.7.0

  • สนับสนุนเดสก์ท็อปเมษายน 2021 และใหม่กว่า

API v3.6.0

  • วิชวลสามารถรับการอัปเดตจาก Power BI โดยไม่จําเป็นต้องผูกข้อมูลใด ๆ
  • สนับสนุน Desktop 2021 กุมภาพันธ์ และรุ่นที่ใหม่กว่า
  • รองรับ Desktop RS พฤษภาคม 2021 และใหม่กว่า

API v3.4.0

  • fetchMoreData : พารามิเตอร์ใหม่ aggregateSegments (ค่าเริ่มต้นเป็น true) สําหรับการสนับสนุน fetchMoreData แบบไม่มีการรวม
  • สนับสนุน Desktop 2020 พฤศจิกายนและรุ่นที่ใหม่กว่า
  • สนับสนุน Desktop RS มกราคม 2021 และรุ่นที่ใหม่กว่า

API v3.2.0

API v2.6.0

  • เพิ่ม isInFocus เพื่ออัปเดตตัวเลือกและวิธีการ switchFocusModeState ไปยังโฮสต์วิชวล
  • รองรับการปรับแต่งผลรวมย่อย
  • สนับสนุน Desktop 2019 มิถุนายนและรุ่นที่ใหม่กว่า
  • รองรับ Desktop RS พฤษภาคม 2019 และใหม่กว่า

API v2.5.0

API v2.3.0

API v2.2.0

API v2.1.0

  • การปรับปรุงประสิทธิภาพการทํางาน:
    • เวลาโหลดเร็วขึ้น
    • ฟุตพริ้นท์หน่วยความจําที่มีขนาดเล็กลง
    • ข้อมูลและทรานสชันเหตุการณ์ที่ปรับให้เหมาะสม

บันทึกย่อประจำรุ่น

  • การกรอง API ที่สร้างขึ้นใหม่จะพร้อมใช้งานใน API 2.2 และไม่ได้รับการรองรับใน API 2.1

  • วิชวลจะได้รับเฉพาะชนิด dataView ที่ถูกประกาศในความสามารถเท่านั้น วิชวลที่ใช้ชนิด dataView หลายชนิดจะเสียหายซึ่งเป็นผลจากการอัปเดตนี้

  • ไม่รองรับ DataViewScopeIdentity อินเทอร์เฟซ อีกต่อไป โดยแทนที่ด้วย data.DataRepetitionSelector อินเทอร์เฟซ ถ้าคุณใช้คุณสมบัติ DataViewScopeIdentity หลักของอินเทอร์เฟซ คุณสามารถแทนที่ด้วย JSON.stringify(identity)

  • undefined จะถูกแทนที่ด้วย null ภายใน dataView เมื่อมีการวนซ้ําบนอาร์เรย์ที่ใช้var item in myArrayการข้ามบน undefinedแต่จะไม่ข้ามบนnull วิชวลที่ใช้รูปแบบนี้อาจเสียหายจากการอัปเดตนี้ ตรวจสอบให้แน่ใจว่าได้ตรวจสอบ null ในอาร์เรย์:

    for (var item in myArray) {
   if (!item) {
     continue;
   }
   console.log(item);
}

  • คุณสมบัติ proto ไม่จัดเก็บ metadata\data ที่ซ่อนไว้ภายใน dataView อีกต่อไป วิชวลที่เข้าถึงคุณสมบัติผ่าน proto อาจเสียหายจากการอัปเดตนี้

API v1.13.0

  • รองรับ ตัวแบ่งส่วนข้อมูลการซิงค์ โปรดทราบว่าจะใช้ได้เฉพาะตัวแบ่งส่วนข้อมูลเขตข้อมูลเดี่ยวเนื่องจาก PBI สถานะของโค้ดปัจจุบัน อ่านเพิ่มเติม
  • การเข้าถึง: การสนับสนุนความคมชัดสูง
  • การเข้าถึง: อนุญาตให้มีการตั้งค่าสถานะโฟกัสของแป้นพิมพ์

API v1.12.0

API v1.11.0

API v1.10.0

  • เพิ่ม ILocalizationManager
  • API การรับรองความถูกต้อง

API v1.9.0

API v1.8.0

  • รองรับ fillRule ชนิดใหม่ (การไล่ระดับสี) ใน schema ความสามารถ
  • รองรับคุณสมบัติกฎใน schema ความสามารถสําหรับคุณสมบัติวัตถุ

API v1.7.0

API v1.6.2

API v1.5.0

API v1.4.0

API v1.3.0

API v1.2.0

  • เพิ่ม colorPalette เพื่อจัดการสีที่ใช้ในวิชวลของคุณ
  • รองรับ การเลือกหลายรายการ - selectionManager สามารถยอมรับอาร์เรย์ ของSelectionId
  • รองรับวิชว ล R โดยใช้สคริปต์ R

API v1.1.0

  • รองรับ การแก้จุดบกพร่องของวิชวลใน iFrame
  • เพิ่ม Sandbox น้ําหนักเบาด้วยการเตรียมใช้งาน iFrame ที่รวดเร็วขึ้น
  • แก้ไขปัญหา Capabilities.objects ไม่สนับสนุนชนิด "text"
  • รองรับ เพื่ออัปเดตข้อกําหนดชนิด API ของวิช pbiviz update วลและ schema
  • --api-versionรองรับค่าสถานะ ใน pbiviz new เพื่อสร้างวิชวลด้วยเวอร์ชัน API เฉพาะ
  • รองรับ alpha release ของ API v1.2.0

โฮสต์วิชวล

  • เพิ่ม createSelectionIdBuilder เพื่อสร้างรหัสเฉพาะที่ใช้สําหรับการเลือกข้อมูล
  • เพิ่ม createSelectionManager เพื่อจัดการสถานะการเลือกของวิชวลและสื่อสารการเปลี่ยนแปลงไปยังโฮสต์วิชวล
  • เพิ่มอาร์เรย์ของสีเริ่มต้นเพื่อใช้ในวิชวล

API v1.0.0

  • การเผยแพร่ API เริ่มต้น