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

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

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

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

Όταν ο πελάτης εισέρχεται στην πύλη σας, επιλέγει μια ειδική σύνδεση που έχετε προετοιμάσει. Αυτή η σύνδεση:

• Εκκινεί τον αυτοματισμό, ο οποίος συγκεντρώνει τις πληροφορίες που χρειάζεται.
• Προρυθμίζει τις παραμέτρους της εφαρμογής προτύπου.
• Ανακατευθύνει τον πελάτη στον λογαριασμό του Power BI όπου μπορεί να εγκαταστήσει την εφαρμογή.

Το μόνο που πρέπει να κάνει είναι να επιλέξει Εγκατάσταση και να εκτελέσει έλεγχο ταυτότητας σε σχέση με την προέλευση δεδομένων του και είναι έτοιμοι!

Εδώ παρουσιάζεται η εμπειρία του πελάτη.

Σε αυτή την εκμάθηση, θα χρησιμοποιήσετε ένα δείγμα της αυτοματοποιημένης εγκατάστασης του Azure Functions που δημιουργήσαμε για να προρυθμίσετε τις παραμέτρους και να εγκαταστήσετε την εφαρμογή προτύπου σας. Αυτό το δείγμα είναι σκόπιμα απλό για σκοπούς επίδειξης. Περιλαμβάνει τη ρύθμιση μιας συνάρτησης Azure ώστε να χρησιμοποιεί τα API του Power BI για την εγκατάσταση μιας εφαρμογής προτύπου και τη ρύθμιση των παραμέτρων της για τους χρήστες σας αυτόματα.

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

Η απλή εφαρμογή μας χρησιμοποιεί μια συνάρτηση Azure. Για περισσότερες πληροφορίες σχετικά με το Azure Functions, ανατρέξτε στην τεκμηρίωση του 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 για να αναπτύξετε μια συνάρτηση Azure μαζί με μια ρύθμιση παραμέτρων εφαρμογής Azure. Δημιουργήστε τη ρύθμιση παραμέτρων της εφαρμογής σας όπως περιγράφεται στο άρθρο.

Καταχώρηση μιας εφαρμογής στο Αναγνωριστικό Microsoft Entra

Δημιουργήστε μια κύρια υπηρεσία όπως περιγράφεται στο θέμα Ενσωμάτωση περιεχομένου Power BI με κύρια υπηρεσία και μυστικό κωδικό εφαρμογής.

Βεβαιωθείτε ότι έχετε καταχωρήσει την εφαρμογή ως εφαρμογή Web από την πλευρά του διακομιστή. Καταχωρήστε μια εφαρμογή Web από την πλευρά του διακομιστή για να δημιουργήσετε έναν μυστικό κωδικό εφαρμογής.

Αποθηκεύστε το αναγνωριστικό εφαρμογής (Αναγνωριστικό προγράμματος-πελάτη) και τον μυστικό κωδικό εφαρμογής (μυστικός κωδικός πελάτη) για τα επόμενα βήματα.

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

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

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

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

• Το Αναγνωριστικό εφαρμογής, το Κλειδί πακέτου και το Αναγνωριστικό κατόχου, όπως εμφανίζονται στη διεύθυνση URL εγκατάστασης στο τέλος της διαδικασίας Ορισμός των ιδιοτήτων της εφαρμογής προτύπου όταν δημιουργηθεί η εφαρμογή.

  Μπορείτε επίσης να λάβετε την ίδια σύνδεση επιλέγοντας Σύνδεση Λήψη στο τμήμα παραθύρου Διαχείριση εκδόσεων της εφαρμογής προτύπου.

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

Σημείωμα

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

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

Σε αυτή την ενότητα, θα χρησιμοποιήσετε ένα δείγμα azure Functions αυτοματοποιημένης εγκατάστασης που δημιουργήσαμε για να προρυθμίσετε τις παραμέτρους και να εγκαταστήσετε την εφαρμογή προτύπου σας. Αυτό το δείγμα είναι σκόπιμα απλό για σκοπούς επίδειξης. Σας επιτρέπει να χρησιμοποιήσετε μια συνάρτηση Azure και Ρύθμιση παραμέτρων εφαρμογών του Azure για εύκολη ανάπτυξη και χρήση του API αυτοματοποιημένης εγκατάστασης για τις εφαρμογές προτύπου σας.

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

Κάντε λήψη του Visual Studio (έκδοση 2017 ή νεότερη). Βεβαιωθείτε ότι έχετε κάνει λήψη του τελευταίου πακέτου NuGet.

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

