Αυτοματοποιημένη ρύθμιση παραμέτρων εγκατάστασης εφαρμογής προτύπου

Οι εφαρμογές προτύπου είναι ένας πολύ καλός τρόπος για να ξεκινήσουν οι πελάτες να λαμβάνουν πληροφορίες από τα δεδομένα τους. Οι εφαρμογές προτύπου ρυθμίζουν γρήγορα τη λειτουργία τους, συνδέοντάς τις στα δεδομένα τους. Οι εφαρμογές προτύπου τους παρέχουν προκατασκευασμένων αναφορών που μπορούν να προσαρμόσουν εάν το επιθυμούν.

Οι πελάτες δεν είναι πάντα εξοικειωμένοι με τις λεπτομέρειες σχετικά με τον τρόπο σύνδεσης στα δεδομένα τους. Η παροχή αυτών των λεπτομερειών όταν εγκαθιστούν μια εφαρμογή προτύπου μπορεί να είναι ένα σημείο αιχμής για αυτούς.

Εάν είστε υπηρεσία παροχής υπηρεσιών δεδομένων και έχετε δημιουργήσει μια εφαρμογή προτύπου για να βοηθήσετε τους πελάτες σας να ξεκινήσουν με τα δεδομένα τους στην υπηρεσία σας, μπορείτε να τους διευκολύνετε να εγκαταστήσουν την εφαρμογή προτύπου σας. Μπορείτε να αυτοματοποιήσετε τη ρύθμιση παραμέτρων της εφαρμογής προτύπου σας. Όταν ο πελάτης εισέρχεται στην πύλη σας, επιλέγει μια ειδική σύνδεση που έχετε προετοιμάσει. Αυτή η σύνδεση:

• Εκκινεί τον αυτοματισμό, ο οποίος συγκεντρώνει τις πληροφορίες που χρειάζεται.
• Προρυθμίζει τις παραμέτρους της εφαρμογής προτύπου.
• Ανακατευθύνει τον πελάτη στον λογαριασμό του 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 με το δελτίο εγκατάστασης και του ζητείται να εγκαταστήσει την εφαρμογή προτύπου. Όταν ο χρήστης επιλέγει Εγκατάσταση, η εφαρμογή προτύπου εγκαθίσταται αυτόματα.

Σημείωμα

Παρόλο που οι τιμές παραμέτρων ρυθμίζονται από τον ISV κατά τη διαδικασία δημιουργίας του δελτίου εγκατάστασης, τα διαπιστευτήρια που σχετίζονται με την προέλευση δεδομένων παρέχονται από τον χρήστη μόνο στα τελικά στάδια της εγκατάστασης. Αυτή η διάταξη αποτρέπει την έκθεσή τους σε τρίτους και εξασφαλίζει μια ασφαλή σύνδεση μεταξύ του χρήστη και των προελεύσεων δεδομένων της εφαρμογής προτύπου.

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

Για να παρέχετε μια προρυθμισμένη εμπειρία εγκατάστασης για την εφαρμογή προτύπου σας, απαιτούνται οι ακόλουθες προϋποθέσεις:

• Άδεια χρήσης Power BI Pro. Εάν δεν έχετε εγγραφεί για το Power BI Pro, εγγραφείτε για μια δωρεάν δοκιμαστική έκδοση προτού ξεκινήσετε.

• Η δική σας ρύθμιση μισθωτή Microsoft Entra. Για οδηγίες σχετικά με τον τρόπο ρύθμισης ενός μισθωτή, ανατρέξτε στο θέμα Δημιουργία μισθωτή Microsoft Entra.

• Μια κύρια υπηρεσία (διακριτικό μόνο για εφαρμογή) καταχωρημένη στον προηγούμενο μισθωτή. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Ενσωμάτωση περιεχομένου Power BI με κύρια υπηρεσία και μυστικό κωδικό εφαρμογής. Βεβαιωθείτε ότι έχετε καταχωρήσει την εφαρμογή ως εφαρμογή Web από την πλευρά του διακομιστή. Καταχωρήστε μια εφαρμογή Web από την πλευρά του διακομιστή για να δημιουργήσετε έναν μυστικό κωδικό εφαρμογής. Από αυτήν τη διαδικασία, πρέπει να αποθηκεύσετε το αναγνωριστικό εφαρμογής (Αναγνωριστικό προγράμματος-πελάτη) και τον μυστικό κωδικό εφαρμογής (μυστικός κωδικός πελάτη) για τα επόμενα βήματα.

