Εκμάθηση: Αυτοματοποίηση της ρύθμισης παραμέτρων της εγκατάστασης εφαρμογής προτύπου με χρήση μιας λειτουργίας AzureTutorial: Automate configuration of template app installation using an Azure function

Οι εφαρμογές προτύπου είναι ένας πολύ καλός τρόπος για τους πελάτες να ξεκινήσουν να λαμβάνουν δεδομενικές πληροφορίες από τα δεδομένα τους.Template apps are a great way for customers to start getting insights from their data. Οι εφαρμογές προτύπου τους βοηθούν να αρχίζουν γρήγορα τις εργασίες τους παρέχοντας σύνδεση με τα δεδομένα τους.Template apps get them up and running quickly by connecting them to their data. Οι εφαρμογές προτύπου παρέχουν στους πελάτες προενσωματωμένες αναφορές που μπορούν να προσαρμόσουν εάν το επιθυμούν.The template apps provide customers with prebuilt reports that they can customize if they so desire.

Οι πελάτες δεν είναι πάντα εξοικειωμένοι με τις λεπτομέρειες του τρόπου σύνδεσης των δεδομένων σας.Customers aren't always familiar with the details of how to connect to their data. Η παροχή αυτών των λεπτομερειών όταν εγκαθιστούν μια εφαρμογή προτύπου μπορεί να αποτελεί σημείο αιχμής για αυτούς.Having to provide these details when they install a template app can be a pain point for them.

Εάν παρέχετε υπηρεσίες δεδομένων και έχετε δημιουργήσει μια εφαρμογή προτύπου για να βοηθήσει τους πελάτες σας να ξεκινήσουν με τα δεδομένα τους στην υπηρεσία σας, μπορείτε να διευκολύνετε την εγκατάσταση της εφαρμογής προτύπου σας.If you are a data services provider and have created a template app to help your customers get started with their data on your service, you can make it easier for them to install your template app. Μπορείτε να αυτοματοποιήσετε τη ρύθμιση των παραμέτρων της εφαρμογής προτύπου σας.You can automate the configuration of your template app's parameters.

Όταν ο πελάτης εισέρχεται στην πύλη σας, επιλέγει μια ειδική σύνδεση που έχετε προετοιμάσει.When the customer signs in to your portal, they select a special link you've prepared. Αυτή η σύνδεση:This link:

  • Εκκινεί την αυτοματοποίηση, που συγκεντρώνει τις απαραίτητες πληροφορίες.Launches the automation, which gathers the information it needs.
  • Ρυθμίζει τις παραμέτρους εφαρμογής προτύπου εκ των προτέρων.Preconfigures the template app parameters.
  • Ανακατευθύνει τον πελάτη στον λογαριασμό του Power BI όπου μπορεί να εγκαταστήσει την εφαρμογή.Redirects the customer to their Power BI account where they can install the app.

Το μόνο που πρέπει να κάνει είναι να επιλέξει Εγκατάσταση και να εκτελέσει έλεγχο ταυτότητας σε σχέση με την προέλευση δεδομένων του και θα είναι έτοιμος να ξεκινήσει!All they have to do is select Install and authenticate against their data source, and they're good to go!

Εδώ παρουσιάζεται η εμπειρία του πελάτη.The customer experience is illustrated here.

Εικόνα της εμπειρίας χρήστη με μια εφαρμογή αυτόματης εγκατάστασης.

Σε αυτό το εκπαιδευτικό βοήθημα, θα χρησιμοποιήσετε ένα δείγμα της αυτοματοποιημένης εγκατάστασης του Azure Functions που δημιουργήσαμε για να προρυθμίσετε τις παραμέτρους και να εγκαταστήσετε την εφαρμογή προτύπου σας.In this tutorial, you'll use an automated installation Azure Functions sample that we've created to preconfigure and install your template app. Αυτό το δείγμα είναι σκόπιμα απλό για σκοπούς επίδειξης.This sample has deliberately been kept simple for demonstration purposes. Περιλαμβάνει τη ρύθμιση μιας συνάρτησης Azure ώστε να χρησιμοποιεί τα API του Power BI για την εγκατάσταση μιας εφαρμογής προτύπου και τη ρύθμιση των παραμέτρων της για τους χρήστες σας αυτόματα.It encapsulates the setup of an Azure function to use Power BI APIs for installing a template app and configuring it for your users automatically.

