Zdieľať cez


Kurz: Automatizácia konfigurácie inštalácie aplikácie šablóny pomocou funkcie Azure

Aplikácie šablón sú skvelým spôsobom, ako môžu zákazníci začať získavať prehľady z údajov. Vďaka nim sa budú môcť rýchlo zapojiť do prevádzky tak, že ich pripojíte k údajom. Aplikácie šablón poskytujú zákazníkom vopred vytvorené zostavy, ktoré si môžu prispôsobiť podľa svojich požiadaviek.

Zákazníci nie sú vždy oboznámení s podrobnosťami o tom, ako sa pripojiť k svojim údajom. Pri inštalácii aplikácie šablóny je nutné zadať tieto podrobnosti, čo môže byť pre nich problémové.

Ak ste poskytovateľom údajových služieb a vytvorili ste aplikáciu šablóny, ktorá má pomôcť vašim zákazníkom začať pracovať s ich údajmi vo vašej službe, môžete im uľahčiť inštaláciu aplikácie šablóny. Môžete automatizovať konfiguráciu parametrov svojej aplikácie šablóny.

Keď sa zákazník prihlási na váš portál, vyberie špeciálne prepojenie, ktoré ste pripravili. Toto prepojenie:

  • Spustí automatizáciu, ktorá zhromažďuje potrebné informácie.
  • Vopred nakonfiguruje parametre aplikácie šablóny.
  • Presmeruje zákazníka na konto Power BI, kde môže aplikáciu nainštalovať.

Stačí vybrať možnosť Inštalovať a overiť zdroj údajov. To je všetko.

Toto prostredie pre zákazníkov je znázornené nižšie.

Illustration of user experience with an auto-installation application.

V tomto kurze budete používať ukážku služby Azure Functions s automatizovanou inštaláciou, ktorú sme vytvorili, aby ste mohli vopred konfigurovať a inštalovať svoju aplikáciu šablóny. Táto ukážka je na účely demonštrácie zámerne jednoduchá. Zapuzdruje nastavenie funkcie Azure, aby sa použili rozhranie API služby Power BI na automatickú inštaláciu a konfiguráciu aplikácie šablóny pre používateľov.

Ďalšie informácie o všeobecnom postupe automatizácie a rozhraniach API, ktoré aplikácia používa, nájdete v téme Automatizácia konfigurácie inštalácie aplikácie šablóny.

Naša jednoduchá aplikácia používa funkciu Azure. Ďalšie informácie o službe Azure Functions nájdete v dokumentácii k službe Azure Functions.

Základný postup

Nasledujúci základný postup ukazuje, čo aplikácia urobí, keď ju zákazník spustí výberom prepojenia na portáli.

  1. Používateľ sa prihlási na portál nezávislého dodávateľa softvéru a vyberie poskytnuté prepojenie. Týmto krokom sa spustí postup. V tejto fáze portál nezávislého dodávateľa softvéru pripraví konfiguráciu pre konkrétneho používateľa.

  2. Nezávislý dodávateľ softvéru získa token len na úrovni aplikácie založený na objekte služby (token len na úrovni aplikácie), ktorý je zaregistrovaný v nájomníkovi nezávislého dodávateľa softvéru.

  3. Nezávislý dodávateľ softvéru vytvorí pomocou rozhraní REST API služby Power BI žiadosti o inštaláciu, ktorá obsahuje konfiguráciu parametrov pripravenú nezávislým dodávateľom softvéru pre konkrétneho používateľa.

  4. Nezávislý dodávateľ softvéru presmeruje používateľa do služby Power BI pomocou POST metódy presmerovania, ktorá obsahuje žiadosti o inštaláciu.

  5. Používateľ je presmerovaný do svojho konta Power BI so žiadosti o inštaláciu. Zobrazí sa výzva na inštaláciu aplikácie šablóny. Keď používateľ vyberie možnosť Inštalovať, aplikácia šablóny sa im nainštaluje.

Poznámka

Hoci sú hodnoty parametrov pri vytváraní žiadosti o inštaláciu nakonfigurované nezávislým dodávateľom softvéru, prihlasovacie údaje týkajúce sa zdroja údajov poskytuje používateľ až v záverečných fázach inštalácie. Vďaka tomu sa zabráni ich vystaveniu tretej strane, čím sa zaistí zabezpečené prepojenie medzi používateľom a zdrojmi údajov aplikácie šablóny.

Predpoklady

Nastavenie vývojové prostredie pre automatizáciu aplikácií šablón

Skôr ako budete pokračovať v nastavovaní aplikácie, postupujte podľa pokynov v téme Rýchly začiatok: Vytvorenie aplikácie riešenia Azure Functions pomocou služby Azure App Configuration na vývoj funkcie Azure spolu so službou Azure App Configuration. Vytvorte konfiguráciu aplikácie tak, ako je popísané v článku.

