Ενοποίηση του Power Automate με τοποθεσίες Web και εφαρμογές

Ενσωματώστε το Power Automate απευθείας στην εφαρμογή σας ή την τοποθεσία Web χρησιμοποιώντας γραφικά στοιχεία ροής για να παρέχετε στους χρήστες έναν απλό τρόπο να αυτοματοποιήσουν τις προσωπικές ή επαγγελματικές εργασίες τους.

Τα γραφικά στοιχεία ροής είναι iframe που βρίσκονται σε ένα κεντρικό έγγραφο. Αυτό το έγγραφο παραπέμπει σε μια σελίδα στο πρόγραμμα σχεδίασης του Power Automate. Αυτά τα γραφικά στοιχεία ενσωματώνουν συγκεκριμένη λειτουργικότητα του Power Automate στην εφαρμογή τρίτου μέρους.

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

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

  • Λογαριασμός Microsoft ή
  • Εταιρικός ή σχολικός λογαριασμός

Χρήση του γραφικού στοιχείου χωρίς έλεγχο ταυτότητας

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

Εμφάνιση των προτύπων για τα σενάριά σας

Για να ξεκινήσετε, προσθέστε αυτόν τον κώδικα για να εμφανίζονται τα πρότυπα Power Automate στην τοποθεσία Web σας:

<iframe src="https://flow.microsoft.com/{locale}/widgets/templates/?q={search term}
&pagesize={number of templates}&destination={destination}&category={category}"></iframe>
Παράμετρος Περιγραφή
locale Ο κωδικός τεσσάρων γραμμάτων γλώσσας και περιοχής για την προβολή προτύπου. Για παράδειγμα, το en-us αντιπροσωπεύει τα Αγγλικά Η.Π.Α. και το de-de αντιπροσωπεύει τα Γερμανικά.
search term Ο όρος αναζήτησης για τα πρότυπα που θέλετε να εμφανίζονται στην προβολή. Για παράδειγμα, αναζήτηση για SharePoint για να εμφανίζονται πρότυπα για SharePoint.
number of templates Ο αριθμός των προτύπων που θέλετε να εμφανίζονται στην προβολή.
destination Η σελίδα που ανοίγει όταν οι χρήστες επιλέγουν το πρότυπο. Πληκτρολογήστε details για να εμφανίσετε τις λεπτομέρειες σχετικά με το πρότυπο ή πληκτρολογήστε new για να ανοίξετε το πρόγραμμα σχεδίασης του Power Automate.
category Φιλτράρει τις κατηγορίες για τη συγκεκριμένη κατηγορία προτύπων.
parameters.{name} Πρόσθετο περιεχόμενο για μεταβίβαση στη ροή.

Εάν η παράμετρος προορισμού είναι new, το πρόγραμμα σχεδίασης του Power Automate ανοίγει όταν οι χρήστες επιλέγουν ένα πρότυπο. Οι χρήστες μπορούν, στη συνέχεια, να δημιουργήσουν μια ροή cloud στο πρόγραμμα σχεδίασης. Εάν θέλετε να εξασφαλίσετε την πλήρη εμπειρία από το γραφικό στοιχείο, ανατρέξτε στην επόμενη ενότητα.

Διαβίβαση πρόσθετων παραμέτρων στο πρότυπο ροής

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

  1. Ορίστε την παράμετρο στο πρότυπο ροής, πριν να το δημοσιεύσετε. Μια παράμετρος μοιάζει με @{parameters('parameter_name')}.
  2. Διαβιβάστε την παράμετρο στη συμβολοσειρά ερωτήματος της προέλευσης iframe. Για παράδειγμα, προσθέστε &parameters.listName={the name of the list} εάν έχετε μια παράμετρο που ονομάζεται listName.

Πλήρες δείγμα

Για να εμφανίσετε τα τέσσερα κύρια πρότυπα SharePoint στα Γερμανικά και για να ξεκινήσει ο χρήστης με το myCoolList, χρησιμοποιήστε αυτόν τον κώδικα:

<iframe src="https://flow.microsoft.com/de-de/widgets/templates/?q=sharepoint%20&pagesize=4&destination=details&parameters.listName=myCoolList"></iframe>

Χρήση των γραφικών στοιχείων ροής με έλεγχο ταυτότητας

Ο παρακάτω πίνακας εμφανίζει τη λίστα των γραφικών στοιχείων του Power Automate που υποστηρίζουν την πλήρη εμπειρία στο γραφικό στοιχείο χρησιμοποιώντας το διακριτικό πρόσβασης ελέγχου ταυτότητας χρήστη. Θα πρέπει να χρησιμοποιήσετε το Javascript Software Developer Kit (JS SDK) του Power Automate για να ενσωματώσετε τα γραφικά στοιχεία και να παράσχετε το απαιτούμενο διακριτικό πρόσβασης χρήστη.