• Μια παραμετροποιημένη εφαρμογή προτύπου που είναι έτοιμη για εγκατάσταση. Η εφαρμογή προτύπου πρέπει να δημιουργηθεί στον ίδιο μισθωτή στον οποίο καταχωρείτε την εφαρμογή σας στο Αναγνωριστικό Microsoft Entra. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Συμβουλές εφαρμογής προτύπου ή Δημιουργία εφαρμογής προτύπου στο Power BI. Από την εφαρμογή προτύπου, πρέπει να λάβετε υπόψη τις ακόλουθες πληροφορίες για τα επόμενα βήματα:

  • Το Αναγνωριστικό εφαρμογής, το Κλειδί πακέτου και το Αναγνωριστικό κατόχου, όπως εμφανίζονται στη διεύθυνση URL εγκατάστασης στο τέλος της διαδικασίας ορισμού των ιδιοτήτων της εφαρμογής προτύπου κατά τη δημιουργία της εφαρμογής. Μπορείτε επίσης να λάβετε την ίδια σύνδεση επιλέγοντας Σύνδεση Λήψη στο τμήμα παραθύρου Διαχείριση εκδόσεων της εφαρμογής προτύπου.
  • Τα ονόματα παραμέτρων όπως ορίζονται στο σημασιολογικό μοντέλο της εφαρμογής προτύπου. Τα ονόματα παραμέτρων λαμβάνουν συμβολοσειρές με διάκριση πεζών-κεφαλαίων και μπορούν επίσης να ανακτηθούν από την καρτέλα Παράμετρος Ρυθμίσεις όταν ορίζετε τις ιδιότητες της εφαρμογής προτύπου ή από τις ρυθμίσεις μοντέλου σημασιολογίας στο Power BI.

• Για να μπορέσετε να δοκιμάσετε τη ροή εργασίας αυτοματισμού, προσθέστε την κύρια υπηρεσία στον χώρο εργασίας της εφαρμογής προτύπου ως Διαχείριση.

  Σημείωμα

  Μπορείτε να ελέγξετε την προρυθμισμένη εφαρμογή εγκατάστασης στην εφαρμογή προτύπου σας, εάν η εφαρμογή προτύπου είναι έτοιμη για εγκατάσταση, ακόμα και αν δεν είναι διαθέσιμη για το κοινό στο AppSource. Για να μπορούν οι χρήστες εκτός του μισθωτή σας να χρησιμοποιήσουν την αυτοματοποιημένη εφαρμογή εγκατάστασης για να εγκαταστήσουν την εφαρμογή προτύπου, η εφαρμογή προτύπου πρέπει να είναι δημόσια διαθέσιμη στο Power BI Apps marketplace. Προτού διανείμετε την εφαρμογή προτύπου χρησιμοποιώντας την εφαρμογή αυτοματοποιημένης εγκατάστασης που δημιουργείτε, φροντίστε να τη δημοσιεύσετε στο Κέντρο συνεργατών.

Κύρια βήματα και API

Τα κύρια βήματα για την αυτοματοποίηση της ρύθμισης παραμέτρων μιας εγκατάστασης εφαρμογής προτύπου και τα API που θα χρειαστείτε, περιγράφονται στις παρακάτω ενότητες. Παρόλο που τα περισσότερα από τα βήματα γίνονται με Power BI REST API, τα παραδείγματα κώδικα που περιγράφονται εδώ γίνονται με το .NET SDK.

Βήμα 1: Δημιουργία αντικειμένου προγράμματος-πελάτη του Power BI

Η χρήση του Power BI REST API απαιτεί να λάβετε ένα διακριτικό πρόσβασης για την κύρια υπηρεσία σας από το αναγνωριστικό Entra της Microsoft. Πρέπει να λάβετε ένα διακριτικό πρόσβασης Του 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 που χρησιμοποιείται για αυτήν τη λειτουργία είναι το API CreateInstallTicket .

• CreateInstallTicket εφαρμογών προτύπου

Ένα δείγμα σχετικά με τον τρόπο δημιουργίας ενός δελτίου εγκατάστασης για την εγκατάσταση και τη ρύθμιση παραμέτρων της εφαρμογής προτύπου είναι διαθέσιμο από το αρχείο InstallTemplateApp/InstallAppFunction.cs στο δείγμα εφαρμογής.

Το παρακάτω παράδειγμα κώδικα δείχνει πώς μπορείτε να χρησιμοποιήσετε το REST API CreateInstallTicket της εφαρμογής προτύπου.

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();
}

Σημείωμα

Υπάρχουν διάφορες μέθοδοι χρήσης POST ανακατευθύνσεων προγράμματος περιήγησης. Θα πρέπει να χρησιμοποιείτε πάντα την πιο ασφαλή μέθοδο, η οποία εξαρτάται από τις ανάγκες και τους περιορισμούς σας για υπηρεσίες. Να θυμάστε ότι ορισμένες μορφές μη ασφαλούς ανακατεύθυνσης μπορεί να έχουν ως αποτέλεσμα την έκθεση των χρηστών ή της υπηρεσίας σας σε προβλήματα ασφάλειας.

Βήμα 4: Μεταφορά του αυτοματισμού στην παραγωγή

Όταν ο αυτοματισμός που έχετε σχεδιάσει είναι έτοιμος, φροντίστε να τον μεταφέρετε στην παραγωγή.

Σχετικό περιεχόμενο

• Δοκιμάστε το εκπαιδευτικό βοήθημα που χρησιμοποιεί μια απλή συνάρτηση Azure για την αυτοματοποίηση της ρύθμισης παραμέτρων μιας εγκατάστασης εφαρμογής προτύπου.
• Περισσότερες ερωτήσεις; Δοκιμάστε να ρωτήσετε την Κοινότητα Power BI.