Για περισσότερες πληροφορίες σχετικά με τη γενική ροή αυτοματισμού και τα API που χρησιμοποιεί η εφαρμογή, ανατρέξτε στο θέμα Αυτοματοποίηση της ρύθμισης παραμέτρων μιας εγκατάστασης εφαρμογής προτύπου.For more information about the general automation flow and the APIs that the app uses, see Automate configuration of a template app installation.

Η απλή εφαρμογή μας χρησιμοποιεί μια συνάρτηση Azure.Our simple application uses an Azure function. Για περισσότερες πληροφορίες σχετικά με το Azure Functions, ανατρέξτε στην τεκμηρίωση του Azure Functions.For more information about Azure Functions, see the Azure Functions documentation.

Βασική ροήBasic flow

Η ακόλουθη βασική ροή αναφέρει όσα κάνει η εφαρμογή όταν ο πελάτης την εκκινεί επιλέγοντας τη σύνδεση στην πύλη σας.The following basic flow lists what the application does when the customer launches it by selecting the link in your portal.

  1. Ο χρήστης εισέρχεται στην πύλη ISV και επιλέγει την παρεχομένη σύνδεση.The user signs in to the ISV's portal and selects the supplied link. Αυτή η ενέργεια εκκινεί τη ροή.This action initiates the flow. Η πύλη ISV προετοιμάζει τη ρύθμιση παραμέτρων του συγκεκριμένου χρήστη σε αυτό το στάδιο.The ISV's portal prepares the user-specific configuration at this stage.

  2. Ο ISV αποκτά ένα διακριτικό μόνο εφαρμογής που βασίζεται σε μια οντότητα υπηρεσίας (διακριτικό μόνο εφαρμογής), που έχει καταχωρηθεί στον μισθωτή του ISV.The ISV acquires an app-only token based on a service principal (app-only token) that's registered in the ISV's tenant.

  3. Με τη χρήση του Power BI REST API, ο ISV δημιουργεί ένα Δελτίο εγκατάστασης το οποίο περιέχει το σύνολο παραμέτρων για τον συγκεκριμένο χρήστη, όπως εκπονήθηκε από τον ISV.Using Power BI REST APIs, the ISV creates an install ticket, which contains the user-specific parameter configuration as prepared by the ISV.

  4. Ο ISV ανακατευθύνει τον χρήστη στο Power BI χρησιμοποιώντας μια μέθοδο ανακατεύθυνσης POST, η οποία περιέχει το δελτίο εγκατάστασης.The ISV redirects the user to Power BI by using a POST redirection method, which contains the install ticket.

  5. Ο χρήστης ανακατευθύνεται στον λογαριασμό του Power BI με το δελτίο εγκατάστασης και του ζητείται να εγκαταστήσει την εφαρμογή προτύπου.The user is redirected to their Power BI account with the install ticket and is prompted to install the template app. Όταν ο χρήστης επιλέγει Εγκατάσταση, η εφαρμογή προτύπου εγκαθίσταται αυτόματα.When the user selects Install, the template app is installed for them.

Σημείωση

Παρόλο που οι τιμές παραμέτρων ρυθμίζονται από τον ISV κατά τη δημιουργία του δελτίου εγκατάστασης, τα διαπιστευτήρια που σχετίζονται με την προέλευση δεδομένων παρέχονται από τον χρήστη μόνο στα τελικά στάδια της εγκατάστασης.While parameter values are configured by the ISV in the process of creating the install ticket, data source-related credentials are only supplied by the user in the final stages of the installation. Αυτή η διάταξη αποτρέπει την έκθεσή τους σε έναν τρίτο και εξασφαλίζει μια ασφαλή σύνδεση μεταξύ των προελεύσεων δεδομένων εφαρμογής προτύπου και χρήστη.This arrangement prevents them from being exposed to a third party and ensures a secure connection between the user and the template app data sources.