Τύπος γραφικού στοιχείου Υποστηριζόμενη δυνατότητα
flows Εμφανίζει μια λίστα ροών σε μια καρτέλα για προσωπικές και κοινόχρηστες ροές. Μπορείτε να επεξεργαστείτε μια υπάρχουσα ροή ή να δημιουργήσετε μια νέα ροή από ένα πρότυπο ή από μια κενή ροή.
flowCreation Δημιουργεί μια ροή cloud από ένα αναγνωριστικό προτύπου που παρέχει η κεντρική εφαρμογή.
runtime Ενεργοποιεί μια ροή μη αυτόματου ή υβριδικού εναύσματος που παρέχει η κεντρική εφαρμογή.
approvalCenter Ενσωματώνει αιτήσεις έγκρισης και απεσταλμένες εγκρίσεις.
templates Εμφανίζει μια λίστα προτύπων. Ο χρήστης επιλέγει ένα για να δημιουργήσει μια νέα ροή.

Χρησιμοποιήστε το SDK Flow με έλεγχο ταυτότητας για να επιτρέψετε στους χρήστες να δημιουργούν και να διαχειρίζονται ροές απευθείας από την τοποθεσία Web ή την εφαρμογή (αντί για να πρέπει να μεταβούν στο Power Automate). Ο χρήστης θα πρέπει να εισέλθει με τον λογαριασμό Microsoft ή Azure Active Directory που διαθέτει, για να είναι δυνατή η χρήση του SDK με έλεγχο ταυτότητας.

Note

Δεν υπάρχει τρόπος για να αποκρύψετε την επωνυμία του Power Automate κατά τη χρήση γραφικών στοιχείων.

Αρχιτεκτονική γραφικού στοιχείου

Τα γραφικά στοιχεία του Power Automate λειτουργούν ενσωματώνοντας ένα iframe το οποίο αναφέρεται στο Power Automate σε μια κεντρική εφαρμογή. Ο κεντρικός υπολογιστής παρέχει το διακριτικό πρόσβασης που απαιτείται από το γραφικό στοιχείο του Power Automate. Η χρήση του JS SDK του Power Automate επιτρέπει στην κεντρική εφαρμογή να προετοιμάσει και να διαχειρίζεται τον κύκλο ζωής του γραφικού στοιχείου.

Διάγραμμα αρχιτεκτονικής γραφικού στοιχείου Power Automate.

Λεπτομέρειες JS SDK

Η ομάδα του Power Automate παρέχει το JS SDK για τη διευκόλυνση της ενσωμάτωσης γραφικών στοιχείων Flow σε εφαρμογές τρίτων. Το Flow JS SDK είναι διαθέσιμο ως δημόσια σύνδεση στην υπηρεσία Flow και επιτρέπει στην κεντρική εφαρμογή τον χειρισμό συμβάντων από το γραφικό στοιχείο και την αλληλεπίδραση με την εφαρμογή Flow με την αποστολή ενεργειών στο γραφικό στοιχείο. Τα συμβάντα και οι ενέργειες γραφικού στοιχείου αφορούν τον συγκεκριμένο τύπο γραφικού στοιχείου.

Προετοιμασία γραφικού στοιχείου

Η αναφορά στο Flow JS SDK πρέπει να προστεθεί στην κεντρική εφαρμογή πριν από την προετοιμασία του γραφικού στοιχείου.

<script src="https://flow.microsoft.com/Content/msflowsdk-1.1.js"></script>

Δημιουργήστε μια παρουσία JS SDK διαβιβάζοντας ένα προαιρετικό hostName και τιμές locale σε ένα αντικείμενο JSON.

var sdk = new MsFlowSdk({
    hostName:'https://flow.microsoft.com',
    locale:'en-US'
});
Ονομασία Απαιτείται/προαιρετικό Περιγραφή
hostName Προαιρετικό Όνομα κεντρικού υπολογιστή του Power Automate, για παράδειγμα, https://flow.microsoft.com
locale Προαιρετικό Οι τοπικές ρυθμίσεις του προγράμματος-πελάτη για το γραφικό στοιχείο (εάν δεν καθοριστούν, χρησιμοποιείται από προεπιλογή en-Us)

Μετά τη δημιουργία της παρουσίας του JS SDK μπορείτε να προετοιμάσετε και να ενσωματώσετε ένα γραφικό στοιχείο του Power Automate σε ένα γονικό στοιχείο στην κεντρική εφαρμογή. Για να το κάνετε αυτό, προσθέστε ένα HTML div:

<div id="flowDiv" class="flowContainer"></div>

