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

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

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

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

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

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

สำคัญ

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

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

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

• .NET Framework
• .NET Core
• React TypeScript

หมายเหตุ

ตัวอย่าง .NET Core และ .NET Framework อนุญาตให้ผู้ใช้ปลายทางดูแดชบอร์ด รายงาน หรือไทล์ของ Power BI ใดๆ ที่พวกเขามีสิทธิ์เข้าถึงในบริการของ Power BI ตัวอย่าง React TypeScript ช่วยให้คุณฝังรายงานเดียวเท่านั้นที่ผู้ใช้ของคุณมีสิทธิ์เข้าถึงในบริการของ Power BI

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

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

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

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

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

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

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

      • Power BI Pro

      • Premium Per User (PPU)

    หมายเหตุ

    หากต้องการ ย้ายไปยังการผลิต คุณจะต้องมีหนึ่งในการกําหนดค่าต่อไปนี้:

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

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

  .NET Core

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

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

    • Visual Studio

    • รหัส Visual Studio

  .NET Framework

  • .NET Framework 4.8

  • Visual Studio

  React TypeScript

  • ตัวแก้ไขข้อความ

  • เทอร์มินัลบรรทัดคําสั่ง (หรือ PowerShell)

---

วิธีการ

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

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 แล้ว เผยแพร่ ไปยังพื้นที่ทํางานของคุณ หรือคุณสามารถอัปโหลดรายงานตัวอย่างไปยังพื้นที่ทํางานของคุณ

เคล็ดลับ

ถ้าคุณมีพื้นที่ทํางานที่มีรายงานอยู่แล้ว คุณสามารถข้ามขั้นตอนนี้ได้เลย

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

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

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

   

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

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

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

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

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

Client ID

เคล็ดลับ

นําไปใช้กับ: .NET Core .NET Framework React TypeScript

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

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

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

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

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

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

เคล็ดลับ

นําไปใช้กับ: .NET Core .NET Framework React TypeScript

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

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

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

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

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

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

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

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

หมายเหตุ

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

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

เคล็ดลับ

นําไปใช้กับ: .NET Core .NET Framework React TypeScript

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

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

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

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

   

รหัสรายงาน

เคล็ดลับ

นําไปใช้กับ: .NET Core .NET Framework ReactTypeScript

หากต้องการรับ 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 Core
   • .NET Framework
   • React-TS

   หมายเหตุ

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

.NET Core

กําหนดค่าแอป Microsoft Entra ของคุณ

1. ลงชื่อเข้าใช้พอร์ทัล Azure

2. เลือก การลงทะเบียนแอป หากคุณไม่เห็นตัวเลือกนี้ ให้ค้นหา

3. เปิดแอปพลิเคชัน Microsoft Entra ที่คุณสร้างใน ขั้นตอนที่ 1 - ลงทะเบียนแอปพลิเคชัน Microsoft Entra

4. จากเมนูจัดการ เลือกการรับรองความถูกต้อง

5. ในการกําหนดค่าแพลตฟอร์ม เปิดแพลตฟอร์มเว็บของคุณและในส่วนการเปลี่ยนเส้นทาง URI เพิ่มhttps://localhost:5000/signin-oidc

   หมายเหตุ

   ถ้าคุณไม่มีแพลตฟอร์มเว็บ เลือกเพิ่มแพลตฟอร์ม และในหน้าต่างกําหนดค่าแพลตฟอร์ม เลือกเว็บ

6. บันทึกการเปลี่ยนแปลงของคุณ

กําหนดค่าแอปการฝังตัวอย่าง

1. เปิดโฟลเดอร์ฝังตัวสําหรับองค์กรของคุณ

2. เปิดแอปตัวอย่างการฝังตัวสําหรับองค์กรของคุณโดยใช้วิธีใดวิธีหนึ่งต่อไปนี้:

   • หากคุณกําลังใช้ Visual Studio ให้เปิดไฟล์ UserOwnsData.sln

   • หากคุณกําลังใช้ Visual Studio Code ให้เปิดโฟลเดอร์ UserOwnsData

3. เปิด appsettings.json และกรอกค่าพารามิเตอร์ต่อไปนี้:

   • ClientId - ใช้ GUID สําหรับ ID ไคลเอ็นต์

   • ClientSecret - ใช้ข้อมูล ลับไคลเอ็นต์

เรียกใช้แอปตัวอย่าง

1. เรียกใช้โครงการโดยการเลือกตัวเลือกที่เหมาะสม:

   • หากคุณกําลังใช้ Visual Studio ให้เลือก IIS Express (เล่น)

   • หากคุณกําลังใช้ Visual Studio Code ให้เลือก เรียกใช้ > การเริ่มการแก้จุดบกพร่อง

2. ลงชื่อเข้าใช้แอปพลิเคชันตัวอย่างการฝังตัว

   หมายเหตุ

   ในระหว่างการลงชื่อเข้าใช้ครั้งแรก คุณจะได้รับแจ้งให้อนุญาตสิทธิ์ Microsoft Entra สําหรับแอป

3. เมื่อโหลดแอปพลิเคชันตัวอย่างการฝัง เลือกเนื้อหา Power BI ที่คุณต้องการฝัง จากนั้นเลือกฝัง

   

