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

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

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

หากต้องการใช้แอปพลิเคชันของคุณ ผู้ใช้ของคุณจะไม่จำเป็นต้องลงชื่อเข้าใช้ Power BI หรือไม่จำเป็นต้องมีสิทธิการใช้งาน Power BI

เราขอแนะนำให้ใช้วิธี การฝังตัวสำหรับลูกค้าของคุณ เพื่อฝังเนื้อหา Power BI ของคุณ หากคุณเป็นผู้จำหน่ายซอฟต์แวร์อิสระ (ISV) หรือนักพัฒนาที่ต้องการสร้างแอปพลิเคชันสำหรับบุคคลที่สาม

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

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

• .NET Framework
• .NET Core
• Java
• Node JS
• Python

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

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

สิ่งที่จำเป็นต้องมี

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

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

  • ผู้เช่า Azure Active Directory ของคุณเอง

  • หากต้องการรับรองความถูกต้องของแอปกับ Power BI คุณจะต้องมีหนึ่งในรายการต่อไปนี้:

    • โครงร่างสำคัญของบริการ - Azure Active Directory (Azure AD) ออบเจ็กต์โครงร่างสำคัญของบริการที่อนุญาตให้ Azure AD รับรองความถูกต้องของแอปของคุณ

    • สิทธิ์การใช้งาน Power BI Pro - ซึ่งจะเป็น ผู้ใช้หลัก ของคุณและแอปของคุณจะใช้เพื่อรับรองความถูกต้องกับ Power BI

    • สิทธิ์การใช้งาน Power BI Premium Per User (PPU) - ซึ่งจะเป็น ผู้ใช้หลัก ของคุณและแอปของคุณจะใช้เพื่อรับรองความถูกต้องกับ Power BI

  หมายเหตุ

  หากต้องการย้ายไปยังการผลิต คุณจะต้องมีความจุ

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

  • .NET Core
  • .NET Framework
  • Java
  • Node JS
  • Python

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

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

    • Visual Studio

    • รหัส Visual Studio

วิธีการ

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

1. เลือกวิธีการรับรองความถูกต้องของคุณ

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

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

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

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

6. สิทธิ์การเข้าถึง API ของโครงร่างสำคัญของบริการ

7. เปิดใช้งานการเข้าถึงพื้นที่ทำงาน

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

ขั้นตอนที่ 1 - เลือกวิธีการรับรองความถูกต้องของคุณ

โซลูชันแบบฝังตัวของคุณจะแตกต่างกันโดยขึ้นอยู่กับวิธีการรับรองความถูกต้องที่คุณเลือก ดังนั้นสิ่งสำคัญคือต้องเข้าใจความแตกต่างระหว่างวิธีการรับรองความถูกต้องและตัดสินใจว่าวิธีใดเหมาะสมกับโซลูชันของคุณมากที่สุด

ตารางด้านล่างนี้อธิบายความแตกต่างที่สำคัญบางประการระหว่างวิธีการรับรองความถูกต้องแบบ โครงร่างสำคัญของบริการ และ ผู้ใช้หลัก

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

พารามิเตอร์	โครงร่างสำคัญของบริการ	ผู้ใช้หลัก
ID ของไคลเอนต์
รหัสพื้นที่ทำงาน
รหัสรายงาน
ข้อมูลลับไคลเอ็นต์
ID ผู้เช่า
ชื่อผู้ใช้ Power BI
รหัสผ่าน Power BI

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

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

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

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

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

4. จากส่วน ภาพรวม ให้คัดลอก GUID สำหรับ 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

   

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

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

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

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

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

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

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

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

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

ID ผู้เช่า

หากต้องการรับ GUID สำหรับ ID ผู้เช่า ให้ทำตามขั้นตอนเหล่านี้:

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

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

3. เลือกแอป Azure AD ที่คุณอยู่เพื่อฝังเนื้อหา Power BI ของคุณ

4. จากส่วน ภาพรวม ให้คัดลอก GUID สำหรับ ID ของ Directory (ผู้เช่า)

ชื่อผู้ใช้และรหัสผ่าน Power BI

รับ ชื่อผู้ใช้ และ รหัสผ่าน ของผู้ใช้ Power BI ที่คุณใช้เป็น ผู้ใช้หลัก ของคุณ ซึ่งเป็นผู้ใช้เดียวกับที่คุณใช้ในการสร้างพื้นที่ทำงานและอัปโหลดรายงานในบริการ Power BI

ขั้นตอนที่ 6 - สิทธิ์การเข้าถึง API ของโครงร่างสำคัญของบริการ

เพื่อให้แอป Azure AD สามารถเข้าถึงเนื้อหา Power BI และ API ได้ ผู้ดูแลระบบ Power BI จำเป็นต้องเปิดใช้งานการเข้าถึงบริการหลักในพอร์ทัลผู้ดูแลระบบของ Power BI หากคุณไม่ใช่ผู้ดูแลระบบของผู้เช่าของคุณ ให้แจ้งผู้ดูแลระบบของผู้เช่าเพื่อเปิดใช้งาน การตั้งค่าผู้เช่า ให้กับคุณ

1. ใน บริการ Power BI ให้เลือก การตั้งค่า > การตั้งค่า > พอร์ทัลผู้ดูแลระบบ

   

2. เลือก การตั้งค่าผู้เช่า จากนั้นเลื่อนลงไปที่ส่วน การตั้งค่าสำหรับนักพัฒนาซอฟต์แวร์

3. ขยาย อนุญาตให้โครงร่างสำคัญของบริการใช้ Power BI APIs และเปิดใช้งานตัวเลือกนี้

   

ขั้นตอนที่ 7 - เปิดใช้งานการเข้าถึงพื้นที่ทำงาน

หากต้องการเปิดใช้งานการเข้าถึงแอป Azure AD ของคุณ เช่น รายงาน แดชบอร์ด และชุดข้อมูลในบริการ Power BI ให้เพิ่ม โครงร่างสำคัญของบริการ หรือ ผู้ใช้หลัก ในฐานะที่เป็น สมาชิก หรือ ผู้ดูแลระบบ ในพื้นที่ทำงานของคุณ

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

2. เลื่อนไปยังพื้นที่ทำงานที่คุณต้องการเปิดใช้งานการเข้าถึง และจากเมนู เพิ่มเติม เลือก การเข้าถึงพื้นที่ทำงาน

   

3. ในบานหน้าต่าง การเข้าถึง ซึ่งขึ้นอยู่กับวิธีการรับรองความถูกต้องที่คุณใช้ ให้คัดลอก โครงร่างสำคัญของบริการ หรือ ผู้ใช้หลัก ไปยังกล่องข้อความ ป้อนที่อยู่อีเมล

   หมายเหตุ

   ถ้าคุณกำลังใช้ โครงร่างสำคัญของบริการ ชื่อนี้เป็นชื่อที่คุณตั้งให้แอป Azure AD ของคุณ

4. เลือก เพิ่ม

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

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

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

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

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

   

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

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

   • .NET Core
   • เฟรมเวอร์ค .NET
   • Java
   • Node JS
   • Python

   หมายเหตุ

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

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

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

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

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

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