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

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

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

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

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

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

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

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

โฟลว์พื้นฐานสําหรับการกําหนดค่าอัตโนมัติ

โฟลว์พื้นฐานสําหรับการกําหนดค่าการติดตั้งแอปเทมเพลตโดยอัตโนมัติจะดําเนินการดังนี้:

1. ผู้ใช้ลงชื่อเข้าใช้พอร์ทัลของ ISV และเลือกลิงก์ที่ให้มา การดําเนินการนี้จะเริ่มต้นโฟลว์อัตโนมัติ พอร์ทัลของ ISV เตรียมการกําหนดค่าเฉพาะผู้ใช้ในขั้นตอนนี้
2. ISV ได้รับโทเค็น เฉพาะแอป ตาม บริการหลัก (โทเค็นเฉพาะแอป) ที่ลงทะเบียนในผู้เช่าของ ISV
3. การใช้ Power BI REST API ISV จะสร้าง ตั๋วการติดตั้ง ซึ่งประกอบด้วยการกําหนดค่าพารามิเตอร์เฉพาะผู้ใช้ตามที่จัดทําโดย ISV
4. ISV เปลี่ยนเส้นทางผู้ใช้ไปยัง Power BI โดยใช้ POST วิธีการเปลี่ยนเส้นทางที่มีตั๋วการติดตั้ง
5. ผู้ใช้จะถูกเปลี่ยนเส้นทางไปยังบัญชี Power BI ของตนด้วยตั๋วการติดตั้ง และได้รับพร้อมท์ให้ติดตั้งแอปเทมเพลต เมื่อผู้ใช้เลือก ติดตั้ง แอปเทมเพลตจะถูกติดตั้งให้

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

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

• สิทธิ์การใช้งาน Power BI Pro ถ้าคุณไม่ได้ลงทะเบียนสําหรับ Power BI Pro ให้ ลงทะเบียนเพื่อทดลองใช้ฟรี ก่อนที่คุณจะเริ่มต้น

• การตั้งค่าผู้เช่า Microsoft Entra ของคุณเอง สําหรับคําแนะนําเกี่ยวกับวิธีการตั้งค่า โปรดดู สร้างผู้เช่า Microsoft Entra

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

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

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

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

  Note

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

ขั้นตอนหลักและ API

ขั้นตอนหลักสําหรับการกําหนดค่าการติดตั้งแอปเทมเพลตโดยอัตโนมัติ และ API ที่คุณต้องการ ได้อธิบายไว้ในส่วนต่อไปนี้ แม้ว่าขั้นตอนส่วนใหญ่จะทําด้วย Power BI REST API ตัวอย่างโค้ดที่อธิบายไว้ที่นี่จะสร้างขึ้นด้วย .NET SDK

ขั้นตอนที่ 1: สร้างออบเจ็กต์ไคลเอ็นต์ Power BI

การใช้ Power BI REST API กําหนดให้คุณต้องได้รับ โทเค็นการเข้าถึง สําหรับ บริการหลัก ของคุณจาก Microsoft Entra ID คุณต้องได้รับโทเค็นการเข้าถึง Microsoft Entra สําหรับแอปพลิเคชัน Power BI ของคุณก่อนที่คุณจะทําการเรียกใช้ Power BI REST API เมื่อต้องการสร้างไคลเอ็นต์ Power BI ด้วยโทเค็นการเข้าถึงของคุณ คุณจําเป็นต้องสร้างออบเจ็กต์ไคลเอ็นต์ Power BI ของคุณ ซึ่งช่วยให้คุณสามารถโต้ตอบกับ Power BI REST API ได้ คุณสร้างวัตถุไคลเอ็นต์ Power BI โดยการตัด AccessToken ด้วยวัตถุ Microsoft.Rest.TokenCredentials

using Microsoft.IdentityModel.Clients.ActiveDirectory;
using Microsoft.Rest;
using Microsoft.PowerBI.Api.V2;

var tokenCredentials = new TokenCredentials(authenticationResult.AccessToken, "Bearer");