Registrácia aplikácie na lokalite Microsoft Entra ID

Vytvorte objekt služby, ako je to popísané v téme Vloženie obsahu služby Power BI pomocou objektu služby a tajného kódu aplikácie.

Aplikáciu zaregistrujte ako webovú aplikáciu na strane servera. Registrujete webovú aplikáciu na strane servera, čím vytvoríte tajný kód aplikácie.

Uložte si ID aplikácie (ClientID) a tajný kód aplikácie (ClientSecret), ktoré použijete v nasledujúcich krokoch.

Ak chcete rýchlo začať vytvárať registráciu aplikácie, môžete použiť nástroj na nastavenie prostredia na vkladanie. Ak používate nástroj na registráciu aplikácie v službe Power BI, vyberte možnosť Vložiť pre vašich zákazníkov.

Pridajte objekt služby do pracovného priestoru aplikácie šablóny ako Spravovanie, aby ste mohli otestovať pracovný postup automatizácie.

Príprava aplikácie šablóny

Po vytvorení aplikácie šablóny a jej príprave na inštaláciu uložte nasledujúce informácie, ktoré vykonáte v ďalších krokoch:

  • ID aplikácie, kľúč balíka a ID vlastníka v zobrazení v inštalačnej URL adrese na konci procesu definovania vlastností aplikácie šablóny po vytvorení aplikácie.

    Rovnaké prepojenie môžete získať aj výberom položky Získať prepojenie na table Spravovanie vydania aplikácie šablóny.

  • Názvy parametrov definované v sémantickom modeli aplikácie šablóny. Názvy parametrov sú reťazce rozlišujú veľké a malé písmená. Možno ich načítať aj z karty Parameter Nastavenia pri definovaní vlastností aplikácie šablóny alebo zo sémantických nastavení modelu v službe Power BI.

Poznámka

Ak je aplikácia šablóny pripravená na inštaláciu, môžete v nej otestovať svoju aplikáciu s vopred nakonfigurovanou inštaláciou, aj keď ešte nie je k dispozícii v službe AppSource. Ak chcete, aby aj používatelia mimo vášho nájomníka mohli používať automatizovanú inštalačnú aplikáciu na inštaláciu aplikácie šablóny, musí byť aplikácia šablóny verejne dostupná na lokalite Power BI Apps Marketplace. Pred distribúciou aplikácie šablóny pomocou vytváranej automatizovanej inštalačnej aplikácie ju nezabudnite publikovať v Centre pre partnerov.

Inštalácia a konfigurácia aplikácie šablóny

V tejto časti budete používať ukážku služby Azure Functions s automatizovanou inštaláciou, ktorú sme vytvorili, aby ste mohli vopred konfigurovať a inštalovať svoju aplikáciu šablóny. Táto ukážka je na účely demonštrácie zámerne jednoduchá. Umožňuje použiť funkciu Azure a službu Azure App Configuration na jednoduché nasadenie a použitie automatizovaného inštalačného rozhrania API pre aplikácie šablón.

Stiahnutie Visual Studia (verzia 2017 alebo novšia)

Stiahnite si Visual Studio (verzia 2017 alebo novšia). Uistite sa, že si stiahnete najnovší balík NuGet.

Stiahnutie ukážky služby Azure Functions s automatizovanou inštaláciou

Stiahnite si ukážku služby Azure Functions s automatizovanou inštaláciou zo služby GitHub a môžete začať.

Screenshot that shows the automated installation Azure Functions sample.

Nastavenie služby Azure App Configuration

Ak chcete spustiť túto ukážku, musíte nastaviť azure app configuration pomocou hodnôt a kľúčov opísaných v tomto článku. Kľúčmi sú ID aplikácie, tajný kód aplikácie a hodnoty AppId, PackageKey a OwnerId aplikácie šablóny. Informácie o tom, ako tieto hodnoty získate, nájdete v nasledujúcich častiach.

Kľúče sú tiež definované v súbore Constants.cs .

Konfiguračný kľúč Zmysle
TemplateAppInstall:Application:AppId AppId z inštalačnej URL adresy
TemplateAppInstall:Application:PackageKey PackageKey z inštalačnej URL adresy
TemplateAppInstall:Application:OwnerId OwnerId z inštalačnej URL adresy
TemplateAppInstall:ServicePrincipal:ClientId ID aplikácie objektu služby
TemplateAppInstall:ServicePrincipal:ClientSecret Tajný kód aplikácie objektu služby

Súbor Constants.cs sa zobrazí tu.

Screenshot that shows the Constant.cs file.

Získanie vlastností aplikácie šablóny

Vyplňte všetky relevantné vlastnosti aplikácie šablóny tak, ako sú definované pri vytvorení aplikácie. Tieto vlastnosti sú hodnoty AppId, PackageKey a OwnerId aplikácie šablóny.