Προαπαιτούμενα στοιχείαPrerequisites

Ρύθμιση του περιβάλλοντος ανάπτυξης αυτοματισμού εφαρμογών προτύπουSet up your template apps automation development environment

Πριν συνεχίσετε τη ρύθμιση της εφαρμογής σας, ακολουθήστε τις οδηγίες στη Γρήγορη εκκίνηση: Δημιουργήστε μια εφαρμογή Azure Functions με τη Ρύθμιση παραμέτρων εφαρμογών του Azure για να αναπτύξετε μια συνάρτηση Azure μαζί με μια ρύθμιση παραμέτρων εφαρμογών του Azure.Before you continue setting up your application, follow the instructions in Quickstart: Create an Azure Functions app with Azure App Configuration to develop an Azure function along with an Azure app configuration. Δημιουργήστε τη ρύθμιση παραμέτρων της εφαρμογής σας όπως περιγράφεται στο άρθρο.Create your app configuration as described in the article.

Καταχώρηση μιας εφαρμογής στο Azure ADRegister an application in Azure AD

Δημιουργήστε μια οντότητα υπηρεσίας όπως περιγράφεται στο θέμα Ενσωμάτωση περιεχομένου Power BI με οντότητα υπηρεσίας και μυστικό κωδικό εφαρμογήςCreate a service principal as described in Embed Power BI content with service principal and an application secret.

Βεβαιωθείτε ότι έχετε καταχωρήσει την εφαρμογή ως Εφαρμογή Web από την πλευρά του διακομιστή.Make sure to register the application as a server-side web application app. Μπορείτε να καταχωρήσετε μια εφαρμογή Web από την πλευρά του διακομιστή για να δημιουργήσετε έναν μυστικό κωδικό εφαρμογής.You register a server-side web application to create an application secret.

Αποθηκεύστε το αναγνωριστικό εφαρμογής (Αναγνωριστικό προγράμματος-πελάτη) και τον μυστικό κωδικό εφαρμογής (μυστικός κωδικός πελάτη) για τα επόμενα βήματα.Save the application ID (ClientID) and application secret (ClientSecret) for later steps.

Μπορείτε να χρησιμοποιήσετε το Εργαλείο ρύθμισης ενσωμάτωσης για να ξεκινήσετε γρήγορα τη δημιουργία μιας καταχώρησης εφαρμογής.You can go through the Embedding setup tool to quickly get started creating an app registration. Εάν χρησιμοποιείτε το Εργαλείο καταχώρησης εφαρμογής Power BI, επιλέξτε την επιλογή Ενσωμάτωση για τους πελάτες σας.If you're using the Power BI App Registration Tool, select the Embed for your customers option.

Προσθέστε την αρχή υπηρεσίας στο χώρο εργασίας του προτύπου app ως διαχειριστής, έτσι ώστε να μπορείτε να δοκιμάσετε τη ροή εργασίας αυτοματισμού.Add the service principal to the template app workspace as an Admin, so that you will be able to test your automation work flow.

Προετοιμασία εφαρμογής προτύπουTemplate app preparation

Αφού δημιουργήσετε την εφαρμογή προτύπου και είναι έτοιμη για εγκατάσταση, αποθηκεύστε τις παρακάτω πληροφορίες για τα επόμενα βήματα:After you've created your template app and it's ready for installation, save the following information for the next steps:

  • το Αναγνωριστικό εφαρμογής, το Κλειδί πακέτου και το Αναγνωριστικό κατόχου, όπως εμφανίζονται στη διεύθυνση URL εγκατάστασης στο τέλος της διεργασίας Ορισμός των ιδιοτήτων της εφαρμογής προτύπου όταν δημιουργηθεί η εφαρμογή.App ID, Package Key, and Owner ID as they appear in the installation URL at the end of the Define the properties of the template app process when the app was created.

    Μπορείτε επίσης να λάβετε την ίδια σύνδεση, επιλέγοντας το στοιχείο Λήψη σύνδεσης στο παράθυρο Διαχείριση εκδόσεων της εφαρμογής προτύπου.You can also get the same link by selecting Get link in the template app's Release Management pane.

  • Τα Ονόματα παραμέτρων όπως ορίζονται στο σύνολο δεδομένων της εφαρμογής προτύπου.Parameter names as they're defined in the template app's dataset. Τα ονόματα παραμέτρων είναι συμβολοσειρές με διάκριση πεζών-κεφαλαίων.Parameter names are case-sensitive strings. Μπορούν επίσης να ανακτηθούν από την καρτέλα Ρυθμίσεις παραμέτρων όταν καθορίσετε τις ιδιότητες της εφαρμογής προτύπου ή από τις ρυθμίσεις συνόλου δεδομένων στο Power BI.They can also be retrieved from the Parameter Settings tab when you define the properties of the template app or from the dataset settings in Power BI.

