บทช่วยสอน: ฝังเนื้อหา 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

    หมายเหตุ

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

    • ผู้ใช้ทั้งหมดProสิทธิ์การใช้งาน
    • ผู้ใช้ทั้งหมดที่มีสิทธิ์การใช้งาน PPU
    • ความจุ P หรือ EM การกําหนดค่านี้อนุญาตให้ผู้ใช้ทุกคนมีสิทธิ์การใช้งานฟรี
  • การขึ้นต่อกันของโค้ด

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

    • เครื่องมือพัฒนาโปรแกรม (integrated development environment : IDE) เราขอแนะนำให้ใช้หนึ่งในรายการต่อไปนี้:


วิธีการ

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

  1. ลงทะเบียนแอปพลิเคชัน Azure AD

  2. สร้างพื้นที่ทำงาน Power BI

  3. สร้าง และเผยแพร่รายงาน Power BI

  4. รับค่าพารามิเตอร์การฝัง

  5. ฝังตัวเนื้อหาของคุณ

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

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

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

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

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

เคล็ดลับ

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

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

  1. ลงชื่อเข้าใช้ไปยัง Power BI

  2. เลือก พื้นที่ทำงาน

  3. เลือก สร้างพื้นที่ทำงาน

  4. ตั้งชื่อพื้นที่ทำงานของคุณและเลือก บันทึก

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

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

เคล็ดลับ

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

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

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

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

    สกรีนช็อตที่แสดงตัวเลือกการดาวน์โหลด ZIP ใน GitHub ตัวอย่าง Power BI desktop

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

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

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

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

พารามิเตอร์ .NET Core เฟรมเวอร์ค .NET React TypeScript
ID ของไคลเอนต์ นำไปใช้กับ นำไปใช้กับ นำไปใช้กับ
ข้อมูลลับไคลเอ็นต์ นำไปใช้กับ นำไปใช้กับ ไม่นำไปใช้
รหัสพื้นที่ทำงาน ไม่นำไปใช้ ไม่นำไปใช้ นำไปใช้กับ
รหัสรายงาน ไม่นำไปใช้ ไม่นำไปใช้ นำไปใช้กับ

ID ของไคลเอนต์

เคล็ดลับ

ใช้กับ:  ใช้กับ NET Core  มีผลใช้งาน .NET Framework ใช้กับ React TypeScript

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

  1. ลงชื่อเข้าใช้ใน Microsoft Azure

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

  3. เลือกแอป Azure AD ที่คุณใช้สำหรับการฝังเนื้อหา Power BI ของคุณ

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

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

เคล็ดลับ

ใช้กับ:  ใช้กับ NET Core  มีผลใช้งาน .NET Framework ไม่สามารถมีผลบังคับกับ React TypeScript

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

  1. ลงชื่อเข้าใช้ใน Microsoft Azure

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

  3. เลือกแอป Azure AD ที่คุณใช้สำหรับการฝังเนื้อหา 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/

    สกรีนช็อตที่แสดง GUID สำหรับ ID พื้นที่ทำงานใน URL ของบริการ Power BI

รหัสรายงาน

เคล็ดลับ

ใช้กับ:  ไม่ปรับใช้ กับ NET Core  ไม่มีผลกับ .NET Framework ใช้กับ ReactTypeScript

หากต้องการรับ GUID ของ ID รายงาน ให้ปฏิบัติตามขั้นตอนเหล่านี้:

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

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

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

    สกรีนช็อตที่แสดง GUID สำหรับ ID รายงานใน URL ของบริการ Power BI

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

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

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

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

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

    สกรีนช็อตที่แสดงตัวเลือกการดาวน์โหลด ZIP ใน GitHub ตัวอย่างสำหรับนักพัฒนา Power BI

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

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

    • .NET Core
    • เฟรมเวอร์ค .NET
    • React-TS

    หมายเหตุ

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

กําหนดค่าแอป Azure AD ของคุณ

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

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

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

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

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

    หมายเหตุ

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

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

สกรีนช็อตที่แสดงการกําหนดค่าการรับรองความถูกต้องแอป Azure AD รวมถึง U R I เปลี่ยนเส้นทางเว็บของตัวอย่างแอป .NET หลัก

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

  1. เปิด โฟลเดอร์ฝังตัวเพื่อ องค์กรของคุณ

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

    • ถ้าคุณใช้งาน Visual Studio ไฟล์ UserOwnsData.sln

    • ถ้าคุณใช้งาน Visual Studio เปิดโฟลเดอร์ UserOwnsData

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

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

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

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

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

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

    หมายเหตุ

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

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

    สกรีนช็อตที่แสดงแอปตัวอย่างการฝัง Power BI

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

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

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