Ak chcete získať predchádzajúce hodnoty, postupujte podľa týchto krokov:

  1. Prihláste sa do služby Power BI.

  2. Prejdite do pôvodného pracovného priestoru aplikácie.

  3. Otvorte tablu Spravovanie vydania.

    Screenshot that shows the Release Management pane.

  4. Vyberte verziu aplikácie a získajte prepojenie na inštaláciu.

    Screenshot that shows the Release Management button.

  5. Skopírujte prepojenie do Schránky.

    Screenshot that shows the Get link button.

  6. Táto inštalačná URL adresa obsahuje tri parametre URL adresy, ktorých hodnoty potrebujete. Použite hodnoty appId, packageKey a ownerId pre aplikáciu. Vzorová URL adresa bude podobná tej, ktorá je zobrazená tu.

    https://app.powerbi.com/Redirect?action=InstallApp&appId=3c386...16bf71c67&packageKey=b2df4b...dLpHIUnum2pr6k&ownerId=72f9...1db47&buildVersion=5
    

Získanie ID aplikácie

Do poľa applicationId zadajte ID aplikácie zo služby Azure. Hodnotu applicationId používa aplikácia na to, aby sa identifikovala používateľom, od ktorých požaduje povolenia.

Ak chcete získať ID aplikácie, postupujte podľa týchto krokov:

  1. Prihláste sa do portálu Azurel.

  2. Na ľavej table vyberte položky Všetky služby>Registrácie aplikácií.

    Screenshot that shows app registrations search.

  3. Vyberte aplikáciu, ktorá vyžaduje ID aplikácie.

    Screenshot that shows choosing an app.

  4. ID aplikácie je uvedené ako identifikátor GUID. Toto ID aplikácie použite ako hodnotu applicationId v aplikácii.

    Screenshot that shows the applicationId value.

Získajte tajný kód aplikácie

Vyplňte údaj ApplicationSecret údajom z časti Kľúče, ktorú nájdete v časti Registračné formuláre aplikácie v službe Azure. Tento atribút funguje pri používaní objektu služby.

Ak chcete získať tajný kód aplikácie, postupujte podľa týchto krokov:

  1. Prihláste sa do portálu Azurel.

  2. Na ľavej table vyberte položky Všetky služby>Registrácie aplikácií.

    Screenshot that shows App registration search.

  3. Vyberte aplikáciu, ktorá musí použiť tajný kód aplikácie.

    Screenshot shows choosing an app.

  4. V časti Spravovať vyberte položku Certifikáty a tajomstvá.

  5. Vyberte položku Nové klientske tajomstvá.

  6. Zadajte názov do poľa Popis a vyberte trvanie. Potom výberom položky Uložiť získate hodnotu pre aplikáciu. Po uložení hodnoty kľúča a zatvorení tably Kľúče sa pole Hodnota zobrazuje len ako skryté. Od tohto bodu už nie je možné načítať hodnotu kľúča. Ak stratíte hodnotu kľúča, vytvorte si na portáli Azure nový.

    Screenshot that shows the key value.

Lokálne testovanie funkcie

Spustite funkciu podľa krokov popísaných v časti Lokálne spustenie funkcie.

Nakonfigurujte portál tak, aby vydával POST požiadavku na URL adresu funkcie. Príkladom je adresa POST http://localhost:7071/api/install. Text požiadavky by mal byť objekt JSON, ktorý popisuje páry kľúč-hodnota. Kľúče sú názvy parametrov, ako je definované v aplikácii Power BI Desktop. Hodnoty sú požadované hodnoty, ktoré majú byť nastavené pre každý parameter v aplikácii šablóny.

Poznámka

V produkčnom prostredí sú hodnoty parametrov odvodené pre každého používateľa podľa zamýšľanej logiky portálu.

Požadovaný postup by mal byť nasledujúci:

  1. Portál pripraví požiadavku pre každého používateľa alebo každú reláciu.
  2. Do POST /api/install funkcie Azure sa vydá požiadavka. Text požiadavky sa skladá z párov kľúča a hodnoty. Kľúč je názov parametra. Hodnota je požadovaná hodnota, ktorá má byť nastavená.
  3. Ak je všetko správne nakonfigurované, prehliadač by sa mal automaticky presmerovať na konto Power BI zákazníka a zobraziť postup automatizovanej inštalácie.
  4. Počas inštalácie sú hodnoty parametrov nastavené podľa konfigurácie v krokoch 1 a 2.

Publikovanie projektu v službe Azure

Ak chcete projekt publikovať v službe Azure, postupujte podľa pokynov v dokumentácii k službe Azure Functions. Potom môžete do produktu integrovať rozhrania API aplikácie šablóny s automatizovanou inštaláciou a začať testovať v produkčných prostrediach.