Στη συνέχεια, προετοιμάστε το γραφικό στοιχείο Power Automate με τη μέθοδο JS SDK renderWidget(). Φροντίστε να καταχωρήσετε τον τύπο του γραφικού στοιχείου και τις αντίστοιχες ρυθμίσεις.

var widget = sdk.renderWidget('<widgettype>', {
        container: 'flowDiv',
        flowsSettings: {},
        templatesSettings: {},
        approvalCenterSettings: {},
        widgetStyleSettings: {}
});

Ακολουθεί ένα δείγμα στυλ για το κοντέινερ που μπορείτε να τροποποιήσετε ώστε να αντιστοιχεί με τις διαστάσεις της κεντρικής εφαρμογής.

<head>
    <style>
        .flowContainer iframe {
            width: 400px;
            height: 1000px;
            border: none;
            overflow: hidden;
    }
    </style>
</head>

Αυτές είναι οι παράμετροι για τη μέθοδο renderWidget():

Παράμετρος Απαιτείται/προαιρετικό Περιγραφή
container Υποχρεωτικό Το αναγνωριστικό ενός στοιχείου DIV στη σελίδα υποδοχής στην οποία θα ενσωματωθεί το γραφικό στοιχείο.
environmentId Προαιρετικό Τα γραφικά στοιχεία χρειάζονται ένα αναγνωριστικό περιβάλλοντος. Εάν δεν παράσχετε ένα αναγνωριστικό, χρησιμοποιείται ένα προεπιλεγμένο περιβάλλον.
flowsSettings Προαιρετικό Αντικείμενο ρυθμίσεων του Power Automate
templatesSettings Προαιρετικό Αντικείμενο ρυθμίσεων προτύπου
approvalCenterSettings Προαιρετικό Αντικείμενο ρυθμίσεων έγκρισης

Διακριτικά πρόσβασης

