Παραχώρηση αδειών χρήσης και επιβολή transactability (Δημόσια προεπισκόπηση)

Όταν δημιουργείτε απεικονίσεις Power BI για λήψη στο AppSource, μπορείτε πλέον να διαχειρίζεστε και επιβάλλετε τις άδειες χρήσης τους χρησιμοποιώντας συστήματα της Microsoft. Ο τελικός χρήστης εκχωρεί και διαχειρίζεται άδειες χρήσης χρησιμοποιώντας οικεία εργαλεία, όπως Κέντρο διαχείρισης Microsoft 365, και το API παραχώρησης αδειών χρήσης σάς επιτρέπει να επιβάλετε αυτές τις άδειες χρήσης και να διασφαλίσετε ότι μόνο οι χρήστες με άδεια χρήσης μπορούν να αποδίδουν τις απεικονίσεις.

Διαδικασία επιβολής άδειας χρήσης

Ο παρακάτω πίνακας παρουσιάζει τα βήματα που εμπλέκονται στη διαχείριση των αδειών χρήσης απεικονίσεών σας μέσω της Microsoft:

Βήμα	Λεπτομέρειες
Δημιουργία προσφοράς στο Κέντρο συνεργατών	Επιλέξτε να κάνετε μετατροπές μέσω του συστήματος εμπορίου της Microsoft. Ενεργοποιήστε τη Microsoft για να διαχειριστείτε τις άδειες χρήσης. Ορισμός τιμολόγησης και διαθεσιμότητας.
Προσθήκη επιβολής άδειας χρήσης στο πακέτο απεικονίσεών σας Power BI	Δημιουργήστε ή ρυθμίστε εκ νέου τις παραμέτρους του πακέτου σας για να χρησιμοποιήσετε την άδεια χρήσης χρόνου εκτέλεσης Power BI, η οποία επιβάλλει την παραχώρηση αδειών χρήσης σύμφωνα με την πρόσβαση κάθε χρήστη.
Οι πελάτες ανακαλύπτουν την προσφορά σας στο AppSource και αγοράζουν μια συνδρομή	Όταν οι πελάτες αγοράσουν την προσφορά σας στο AppSource, λαμβάνουν επίσης άδειες χρήσης για την απεικόνιση Power BI.
Οι πελάτες διαχειρίζονται τις συνδρομές τους και εκχωρούν/κατανέμουν άδειες χρήσης	Οι πελάτες διαχειρίζονται συνδρομές και εκχωρούν άδειες χρήσης για αυτές τις απεικονίσεις και προσφορές στον Κέντρο διαχείρισης Microsoft 365, ακριβώς όπως κάνουν για οποιαδήποτε από τις άλλες συνδρομές τους, όπως το Office ή το Power BI.
Επιβολή ελέγχων χρόνου εκτέλεσης	Δώστε στους πελάτες σας μια ενιαία εμπειρία χρησιμοποιώντας τα έτοιμες προς χρήση API μας για την επιβολή ελέγχων αδειών χρήσης χρόνου εκτέλεσης.
Προβολή αναφορών για την ανάπτυξη καυσίμων	Αποκτήστε πληροφορίες σχετικά με τα έσοδα, τις πληροφορίες πληρωμών και τις λεπτομέρειες παραγγελιών και αδειών χρήσης. Δείτε πληροφορίες σχετικά με τις άδειες χρήσης και τις παραγγελίες που αγοράστηκαν, ανανεώθηκαν και ακυρώθηκαν με την πάροδο του χρόνου και κατά γεωγραφική τοποθεσία.

API παραχώρησης αδειών χρήσης

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

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

Σημείωμα

Το API παραχώρησης αδειών χρήσης είναι διαθέσιμο από την έκδοση 4.7. Για να μάθετε ποια έκδοση χρησιμοποιείτε, ελέγξτε το apiVersion στο αρχείο pbiviz.json .

Ανάκτηση προγραμμάτων υπηρεσίας της απεικόνισης που έχουν αντιστοιχιστεί στον ενεργό χρήστη

Για να εκχωρήσετε προγράμματα υπηρεσιών, προσθέστε μια κλήση στο getAvailableServicePlans (διαθέσιμη μέσω IVisualLicenseManager). Από την πλευρά των επιδόσεων, επιχειρήσετε να λάβετε τις άδειες χρήσης μία φορά, κατά προτίμηση στις constructor κλήσεις ή στις init κλήσεις και αποθηκεύστε το αποτέλεσμα.
Μόλις ανακτηθούν οι άδειες χρήσης, θα αποθηκευτούν στο cache στην πλευρά του κεντρικού υπολογιστή power BI κατά τη διάρκεια της περιόδου λειτουργίας του Power BI και τυχόν περαιτέρω κλήσεις στο ίδιο θα επιστρέψουν τα δεδομένα στο cache.

