บทช่วยสอน: ทําให้การกําหนดค่าการติดตั้งแอปเทมเพลตเป็นแบบอัตโนมัติโดยใช้ Azure Function

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

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

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

เมื่อลูกค้าลงชื่อเข้าใช้พอร์ทัลของคุณ พวกเขาจะเลือกลิงก์พิเศษที่คุณเตรียมไว้ ลิงก์นี้:

• เปิดใช้การทํางานโดยอัตโนมัติ ซึ่งรวบรวมข้อมูลที่ต้องการ
• กําหนดค่าพารามิเตอร์แอปเทมเพลตล่วงหน้า
• เปลี่ยนเส้นทางลูกค้าไปยังบัญชี Power BI ของพวกเขาซึ่งพวกเขาสามารถติดตั้งแอปได้

สิ่งที่พวกเขาต้องทําคือเลือก ติดตั้ง และรับรองความถูกต้องเทียบกับแหล่งข้อมูลของพวกเขา และพวกเขาก็พร้อมแล้ว!

ประสบการณ์ของลูกค้าแสดงเป็นภาพประกอบไว้ที่นี่

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

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

แอปพลิเคชันแบบง่ายของเราใช้ Azure Function สําหรับข้อมูลเพิ่มเติมเกี่ยวกับ Azure Function โปรดดูที่เอกสารเกี่ยวกับ Azure Functions

โฟลว์พื้นฐาน

ขั้นตอนพื้นฐานต่อไปนี้แสดงสิ่งที่แอปพลิเคชันทําเมื่อลูกค้าเปิดใช้งานโดยการเลือกลิงก์ในพอร์ทัลของคุณ

1. ผู้ใช้ลงชื่อเข้าใช้พอร์ทัลของ ISV และเลือกลิงก์ที่ให้มา การดําเนินการนี้จะเริ่มใช้โฟลว์ พอร์ทัลของ ISV เตรียมการกําหนดค่าเฉพาะของผู้ใช้ในลําดับขั้นนี้

2. ISV ได้รับโทเค็น เฉพาะแอป ตาม องค์ประกอบหลักของบริการ (โทเค็นเฉพาะแอป) ที่ลงทะเบียนในผู้เช่าของ ISV

3. ด้วยการใช้ Power BI REST API ISV จะสร้าง ตั๋วการติดตั้งซึ่งมีการกําหนดค่าพารามิเตอร์เฉพาะของผู้ใช้ตามที่ ISV เตรียมไว้

4. ISV เปลี่ยนเส้นทางผู้ใช้ไปยัง Power BI โดยใช้ POST วิธีการเปลี่ยนเส้นทางซึ่งมีตั๋วการติดตั้ง

5. ผู้ใช้จะถูกเปลี่ยนเส้นทางไปยังบัญชี Power BI ของพวกเขาด้วยตั๋วการติดตั้งและได้รับพร้อมท์แจ้งให้ติดตั้งแอปเทมเพลต เมื่อผู้ใช้เลือก ติดตั้ง แอปเทมเพลตจะถูกติดตั้งสําหรับพวกเขา

หมายเหตุ

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

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

• การตั้งค่าผู้เช่า Microsoft Entra ของคุณเอง สําหรับคําแนะนําเกี่ยวกับวิธีการตั้งค่า โปรดดูสร้างผู้เช่า Microsoft Entra
• องค์ประกอบหลักของบริการ (โทเค็นเฉพาะแอป) ที่ลงทะเบียนในผู้เช่าก่อนหน้า
• แอปเทมเพลตที่กําหนดพารามิเตอร์ที่พร้อมสําหรับการติดตั้ง ต้องสร้างแอปเทมเพลตในผู้เช่าเดียวกันกับที่คุณลงทะเบียนแอปพลิเคชันของคุณในรหัส Microsoft Entra สําหรับข้อมูลเพิ่มเติม ดูเคล็ดลับสําหรับการเขียนแอปแม่แบบ หรือ สร้างแอปแม่แบบใน Power BI
• เมื่อต้องการทดสอบโฟลว์งานอัตโนมัติของคุณ ให้เพิ่มบริการหลักไปยังพื้นที่ทํางานของแอปเทมเพลตในฐานะผู้ดูแลระบบ
• สิทธิ์การใช้งาน Power BI Pro หากคุณยังไม่ได้ลงทะเบียน Power BI Pro ให้ ลงทะเบียนรุ่นทดลองใช้ฟรี ก่อนที่คุณจะเริ่มต้น