Σημείωση

Μπορείτε να ελέγξετε την προρυθμισμένη εφαρμογή εγκατάστασης στην εφαρμογή προτύπου σας, εάν η εφαρμογή προτύπου είναι έτοιμη για εγκατάσταση, ακόμα και αν δεν είναι διαθέσιμη για το κοινό στο AppSource.You can test your preconfigured installation application on your template app if the template app is ready for installation, even if it isn't publicly available on AppSource yet. Για να μπορούν οι χρήστες εκτός του μισθωτή σας να χρησιμοποιήσουν την αυτοματοποιημένη εφαρμογή εγκατάστασης για να εγκαταστήσουν την εφαρμογή του προτύπου σας, η εφαρμογή προτύπου πρέπει να είναι δημόσια διαθέσιμη στο Power BI Apps marketplace.For users outside your tenant to be able to use the automated installation application to install your template app, the template app must be publicly available in the Power BI apps marketplace. Προτού διανείμετε τη δική σας εφαρμογή προτύπου χρησιμοποιώντας την εφαρμογή αυτοματοποιημένης εγκατάστασης που δημιουργείτε, φροντίστε να τη δημοσιεύσετε στο Κέντρο συνεργατών.Before you distribute your template app by using the automated installation application you're creating, be sure to publish it to Partner Center.

Εγκατάσταση και ρύθμιση παραμέτρων της εφαρμογής προτύπου σαςInstall and configure your template app

Σε αυτήν την ενότητα, θα χρησιμοποιήσετε ένα δείγμα της αυτοματοποιημένης εγκατάστασης του Azure Functions που δημιουργήσαμε για να προρυθμίσετε τις παραμέτρους και να εγκαταστήσετε την εφαρμογή προτύπου σας.In this section, you'll use an automated installation Azure Functions sample that we created to preconfigure and install your template app. Αυτό το δείγμα είναι σκόπιμα απλό για σκοπούς επίδειξης.This sample has deliberately been kept simple for demonstration purposes. Σας επιτρέπει να χρησιμοποιήσετε μια συνάρτηση Azure και τη Ρύθμιση παραμέτρων εφαρμογών Azure για εύκολη ανάπτυξη και χρήση του API αυτοματοποιημένης εγκατάστασης για τις εφαρμογές προτύπου σας.It allows you to use an Azure function and Azure App Configuration to easily deploy and use the automated installation API for your template apps.

Λήψη του Visual Studio (έκδοση 2017 ή νεότερη)Download Visual Studio (version 2017 or later)

Κατεβάστε το Visual Studio, (έκδοση 2017 ή νεότερη).Download Visual Studio (version 2017 or later). Φροντίστε να κάνετε λήψη του τελευταίου πακέτου NuGet.Make sure to download the latest NuGet package.

Λήψη του δείγματος Azure Functions αυτοματοποιημένης εγκατάστασηςDownload the automated installation Azure Functions sample

Κάντε λήψη του δείγματος Azure Functions αυτοματοποιημένης εγκατάστασης από το GitHub για να ξεκινήσετε.Download the automated installation Azure Functions sample from GitHub to get started.

Στιγμιότυπο οθόνης που εμφανίζει το δείγμα Azure Functions αυτοματοποιημένης εγκατάστασης.

