โฟลเดอร์รายงานโครงการ Power BI Desktop

บทความนี้อธิบายไฟล์และโฟลเดอร์ย่อยในโฟลเดอร์ รายงาน ของโครงการ Microsoft Power BI Desktop ไฟล์และโฟลเดอร์ย่อยในส่วนนี้แสดงรายงาน Power BI โฟลเดอร์รายงานอาจประกอบด้วย:

1 - ไฟล์นี้เป็นสิ่งจําเป็น
2 - ไฟล์นี้จําเป็นสําหรับรูปแบบ PBIR-Legacy
3 - ไฟล์นี้จําเป็นสําหรับรูปแบบ PBIR

ไม่ใช่ทุกโฟลเดอร์รายงานโครงการที่มีไฟล์และโฟลเดอร์ย่อยทั้งหมดที่อธิบายไว้ที่นี่

ไฟล์รายงาน

.pbi\localSettings.json

ประกอบด้วยการตั้งค่ารายงานที่นําไปใช้เฉพาะสําหรับผู้ใช้ปัจจุบันและคอมพิวเตอร์เฉพาะที่เท่านั้น ซึ่งควรรวมอยู่ใน gitIgnore หรือการยกเว้นตัวควบคุมแหล่งข้อมูลอื่นๆ ตามค่าเริ่มต้น Git จะละเว้นไฟล์นี้

สําหรับข้อมูลเพิ่มเติม โปรดดูเอกสารเค้าร่าง localSettings.json

CustomVisuals\

โฟลเดอร์ย่อยที่ประกอบด้วยเมตาดาต้าสําหรับวิชวลแบบกําหนดเองในรายงาน Power BI สนับสนุนวิชวลแบบกําหนดเองสามชนิด:

  • วิชวลที่จัดเก็บขององค์กร - องค์กรสามารถอนุมัติและปรับใช้วิชวลแบบกําหนดเองไปยัง Power BI สําหรับองค์กรของพวกเขาได้ เมื่อต้องการเรียนรู้เพิ่มเติม ให้ดูที่ ที่เก็บขององค์กร
  • วิชวล Power BI ของ AppSource - หรือที่เรียกว่า "วิชวลแบบกําหนดเองสาธารณะ" วิชวลเหล่านี้จะพร้อมใช้งานจาก Microsoft AppSource นักพัฒนารายงานสามารถติดตั้งวิชวลเหล่านี้ได้โดยตรงจาก Power BI Desktop
  • ไฟล์วิชวลแบบกําหนดเอง - หรือที่เรียกว่า "วิชวลแบบกําหนดเองส่วนตัว" สามารถโหลดไฟล์ลงในรายงานโดยการอัปโหลดแพคเกจ pbiviz

โหลดเฉพาะวิชวลแบบกําหนดเองส่วนตัวลงในโฟลเดอร์ CustomVisuals เท่านั้น วิชวลของ AppSource และองค์กรจะโหลดโดยอัตโนมัติโดย Power BI Desktop

RegisteredResources\

โฟลเดอร์ย่อยที่มีไฟล์ทรัพยากรเฉพาะในรายงานและโหลดโดยผู้ใช้ เช่น ธีมแบบกําหนดเอง รูปภาพ และวิชวลแบบกําหนดเอง (ไฟล์ pbiviz)

นักพัฒนาเป็นผู้รับผิดชอบไฟล์ที่นี่และรองรับการเปลี่ยนแปลง ตัวอย่างเช่น คุณสามารถเปลี่ยนไฟล์ และหลังจากรีสตาร์ท Power BI Desktop ไฟล์ใหม่จะถูกโหลดลงในรายงาน โฟลเดอร์นี้สามารถยกเลิกการบล็อกสถานการณ์ที่เป็นประโยชน์บางอย่างเช่น:

  • การเขียนธีมแบบกําหนดเองภายนอก Power BI Desktop โดยใช้ Schema สาธารณะ
  • การใช้การเปลี่ยนแปลงชุดงานโดยการเปลี่ยนไฟล์ทรัพยากรบนรายงานหลายฉบับ ตัวอย่างเช่น คุณสามารถสลับธีมแบบกําหนดเองขององค์กร เปลี่ยนระหว่างธีมสีสว่างและสีเข้ม และเปลี่ยนรูปภาพโลโก้ได้