export interface IVisualLicenseManager {
        getAvailableServicePlans(): IPromise<powerbi.extensibility.visual.LicenseInfoResult>;
    }

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

export interface LicenseInfoResult {
        plans: ServicePlan[] | undefined;
        isLicenseUnsupportedEnv: boolean; 
        isLicenseInfoAvailable: boolean; 
    }

• plans - ένας πίνακας προγραμμάτων υπηρεσιών που έχει αγοραστεί από τον ενεργό χρήστη για αυτή την απεικόνιση. (Οι άδειες χρήσης που έχουν αγοραστεί για οποιεσδήποτε άλλες απεικονίσεις δεν περιλαμβάνονται στην απόκριση.)
  Ένα ServicePlan περιέχει το αναγνωριστικό υπηρεσίας (spIdentifier) και την κατάστασή του (ServicePlanState).

  • spIdentifier: η τιμή συμβολοσειράς του αναγνωριστικού υπηρεσίας που δημιουργήθηκε όταν ρυθμίζετε τα προγράμματα της προσφοράς σας στο Κέντρο συνεργατών (ανατρέξτε στο παρακάτω παράδειγμα)

  • state – enum (ServicePlanState) που αντιπροσωπεύει την κατάσταση των προγραμμάτων που έχουν ανατεθεί.
    Το υποστηριζόμενο πρόγραμμα υπηρεσιών αναφέρει τα εξής:

    Νομός	Περιγραφή
    Ανενεργοί	Υποδεικνύει ότι η άδεια χρήσης δεν είναι ενεργή και δεν θα πρέπει να χρησιμοποιείται για την παροχή παροχών.
    Eνεργές	Υποδεικνύει ότι η άδεια χρήσης είναι ενεργή και μπορεί να χρησιμοποιηθεί για την παροχή παροχών.
    Προειδοποίηση	Υποδεικνύει ότι η άδεια χρήσης βρίσκεται σε περίοδο χάριτος λόγω παραβίασης πληρωμής.
    Τέθηκε σε αναστολή	Υποδεικνύει ότι η άδεια χρήσης έχει ανασταλεί πιθανώς λόγω παραβίασης πληρωμής.
    Άγνωστο	Τιμή sentinel.

    Μόνο οι ενεργές καταστάσεις και οι καταστάσεις προειδοποίησης αντιπροσωπεύουν μια άδεια χρήσης με δυνατότητα χρήσης. Όλες οι άλλες πολιτείες θα πρέπει να αντιμετωπίζονται ως μη με αποτέλεσμα μια εύχρηστη άδεια χρήσης.

• isLicenseUnsupportedEnv - υποδεικνύει ότι η απεικόνιση αποδίδεται σε ένα περιβάλλον Power BI που δεν υποστηρίζει τη διαχείριση ή επιβολή αδειών χρήσης. Προς το παρόν, τα ακόλουθα περιβάλλοντα Power BI δεν υποστηρίζουν διαχείριση αδειών χρήσης ή επιβολή αδειών χρήσης:

  • Ενσωμάτωση - Δημοσίευση στο Web, Ενσωμάτωση PaaS
  • Εθνικά/Περιφερειακά cloud (Εξαρτάται από τη γενική υποστήριξη για τη δυνατότητα μεταμορφωσιμότητας σε εθνικά/περιφερειακά cloud)
  • Διακομιστής RS (Δεν υπάρχει προγραμματισμένη υποστήριξη)
  • Εξαγωγή (PDF\PPT) με χρήση του REST API

• isLicenseInfoAvailable - Υποδεικνύει εάν μπορούν να ανακτηθούν πληροφορίες αδειών χρήσης. Αποτυχία στην ανάκτηση αδειών χρήσης μπορεί να προκύψει σε περίπτωση που ο χρήστης του Power BI Desktop δεν έχει συνδεθεί ή δεν είναι συνδεδεμένος στο Internet (χωρίς σύνδεση). Για το Web, η ανάκτηση αδειών χρήσης μπορεί να αποτύχει λόγω προσωρινής διακοπής παροχής υπηρεσίας.