Ρύθμιση παραμέτρων της εφαρμογής AzureSet up your Azure app configuration

Για να εκτελέσετε αυτό το δείγμα, πρέπει να κάνετε ρύθμιση παραμέτρων της εφαρμογής σας Azure με τις τιμές και τα κλειδιά που περιγράφονται παρακάτω.To run this sample, you need to set up your Azure app configuration with the values and keys as described here. Τα κλειδιά είναι τα αναγνωριστικό εφαρμογής, ο μυστικός κωδικός εφαρμογής και οι τιμές AppId, PackageKey και OwnerId.The keys are the application ID, the application secret, and your template app's AppId, PackageKey, and OwnerId values. Δείτε τις παρακάτω ενότητες για πληροφορίες σχετικά με τον τρόπο λήψης αυτών των τιμών.See the following sections for information about how to get these values.

Τα κλειδιά ορίζονται επίσης στο αρχείο Constants.cs.The keys are also defined in the Constants.cs file.

Κλειδί ρύθμισης παραμέτρωνConfiguration key ΝόημαMeaning
TemplateAppInstall:Application:AppIdTemplateAppInstall:Application:AppId AppId από τη διεύθυνση URL εγκατάστασηςAppId from the installation URL
TemplateAppInstall:Application:PackageKeyTemplateAppInstall:Application:PackageKey PackageKey από τη διεύθυνση URL εγκατάστασηςPackageKey from the installation URL
TemplateAppInstall:Application:OwnerIdTemplateAppInstall:Application:OwnerId OwnerId από τη διεύθυνση URL εγκατάστασηςOwnerId from the installation URL
TemplateAppInstall:ServicePrincipal:ClientIdTemplateAppInstall:ServicePrincipal:ClientId Αναγνωριστικό εφαρμογής κύριας υπηρεσίαςService principal application ID
TemplateAppInstall:ServicePrincipal:ClientSecretTemplateAppInstall:ServicePrincipal:ClientSecret Μυστικός κωδικός εφαρμογής κύριας υπηρεσίαςService principal application secret

Το αρχείο Constants.cs εμφανίζεται εδώ.The Constants.cs file is shown here.

Στιγμιότυπο οθόνης που εμφανίζει το αρχείο Constants.cs.

Λήψη των ιδιοτήτων εφαρμογής προτύπουGet the template app properties

Συμπληρώστε όλες τις σχετικές ιδιότητες της εφαρμογής προτύπου, όπως έχουν οριστεί κατά τη δημιουργία της εφαρμογής.Fill in all relevant template app properties as they're defined when the app is created. Αυτές οι ιδιότητες είναι οι τιμές AppId, PackageKey και OwnerId της εφαρμογής προτύπου.These properties are the template app's AppId, PackageKey, and OwnerId values.

Για να λάβετε τις προηγούμενες τιμές, ακολουθήστε αυτά τα βήματα:To get the preceding values, follow these steps:

  1. Πραγματοποιήστε είσοδο στο Power BI.Sign in to Power BI.

  2. Μεταβείτε στον αρχικό χώρο εργασίας της εφαρμογής.Go to the application's original workspace.

  3. Ανοίξτε το τμήμα παραθύρου Διαχείριση εκδόσεων.Open the Release Management pane.

    Στιγμιότυπο οθόνης που εμφανίζει το τμήμα παραθύρου "Διαχείριση εκδόσεων".

  4. Επιλέξτε την έκδοση εφαρμογής και λάβετε τη σύνδεση εγκατάστασής της.Select the app version, and get its installation link.

    Στιγμιότυπο οθόνης που εμφανίζει το κουμπί "Διαχείριση εκδόσεων".

  5. Αντιγράψτε τη σύνδεση στο πρόχειρο.Copy the link to the clipboard.

    Στιγμιότυπο οθόνης που εμφανίζει το κουμπί "Λήψη σύνδεσης".

  6. Αυτή η διεύθυνση URL εγκατάστασης διατηρεί τις τρεις παραμέτρους διεύθυνσης URL των οποίων τις τιμές χρειάζεστε.This installation URL holds the three URL parameters whose values you need. Χρησιμοποιήστε τις τιμές appId, packageKey και ownerId για την εφαρμογή.Use the appId, packageKey, and ownerId values for the application. Ένα δείγμα διεύθυνσης URL θα είναι παρόμοιο με αυτό που εμφανίζεται εδώ.A sample URL will be similar to what is shown here.

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