ไฟล์ทรัพยากรทั้งหมดต้องมีรายการที่สอดคล้องกันในไฟล์ report.json การแก้ไขไฟล์ RegisteredResources รองรับเฉพาะทรัพยากรที่โหลดแล้วที่ทําให้ Power BI Desktop ลงทะเบียนทรัพยากรใน report.json เท่านั้น

semanticModelDiagramLayout.json

ประกอบด้วยไดอะแกรมแบบจําลองข้อมูลที่อธิบายโครงสร้างของแบบจําลองความหมายที่เชื่อมโยงกับรายงาน ไฟล์นี้ไม่รองรับการแก้ไขจากภายนอก

definition.pbir

ประกอบด้วยข้อกําหนดโดยรวมของรายงานและการตั้งค่าหลัก ไฟล์นี้ยังเก็บการอ้างอิงไปยังแบบจําลองความหมายที่ใช้โดยรายงาน Power BI Desktop สามารถเปิดไฟล์ PBIR ได้โดยตรง เหมือนกับว่ารายงานถูกเปิดจากไฟล์ PBIP การเปิดไฟล์ PBIR ยังเปิดแบบจําลองความหมายควบคู่ไปกับถ้ามีการอ้างอิงสัมพัทธ์โดยใช้byPath

ตัวอย่างคําจํากัดความ.pbir:

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byPath": {
      "path": "../Sales.Dataset"
    }    
  }
}

ข้อกําหนดรวมถึง datasetReference คุณสมบัติ ซึ่งอ้างอิงแบบจําลองความหมายที่ใช้ในรายงาน การอ้างอิงอาจเป็น:

byPath - ระบุเส้นทางสัมพัทธ์ไปยังโฟลเดอร์แบบจําลองความหมายเป้าหมาย เส้นทางสัมบูรณ์ไม่ได้รับการสนับสนุน เครื่องหมายทับไปข้างหน้า (/) ใช้เป็นตัวคั่นโฟลเดอร์ เมื่อใช้ Power BI Desktop จะเปิดแบบจําลองความหมายในโหมดแก้ไขแบบเต็ม

byConnection - ระบุการเชื่อมต่อกับแบบจําลองความหมายในพื้นที่ทํางาน Fabric โดยใช้สตริงการเชื่อมต่อ byConnectionเมื่อมีการใช้การอ้างอิง Power BI Desktop จะไม่เปิดแบบจําลองความหมายในโหมดแก้ไข

byConnectionใช้การอ้างอิง ต้องระบุคุณสมบัติต่อไปนี้:

Property Description
connectionString สตริงการเชื่อมต่อที่อ้างถึงแบบจําลองความหมายในพื้นที่ทํางาน Fabric

ตัวอย่างโดยใช้ byConnection:

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byConnection": {      
      "connectionString": "Data Source=\"powerbi://api.powerbi.com/v1.0/myorg/[WorkpaceName]\";initial catalog=[SemanticModelName];access mode=readonly;integrated security=ClaimsToken;semanticmodelid=[SemanticModelId]"
    }
  }
}

เมื่อปรับใช้รายงานผ่าน Fabric REST API คุณต้องระบุคุณสมบัติเท่านั้นsemanticmodelid เช่น:

{  
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definitionProperties/2.0.0/schema.json",
  "version": "4.0",
  "datasetReference": {
    "byConnection": {      
      "connectionString": "semanticmodelid=[SemanticModelId]"
    }
  }
}

Important

เมื่อปรับใช้รายงานผ่าน Fabric REST API คุณต้องใช้ byConnection การอ้างอิง ไม่ควรสับสนกับ โหมดที่เก็บข้อมูล ของแบบจําลองความหมาย เช่น DirectQuery datasetReferenceในรายงานจะระบุเฉพาะแบบจําลองความหมายที่รายงานเชื่อมต่อด้วย เท่านั้น ซึ่งไม่ได้กําหนดวิธีที่แบบจําลองนั้นจัดเก็บหรือเข้าถึงข้อมูล