.NET Framework

กําหนดค่าแอป Microsoft Entra ของคุณ

1. ลงชื่อเข้าใช้พอร์ทัล Azure

2. เลือก การลงทะเบียนแอป หากคุณไม่เห็นตัวเลือกนี้ ให้ค้นหา

3. เปิดแอปพลิเคชัน Microsoft Entra ที่คุณสร้างใน ขั้นตอนที่ 1 - ลงทะเบียนแอปพลิเคชัน Microsoft Entra

4. จากเมนูจัดการ เลือกการรับรองความถูกต้อง

5. ใน การกําหนดค่าแพลตฟอร์ม ให้กําหนดค่าตัวเลือกต่อไปนี้:

   1. ในแพลตฟอร์มเว็บของคุณ ในส่วนการเปลี่ยนเส้นทาง URI ให้เพิ่มhttps://localhost:44300/

      หมายเหตุ

      ถ้าคุณไม่มีแพลตฟอร์มเว็บ เลือกเพิ่มแพลตฟอร์ม และในหน้าต่างกําหนดค่าแพลตฟอร์ม เลือกเว็บ

   2. ในการ ให้สิทธิ์โดยนัยและโฟลว์แบบไฮบริด ให้ เปิดใช้งานตัวเลือกโทเค็น ID

6. บันทึกการเปลี่ยนแปลงของคุณ

กําหนดค่าแอปการฝังตัวอย่าง

1. เปิดโฟลเดอร์ฝังตัวสําหรับองค์กรของคุณ

2. ใช้ Visual Studio เปิดไฟล์ UserOwnsData.sln

3. เปิด Web.config และกรอกค่าพารามิเตอร์ต่อไปนี้:

   • clientId - ใช้ GUID สําหรับ ID ไคลเอ็นต์

   • clientSecret - ใช้ข้อมูล ลับไคลเอ็นต์

เรียกใช้แอปตัวอย่าง

1. เรียกใช้โครงการโดยการเลือก IIS Express (เล่น)

2. ลงชื่อเข้าใช้แอปพลิเคชันตัวอย่างการฝังตัว

   หมายเหตุ

   ในระหว่างการลงชื่อเข้าใช้ครั้งแรก คุณจะได้รับแจ้งให้อนุญาตสิทธิ์ Microsoft Entra สําหรับแอป

3. เมื่อโหลดแอปพลิเคชันตัวอย่างการฝัง เลือกเนื้อหา Power BI ที่คุณต้องการฝัง จากนั้นเลือกฝัง

   

React TypeScript

กําหนดค่าแอป Microsoft Entra ของคุณ

1. ลงชื่อเข้าใช้พอร์ทัล Azure

2. เลือก การลงทะเบียนแอป หากคุณไม่เห็นตัวเลือกนี้ ให้ค้นหา

3. เปิดแอปพลิเคชัน Microsoft Entra ที่คุณสร้างใน ขั้นตอนที่ 1 - ลงทะเบียนแอปพลิเคชัน Microsoft Entra

4. จากเมนูจัดการ เลือกการรับรองความถูกต้อง

5. ในการกําหนดค่าแพลตฟอร์ม กําหนดค่าแพลตฟอร์มเว็บของคุณดังนี้:

   1. ในการเปลี่ยนเส้นทาง URI เพิ่มhttps://localhost:3000และเลือกกําหนดค่า

      หมายเหตุ

      ถ้าคุณไม่มีแพลตฟอร์มเว็บ เลือกเพิ่มแพลตฟอร์ม และในหน้าต่างกําหนดค่าแพลตฟอร์ม เลือกเว็บ

   2. ในการ ให้สิทธิ์โดยนัยและโฟลว์แบบไฮบริด ให้เปิดใช้งานทั้งสองตัวเลือก:

      • โทเค็นการเข้าถึง
      • โทเค็น ID

6. บันทึกการเปลี่ยนแปลงของคุณ

กําหนดค่าแอปการฝังตัวอย่าง

1. เปิดโฟลเดอร์ฝังตัวสําหรับผู้ใช้องค์กรของคุณ>UserOwnsData>src

2. ใช้ตัวแก้ไขข้อความเปิด ไฟล์ Config.ts และกรอกค่าพารามิเตอร์ต่อไปนี้:

   • clientId - ใช้ GUID สําหรับ ID ไคลเอ็นต์

   • workspaceId - ใช้ ID พื้นที่ทํางาน

   • reportId - ใช้ รหัสรายงาน

3. บันทึกไฟล์

เรียกใช้แอปตัวอย่าง

1. เปิดเทอร์มินัลและนําทางไปยังการฝังสําหรับผู้ใช้องค์กรของคุณ>OwnsData

2. ติดตั้งการขึ้นต่อกันที่จําเป็นโดยการป้อนคําสั่งต่อไปนี้:

   npm install

3. เรียกใช้แอปพลิเคชันโดยการป้อนคําสั่งต่อไปนี้:

   npm run start

   หมายเหตุ

   ในระหว่างการลงชื่อเข้าใช้ครั้งแรก คุณจะได้รับแจ้งให้อนุญาตสิทธิ์ Microsoft Entra สําหรับแอป

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

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

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

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

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

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

ถามชุมชน Power BI