Λήψη του αναγνωριστικού εφαρμογήςGet the application ID

Συμπληρώστε τις πληροφορίες applicationId με το αναγνωριστικό εφαρμογής από το Azure.Fill in the applicationId information with the application ID from Azure. Η τιμή applicationId χρησιμοποιείται από την εφαρμογή για να προσδιορίσει τον εαυτό της στους χρήστες από τους οποίους ζητάτε δικαιώματα.The applicationId value is used by the application to identify itself to the users from which you're requesting permissions.

Για να λάβετε το αναγνωριστικό εφαρμογής, ακολουθήστε αυτά τα βήματα:To get the application ID, follow these steps:

  1. Πραγματοποιήστε είσοδο στην πύλη Azure.Sign in to the Azure portal.

  2. Στο αριστερό τμήμα παραθύρου, επιλέξτε Όλες οι υπηρεσίες > Καταχωρήσεις εφαρμογών.In the left pane, select All services > App registrations.

    Στιγμιότυπο οθόνης που εμφανίζει αναζήτηση καταχωρήσεων εφαρμογών.

  3. Επιλέξτε την εφαρμογή που χρειάζεται να χρησιμοποιήσει το αναγνωριστικό εφαρμογής.Select the application that needs the application ID.

    Στιγμιότυπο οθόνης που εμφανίζει την επιλογή μιας εφαρμογής.

  4. Υπάρχει ένα αναγνωριστικό εφαρμογής που παρατίθεται ως GUID.There's an application ID that's listed as a GUID. Χρησιμοποιήστε αυτό το αναγνωριστικό εφαρμογής ως την τιμή applicationId για την εφαρμογή.Use this application ID as the applicationId value for the application.

    Στιγμιότυπο οθόνης που εμφανίζει την τιμή applicationId.

Λήψη του μυστικού της εφαρμογήςGet the application secret

Συμπληρώστε τις πληροφορίες ApplicationSecret από την ενότητα Κλειδιά της ενότητας Καταχωρήσεις εφαρμογών στο Azure.Fill in the ApplicationSecret information from the Keys section of your App registrations section in Azure. Αυτό το χαρακτηριστικό λειτουργεί όταν χρησιμοποιείτε την κύρια υπηρεσία.This attribute works when you use the service principal.

Για να λάβετε τον μυστικό κωδικό εφαρμογής, ακολουθήστε τα εξής βήματα:To get the application secret, follow these steps:

  1. Πραγματοποιήστε είσοδο στην πύλη Azure.Sign in to the Azure portal.

  2. Στο αριστερό τμήμα παραθύρου, επιλέξτε Όλες οι υπηρεσίες > Καταχωρήσεις εφαρμογών.In the left pane, select All services > App registrations.

    Στιγμιότυπο οθόνης που εμφανίζει αναζήτηση καταχωρήσεων εφαρμογών.

  3. Επιλέξτε την εφαρμογή που χρειάζεται να χρησιμοποιήσει τον μυστικό κωδικό εφαρμογής.Select the application that needs to use the application secret.

    Στιγμιότυπο οθόνης που εμφανίζει την επιλογή μιας εφαρμογής.

  4. Επιλέξτε Πιστοποιητικά και μυστικοί κωδικοί στη Διαχείριση.Select Certificates and secrets under Manage.

  5. Επιλέξτε Νέοι μυστικοί κωδικοί προγράμματος-πελάτη.Select New client secrets.

  6. Καταχωρήστε ένα όνομα στο πλαίσιο Περιγραφή και επιλέξτε μια διάρκεια.Enter a name in the Description box, and select a duration. Στη συνέχεια, επιλέξτε Αποθήκευση για να λάβετε την τιμή για την εφαρμογή σας.Then select Save to get the value for your application. Όταν κλείσετε το τμήμα παραθύρου Κλειδιά αφού αποθηκεύσετε την τιμή κλειδιού, εμφανίζεται το πεδίο Τιμή μόνο ως κρυφό.When you close the Keys pane after you save the key value, the Value field shows only as hidden. Σε αυτό το σημείο, δεν μπορείτε να ανακτήσετε την τιμή κλειδιού.At that point, you aren't able to retrieve the key value. Αν χάσετε την τιμή κλειδιού, δημιουργήστε μια νέα στην πύλη Azure.If you lose the key value, create a new one in the Azure portal.

    Στιγμιότυπο οθόνης που εμφανίζει την τιμή κλειδιού.