// Create a Power BI client object. It's used to call Power BI APIs.
using (var client = new PowerBIClient(new Uri(ApiUrl), tokenCredentials))
{
    // Your code goes here.
}

ขั้นตอนที่ 2: สร้างตั๋วติดตั้ง

สร้างตั๋วการติดตั้ง ซึ่งจะใช้เมื่อคุณเปลี่ยนเส้นทางผู้ใช้ของคุณไปยัง Power BI API ที่ใช้สําหรับการดําเนินการนี้คือ CreateInstallTicket API

• แอปเทมเพลต - สร้างตั๋วติดตั้ง

ตัวอย่างวิธีการสร้างตั๋วการติดตั้งสําหรับการติดตั้งและการกําหนดค่าแอปเทมเพลตมีให้จากไฟล์ InstallTemplateApp/InstallAppFunction.cs ในแอปพลิเคชันตัวอย่าง

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้แอปเทมเพลต CreateInstallTicket REST API

using Microsoft.PowerBI.Api.V2;
using Microsoft.PowerBI.Api.V2.Models;

// Create Install Ticket Request.
InstallTicket ticketResponse = null;
var request = new CreateInstallTicketRequest()
{
    InstallDetails = new List<TemplateAppInstallDetails>()
    {
        new TemplateAppInstallDetails()
        {
            AppId = Guid.Parse(AppId),
            PackageKey = PackageKey,
            OwnerTenantId = Guid.Parse(OwnerId),
            Config = new TemplateAppConfigurationRequest()
            {
                Configuration = Parameters
                                    .GroupBy(p => p.Name)
                                    .ToDictionary(k => k.Key, k => k.Select(p => p.Value).Single())
            }
        }
    }
};

// Issue the request to the REST API using .NET SDK.
InstallTicket ticketResponse = await client.TemplateApps.CreateInstallTicketAsync(request);

ขั้นตอนที่ 3: เปลี่ยนเส้นทางผู้ใช้ไปยัง Power BI ด้วยตั๋ว

หลังจากที่คุณได้สร้างตั๋วการติดตั้งแล้ว คุณจะใช้เพื่อเปลี่ยนเส้นทางผู้ใช้ของคุณไปยัง Power BI เพื่อดําเนินการติดตั้งและกําหนดค่าแอปเทมเพลตต่อไป คุณใช้ POST วิธีการเปลี่ยนเส้นทางไปยัง URL การติดตั้งของแอปเทมเพลต โดยมีตั๋วการติดตั้งในเนื้อหาคําขอ

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

ตัวอย่างง่ายๆ ซึ่งส่วนใหญ่ใช้เพื่อวัตถุประสงค์ในการทดสอบ จะใช้แบบฟอร์มที่มีฟิลด์ที่ซ่อนอยู่ ซึ่งจะส่งตัวเองโดยอัตโนมัติเมื่อโหลด

<html>
    <body onload='document.forms["form"].submit()'>
        <!-- form method is POST and action is the app install URL -->
        <form name='form' action='https://app.powerbi.com/....' method='post' enctype='application/json'>
            <!-- value should be the new install ticket -->
            <input type='hidden' name='ticket' value='H4sI....AAA='>
        </form>
    </body>
</html>

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

...
    return new ContentResult() { Content = RedirectWithData(redirectUrl, ticket.Ticket), ContentType = "text/html" };
}

...

public static string RedirectWithData(string url, string ticket)
{
    StringBuilder s = new StringBuilder();
    s.Append("<html>");
    s.AppendFormat("<body onload='document.forms[\"form\"].submit()'>");
    s.AppendFormat("<form name='form' action='{0}' method='post' enctype='application/json'>", url);
    s.AppendFormat("<input type='hidden' name='ticket' value='{0}' />", ticket);
    s.Append("</form></body></html>");
    return s.ToString();
}

ขั้นตอนที่ 4: ย้ายระบบอัตโนมัติของคุณไปยังการผลิต

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

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

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