ตั้งค่าสภาพแวดล้อมการพัฒนาอัตโนมัติของแอปเทมเพลตของคุณ

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

การลงทะเบียนแอพลิเคชันเป็น Microsoft Entra รหัส

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

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

บันทึก ID แอปพลิเคชัน (ID ไคลเอ็นต์) และข้อมูล ลับของแอปพลิเคชัน (ข้อมูลลับของไคลเอ็นต์) สําหรับขั้นตอนต่อไป

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

การเตรียมแอปเทมเพลต

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

• App ID, Package Key และ Owner ID ตามที่ปรากฏใน URL การติดตั้งในตอนท้ายของกระบวนการ กําหนดคุณสมบัติของแอปเทมเพลต เมื่อสร้างแอปขึ้นแล้ว

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

• ชื่อพารามิเตอร์ ตามที่กําหนดไว้ในแบบจําลองความหมายของแอปเทมเพลต ชื่อพารามิเตอร์เป็นสตริงที่ไวต่ออักษรใหญ่-เล็ก นอกจากนี้ยังสามารถเรียกใช้ได้จากแท็บ การตั้งค่าพารามิเตอร์ เมื่อคุณ กําหนดคุณสมบัติของแอปเทมเพลต หรือจากการตั้งค่าแบบจําลองความหมายใน Power BI

หมายเหตุ

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

ติดตั้งและกําหนดค่าแอปเทมเพลตของคุณ

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

ดาวน์โหลด Visual Studio (เวอร์ชัน 2017 หรือใหม่กว่า)

ดาวน์โหลด Visual Studio (เวอร์ชัน 2017 หรือใหม่กว่า) ตรวจสอบให้แน่ใจว่าได้ดาวน์โหลด แพคเกจ NuGet ล่าสุด

ดาวน์โหลดตัวอย่างฟังก์ชัน Azure สําหรับการติดตั้งอัตโนมัติ

ดาวน์โหลด ตัวอย่างฟังก์ชัน Azure สําหรับการติดตั้งอัตโนมัติ จาก GitHub เพื่อเริ่มต้นใช้งาน

ตั้งค่าการกําหนดค่าแอป Azure ของคุณ

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

นอกจากนี้ยังมีการกําหนดคีย์ในไฟล์ Constants.cs ด้วย

คีย์การกําหนดค่า	ความหมาย
TemplateAppInstall:Application:AppId	appId จาก URL การติดตั้ง
TemplateAppInstall:แอปพลิเคชัน:PackageKey	packageKey จาก URL การติดตั้ง
TemplateAppInstall:Application:OwnerId	ownerId จาก URL การติดตั้ง
TemplateAppInstall:ServicePrincipal:ClientId	ID แอปพลิเคชันสําหรับองค์ประกอบหลักของบริการ
TemplateAppInstall:ServicePrincipal:ClientSecret	ข้อมูลลับของแอปพลิเคชันสําหรับองค์ประกอบหลักของบริการ

ไฟล์ Constants.cs จะแสดงที่นี่

รับคุณสมบัติแอปเทมเพลต

กรอกคุณสมบัติของแอปเทมเพลตที่เกี่ยวข้องทั้งหมดตามที่กําหนดไว้เมื่อสร้างแอป คุณสมบัติเหล่านี้คือ appId, packageKey และ ownerId ของแอปเทมเพลต

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

1. ลงชื่อเข้าใช้ Power BI

2. ไปยังพื้นที่ทํางานเดิมของแอปพลิเคชัน

3. เปิดบานหน้าต่างการจัดการวางจําหน่าย

   

4. เลือกเวอร์ชันแอปและรับลิงก์การติดตั้ง

   

5. คัดลอกลิงก์ไปยังคลิปบอร์ด

   