Δοκιμή της συνάρτησης τοπικάTest your function locally

Ακολουθήστε τα βήματα που περιγράφονται στο θέμα Εκτέλεση της συνάρτησης τοπικά για να εκτελέσετε τη συνάρτηση.Follow the steps as described in Run the function locally to run your function.

Ρυθμίστε τις παραμέτρους της πύλης σας για την έκδοση μιας αίτησης POST στη διεύθυνση URL της συνάρτησης.Configure your portal to issue a POST request to the URL of the function. Για παράδειγμα, POST http://localhost:7071/api/install.An example is POST http://localhost:7071/api/install. Το σώμα αίτησης θα πρέπει να είναι ένα αντικείμενο JSON που περιγράφει ζεύγη κλειδιού-τιμής.The request body should be a JSON object that describes key-value pairs. Τα κλειδιά είναι ονόματα παραμέτρων όπως ορίζονται στο Power BI Desktop.Keys are parameter names as defined in Power BI Desktop. Οι τιμές είναι οι επιθυμητές τιμές που θα οριστούν για κάθε παράμετρο στην εφαρμογή προτύπου.Values are the desired values to be set for each parameter in the template app.

Σημείωση

Στην παραγωγή, οι τιμές παραμέτρων συνάγονται για κάθε χρήστη από την προβλεπόμενη λογική της πύλης σας.In production, parameter values are deduced for each user by your portal's intended logic.

Η επιθυμητή ροή θα πρέπει να είναι:The desired flow should be:

  1. Η πύλη προετοιμάζει την αίτηση, ανά χρήστη ή περίοδο λειτουργίας.The portal prepares the request, per user or session.
  2. Εκδίδεται η αίτηση POST /api/install στη συνάρτηση Azure.The POST /api/install request is issued to your Azure function. Το σώμα της αίτησης αποτελείται από ζεύγη κλειδιού-τιμής.The request body consists of key-value pairs. Το κλειδί είναι το όνομα παραμέτρου.The key is the parameter name. Η τιμή είναι η επιθυμητή τιμή που θα οριστεί.The value is the desired value to be set.
  3. Εάν όλες οι παράμετροι έχουν ρυθμιστεί σωστά, το πρόγραμμα περιήγησης θα πρέπει να ανακατευθύνει αυτόματα στον λογαριασμό Power BI του πελάτη και να εμφανίζει την αυτοματοποιημένη ροή εγκατάστασης.If everything is configured properly, the browser should automatically redirect to the customer's Power BI account and show the automated installation flow.
  4. Κατά την εγκατάσταση, οι τιμές παραμέτρων ορίζονται όπως έχουν ρυθμιστεί στα βήματα 1 και 2.Upon installation, parameter values are set as configured in steps 1 and 2.

Επόμενα βήματαNext steps

Δημοσίευση του έργου σας στο AzurePublish your project to Azure

Για να δημοσιεύσετε το έργο σας στο Azure, ακολουθήστε τις οδηγίες στην τεκμηρίωση του Azure Functions.To publish your project to Azure, follow the instructions in the Azure Functions documentation. Έπειτα, μπορείτε να ενσωματώσετε API αυτοματοποιημένης εγκατάστασης εφαρμογής προτύπου στο προϊόν σας και να ξεκινήσετε τη δοκιμή τους σε περιβάλλον παραγωγής.Then you can integrate template app automated installation APIs into your product and begin testing it in production environments.