ไฟล์ Multiple *.pbir

เมื่อแบบจําลองความหมายและรายงานใช้พื้นที่ทํางานเดียวกัน Fabric Git Integration จะส่งออกข้อกําหนดพร้อม byPath การอ้างอิงไปยังแบบจําลองความหมายเสมอ ถ้าคุณต้องการบังคับให้เปิดรายงานใน Live Connect (ตัวอย่างเช่น เพื่อทํางานกับหน่วยวัดระดับรายงาน) คุณสามารถมีไฟล์ได้หลาย *.pbir ไฟล์ เช่น ไฟล์หนึ่งมีการเชื่อมต่อ byPath และอีกไฟล์หนึ่งมีการเชื่อมต่อ byConnection Fabric Git Integration ประมวลผลเฉพาะไฟล์ definition.pbir และละเว้นไฟล์ *.pbir อื่นๆ ทั้งหมด อย่างไรก็ตาม ไฟล์เหล่านี้สามารถอยู่ร่วมในที่เก็บเดียวกันได้

  ├── definition\
  ├── StaticResources\
  ├── .platform
  ├── definition-liveConnect.pbir
  └── definition.pbir

ไฟล์ definition.pbir ยังระบุรูปแบบข้อกําหนดของรายงานที่ได้รับการสนับสนุนผ่านคุณสมบัติ 'เวอร์ชัน'

Version รูปแบบที่รองรับ
1.0 ข้อกําหนดของรายงานต้องถูกจัดเก็บเป็น PBIR-Legacy ในไฟล์ report.json
4.0 หรือสูงกว่า คําจํากัดความของรายงานสามารถจัดเก็บเป็น PBIR-Legacy (ไฟล์report.json) หรือ PBIR (โฟลเดอร์ \definition)

สําหรับข้อมูลเพิ่มเติม ให้ดู เอกสาร definition.pbir schema

mobileState.json

ประกอบด้วยการตั้งค่าลักษณะที่ปรากฏและลักษณะการทํางานของรายงานเมื่อแสดงบนอุปกรณ์เคลื่อนที่ ไฟล์นี้ไม่รองรับการแก้ไขจากภายนอก

report.json

ไฟล์นี้ประกอบด้วยข้อกําหนดของรายงานในรูปแบบดั้งเดิมของรายงาน Power BI (PBIR-Legacy) และไม่สนับสนุนการแก้ไขจากภายนอก

คําจํากัดความ\โฟลเดอร์

โฟลเดอร์นี้จะพร้อมใช้งานเมื่อมีการบันทึกโครงการ Power BI โดยใช้รูปแบบรายงานที่ได้รับการปรับปรุงของ Power BI (PBIR) มันแทนที่ไฟล์ report.json

.platform

ไฟล์แพลตฟอร์มผ้าที่มีคุณสมบัติสําคัญสําหรับการสร้างและรักษาการเชื่อมต่อระหว่างรายการ Fabric และ Git

หากต้องการเรียนรู้เพิ่มเติม โปรดดู การรวม Git ไฟล์ระบบที่สร้างขึ้นโดยอัตโนมัติ

รูปแบบ PBIR

การบันทึกไฟล์โครงการ Power BI (PBIP) ของคุณโดยใช้รูปแบบรายงานขั้นสูงของ Power BI (PBIR) ช่วยปรับปรุงการติดตามการเปลี่ยนแปลงและการแก้ปัญหาความขัดแย้งของการรวมโดยใช้ไฟล์ JSON ที่จัดรูปแบบอย่างถูกต้อง

สกรีนช็อตของปัญหา PBIR ที่เป็นมิตร

แต่ละหน้า วิชวล บุ๊กมาร์ก ฯลฯ จะถูกจัดระเบียบเป็นไฟล์แยกต่างหาก แต่ละไฟล์ภายในโครงสร้างโฟลเดอร์ รูปแบบนี้เหมาะสําหรับการแก้ปัญหาความขัดแย้งของ codevelopment

สกรีนช็อตของโฟลเดอร์ PBIR ที่เรียกง่าย