Κάντε λήψη του δείγματος Azure Functions αυτοματοποιημένης εγκατάστασης από το GitHub για να ξεκινήσετε.

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

Για να εκτελέσετε αυτό το δείγμα, πρέπει να ρυθμίσετε τη ρύθμιση παραμέτρων της εφαρμογής Azure με τις τιμές και τα κλειδιά που περιγράφονται εδώ. Τα κλειδιά είναι το αναγνωριστικό εφαρμογής, ο μυστικός κωδικός εφαρμογής και οι τιμές AppId, PackageKey και OwnerId της εφαρμογής σας. Ανατρέξτε στις παρακάτω ενότητες για πληροφορίες σχετικά με τον τρόπο λήψης αυτών των τιμών.

Τα κλειδιά ορίζονται επίσης στο αρχείο Constants.cs .

Κλειδί ρύθμισης παραμέτρων	Νόημα
TemplateAppInstall:Application:AppId	AppId από τη διεύθυνση URL εγκατάστασης
TemplateAppInstall:Application:PackageKey	PackageKey από τη διεύθυνση URL εγκατάστασης
TemplateAppInstall:Application:OwnerId	OwnerId από τη διεύθυνση URL εγκατάστασης
TemplateAppInstall:ServicePrincipal:ClientId	Αναγνωριστικό εφαρμογής κύριας υπηρεσίας
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=3c386...16bf71c67&packageKey=b2df4b...dLpHIUnum2pr6k&ownerId=72f9...1db47&buildVersion=5
   

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

Συμπληρώστε τις πληροφορίες applicationId με το αναγνωριστικό εφαρμογής από το Azure. Η τιμή applicationId χρησιμοποιείται από την εφαρμογή για να προσδιορίσει τον εαυτό της στους χρήστες από τους οποίους ζητάτε δικαιώματα.

Για να λάβετε το αναγνωριστικό εφαρμογής, ακολουθήστε τα εξής βήματα:

1. Εισέλθετε στην Πύλη Azure.

2. Στο αριστερό τμήμα παραθύρου, επιλέξτε Όλες οι υπηρεσίες>Καταχωρήσεις εφαρμογών.

   

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

   

4. Υπάρχει ένα αναγνωριστικό εφαρμογής που παρατίθεται ως GUID. Χρησιμοποιήστε αυτό το αναγνωριστικό εφαρμογής ως την τιμή applicationId για την εφαρμογή.

   

Λήψη του μυστικού κωδικού της εφαρμογής

Συμπληρώστε τις πληροφορίες ApplicationSecret από την ενότητα Κλειδιά της ενότητας Καταχωρήσεις εφαρμογών στο Azure. Αυτό το χαρακτηριστικό λειτουργεί όταν χρησιμοποιείτε την κύρια υπηρεσία.

Για να λάβετε τον μυστικό κωδικό εφαρμογής, ακολουθήστε τα εξής βήματα:

1. Εισέλθετε στην Πύλη Azure.

2. Στο αριστερό τμήμα παραθύρου, επιλέξτε Όλες οι υπηρεσίες>Καταχωρήσεις εφαρμογών.

   

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

   

4. Επιλέξτε Πιστοποιητικά και μυστικοί έλεγχοι στην περιοχή Διαχείριση.

5. Επιλέξτε Νέα μυστικά προγράμματος-πελάτη.

6. Εισαγάγετε ένα όνομα στο πλαίσιο Περιγραφή και επιλέξτε μια διάρκεια. Στη συνέχεια, επιλέξτε Αποθήκευση για να λάβετε την τιμή για την εφαρμογή σας. Όταν κλείσετε το τμήμα παραθύρου Κλειδιά αφού αποθηκεύσετε την τιμή κλειδιού, το πεδίο Τιμή εμφανίζεται μόνο ως κρυφό. Σε αυτό το σημείο, δεν μπορείτε να ανακτήσετε την τιμή κλειδιού. Εάν χάσετε την τιμή κλειδιού, δημιουργήστε μια νέα στην πύλη Azure.

   

Δοκιμή της συνάρτησης τοπικά

Ακολουθήστε τα βήματα που περιγράφονται στο θέμα Εκτέλεση της συνάρτησης τοπικά για να εκτελέσετε τη συνάρτηση.

Ρυθμίστε τις παραμέτρους της πύλης σας για την έκδοση μιας 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 Functions. Στη συνέχεια, μπορείτε να ενσωματώσετε API αυτοματοποιημένης εγκατάστασης εφαρμογής προτύπου στο προϊόν σας και να ξεκινήσετε τη δοκιμή τους σε περιβάλλοντα παραγωγής.