Παράδειγμα κλήσης getAvailableServicePlans (με χρήση του αναγνωριστικού υπηρεσίας από την παραπάνω εικόνα):

this.licenseManager.getAvailableServicePlans().then((result: LicenseInfoResult) => {
            this.notificationType = result.isLicenseUnsupportedEnv ?  powerbi.LicenseNotificationType.UnsupportedEnv : powerbi.LicenseNotificationType.General;
            this.hasServicePlans = !!(result.plans && result.plans.length && result.plans[0].spIdentifier == "test_isvconnect1599092224747.powerbivisualtransact.plan1" && 
                ( result.plans[0].state == powerbi.ServicePlanState.Active ||  result.plans[0].state == powerbi.ServicePlanState.Warning));
            
            // display notification if the user doesn't have licenses
            if (!this.hasServicePlans) {
                this.licenseManager.notifyLicenseRequired(this.notificationType).then((value) => {
                    if (value) {
                        this.isIconDisplayed = true;
                    }
                }).catch((err) => {
                    console.log('ERROR', err);
                })
            }
        }).catch((err) => {
            this.hasServicePlans = undefined;
            console.log(err);
        });

Ειδοποίηση του χρήστη ότι λείπουν οι απαιτούμενες άδειες χρήσης

Η πλατφόρμα Power BI παρέχει πολλές έτοιμες εμπειρίες που μπορούν να χρησιμοποιηθούν για την ειδοποίηση:

• Οι άδειες χρήσης θα πρέπει να αγοράζονται για να απολαύσετε τις πλήρεις δυνατότητες της απεικόνισης
• Η δυνατότητα συγκεκριμένης απεικόνισης αποκλείεται λόγω αδειών χρήσης που λείπουν
• Ολόκληρη η απεικόνιση αποκλείεται λόγω ελλιπών αδειών χρήσης
• Ολόκληρη η απεικόνιση αποκλείεται επειδή το περιβάλλον Power BI σε χρήση δεν υποστηρίζει διαχείριση αδειών χρήσης\επιβολή

export interface IVisualLicenseManager {
        notifyLicenseRequired(notificationType: LicenseNotificationType): IPromise<boolean>;
        notifyFeatureBlocked(tooltip: string): IPromise<boolean>;
        clearLicenseNotification(): IPromise<boolean>;
    }

Εικονίδιο "Γενικά" που υποδεικνύει ότι λείπει μια απαιτούμενη άδεια χρήσης

Χρησιμοποιήστε την κλήση με LicenseNotificationType.General για να εμφανίσετε notifyLicenseRequired ένα εικονίδιο ως μέρος του κοντέινερ της απεικόνισης.
Όταν ενεργοποιηθεί, το εικονίδιο θα διατηρηθεί κατά τη διάρκεια ζωής της απεικόνισης μέχρι clearLicenseNotification ή notifyLicenseRequired να κληθεί.

Σημείωμα

Η LicenseNotificationType.General ειδοποίηση επιβάλλεται μόνο όταν ισχύουν και οι δύο περιπτώσεις: υποστηρίζεται για σενάρια περιβάλλοντος παραχώρησης αδειών χρήσης και επεξεργασίας Power BI. Αυτή η κλήση σε ένα μη υποστηριζόμενο περιβάλλον ή όταν η αναφορά βρίσκεται σε λειτουργία ανάγνωσης ή σε πίνακα εργαλείων δεν θα εφαρμόσει το εικονίδιο και θα επιστρέψει false στην απόκριση της κλήσης.

Παράδειγμα της απεικόνισης που περιέχει το γενικό εικονίδιο "οι άδειες χρήσης απαιτούνται":

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

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

Παράδειγμα της εμφάνισης της απεικόνισης που περιέχει την ειδοποίηση αποκλεισμένη απεικόνιση. Το Power BI Desktop θα εμφανίσει μόνο την επιλογή Λήψη άδειας χρήσης :

Επικάλυψη της εμφάνισης της απεικόνισης με μια ειδοποίηση μη υποστηριζόμενου περιβάλλοντος

Χρησιμοποιήστε notifyLicenseRequired την κλήση με LicenseNotificationType.UnsupportedEnv για να επικαλύπτετε την εμφάνιση της απεικόνισης με μια ειδοποίηση ότι η απεικόνιση έχει αποκλειστεί, καθώς το Power BI σε χρήση δεν υποστηρίζει διαχείριση\επιβολή αδειών χρήσης.
Όταν ενεργοποιηθεί, το εικονίδιο θα διατηρηθεί κατά τη διάρκεια ζωής της απεικόνισης μέχρι clearLicenseNotification ή notifyLicenseRequired να κληθεί.