ซึ่งแตกต่างจาก PBIR-Legacy (report.json) PBIR คือรูปแบบที่จัดทําเป็นเอกสารสาธารณะที่สนับสนุนการปรับเปลี่ยนจากแอปพลิเคชันที่ไม่ใช่ Power BI แต่ละไฟล์มีเค้าร่าง JSON สาธารณะซึ่งไม่เพียง แต่จัดทําเอกสารไฟล์ แต่ยังอนุญาตให้ผู้แก้ไขโค้ดเช่น Visual Studio Code ดําเนินการตรวจสอบไวยากรณ์ในขณะที่แก้ไข

สถานการณ์ที่เป็นไปได้บางอย่างพร้อมใช้งานกับ PBIR ประกอบด้วย:

  • คัดลอกหน้า/วิชวล/บุ๊กมาร์กระหว่างรายงาน
  • ตรวจสอบให้แน่ใจถึงความสอดคล้องของชุดวิชวลในทุก ๆ หน้า โดยการคัดลอกและวางไฟล์วิชวล
  • ค้นหาและแทนที่ได้ง่ายในไฟล์รายงานหลายไฟล์
  • ใช้การแก้ไขชุดงานในวิชวลทั้งหมดโดยใช้สคริปต์ (ตัวอย่างเช่น ซ่อนตัวกรองระดับวิชวล)

บันทึกเป็นโครงการโดยใช้ PBIR

เมื่อคุณบันทึกโครงการโดยใช้ PBIR รายงานของคุณจะถูกบันทึกภายในโฟลเดอร์ที่ชื่อ \definition ภายใน โฟลเดอร์รายงาน:

สกรีนช็อตของโฟลเดอร์ข้อกําหนดภายในโฟลเดอร์รายงาน PBIP

เรียนรู้เพิ่มเติมเกี่ยวกับ โครงสร้างโฟลเดอร์ PBIR

โฟลเดอร์และไฟล์ PBIR

ข้อกําหนดของรายงานจะถูกจัดเก็บไว้ definition\ ภายในโฟลเดอร์ที่มีโครงสร้างต่อไปนี้:

├── bookmarks\
│   ├── [bookmarkName].bookmark.json
|   └── bookmarks.json
├── pages\
│   ├── [pageName]\
│   |   ├── \visuals
|   │   |   ├── [visualName]\
|   |   │   │   |── mobile.json
|   |   |   └   └── visual.json
|   |   └── page.json
|   └── pages.json
├── version.json
├── reportExtensions.json
└── report.json
File/Folder Required Description
bookmarks\ No โฟลเดอร์ที่มีไฟล์บุ๊กมาร์กทั้งหมดของรายงาน
── [ชื่อบุ๊กมาร์ก].bookmark.json No บุ๊กมาร์กเมตาดาต้า เช่น วิชวลเป้าหมายและตัวกรอง
ข้อมูลเพิ่มเติมที่ schema
── bookmarks.json No บุ๊กมาร์กเมตาดาต้า เช่น ลําดับและกลุ่มของบุ๊กมาร์ก
ข้อมูลเพิ่มเติมที่ schema
pages\ Yes โฟลเดอร์ที่มีหน้าทั้งหมดของรายงาน
── [ชื่อหน้า]\ Yes หนึ่งโฟลเดอร์ต่อหน้า
──── ภาพ\ No โฟลเดอร์ที่มีวิชวลทั้งหมดของหน้า
────── [ชื่อวิชวล]\ No หนึ่งโฟลเดอร์ต่อวิชวล
──────── mobile.json No เมตาดาต้าเค้าโครงอุปกรณ์เคลื่อนที่ของวิชวล เช่น ตําแหน่งอุปกรณ์เคลื่อนที่และการจัดรูปแบบ
ข้อมูลเพิ่มเติมที่ schema
──────── visual.json Yes เมตาดาต้าวิชวล เช่น ตําแหน่งและการจัดรูปแบบ คิวรี
ข้อมูลเพิ่มเติมที่ schema
──── page.json Yes เมตาดาต้าของหน้า เช่น ตัวกรองระดับหน้าและการจัดรูปแบบ
ข้อมูลเพิ่มเติมที่ schema
── pages.json No เมตาดาต้าของหน้า เช่น ลําดับหน้าและหน้าที่ใช้งานอยู่
ข้อมูลเพิ่มเติมที่ schema
version.json Yes เวอร์ชันไฟล์ PBIR ในปัจจัยอื่น ๆ กําหนดไฟล์ที่ต้องการโหลด
ข้อมูลเพิ่มเติมที่ schema
reportExtensions.json No ส่วนขยายรายงาน เช่น หน่วยวัดระดับรายงาน
ข้อมูลเพิ่มเติมที่ schema
report.json Yes รายงานเมตาดาต้า เช่น ตัวกรองระดับรายงานและการจัดรูปแบบ
ข้อมูลเพิ่มเติมที่ schema