Μετά την εκτέλεση της μεθόδου JS SDK renderWidget(), το JS SDK προετοιμάζει ένα iframe που παραπέμπει στη διεύθυνση URL του γραφικού στοιχείου Power Automate. Αυτή η διεύθυνση URL περιέχει όλες τις ρυθμίσεις στις παραμέτρους της συμβολοσειράς ερωτήματος. Η κεντρική εφαρμογή πρέπει να λάβει ένα διακριτικό πρόσβασης Power Automate για τον χρήστη (διακριτικό JWT Azure Active Directory με κοινό https://service.flow.microsoft.com) προτού προετοιμάσει το γραφικό στοιχείο. Το γραφικό στοιχείο ενεργοποιεί ένα συμβάν GET_ACCESS_TOKEN για να ζητήσει διακριτικό πρόσβασης από τον κεντρικό υπολογιστή. Ο κεντρικός υπολογιστής πρέπει να χειριστεί το συμβάν και να διαβιβάσει το διακριτικό στο γραφικό στοιχείο:

widget.listen("GET_ACCESS_TOKEN", function(requestParam, widgetDoneCallback) {
    widgetDoneCallback(null, {
        token:  '<accesstokenFromHost>'
    });
});

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

Εξακρίβωση της ετοιμότητας του γραφικού στοιχείου

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

widget.listen("WIDGET_READY", function() {
    console.log("The flow widget is now ready.");
    // other host code on widget ready
});

Ρυθμίσεις γραφικού στοιχείου

FlowsSettings

Οι ρυθμίσεις FlowsSettings μπορούν να χρησιμοποιηθούν για να προσαρμόσετε τη λειτουργικότητα του γραφικού στοιχείου του Power Automate.

flowsSettings?: {
    createFromBlankTemplateId?: string;
    flowsFilter?: string;sc
    tab?: string;
};
Παράμετρος Απαιτείται/προαιρετικό Περιγραφή
createFromBlankTemplateId Υποχρεωτικό Χρήση του GUID του προτύπου, όταν ο χρήστης επιλέγει το κουμπί Δημιουργία από κενό στο γραφικό στοιχείο Flow
flowsFilter Προαιρετικό Το γραφικό στοιχείο του Power Automate εφαρμόζει το φίλτρο που παρέχεται κατά την παράθεση ροών. Για παράδειγμα, εμφανίζει τις ροές που αναφέρονται σε μια συγκεκριμένη τοποθεσία του SharePoint.
flowsFilter: "operations/any(operation: operation/sharepoint.site eq 'https://microsoft.sharepoint.com/teams/ProcessSimple' )"
tab Προαιρετικό Επαναφέρει στις προεπιλογές την ενεργή καρτέλα που θα εμφανίζεται στο γραφικό στοιχείο Power Automate.
Για παράδειγμα,
το tab:'sharedFlows' εμφανίζει την καρτέλα "Ομάδα"
ενώ το tab:'myFlows' εμφανίζει την καρτέλα "Οι ροές μου".

TemplatesSettings

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

templatesSettings?: {
    defaultParams?: any;
    destination?: string;
    pageSize?: number;
    searchTerm?: string;
    templateCategory?: string;
    useServerSideProvisioning?: boolean;
    enableDietDesigner?: boolean;
};
Παράμετρος Απαιτείται/προαιρετικό Περιγραφή
defaultParams Προαιρετικές Παράμετροι χρόνου σχεδίασης για χρήση κατά τη δημιουργία μιας ροής cloud από ένα πρότυπο, για παράδειγμα:
defaultParams: {'parameters.sharepoint.site': 'https://microsoft.sharepoint.com/teams/ProcessSimple', 'parameters.sharepoint.list': 'b3a5baa8-fe94-44ca-a6f0-270d9f821668' }
destination Προαιρετικές Οι έγκυρες τιμές είναι "new" ή "details". Όταν οριστεί σε «details», εμφανίζεται μια σελίδα λεπτομερειών κατά τη δημιουργία μιας ροής cloud από ένα πρότυπο.
pageSize Προαιρετικές Ο αριθμός των προτύπων για εμφάνιση. Προεπιλεγμένο μέγεθος = 6
searchTerm Προαιρετικό Εμφάνιση των προτύπων που συμφωνούν με τον παρεχόμενο όρο αναζήτησης
templateCategory Προαιρετικό Εμφάνιση των προτύπων σε μια συγκεκριμένη κατηγορία

ApprovalCenterSettings

Ισχύει για τα γραφικά στοιχεία ApprovalCenter.

approvalCenterSettings?: {
   approvalsFilter?: string;
   tab?: string;but
   showSimpleEmptyPage? boolean;
   hideLink?: boolean
};
Παράμετρος Απαιτείται/προαιρετικό Περιγραφή
hideLink Προαιρετικό Όταν οριστεί σε true, το γραφικό στοιχείο αποκρύπτει τις συνδέσεις για ληφθείσες και απεσταλμένες εγκρίσεις
approvalsFilter Προαιρετικές Το γραφικό στοιχείο έγκρισης θα εφαρμόσει το καθορισμένο φίλτρο έγκρισης κατά την παράθεση των εγκρίσεων, για παράδειγμα: το γραφικό στοιχείο έγκρισης θα εφαρμόσει το καθορισμένο φίλτρο έγκρισης κατά την παράθεση των εγκρίσεων, για παράδειγμα:
approvalsFilter: 'properties/itemlink eq \'https://microsoft.sharepoint.com/teams/ProcessSimple/_layouts/15/listform.aspx?PageType=4&ListId=737e30a6-5bc4-4e9c-bcdc-d34c5c57d938&ID=3&ContentTypeID=0x010010B708969A9C16408696FD23801531C6\''

approvalsFilter: 'properties/itemlinkencoded eq \'{Your base64 encoded item link url} \''
tab Προαιρετικό Η προεπιλεγμένη ενεργή καρτέλα που θα εμφανίζεται στο γραφικό στοιχείο Flow.
Οι έγκυρες τιμές είναι "receivedApprovals", "sentApprovals"
showSimpleEmptyPage Προαιρετικό Εμφανίζει μια κενή σελίδα όταν δεν υπάρχουν εγκρίσεις
hideInfoPaneCloseButton Προαιρετικό Αποκρύπτει το κουμπί κλεισίματος παραθύρου πληροφοριών (ή ο κεντρικός υπολογιστής έχει ήδη ένα κουμπί κλεισίματος)

Συμβάντα γραφικού στοιχείου

Το γραφικό στοιχείο του Power Automate υποστηρίζει συμβάντα που επιτρέπουν στον κεντρικό υπολογιστή να παρακολουθεί για συμβάντα του κύκλου ζωής του γραφικού στοιχείου. Το γραφικό στοιχείο του Power Automate υποστηρίζει δύο τύπους συμβάντων: συμβάντα μονόπλευρης ειδοποίησης (για παράδειγμα, Widget_Ready) και συμβάντα που ενεργοποιήθηκαν από το γραφικό στοιχείο για τη λήψη δεδομένων από τον κεντρικό υπολογιστή (Get_Access_Token). Ο κεντρικός υπολογιστής πρέπει να χρησιμοποιεί τη μέθοδο widget.listen() για να παρακολουθεί για συγκεκριμένα συμβάντα που ενεργοποιούνται από το γραφικό στοιχείο.

Χρήση

widget.listen("<WIDGET_EVENT>", function() {
    console.log("The flow widget raised event");
});

Υποστηριζόμενα συμβάντα κατά τύπο γραφικού στοιχείου

Συμβάν γραφικού στοιχείου Λεπτομέρειες
WIDGET_READY Το γραφικό στοιχείο φορτώθηκε με επιτυχία
WIDGET_RENDERED Το γραφικό στοιχείο φορτώθηκε και η απόδοση του περιβάλλοντος εργασίας χρήστη ολοκληρώθηκε
GET_ACCESS_TOKEN Αίτηση γραφικού στοιχείου για ενσωμάτωση διακριτικού πρόσβασης χρήστη
GET_STRINGS Επιτρέπει στον κεντρικό υπολογιστή να παρακάμψει ένα σύνολο συμβολοσειρών περιβάλλοντος εργασίας χρήστη που εμφανίζονται στο γραφικό στοιχείο

Γραφικό στοιχείο περιβάλλοντος εκτέλεσης

Συμβάν γραφικού στοιχείου Λεπτομέρειες Δεδομένα
RUN_FLOW_STARTED Ενεργοποιήθηκε και η εκτέλεση ροής εκκινήθηκε
RUN_FLOW_COMPLETED Η εκτέλεση ροής ενεργοποιήθηκε με επιτυχία
RUN_FLOW_DONE_BUTTON_CLICKED Ο χρήστης επέλεξε το κουμπί "Τέλος" στην εκτέλεση ροής
RUN_FLOW_CANCEL_BUTTON_CLICKED Ο χρήστης επέλεξε το κουμπί "Άκυρο" στην εκτέλεση ροής
FLOW_CREATION_SUCCEEDED Η ροή δημιουργήθηκε με επιτυχία { flowUrl: string, flowId: string, fromTemplate: string }
WIDGET_CLOSE Ενεργοποιείται όταν ο κεντρικός υπολογιστής πρέπει να κλείσει το γραφικό στοιχείο

Γραφικό στοιχείο δημιουργίας ροής

Συμβάν γραφικού στοιχείου Λεπτομέρειες Δεδομένα
FLOW_CREATION_FAILED Η δημιουργία ροής απέτυχε
WIDGET_CLOSE Ενεργοποιείται όταν ο κεντρικός υπολογιστής πρέπει να κλείσει το γραφικό στοιχείο
TEMPLATE_LOAD_FAILED Η φόρτωση του προτύπου απέτυχε
FLOW_CREATION_SUCCEEDED Η ροή δημιουργήθηκε με επιτυχία { flowUrl: string, flowId: string,fromTemplate?: string }

Γραφικό στοιχείο έγκρισης

Συμβάν γραφικού στοιχείου Λεπτομέρειες
RECEIVED_APPROVAL_STATUS_CHANGED Η κατάσταση έγκρισης που λήφθηκε άλλαξε
SENT_APPROVAL_STATUS_CHANGED Η κατάσταση έγκρισης που στάλθηκε άλλαξε

Το συμβάν GET_STRINGS σάς επιτρέπει να προσαρμόσετε το κείμενο για ορισμένα από τα στοιχεία περιβάλλοντος εργασίας χρήστη που εμφανίζονται στο γραφικό στοιχείο. Μπορείτε να προσαρμόσετε τις ακόλουθες συμβολοσειρές:

Κλειδί συμβολοσειράς Χρήση στο γραφικό στοιχείο
FLOW_CREATION_CREATE_BUTTON Κείμενο που εμφανίζεται στο κουμπί δημιουργίας ροής στο γραφικό στοιχείο δημιουργίας ροής και περιβάλλοντος εκτέλεσης
FLOW_CREATION_CUSTOM_FLOW_NAME Η αρχική τιμή που θα χρησιμοποιηθεί για το όνομα της ροής στο γραφικό στοιχείο δημιουργίας ροής. Χρησιμοποιείται μόνο όταν είναι ενεργοποιημένη η ρύθμιση allowCustomFlowName.
FLOW_CREATION_HEADER Κεφαλίδα για χρήση κατά τη δημιουργία μιας ροής cloud στο γραφικό στοιχείο δημιουργίας ροής και περιβάλλοντος εκτέλεσης
INVOKE_FLOW_HEADER Κεφαλίδα για χρήση κατά την κλήση μιας ροής cloud στο γραφικό στοιχείο περιβάλλοντος εκτέλεσης
INVOKE_FLOW_RUN_FLOW_BUTTON Το κείμενο που εμφανίζεται στο κουμπί που χρησιμοποιείται για την κλήση/εκτέλεση μιας ροής cloud στο γραφικό στοιχείο περιβάλλοντος εκτέλεσης

Παράδειγμα

Καλέστε το widgetDoneCallback διαβιβάζοντας ένα αντικείμενο JSON με ζεύγη κλειδιού-τιμής κλειδιού συμβολοσειράς και κειμένου για την παράκαμψη της προεπιλεγμένης τιμής.

widget.listen("GET_STRINGS", function(requestParam, widgetDoneCallback) {
    widgetDoneCallback(null, {
         "FLOW_CREATION_HEADER": "<string override would go here>",
        "INVOKE_FLOW_RUN_FLOW_BUTTON":  "<string override would go here>"
    });
});

Ενέργειες γραφικού στοιχείου

Ο κεντρικός υπολογιστής χρησιμοποιεί ενέργειες γραφικού στοιχείου για την αποστολή μιας συγκεκριμένης ενέργειας ή μηνύματος στο γραφικό στοιχείο. Το JS SDK του γραφικού στοιχείου παρέχει τη μέθοδο notify() για να στείλει ένα μήνυμα ή ένα ωφέλιμο φορτίο JSON στο γραφικό στοιχείο. Κάθε ενέργεια γραφικού στοιχείου υποστηρίζει μια συγκεκριμένη υπογραφή ωφέλιμου φορτίου.

Χρήση

widget.notify('<WIDGET_ACTION>', parameterMatchingParameterInterface)
    .then(result => console.log(result))
    .catch(error => console.log(error))

Παράδειγμα

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

widget.notify('triggerFlow', { flowName: flowName, implicitData:implicitData });

Γραφικό στοιχείο περιβάλλοντος εκτέλεσης

Ενέργεια γραφικού στοιχείου Details Διασύνδεση παραμέτρου
triggerFlow Ενεργοποιεί μια εκτέλεση ροής cloud { flowName: string, implicitData?: string }
triggerFlowByTemplate Ενεργοποιεί μια εκτέλεση ροής cloud από πρότυπο { templateId: string, implicitData?: string, designTimeParameters?: Record<string, any> }
getTriggerSchema Λαμβάνει το σχήμα εναύσματος για μια ροή cloud { flowName: string, }
closeWidget Ακυρώνει τυχόν εκκρεμείς δραστηριότητες και ενεργοποιεί ένα συμβάν WIDGET_CLOSE

Γραφικό στοιχείο δημιουργίας ροής

Ενέργεια γραφικού στοιχείου Details Διασύνδεση παραμέτρου
createFlowFromTemplate Δημιουργεί μια ροή cloud για το επιλεγμένο πρότυπο { templateName: string, designTimeParameters?: Record<string, any> }
createFlowFromTemplateDefinition Δημιουργεί μια ροή cloud για τον επιλεγμένο ορισμό προτύπου { templateDefinition: string }
closeWidget Ακυρώνει τυχόν εκκρεμείς δραστηριότητες και ενεργοποιεί ένα συμβάν WIDGET_CLOSE

Γραφικό στοιχείο έγκρισης

Ενέργεια γραφικού στοιχείου Λεπτομέρειες Διασύνδεση παραμέτρου
closeInfoPane Κλείνει το τμήμα παραθύρου πληροφοριών που εμφανίζει τις λεπτομέρειες έγκρισης Δ/Υ

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

Θα χρειαστεί να ρυθμίσετε τις παραμέτρους της εφαρμογής-πελάτη σας με εμβέλειες υπηρεσίας Flow (δικαιώματα με ανάθεση). Εάν η εφαρμογή Azure Active Directory (AAD) που χρησιμοποιείται για την ενοποίηση του γραφικού στοιχείου χρησιμοποιεί μια ροή ελέγχου ταυτότητας "εκχώρησης κώδικα", η εφαρμογή AAD πρέπει να ρυθμιστεί εκ των προτέρων με δικαιώματα με ανάθεση που υποστηρίζονται από το Power Automate. Αυτό παρέχει δικαιώματα με ανάθεση που επιτρέπουν στην εφαρμογή να εκτελεί τα εξής:

  • Διαχείριση εγκρίσεων
  • Ανάγνωση εγκρίσεων
  • Ανάγνωση δραστηριοτήτων
  • Διαχείριση ροών
  • Ανάγνωση ροών

Ακολουθήστε τα παρακάτω βήματα για να επιλέξετε ένα ή περισσότερα δικαιώματα με ανάθεση:

  1. Μετάβαση στο https://portal.azure.com
  2. Επιλέξτε το στοιχείο Azure Active Directory.
  3. Επιλέξτε Καταχωρήσεις εφαρμογών στην περιοχή Διαχείριση.
  4. Εισαγάγετε την εφαρμογή τρίτου που πρέπει να ρυθμιστεί για εμβέλειες υπηρεσίας Flow.
  5. Επιλέξτε Ρυθμίσεις. Στιγμιότυπο οθόνης που εντοπίζει το εικονίδιο ρυθμίσεων για την εφαρμογή.
  6. Επιλέξτε Απαιτούμενα δικαιώματα στην περιοχή Πρόσβαση API/
  7. Επιλέξτε Προσθήκη.
  8. Κάντε κλικ στο στοιχείο Επιλέξτε API. Στιγμιότυπο οθόνης που εντοπίζει απαιτούμενα δικαιώματα, προσθέστε και επιλέξτε μια διεύθυνση API.
  9. Αναζητήστε και επιλέξτε την υπηρεσία Power Automate. Σημείωση: Για να μπορέσετε να εντοπίσετε την υπηρεσία Power Automate, ο μισθωτής σας πρέπει να έχει τουλάχιστον έναν χρήστη AAD συνδεδεμένο στην πύλη Flow (https://flow.microsoft.com)
  10. Επιλέξτε τις απαιτούμενες εμβέλειες Flow για την εφαρμογή σας και, στη συνέχεια, επιλέξτε Αποθήκευση. Στιγμιότυπο οθόνης που δείχνει τα δικαιώματα που έχουν ανατεθεί.

Η εφαρμογή σας θα λάβει ένα διακριτικό υπηρεσίας Flow που περιέχει δικαιώματα με ανάθεση στον ισχυρισμό 'scp' στο διακριτικό JWT.

Δείγμα εφαρμογής με ενσωμάτωση γραφικών στοιχείων ροής

Στην ενότητα των πόρων παρέχεται ένα δείγμα JavaScript Single Page Application (SPA), ώστε να μπορέσετε να πειραματιστείτε με την ενσωμάτωση γραφικών στοιχείων ροής σε μια σελίδα υποδοχής. Η χρήση του δείγματος εφαρμογής απαιτεί καταχώρηση μιας εφαρμογής AAD με ενεργοποιημένη τη ροή έμμεσης εκχώρησης.

Καταχώρηση μιας εφαρμογής AAD

  1. Εισέλθετε στην Πύλη Azure.
  2. Στο αριστερό τμήμα παραθύρου περιήγησης, επιλέξτε Azure Active Directory και, στη συνέχεια, επιλέξτε Καταχωρήσεις εφαρμογών (Προεπισκόπηση) > Νέα καταχώρηση.
  3. Όταν εμφανιστεί η σελίδα Καταχώρηση μιας εφαρμογής, πληκτρολογήστε ένα όνομα για την εφαρμογή σας.
  4. Στην περιοχή Υποστηριζόμενοι τύποι λογαριασμού, επιλέξτε Λογαριασμοί σε οποιονδήποτε κατάλογο οργανισμού.
  5. Στην ενότητα Διεύθυνση URL ανακατεύθυνσης, επιλέξτε την πλατφόρμα web και ορίστε την τιμή για τη διεύθυνση URL της εφαρμογής' με βάση τον διακομιστή web. Ρυθμίστε τις παραμέτρους αυτής της τιμής σε http://localhost:30662/ για την εκτέλεση του δείγματος εφαρμογής.
  6. Επιλέξτε Καταχώρηση.
  7. Στη σελίδα Επισκόπηση της εφαρμογής, σημειώστε την τιμή του αναγνωριστικού της εφαρμογής (πελάτη).
  8. Το δείγμα απαιτεί να είναι ενεργοποιημένη η ροή έμμεσης εκχώρησης. Στο αριστερό τμήμα παραθύρου περιήγησης της καταχωρημένης εφαρμογής, επιλέξτε Έλεγχος ταυτότητας.
  9. Στις Ρυθμίσεις για προχωρημένους, στην περιοχή Έμμεση εκχώρηση, επιλέξτε τα πλαίσια ελέγχου Διακριτικά αναγνωριστικού και Διακριτικά πρόσβασης. Τα διακριτικά αναγνωριστικού και διακριτικά πρόσβασης απαιτούνται δεδομένου ότι αυτή η εφαρμογή πρέπει να συνδέει τους χρήστες και να καλεί το Flow API.
  10. Επιλέξτε Αποθήκευση.

Εκτέλεση του δείγματος

  1. Κάντε λήψη του δείγματος και αντιγράψτε το σε έναν τοπικό φάκελο στη συσκευή σας.
  2. Ανοίξτε το αρχείο index.html στον φάκελο FlowSDKSample και τροποποιήστε το applicationConfig για να ενημερώσετε το clientID με το αναγνωριστικό εφαρμογής που καταχωρήσατε προηγουμένως. Στιγμιότυπο οθόνης του αρχείου htmal dot ευρεητρίου που εντοπίζει το αναγνωριστικό προγράμματος-πελάτη.
  3. Το δείγμα εφαρμογής έχει ρυθμιστεί ώστε να χρησιμοποιεί τις εμβέλειες Flow Flows.Read.All και Flow.Manage.All. Μπορείτε να ρυθμίσετε πρόσθετες εμβέλειες, ενημερώνοντας την ιδιότητα flowScopes στο αντικείμενο applicationConfig.
  4. Εκτελέστε αυτές τις εντολές για να εγκαταστήσετε την εξάρτηση και να εκτελέσετε το δείγμα εφαρμογής:

    > npm install > node server.js

  5. Ανοίξτε το πρόγραμμα περιήγησης και, στη συνέχεια, πληκτρολογήστε http://localhost:30662
  6. Επιλέξτε το κουμπί Είσοδος για να ολοκληρώσετε τον έλεγχο ταυτότητας για το AAD και να αποκτήσετε ένα διακριτικό πρόσβασης ροής cloud.
  7. Το πλαίσιο κειμένου Διακριτικό πρόσβασης περιέχει το διακριτικό πρόσβασης. Στιγμιότυπο οθόνης που δείχνει πλαίσιο διακριτικού πρόσβασης που περιέχει διακριτικό πρόσβασης.
  8. Επιλέξτε Φόρτωση γραφικού στοιχείου ροών ή Φόρτωση γραφικού στοιχείου προτύπων για να ενσωματώσετε τα αντίστοιχα γραφικά στοιχεία. Στιγμιότυπο οθόνης που δείχνει κουμπιά για ενσωμάτωσν του γραφικού στοιχείου Φόρτωση ροών ή το γραφικό στοιχείο Φόρτωση προτύπων.

Σύνδεση λήψης δείγματος εφαρμογής.

Πόροι

Δοκιμαστικές σελίδες γραφικού στοιχείου

Μάθετε περισσότερα σχετικά με την ενοποίηση και τις ρυθμίσεις γραφικών στοιχείων:

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

Αν δεν αναφέρονται οι τοπικές ρυθμίσεις της προετοιμασίας, το Flow θα ορίσει από προεπιλογή τις πλησιέστερες υποστηριζόμενες τοπικές ρυθμίσεις.

Τοπικές ρυθμίσεις Language
bg-bg Βουλγαρικά (Βουλγαρίας)
ca-es Καταλανικά (Καταλανίας)
cs-cz Τσεχικά (Δημοκρατία της Τσεχίας)
da-dk Δανικά (Δανίας)
de-de Γερμανικά (Γερμανίας)
el-gr Ελληνικά (Ελλάδας)
en-Us Αγγλικά (Ηνωμένων Πολιτειών)
es-es Ισπανικά (Καστιλιάνικα)
et-ee Εσθονικά (Εσθονίας)
eu-es Βασκικά (Χώρας των Βάσκων)
fi-fi Φινλανδικά (Φινλανδίας)
fr-fr Γαλλικά (Γαλλίας)
gl-es Γαλικία (Γαλικίας)
hi-HU Ουγγρικά (Ουγγαρίας)
hi-in Χίντι (Ινδίας)
hr-hr Κροατικά (Κροατία)
id-Id Ινδονησιακά (Ινδονησίας)
it-It Ιταλικά (Ιταλίας)
jp-Jp Ιαπωνικά (Ιαπωνίας)
kk-kz Καζακικά (Καζαχστάν )
ko-kr Κορεατικά (Κορέας)
lt-LT Λιθουανικά (Λιθουανίας)
lv-lv Λετονία (Λετονίας)
ms-my Μαλαϊκά (Μαλαισίας)
nb-no Νορβηγικά (Bokmål)
nl-nl Ολλανδικά (Κάτω Χωρών)
pl-pl Πολωνικά (Πολωνίας)
pt-br Πορτογαλικά (Βραζιλίας)
pt-pt Πορτογαλικά (Πορτογαλίας)
ro-ro Ρουμανικά (Ρουμανίας)
ru-ru Ρωσικά (Ρωσίας)
sk-sk Σλοβακικά (Σλοβακίας)
sl-si Σλοβενικά(Σλοβενίας)
sr-cyrl-rs Σερβικά (Κυριλλικά, Σερβίας)
sr-latn-rs Σερβικά (Λατινικά, Σερβίας)
sv-se Σουηδικά (Σουηδίας)
th-th Ταϊλανδικά (Ταϊλάνδης)
tr-tr Τουρκικά (Τουρκίας)
uk-ua Ουκρανικά (Ουκρανίας)
vi-vn Βιετναμικά (Βιετνάμ)

Η χρήση του SDK ενσωμάτωσης Power Automate καλύπτεται από τους Όρους άδειας χρήσης λογισμικού της Microsoft.

Note

Μπορείτε να μας πείτε ποια γλώσσα προτιμάτε για την τεκμηρίωση; Πάρτε μέρος σε μια σύντομη έρευνα. (σημειώνεται ότι αυτή η έρευνα είναι στα Αγγλικά)

Η έρευνα θα διαρκέσει περίπου επτά λεπτά. Δεν συλλέγονται προσωπικά δεδομένα (δήλωση προστασίας προσωπικών δεδομένων).

  • Last updated on