บทช่วยสอน: ฝังเนื้อหา Power BI โดยใช้แอปพลิเคชันตัวอย่างการฝังตัวสําหรับองค์กรของคุณ

การวิเคราะห์แบบฝังตัวของ Power BI ช่วยให้คุณสามารถฝังเนื้อหา Power BI เช่น รายงาน แดชบอร์ด และไทล์ลงในแอปพลิเคชันของคุณได้

ในบทช่วยสอนนี้ คุณจะเรียนรู้วิธีการ:

หากต้องการใช้แอปพลิเคชันของคุณ ผู้ใช้ของคุณจะต้องลงชื่อเข้าใช้ Power BI

โซลูชันฝังตัวสําหรับองค์กรของคุณมักใช้โดยองค์กรและองค์กรขนาดใหญ่ และมีไว้สําหรับผู้ใช้ภายใน

ข้อมูลจําเพาะตัวอย่างของโค้ด

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

• .NET Framework
• .NET คอร์
• ปฏิกิริยา TypeScript

ตัวอย่างโค้ดสนับสนุนเบราว์เซอร์ต่อไปนี้:

• ไมโครซอฟท์เอดจ์
• กูเกิล โครม
• มอซิลลา ไฟร์ฟอกซ์

ข้อกำหนดเบื้องต้น

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

• การขึ้นต่อกันของ Power BI

  • ผู้เช่า Microsoft Entra ของคุณเอง

  • หนึ่งในสิทธิ์การใช้งานต่อไปนี้:

    • Microsoft Fabric

    • Power BI โปร

    • พรีเมี่ยมต่อผู้ใช้ (PPU)

    หมายเหตุ

    หากต้องการ ย้ายแอปแบบฝังตัวของคุณไปยังการผลิต คุณจะต้องมีการกําหนดค่าต่อไปนี้:

    • ผู้ใช้ทั้งหมดที่มีสิทธิ์การใช้งาน Pro
    • ผู้ใช้ทั้งหมดที่มีสิทธิการใช้งาน PPU
    • SKU ที่เทียบเท่ากับหรือสูงกว่า F64 SKU การกําหนดค่านี้ช่วยให้ผู้ใช้ทั้งหมดมีสิทธิ์การใช้งานฟรี

• การขึ้นต่อกันของโค้ด

  • .NET คอร์
  • .NET เฟรมเวิร์ก
  • ปฏิกิริยา TypeScript

  • .NET Core 3.1 SDK (หรือสูงกว่า)

  • สภาพแวดล้อมการพัฒนาแบบรวม (IDE) เราขอแนะนําให้ใช้หนึ่งใน IDE ต่อไปนี้:

    • วิชวลสตูดิโอ

    • รหัส Visual Studio

วิธีการ

หากต้องการสร้างแอปตัวอย่างการ ฝังตัวสําหรับองค์กรของคุณ ให้ทําตามขั้นตอนเหล่านี้:

1. ลงทะเบียนแอปพลิเคชัน Microsoft Entra
2. สร้างพื้นที่ทํางาน Power BI
3. สร้างและเผยแพร่รายงาน Power BI
4. รับค่าพารามิเตอร์การฝัง
5. ฝังเนื้อหาของคุณ

ขั้นตอนที่ 1 - ลงทะเบียนแอปพลิเคชัน Microsoft Entra

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

หากต้องการลงทะเบียนแอปพลิเคชันของคุณด้วย Microsoft Entra ID ให้ทําตามคําแนะนําใน ลงทะเบียนแอปพลิเคชันของคุณ

ขั้นตอนที่ 2 - สร้างพื้นที่ทํางาน Power BI

Microsoft Fabric เก็บรายงาน แดชบอร์ด และไทล์ของคุณไว้ในพื้นที่ทํางาน เมื่อต้องฝังรายการเหล่านี้ คุณจําเป็นต้องสร้างและอัปโหลดลงในพื้นที่ทํางาน

หากต้องการสร้างพื้นที่ทํางาน ให้ทําดังต่อไปนี้:

1. ลงชื่อเข้าใช้ Fabric
2. เลือกพื้นที่ทํางาน
3. เลือก + พื้นที่ทํางานใหม่
4. ตั้งชื่อพื้นที่ทํางานของคุณและเลือกนําไปใช้

ขั้นตอนที่ 3 - สร้างและเผยแพร่รายงาน Power BI

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

หากต้องการดาวน์โหลดรายงานตัวอย่าง (ไม่ใช่ Direct Lake ที่เปิดใช้งาน) และเผยแพร่ไปยังพื้นที่ทํางานของคุณ ให้ทําตามขั้นตอนเหล่านี้:

1. เปิดโฟลเดอร์ตัวอย่าง Power BI Desktop ใน GitHub

2. เลือก โค้ด จากนั้นเลือก ดาวน์โหลด ZIP

   

3. แยก ZIP ที่ดาวน์โหลดและนําทางไปยังโฟลเดอร์รายงานตัวอย่าง

4. เลือกรายงานที่จะฝัง และ เผยแพร่ รายงานไปยังพื้นที่ทํางานของคุณ