Important

ไฟล์เมตาดาต้าของรายงานบางไฟล์ เช่น visual.json หรือ bookmarks.jsonสามารถบันทึกด้วยค่าข้อมูลจากแบบจําลองความหมายของคุณ ตัวอย่างเช่น ถ้าคุณใช้ตัวกรองกับวิชวลสําหรับเขตข้อมูล 'บริษัท' = 'Contoso' ค่า 'Contoso' จะยังคงเป็นส่วนหนึ่งของเมตาดาต้า นอกจากนี้ยังนําไปใช้กับการกําหนดค่าอื่น ๆ เช่นการเลือกตัวแบ่งส่วนข้อมูล ความกว้างของคอลัมน์แบบกําหนดเองของเมทริกซ์ และการจัดรูปแบบสําหรับชุดข้อมูลที่ระบุ

แบบแผนการตั้งชื่อ PBIR

ชื่อทั้งหมดภายในเครื่องหมายวงเล็บสี่เหลี่ยม ([]) ในตารางก่อนหน้านี้เป็นไปตามรูปแบบการตั้งชื่อเริ่มต้น แต่สามารถเปลี่ยนชื่อเป็นชื่อที่จําง่ายมากขึ้น ตามค่าเริ่มต้น หน้า วิชวล และบุ๊กมาร์กใช้ชื่อวัตถุรายงานเป็นชื่อไฟล์หรือโฟลเดอร์ ชื่อออบเจ็กต์เหล่านี้เป็นตัวระบุที่ไม่ซ้ํากัน 20 อักขระในขั้นต้น เช่น '90c2e07d8e84e7d5c026'

ภาพหน้าจอของคุณสมบัติชื่อ PBIR

การเปลี่ยนชื่อคุณสมบัติ 'ชื่อ' ภายในไฟล์ JSON แต่ละไฟล์ได้รับการสนับสนุน แต่อาจแบ่งการอ้างอิงภายนอกทั้งภายในและภายนอกรายงาน ชื่อวัตถุและ/หรือชื่อไฟล์/โฟลเดอร์ต้องมีอักขระคําอย่างน้อยหนึ่งตัว (ตัวอักษร ตัวเลข ขีดล่าง) หรือเครื่องหมายยัติภังค์

หลังจากเปลี่ยนชื่อไฟล์หรือโฟลเดอร์ PBIR แล้ว คุณต้องรีสตาร์ท Power BI Desktop เมื่อรีสตาร์ท Power BI Desktop จะเก็บรักษาชื่อไฟล์หรือโฟลเดอร์เดิมไว้เมื่อบันทึก

คัดลอกชื่อวัตถุของรายงาน

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

สกรีนช็อตของรายงานที่มีลูกศรชี้จากหนึ่งในวิชวลไปยังชื่อของไฟล์ที่สอดคล้องกัน

  1. ไปที่ไฟล์>ตัวเลือกและการตั้งค่า>การตั้งค่า>รายงานวัตถุรายงานและเปิดใช้งานการคัดลอกชื่อวัตถุเมื่อคลิกขวาที่การตั้งค่าวัตถุรายงาน ต้องทําเพียงครั้งเดียวเท่านั้น

    สกรีนช็อตของการตั้งค่ารายงานออบเจ็กต์รายงาน

  2. คลิกขวาบนวัตถุรายงานใด ๆ และเลือกคัดลอกชื่อวัตถุ

    สกรีนช็อตของรายงานบนเดสก์ท็อปที่เลือกชื่อวัตถุคัดลอก