Σημείωμα

Η LicenseNotificationType.UnsupportedEnv ειδοποίηση επιβάλλεται μόνο όταν καλείται στο περιβάλλον μη υποστηριζόμενων για περιβάλλον παραχώρησης αδειών χρήσης. Αυτή η κλήση σε οποιοδήποτε άλλο περιβάλλον δεν θα εφαρμόσει την ειδοποίηση και θα επιστρέψει false στην απάντηση της κλήσης.

Παράδειγμα της απεικόνισης που περιέχει την ειδοποίηση "Μη υποστηριζόμενο περιβάλλον":

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

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

Σημείωμα

Η ειδοποίηση που είναι αποκλεισμένη επιβάλλεται μόνο όταν καλείται στο περιβάλλον που υποστηρίζεται για περιβάλλον παραχώρησης αδειών χρήσης και, σε περίπτωση που δεν εφαρμόζονται επικαλύψεις αποκλεισμού (LicenseNotificationType.UnsupportedEnv, LicenseNotificationType.VisualIsBlocked). Η κλήση αυτής της ειδοποίησης σε ένα μη υποστηριζόμενο περιβάλλον δεν θα εφαρμόσει την ειδοποίηση και θα επιστρέψει false στην απάντηση της κλήσης.

Σημείωμα

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

Όταν ενεργοποιηθεί, το πλαίσιο θα εμφανιστεί για 10 δευτερόλεπτα ή μέχρι να ενεργοποιηθεί ένα άλλο πλαίσιο "αποκλεισμένη δυνατότητα" ή μέχρι clearLicenseNotification να κληθεί (ό,τι έρχεται πρώτο).

Παράδειγμα της εμφάνισης της απεικόνισης που περιέχει την ειδοποίηση πλαισίου "αποκλεισμένη δυνατότητα":

Δοκιμή απεικόνισης με άδεια χρήσης

Για να δοκιμάσετε μια απεικόνιση με άδεια χρήσης, έως τέλους, πριν την καταστήσετε διαθέσιμη στο κοινό:

• Εάν δημιουργείτε μια ολοκαίνουργια προσφορά, προσθέστε την απεικόνιση ως ιδιωτικό πρόγραμμα για έναν δοκιμαστικό λογαριασμό πελάτη. Η προσφορά θα είναι ορατή μόνο σε αυτόν τον λογαριασμό δοκιμής για αγορά. Χρησιμοποιήστε αυτόν τον λογαριασμό για να επικυρώσετε την προσφορά προτού την δημοσιοποιήσετε.
• Εάν η απεικόνισή σας είναι ήδη διαθέσιμη στο AppSource και θέλετε να την αναβαθμίσετε σε μια απεικόνιση με άδεια χρήσης, δεν μπορείτε να την μετατρέψετε σε ιδιωτικό πρόγραμμα , επειδή αυτό θα αποκρύψει την απεικόνιση από το AppSource και οι υπάρχοντες χρήστες σας δεν θα έχουν πρόσβαση σε αυτή. Προς το παρόν δεν υπάρχει τρόπος δοκιμής μιας δημοσιευμένης απεικόνισης από άκρο σε άκρο. Δοκιμάστε την με τον ίδιο τρόπο που δοκιμάσατε την αρχική απεικόνιση στο AppSource, δοκιμάζοντας την τιμή API παραχώρησης αδειών χρήσης για να ελέγξετε τις διαφορετικές δυνατότητες.

Ζητήματα προς εξέταση και περιορισμοί

• Η συμβουλή εργαλείου για το πλαίσιο δυνατοτήτων περιορίζεται από 500 chars.
• Η συμβουλή εργαλείου για το πλαίσιο δυνατοτήτων απαιτεί τοπική προσαρμογή.
• Η συγκέντρωση αδειών χρήσης (δηλαδή μία άδεια χρήσης που καλύπτει πολλές προσφορές από τον ίδιο εκδότη) δεν υποστηρίζεται ακόμα.

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

Δημοσίευση προσαρμοσμένης απεικόνισης Power BI

Περισσότερες ερωτήσεις; Δοκιμάστε να ρωτήσετε τον Κοινότητα Power BI