ขั้นตอนที่ 4 - รับค่าพารามิเตอร์การฝัง

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

พารามิเตอร์	.NET คอร์	.NET Framework	ปฏิกิริยา TypeScript
รหัสไคลเอ็นต์
ข้อมูลลับของไคลเอ็นต์
ID พื้นที่ทํางาน
รหัสรายงาน

ID ไคลเอ็นต์

เมื่อต้องการรับ GUID รหัสไคลเอ็นต์ (หรือที่เรียกว่า รหัสแอปพลิเคชัน) ให้ทําตามขั้นตอนเหล่านี้:

1. เข้าสู่ระบบ Microsoft Azure

2. ค้นหา การลงทะเบียนแอป และเลือกลิงก์ การลงทะเบียนแอป

3. เลือกแอป Microsoft Entra ที่คุณกําลังใช้เพื่อฝังเนื้อหา Power BI ของคุณ

4. จากส่วนภาพรวม ให้คัดลอก GUID สําหรับ ID แอปพลิเคชัน (ไคลเอนต์)

ข้อมูลลับของไคลเอ็นต์

หากต้องการรับข้อมูลลับไคลเอ็นต์ ให้ทําตามขั้นตอนเหล่านี้:

1. เข้าสู่ระบบ Microsoft Azure

2. ค้นหา การลงทะเบียนแอป และเลือกลิงก์ การลงทะเบียนแอป

3. เลือกแอป Microsoft Entra ที่คุณกําลังใช้เพื่อฝังเนื้อหา Power BI ของคุณ

4. ภายใต้ จัดการ เลือก ใบรับรองและข้อมูลลับ

5. ภายใต้ ข้อมูลลับไคลเอ็นต์ ให้เลือก ข้อมูลลับไคลเอ็นต์ใหม่

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

7. จากส่วนข้อมูลลับไคลเอ็นต์ ให้คัดลอกสตริงในคอลัมน์ ค่า ของข้อมูลลับของแอปพลิเคชันที่สร้างขึ้นใหม่ ค่าข้อมูลลับไคลเอ็นต์คือ ID ไคลเอ็นต์ของคุณ

ID พื้นที่ทำงาน

หากต้องการรับ GUID สําหรับ ID พื้นที่ทํางาน ให้ทําตามขั้นตอนเหล่านี้:

1. ลงชื่อเข้าใช้การบริการ Power BI

2. เปิดรายงานที่คุณต้องการฝัง

3. คัดลอก GUID จาก URL GUID คือตัวเลขระหว่าง /groups/ และ /reports/

   

รหัสรายงาน

หากต้องการรับ GUID สําหรับ ID รายงาน ให้ทําตามขั้นตอนเหล่านี้:

1. ลงชื่อเข้าใช้การบริการ Power BI

2. เปิดรายงานที่คุณต้องการฝัง

3. คัดลอก GUID จาก URL GUID คือตัวเลขระหว่าง /reports/ และ /ReportSection

   

ขั้นตอนที่ 5 - ฝังเนื้อหาของคุณ

แอปพลิเคชันตัวอย่าง Power BI embedded ช่วยให้คุณสามารถสร้างแอป Power BI แบบ ฝังตัวสําหรับองค์กรของคุณ ได้

ทําตามขั้นตอนเหล่านี้เพื่อปรับเปลี่ยนแอปพลิเคชันตัวอย่างการ ฝังตัวสําหรับองค์กรของคุณ เพื่อฝังรายงาน Power BI ของคุณ

1. เปิด โฟลเดอร์ตัวอย่างสําหรับ นักพัฒนา Power BI

2. เลือก โค้ด จากนั้นเลือก ดาวน์โหลด ZIP

   

3. แยก ZIP ที่ดาวน์โหลดและนําทางไปยังโฟลเดอร์ PowerBI-Developer-Samples-master

4. เปิดหนึ่งในโฟลเดอร์ต่อไปนี้ โดยขึ้นอยู่กับภาษาที่คุณต้องการให้แอปพลิเคชันของคุณใช้:

   • .NET คอร์
   • .NET Framework
   • React-TS

   หมายเหตุ

   แอปพลิเคชันตัวอย่างการ ฝังตัวสําหรับองค์กรของคุณ สนับสนุนเฉพาะเฟรมเวิร์กที่ระบุไว้ก่อนหน้านี้เท่านั้น แอปพลิเคชันตัวอย่าง Java, Node JS และ Python รองรับเฉพาะโซลูชันการ ฝังตัวสําหรับลูกค้าของคุณ เท่านั้น

พัฒนาแอปพลิเคชันของคุณ

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

อัปเดตสิทธิ์ของผู้ใช้

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

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

• บทช่วยสอน: ฝังเนื้อหา Power BI โดยใช้แอปพลิเคชันตัวอย่างการฝังตัวสําหรับลูกค้าของคุณ
• รายงานที่มีการแบ่งหน้าแบบฝังตัว
• มีคำถามเพิ่มเติมหรือไม่? ลองถามชุมชน Power BI