ด้วยชื่อวัตถุที่คัดลอกไปยังคลิปบอร์ดของคุณ คุณสามารถใส่ลงในแถบค้นหาของ Windows Explorer หรือ Visual Studio Code เพื่อค้นหาหรือระบุชื่อวัตถุภายในโฟลเดอร์ PBIR ได้อย่างง่ายดาย

สกรีนช็อตของแถบค้นหาที่มีชื่อของวัตถุ

สคีมา Json ของ PBIR

ไฟล์ PBIR JSON แต่ละไฟล์มีการประกาศ JSON schema ที่ด้านบนของเอกสาร URL ของ Schema นี้สามารถเข้าถึงได้โดยสาธารณะและสามารถใช้เพื่อเรียนรู้เพิ่มเติมเกี่ยวกับคุณสมบัติและวัตถุที่พร้อมใช้งานสําหรับแต่ละไฟล์ นอกจากนี้ยังมี IntelliSense และการตรวจสอบที่มีอยู่ภายในเมื่อแก้ไขด้วยตัวแก้ไขโค้ด เช่น Visual Studio Code

สกรีนช็อตของคําแนะนําเครื่องมือของเค้าร่าง PBIR JSON

URL schema ยังกําหนดเวอร์ชันของเอกสาร ซึ่งคาดว่าจะเปลี่ยนแปลงเมื่อข้อกําหนดของรายงานพัฒนาขึ้น

สคีมา JSON ทั้งหมดเผยแพร่ที่นี่

คําอธิบายประกอบ PBIR

คุณสามารถใส่คําอธิบายประกอบเป็นคู่ชื่อ-ค่าภายในข้อกําหนดของรายงานสําหรับแต่ละ visualpage และreport ในขณะที่ Power BI Desktop ละเว้นคําอธิบายประกอบเหล่านี้ แต่ก็มีประโยชน์สําหรับแอปพลิเคชันภายนอก เช่น สคริปต์

ตัวอย่างเช่น คุณสามารถระบุ defaultPage สําหรับรายงานที่ report.json ไฟล์ ซึ่งสามารถใช้โดยสคริปต์การปรับใช้ได้

{
  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/report/1.0.0/schema.json",
  "themeCollection": {
    "baseTheme": {
      "name": "CY24SU06",
      "reportVersionAtImport": "5.55",
      "type": "SharedResources"
    }
  },
  ...
  "annotations": [
    {
      "name": "defaultPage",
      "value": "c2d9b4b1487b2eb30e98"
    }
  ]
}

การเปลี่ยนแปลงภายนอกไปยังไฟล์ PBIR

คุณสามารถแก้ไขไฟล์ PBIR JSON ที่รองรับในตัวแก้ไขโค้ด เช่น Visual Studio Code หรือเครื่องมือภายนอกอื่นในขณะที่โครงการยังคงเปิดใน Power BI Desktop เมื่อคุณบันทึกแฟ้ม Power BI Desktop จะตรวจพบการเปลี่ยนแปลง และแสดงแบนเนอร์ ใช้การเปลี่ยนแปลงภายนอก เลือก ใช้การเปลี่ยนแปลงภายนอก เพื่อโหลดข้อกําหนดของรายงานโดยไม่ปิดและเปิดโครงการใหม่

ก่อนที่คุณจะแก้ไขไฟล์ PBIR ภายนอก ให้บันทึกการเปลี่ยนแปลงใดๆ ใน Power BI Desktop ถ้า Power BI Desktop มีการเปลี่ยนแปลงที่ยังไม่ได้บันทึกเมื่อคุณใช้การเปลี่ยนแปลงภายนอก จะมีการเตือนคุณว่าการเปลี่ยนแปลงที่ยังไม่ได้บันทึกจะถูกเขียนทับ สําหรับเวิร์กโฟลว์และข้อจํากัดที่เสร็จสมบูรณ์ ดูแก้ไขไฟล์ PBIP ภายนอก Power BI Desktop