6. URL การติดตั้งนี้จะเก็บพารามิเตอร์ URL สามค่าที่คุณต้องการ ใช้ค่า appId, packageKey และ ownerId สําหรับแอปพลิเคชัน URL ตัวอย่างจะคล้ายกับที่แสดงที่นี่

   https://app.powerbi.com/Redirect?action=InstallApp&appId=66667...9cccc0000&packageKey=b2df4b...dLpHIUnum2pr6k&ownerId=aaaa...22222&buildVersion=5
   

รับ ID แอปพลิเคชัน

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

หากต้องการรับ ID แอปพลิเคชัน ให้ทําตามขั้นตอนเหล่านี้:

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

2. จากเมนูพอร์ทัล เลือกบริการทั้งหมด

3. บนหน้า บริการทั้งหมด ในส่วน ข้อมูลประจําตัว ให้เลือก >การลงทะเบียนแอป

4. เลือกแอปพลิเคชันที่ต้องใช้ ID แอปพลิเคชัน

   

5. มี ID แอปพลิเคชันที่แสดงในรูปของ GUID ใช้ ID แอปพลิเคชันนี้เป็นค่า applicationId สําหรับแอปพลิเคชัน

   

รับข้อมูลลับของแอปพลิเคชัน

กรอกข้อมูล ApplicationSecret จากส่วน คีย์ ของส่วน การลงทะเบียนแอป ของคุณใน Azure แอตทริบิวต์นี้ทํางานเมื่อคุณใช้บริการหลัก

สําหรับวิธีรับข้อมูลลับของแอปพลิเคชัน ให้ทําตามขั้นตอนเหล่านี้:

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

2. จากเมนูพอร์ทัล เลือกบริการทั้งหมด

3. บนหน้า บริการทั้งหมด ในส่วน ข้อมูลประจําตัว ให้เลือก >การลงทะเบียนแอป

   

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

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

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

ทดสอบฟังก์ชันของคุณภายในเครื่อง

ทําตามขั้นตอนตามที่อธิบายไว้ใน เรียกใช้ฟังก์ชันภายในเครื่อง เพื่อเรียกใช้ฟังก์ชันของคุณ

กําหนดค่าพอร์ทัลของคุณเพื่อส่ง POST คําขอ ไปยัง URL ของฟังก์ชัน ตัวอย่างคือ POST http://localhost:7071/api/install เนื้อความคําขอควรเป็นออบเจ็กต์ JSON ที่อธิบายถึงคู่ค่าคีย์ คีย์คือ ชื่อพารามิเตอร์ ตามที่กําหนดไว้ใน Power BI Desktop ค่าคือค่าที่ต้องการตั้งสําหรับแต่ละพารามิเตอร์ในแอปเทมเพลต

หมายเหตุ

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

โฟลว์ที่ต้องการควรเป็น:

1. พอร์ทัลจัดเตรียมคําขอ ต่อผู้ใช้หรือเซสชัน
2. POST /api/installมีการส่งคําขอ ไปยังฟังก์ชัน Azure ของคุณ เนื้อความคําขอประกอบด้วยคู่ค่าคีย์ คีย์คือชื่อพารามิเตอร์ ค่านี้คือค่าที่ต้องการตั้ง
3. หากกําหนดค่าทั้งหมดอย่างถูกต้องแล้ว เบราว์เซอร์ควรเปลี่ยนเส้นทางไปยังบัญชี Power BI ของลูกค้าโดยอัตโนมัติและแสดงโฟลว์การติดตั้งแบบอัตโนมัติ
4. เมื่อติดตั้งแล้ว ค่าพารามิเตอร์จะถูกตั้งค่าตามที่กําหนดไว้ในขั้นตอนที่ 1 และ 2

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

เผยแพร่โครงการของคุณไปยัง Azure

หากต้องการเผยแพร่โครงการของคุณไปยัง Azure ให้ทําตามคําแนะนําในเอกสารของฟังก์ชัน Azure จากนั้นคุณสามารถรวม API การติดตั้งอัตโนมัติของแอปเทมเพลตเข้ากับผลิตภัณฑ์ของคุณและเริ่มทดสอบในสภาพแวดล้อมการผลิต