บทช่วยสอน: ฝังเนื้อหา 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
ผู้เช่า Azure Active Directory ของคุณเอง
หนึ่งในสิทธิ์การใช้งานต่อไปนี้:
หมายเหตุ
หากต้องการ ย้ายไปยังการผลิต คุณจะต้องใช้หนึ่งในการกําหนดค่าต่อไปนี้:
- ผู้ใช้ทั้งหมดProสิทธิ์การใช้งาน
- ผู้ใช้ทั้งหมดที่มีสิทธิ์การใช้งาน PPU
- ความจุ P หรือ EM การกําหนดค่านี้อนุญาตให้ผู้ใช้ทุกคนมีสิทธิ์การใช้งานฟรี
การขึ้นต่อกันของโค้ด
.NET Core 3.1 SDK (หรือสูงกว่า)
เครื่องมือพัฒนาโปรแกรม (integrated development environment : IDE) เราขอแนะนำให้ใช้หนึ่งในรายการต่อไปนี้:
วิธีการ
เมื่อต้องการสร้างแอป ตัวอย่างการฝังตัวให้กับ องค์กรของคุณ ให้ปฏิบัติตามขั้นตอนเหล่านี้:
ขั้นตอนที่ 1 - ลงทะเบียนแอปพลิเคชัน Azure AD
การลงทะเบียนแอปพลิเคชันด้วย Azure AD จะช่วยให้คุณสามารถสร้างข้อมูลเฉพาะตัวของแอปของคุณ
หากต้องการลงทะเบียนแอปพลิเคชันของคุณด้วย Azure AD ให้ทำตามคำแนะนำในลงทะเบียนแอปพลิเคชันของคุณ
ขั้นตอนที่ 2 - สร้างพื้นที่งาน Power BI
Power BI เก็บรายงาน แดชบอร์ด และไทล์ของคุณไว้ในพื้นที่ทำงาน หากต้องการฝังรายการเหล่านี้ คุณจะต้องสร้างและอัปโหลดรายการเหล่านั้นลงในพื้นที่ทำงาน
เคล็ดลับ
ถ้าคุณมีพื้นที่ทำงานอยู่แล้ว คุณสามารถข้ามขั้นตอนนี้ได้เลย
หากต้องการสร้างพื้นที่ทำงาน ให้ทำดังต่อไปนี้:
ลงชื่อเข้าใช้ไปยัง Power BI
เลือก พื้นที่ทำงาน
เลือก สร้างพื้นที่ทำงาน
ตั้งชื่อพื้นที่ทำงานของคุณและเลือก บันทึก
ขั้นตอนที่ 3 - สร้างและเผยแพร่รายงาน Power BI
ขั้นตอนถัดไปของคุณคือการสร้างรายงานและอัปโหลดไปยังพื้นที่ทำงานของคุณ คุณสามารถสร้างรายงานของคุณเองโดยใช้ Power BI Desktop และจากนั้นเผยแพร่รายงานดังกล่าวไปยังพื้นที่ทำงานของคุณ หรือคุณสามารถอัปโหลดรายงานตัวอย่างไปยังพื้นที่ทำงานของคุณได้
เคล็ดลับ
ถ้าคุณมีพื้นที่ทำงานที่มีรายงานอยู่แล้ว คุณสามารถข้ามขั้นตอนนี้ได้เลย
หากต้องการดาวน์โหลดรายงานตัวอย่างและเผยแพร่ไปยังพื้นที่ทำงานของคุณ ให้ทำตามขั้นตอนเหล่านี้:
เปิดโฟลเดอร์ตัวอย่าง Power BI Desktop ใน GitHub
เลือก โค้ด จากนั้นเลือก ดาวน์โหลด zip
แยก ZIP ที่ดาวน์โหลดและนำทางไปยังโฟลเดอร์ รายงานตัวอย่าง
เลือกรายงานที่จะฝัง และเผยแพร่รายงานนั้นไปยังพื้นที่ทำงานของคุณ
ขั้นตอนที่ 4 - รับค่าพารามิเตอร์การฝัง
หากต้องการฝังเนื้อหาของคุณ คุณจะต้องได้รับค่าพารามิเตอร์สองถึงสามค่า ค่าพารามิเตอร์ที่คุณจะต้องขึ้นอยู่กับภาษาของแอปพลิเคชันตัวอย่างที่คุณต้องการใช้ ตารางด้านล่างแสดงรายการค่าพารามิเตอร์ที่ต้องใช้ในแต่ละรายการ
| พารามิเตอร์ | .NET Core | เฟรมเวอร์ค .NET | React TypeScript |
|---|---|---|---|
| ID ของไคลเอนต์ | ![]() |
![]() |
![]() |
| ข้อมูลลับไคลเอ็นต์ | ![]() |
![]() |
![]() |
| รหัสพื้นที่ทำงาน | ![]() |
![]() |
![]() |
| รหัสรายงาน | ![]() |
![]() |
![]() |
ID ของไคลเอนต์
เคล็ดลับ
ใช้กับ:
NET Core
React TypeScript
หากต้องการรับ GUID สำหรับ ID ของไคลเอ็นต์ (หรือที่เรียกว่า ID แอปพลิเคชัน) ให้ทำตามขั้นตอนเหล่านี้:
ลงชื่อเข้าใช้ใน Microsoft Azure
ค้นหา การลงทะเบียนแอป และเลือกลิงก์ การลงทะเบียนแอป
เลือกแอป Azure AD ที่คุณใช้สำหรับการฝังเนื้อหา Power BI ของคุณ
จากส่วน ภาพรวม ให้คัดลอก GUID สำหรับ ID แอปพลิเคชัน (ไคลเอนต์)
ข้อมูลลับไคลเอ็นต์
เคล็ดลับ
ใช้กับ:
NET Core
React TypeScript
หากต้องการรับข้อมูลลับไคลเอ็นต์ ให้ทำตามขั้นตอนเหล่านี้:
ลงชื่อเข้าใช้ใน Microsoft Azure
ค้นหา การลงทะเบียนแอป และเลือกลิงก์ การลงทะเบียนแอป
เลือกแอป Azure AD ที่คุณใช้สำหรับการฝังเนื้อหา Power BI ของคุณ
เลือก ใบรับรองและข้อมูลลับ ภายใต้ จัดการ
เลือก ข้อมูลลับไคลเอ็นต์ใหม่ ภายใต้ ข้อมูลลับไคลเอ็นต์
ในหน้าต่างป๊อปอัป เพิ่มข้อมูลลับไคลเอ็นต์ ให้คำอธิบายสำหรับข้อมูลลับของแอปพลิเคชันของคุณ เลือกเวลาที่ข้อมูลลับของแอปพลิเคชันจะหมดอายุและเลือก เพิ่ม
คัดลอกสตริงในคอลัมน์ ค่า ของข้อมูลลับของแอปพลิเคชันที่สร้างขึ้นใหม่จากส่วน ข้อมูลลับไคลเอ็นต์ ค่าข้อมูลลับไคลเอ็นต์คือ ID ไคลเอ็นต์ ของคุณ
หมายเหตุ
ตรวจสอบให้แน่ใจว่าคุณคัดลอกค่า ความลับของไคลเอ็นต์ เมื่อปรากฏก่อน หลังจากนําทางออกจากหน้านี้ ความลับของไคลเอ็นต์จะถูกซ่อนอยู่และคุณจะไม่สามารถเรียกใช้ค่าได้
ID พื้นที่ทำงาน
เคล็ดลับ
ใช้กับ:
กับ NET Core
React TypeScript
หากต้องการรับ GUID สำหรับ ID พื้นที่ทำงาน ให้ทำตามขั้นตอนเหล่านี้:
ลงชื่อเข้าใช้บริการ Power BI
เปิดรายงานที่คุณต้องการฝัง
คัดลอก GUID จาก URL GUID คือตัวเลขระหว่าง /groups/ และ /reports/
รหัสรายงาน
เคล็ดลับ
ใช้กับ:
กับ NET Core
ReactTypeScript
หากต้องการรับ GUID ของ ID รายงาน ให้ปฏิบัติตามขั้นตอนเหล่านี้:
ลงชื่อเข้าใช้บริการ Power BI
เปิดรายงานที่คุณต้องการฝัง
คัดลอก GUID จาก URL GUID คือตัวเลขระหว่าง /reports/ และ /ReportSection
ขั้นตอนที่ 5 - ฝังเนื้อหาของคุณ
แอปพลิเคชันตัวอย่าง Power BI embedded ช่วยให้คุณสามารถสร้าง แอป Power BI แบบฝังตัวขององค์กรได้
ให้ปฏิบัติตามขั้นตอนเหล่านี้เพื่อ ปรับเปลี่ยนแอปพลิเคชันตัวอย่าง การฝังตัวเพื่อองค์กรของคุณ เพื่อฝังรายงาน Power BI ของคุณ
เปิดโฟลเดอร์ตัวอย่างสำหรับนักพัฒนา Power BI
เลือก โค้ด จากนั้นเลือก ดาวน์โหลด zip
แตกไฟล์ ZIP ที่ดาวน์โหลดมาและไปที่โฟลเดอร์ PowerBI-Developer-Samples-master
เปิดหนึ่งในโฟลเดอร์เหล่านี้ ทั้งนี้ขึ้นอยู่กับภาษาที่คุณต้องการให้แอปพลิเคชันของคุณใช้:
- .NET Core
- เฟรมเวอร์ค .NET
- React-TS
หมายเหตุ
การ ฝังเพื่อแอปพลิเคชันตัวอย่าง องค์กรของคุณสนับสนุนเฉพาะเฟรมเวิร์กที่แสดงไว้ด้านบนเท่านั้น แอปพลิเคชัน ตัวอย่าง Java, Node JS และ Python สนับสนุนเฉพาะ โซลูชันการฝังตัวกับลูกค้า ของคุณเท่านั้น
กําหนดค่าแอป Azure AD ของคุณ
ลงชื่อเข้าใช้พอร์ทัล Azure
เลือก การลงทะเบียนแอป หากคุณไม่เห็นตัวเลือกนี้ ให้ค้นหา
เปิดแอปพลิเคชัน Azure AD ที่คุณสร้างในขั้นตอนที่ 1 - ลงทะเบียนแอปพลิเคชัน Azure AD
จากเมนู จัดการให้เลือกการรับรองความถูกต้อง
ในการ กําหนดค่า แพลตฟอร์ม เปิด แพลตฟอร์ม เว็บของคุณและ ในส่วนการเปลี่ยนเส้นทาง URI
https://localhost:5000/signin-oidcเพิ่มหมายเหตุ
ถ้าคุณไม่มีแพลตฟอร์มเว็บ ให้เลือก เพิ่ม แพลตฟอร์ม และ ในหน้าต่าง กําหนดค่า แพลตฟอร์ม ให้เลือก เว็บ
บันทึกการเปลี่ยนแปลงของคุณ
กําหนดค่าแอปตัวอย่างการฝัง
เปิด โฟลเดอร์ฝังตัวเพื่อ องค์กรของคุณ
เปิด แอปตัวอย่างการฝังตัวเพื่อองค์กรของคุณ โดยใช้หนึ่งในวิธีเหล่านี้:
ถ้าคุณใช้งาน Visual Studio เปิดโฟลเดอร์ UserOwnsData
เปิด appsettings.json และกรอกค่าพารามิเตอร์ต่อไปนี้:
ClientId- ใช้GUID ID ไคลเอ็นต์ClientSecret- ใช้ความลับ ของไคลเอ็นต์
เรียกใช้แอปตัวอย่าง
เรียกใช้โครงการโดยการเลือกตัวเลือกที่เหมาะสม:
หากคุณกำลังใช้ Visual Studio ให้เลือก IIS Express (เล่น)
หากคุณกำลังใช้ Visual Studio Code ให้เลือก เรียกใช้> เริ่มต้นการดีบัก
ลงชื่อเข้าใช้แอปพลิเคชันตัวอย่างการฝัง
หมายเหตุ
ในระหว่างการลงชื่อเข้าใช้ครั้งแรกของคุณ คุณจะได้รับพร้อมท์ให้อนุญาตให้ Azure AD มีสิทธิ์แอป
เมื่อโหลดแอปพลิเคชันตัวอย่างการฝัง เลือกเนื้อหา Power BI ที่คุณต้องการฝัง แล้วเลือก ฝัง
การพัฒนาแอปพลิเคชันของคุณ
หลังจากกำหนดค่าและเรียกใช้แอปพลิเคชันตัวอย่าง การฝังตัวสำหรับลูกค้าของคุณ คุณสามารถเริ่มต้นการพัฒนาแอปพลิเคชันของคุณเองได้