ไฟล์ PBIR ต้องสอดคล้องกับสคีมา JSON ของพวกเขา VS Code ระบุปัญหา เช่น ชื่อคุณสมบัติที่ไม่รองรับหรือชนิดคุณสมบัติที่ไม่ถูกต้อง:

สกรีนช็อตของการตรวจสอบเค้าร่าง PBIR JSON

การเปลี่ยนแปลงภายนอกไปยังเนื้อหา PBIR อาจส่งผลให้เกิดข้อผิดพลาดเมื่อคุณใช้การเปลี่ยนแปลงหรือเปิดไฟล์ใน Power BI Desktop ข้อผิดพลาดเหล่านี้สามารถเป็นได้สองชนิด:

การบล็อกข้อผิดพลาดป้องกันไม่ให้ Power BI Desktop โหลดการเปลี่ยนแปลงของรายงาน ข้อผิดพลาดเหล่านี้ระบุปัญหาและไฟล์ที่คุณต้องแก้ไขก่อนที่จะใช้การเปลี่ยนแปลงอีกครั้ง:

สกรีนช็อตของข้อผิดพลาดการบล็อก PBIR พร้อมท์

ข้อผิดพลาดเช่นเค้าร่างไม่ถูกต้องหรือคุณสมบัติที่จําเป็นหายไปกําลังบล็อกข้อผิดพลาด หากต้องการระบุข้อผิดพลาดเหล่านี้ ให้เปิดไฟล์ใน VS Code และตรวจสอบข้อความการตรวจสอบความถูกต้องของ schema

ข้อผิดพลาดที่ไม่บล็อก ไม่ได้ป้องกันไม่ให้ Power BI Desktop เปิดรายงานและได้รับการแก้ไขโดยอัตโนมัติ

สกรีนช็อตของข้อผิดพลาดการไม่บล็อก PBIR

การกําหนดค่าที่ไม่ถูกต้องactivePageNameคือตัวอย่างของข้อผิดพลาดที่ไม่บล็อกที่ Power BI Desktop แก้ไขโดยอัตโนมัติ คําเตือนจะให้โอกาสในการตรวจสอบการแก้ไขก่อนที่คุณจะบันทึกรายงานและเขียนทับข้อกําหนดภายนอก

ข้อผิดพลาด PBIR ทั่วไป

สถานการณ์สมมติ:หลังจากเปลี่ยนชื่อโฟลเดอร์วิชวลหรือเพจแล้ว วิชวลหรือเพจของฉันจะไม่ปรากฏขึ้นอีกต่อไปเมื่อเปิดรายงาน

สารละลาย: ตรวจสอบว่าชื่อสอดคล้องกับ แบบแผนการตั้งชื่อหรือไม่ หากไม่เป็นเช่นนั้น Power BI Desktop จะละเว้นไฟล์หรือโฟลเดอร์และถือว่าเป็นไฟล์ผู้ใช้ส่วนตัว

สถานการณ์สมมติ:วัตถุรายงานใหม่มีชื่อแตกต่างจากวัตถุอื่นๆ ตัวอย่างเช่น โฟลเดอร์หน้าส่วนใหญ่มีชื่อว่า 'ReportSection0e71dafbc949c0853608' ในขณะที่บางโฟลเดอร์มีชื่อว่า '1b3c2ab12b603618070b'

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

สถานการณ์สมมติ:ฉันคัดลอกไฟล์บุ๊กมาร์ก และเมื่อบันทึก การกําหนดค่าบุ๊กมาร์กส่วนใหญ่ถูกลบ

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

สถานการณ์สมมติ:ฉันคัดลอกโฟลเดอร์หน้าจากรายงานอื่น และพบข้อผิดพลาดที่ระบุว่า "ค่าสําหรับคุณสมบัติ 'pageBinding.name' ต้องไม่ซ้ํากัน"

สารละลาย: วัตถุ pageBinding เป็นสิ่งจําเป็นเพื่อสนับสนุนการดูรายละเอียดแบบเจาะลึกและคําแนะนําเครื่องมือของหน้า เนื่องจากอาจมีการอ้างอิงถึงโดยหน้าอื่น ชื่อต้องไม่ซ้ํากันภายในรายงาน ในหน้าที่คัดลอกใหม่ ให้กําหนดค่าที่ไม่ซ้ํากันเพื่อแก้ไขข้อผิดพลาด หลังจากเดือนมิถุนายน 2024 สถานการณ์นี้ไม่มีปัญหาอีกต่อไปเนื่องจากชื่อ pageBinding เป็น GUID ตามค่าเริ่มต้น

แปลงรายงานที่มีอยู่เป็น PBIR

PBIR จะพร้อมใช้งานโดยทั่วไปและเป็นรูปแบบรายงานเริ่มต้น คุณยังสามารถเปิดรายงานที่ใช้ PBIR-Legacy ใน Power BI Desktop และ บริการของ Power BI เมื่อคุณแก้ไขและบันทึกรายงาน PBIR-Legacy Power BI อย่างเงียบ ๆ และแปลงเป็น PBIR โดยอัตโนมัติ

ก่อนการแปลง Power BI จะสร้างการสํารองข้อมูลของรายงาน:

  • Power BI Desktop เก็บสํารองข้อมูลไว้เป็นเวลา 30 วันในตําแหน่งใดตําแหน่งหนึ่งต่อไปนี้:
    • เวอร์ชัน Microsoft Store: %USERPROFILE%\Microsoft\Power BI Desktop Store App\TempSaves\Backups
    • เวอร์ชันของตัวติดตั้งที่ใช้งานได้: %USERPROFILE%\AppData\Local\Microsoft\Power BI Desktop\TempSaves\Backups
  • บริการของ Power BI เก็บการสํารองข้อมูล PBIR-Legacy ไว้เป็นเวลา 28 วัน หากต้องการกู้คืน ให้เปิดการตั้งค่ารายงานจากพื้นที่ทํางานและเลือกคืนค่าเป็น PBIR-Legacy การสํารองข้อมูลนี้ถูกสร้างขึ้นสําหรับรายงานที่แปลงโดยตรงใน บริการของ Power BI เท่านั้น

การกู้คืนข้อมูลสํารอง PBIR-Legacy ไม่ได้ป้องกันการแปลงอื่น หากต้องการเก็บรายงานในรูปแบบ PBIR-Legacy อย่าแก้ไขใน บริการของ Power BI หรือใช้การเผยแพร่ของ Power BI Desktop ที่เผยแพร่ก่อนเดือนกันยายน 2026

ข้อควรพิจารณาและข้อจํากัดของ PBIR

คํานึงถึงข้อควรพิจารณาและข้อจํากัดดังต่อไปนี้:

  • ตัวกรองวิ ชวลอัตโนมัติจะยังคงอยู่ในไฟล์ PBIR visual.json หลังจากขยายบานหน้าต่างตัวกรองอย่างน้อยหนึ่งครั้งในขณะแก้ไขรายงาน
  • หาก Power BI ไม่ได้แปลงรายงาน PBIR-Legacy เป็น PBIR เมื่อคุณแก้ไขและบันทึก การแปลงได้พบปัญหาผลิตภัณฑ์ สร้างคําขอการสนับสนุน เพื่อรายงานปัญหา

ข้อจํากัดของขนาด PBIR ที่บังคับใช้โดยบริการ:

  • สูงสุด 1,000 หน้าต่อรายงาน
  • วิชวลสูงสุด 1,000 รายการต่อหน้า
  • สูงสุด 1000 ไฟล์แพคเกจทรัพยากรต่อรายงาน
  • ขนาดสูงสุด 300 mb สําหรับไฟล์แพคเกจทรัพยากรทั้งหมด
  • ขนาดสูงสุด 300 mb ของไฟล์รายงานทั้งหมด

Important

หากถึงขีดจํากัดข้างต้น คุณควรพิจารณาเพิ่มประสิทธิภาพรายงาน ดูเอกสารการเพิ่มประสิทธิภาพ Power BI

Fabric Git Integration และ Fabric REST API ส่งออกข้อกําหนดรายงานโดยใช้ PBIR

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

  • อัปเดตล่าสุดเมื่อ