Εργασία με μεταβλητές

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

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

Μπορείτε να διαβιβάσετε μεταβλητές και να τις επιστρέψετε από άλλα θέματα και ροές του Power Automate.

Δημιουργία μεταβλητής

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

Στιγμιότυπο οθόνης ενός κόμβου ερώτησης, με επισημασμένο το προεπιλεγμένο όνομα και τύπο της μεταβλητής.

Φιλοδώρημα

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

Δεν είναι δυνατή η μετονομασία κόμβων ενεργοποίησης και οι κόμβοι μετάβασης σε βήματα.

Τα ονόματα κόμβων μπορούν να έχουν μήκος έως 500 χαρακτήρες.

Πρέπει να επιλέξετε μια οντότητα

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

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

Μετονομασία μεταβλητής

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

  1. Επιλέξτε τη μεταβλητή. Εμφανίζεται ο πίνακας ιδιοτήτων μεταβλητών.

  2. Στην περιοχή Όνομα μεταβλητής, πληκτρολογήστε το όνομα που θέλετε για τη μεταβλητή σας.

Ορισμός μεταβλητής

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

  1. Επιλέξτε το εικονίδιο Προσθήκη κόμβου κάτω από τον κόμβο μετά από τον οποίο θέλετε να προσθέσετε έναν κόμβο Ορισμός τιμής μεταβλητής .

  2. Επιλέξτε Διαχείριση μεταβλητών>Ορίστε μια τιμή μεταβλητής. Εμφανίζεται ένας κόμβος Ορισμός τιμής μεταβλητής στον καμβά.

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

    • Εάν η μεταβλητή που θέλετε να ορίσετε υπάρχει ήδη, επιλέξτε την.

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

      Στιγμιότυπο οθόνης ενός κόμβου Ορισμός τιμής μεταβλητής με νέα μεταβλητή άγνωστου τύπου.

  4. Για την τιμή Προς, εκχωρήστε μια τιμή χρησιμοποιώντας μία από τις ακόλουθες επιλογές:

    • Πληκτρολογήστε μια τιμή λεκτικής σταθεράς.

    • Επιλέξτε μια υπάρχουσα μεταβλητή του ίδιου τύπου.

    • Χρησιμοποιήστε έναν τύπο Power Fx. Οι τύποι Power Fx είναι χρήσιμοι για πιο σύνθετους τύπους, όπου δεν μπορούν να χρησιμοποιηθούν τιμές λεκτικής σταθεράς, όπως οι τύποι πίνακα και καρτέλας.

Χρήση μεταβλητών σε κόμβους ενεργειών

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

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

Χρήση τιμών λεκτικής σταθεράς για εισόδους μεταβλητής

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

Στιγμιότυπο οθόνης που δείχνει τη χρήση μιας κυριολεκτικής τιμής για μια παράμετρο εισόδου μεταβλητής με όνομα productName.

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

Για ορισμένα σενάρια, όπως σενάρια που χρησιμοποιούν σύνθετους τύπους, ίσως χρειαστεί να χρησιμοποιήσετε έναν τύπο Power Fx για να ορίσετε έναν συγκεκριμένο τύπο.

Χρήση μεταβλητών περιβάλλοντος για μυστικούς Azure Key Vault

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

Για να δημιουργήσετε μια μεταβλητή μυστικού περιβάλλοντος στο Power Apps, πρέπει να ρυθμίσετε τις παραμέτρους ενός Key Vault Vault.

Για να εξουσιοδοτήσετε το Copilot Studio να διαβάσει αυτό το Key Vault Vault, ολοκληρώστε τις ακόλουθες ενέργειες:

  1. Εκχωρήστε τον ρόλο Χρήστης Key Vault Secrets στην εφαρμογή Υπηρεσία Microsoft Copilot Studio .

  2. Για να εξουσιοδοτήσετε σε όλους τους υπαλλήλους από το περιβάλλον να αποκτήσουν πρόσβαση στον μυστικό κωδικό, δημιουργήστε μια ετικέτα AllowedEnvironments στον μυστικό κωδικό και προσθέστε τα επιτρεπόμενα αναγνωριστικά περιβάλλοντος διαχωρισμένα με κόμματα.

  3. Για να εξουσιοδοτήσετε μόνο συγκεκριμένους παράγοντες από το περιβάλλον να χρησιμοποιήσουν αυτόν τον θάλαμο, δημιουργήστε μια ετικέτα AllowedAgents και τοποθετήστε το αναγνωριστικό παράγοντα στη μορφή {envId}/{schemaName}. Για πολλαπλές τιμές, διαχωρίστε τις τιμές με κόμματα.

    Εάν φτάσετε το μέγιστο αριθμό χαρακτήρων αλλά εξακολουθείτε να χρειάζεται να προσθέσετε περισσότερους παράγοντες, προσθέστε μια άλλη ετικέτα με ένα περιγραφικό αλλά μοναδικό όνομα (για παράδειγμα: AllowedAgents2).

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

Προειδοποίηση

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

Πίνακας μεταβλητών

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

Για να ανοίξετε τον πίνακα Μεταβλητές , επιλέξτε Μεταβλητές στη γραμμή μενού του θέματος.

Στιγμιότυπο οθόνης του πίνακα

Για κάθε μεταβλητή θέματος, μπορείτε να επιλέξετε αν μπορεί να λάβει την αξία της από άλλα θέματα, να επιστρέψει την αξία της σε άλλα θέματα ή και τα δύο. Μπορείτε επίσης να επιλέξετε μια μεταβλητή για να επεξεργαστείτε τις ιδιότητές της στον πίνακα Ιδιότητες Μεταβλητής.

Πίνακας ιδιοτήτων μεταβλητής

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

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

Μεταβιβάστε μεταβλητές μεταξύ θεμάτων

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

Λήψη τιμών από άλλα θέματα

Όταν ένα θέμα καθορίζει μια μεταβλητή (για παράδειγμα, από έναν κόμβο ερώτησης), ο παράγοντας ρωτάει το χρήστη για να συμπληρώσει την τιμή της μεταβλητής. Σε περίπτωση που ο παράγοντας έχει ήδη λάβει την τιμή σε προηγούμενο θέμα, δεν υπάρχει λόγος να κάνετε ξανά την ερώτηση. Σε αυτές τις περιπτώσεις, μπορείτε να ορίσετε τη μεταβλητή ως Λήψη τιμών από άλλα θέματα. Όταν ένα θέμα κάνει ανακατεύθυνση σε αυτήν, μπορεί να μεταβιβάσει είτε την τιμή μιας μεταβλητής (ή μια τιμή λεκτικής σταθεράς) σε αυτήν τη μεταβλητή και να παραλείψει την ερώτηση. Η εμπειρία του χρήστη που μιλάει στον παράγοντα είναι ομαλή.

Αυτό το παράδειγμα χρησιμοποιεί δύο θέματα: Χαιρετισμός και Ομιλία στον πελάτη. Και τα δύο θέματα ζητούν το όνομα του πελάτη. Ωστόσο, εάν εκτελείται πρώτα η θέμα Χαιρετισμός, το θέμα Μιλήστε στον πελάτη παραλείπει την ερώτησή του. Αντ' αυτού, χρησιμοποιεί την τιμή της μεταβλητής που μεταβιβάται από το θέμα Χαιρετισμός.

Ακολουθεί η ροή του θέματος Μιλήστε στον πελάτη:

Στιγμιότυπο οθόνης της ροής συνομιλίας του θέματος Μιλήστε στον πελάτη.

Όπως φαίνεται στον πίνακα δοκιμής, εάν αυτό το θέμα ενεργοποιείται πρώτα, ρωτά τον χρήστη, "Πώς πρέπει να σας ονομάσω;" Αποθηκεύει την τιμή σε μια μεταβλητή συμβολοσειράς με την ονομασία customerName. Η customerName μεταβλητή έχει οριστεί επίσης για να λάβει την αξία της από άλλα θέματα. Το θέμα ολοκληρώνεται με το μήνυμα "Ελπίζω να περνάς μια υπέροχη μέρα, customerName!"

Ακολουθεί η ροή του θέματος Χαιρετισμός:

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

Όπως φαίνεται στον πίνακα δοκιμής, εάν αυτό το θέμα ενεργοποιείται πρώτα, ρωτά τον χρήστη, "Ποιο είναι το όνομά σας;" Αποθηκεύει την τιμή σε μια μεταβλητή συμβολοσειράς με την ονομασία customerName. Το θέμα στέλνει το μήνυμα: «Χάρηκα για τη γνωριμία, customerName!» Στη συνέχεια, ανακατευθύνεται στο θέμα Μιλήστε με τον πελάτη, το οποίο στέλνει το μήνυμα, «Ελπίζω να έχεις μια υπέροχη μέρα, customerName!» Σημειώστε, ωστόσο, ότι το θέμα Μιλήστε με τον πελάτη παραλείπει να ζητήσει ξανά το όνομα του χρήστη. Αντί για αυτό, χρησιμοποίησε την τιμή της μεταβλητής customerName που μεταβιβάστηκε από το θέμα Χαιρετισμός .

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

Στιγμιότυπο οθόνης της ροής συνομιλίας του θέματος Μιλήστε στον πελάτη όταν ενεργοποιηθεί πρώτα το θέμα Χαιρετισμός.

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

Ρύθμιση του θέματος προορισμού

Το θέμα προορισμού λαμβάνει τιμές από άλλα θέματα. Σε αυτό το παράδειγμα, είναι Συζήτηση στον πελάτη.

  1. Δημιουργήστε ένα νέο θέμα και ονομάστε το "Talk to Customer".

  2. Προσθέστε φράσεις ενεργοποίησης όπως "επικοινωνήστε μαζί μου", "μιλήστε μαζί μου" και "συνομιλήστε μαζί μου".

  3. Προσθέστε έναν κόμβο ερώτησης και πληκτρολογήστε "Πώς πρέπει να σας αποκαλώ;" για το μήνυμα.

  4. Στην περιοχή Προσδιορισμός, επιλέξτε την προκατασκευασμένη οντότητα Όνομα προσώπου.

  5. Επιλέξτε το όνομα της μεταβλητής. Ανοίγει ο πίνακας ιδιοτήτων της μεταβλητής.

  6. Αντικαταστήστε το προεπιλεγμένο όνομα με customerNameκαι, στη συνέχεια, επιλέξτε Λήψη τιμών από άλλα θέματα.

    Στιγμιότυπο οθόνης του πίνακα

  7. Προσθέστε έναν κόμβο Μήνυμα.

  8. Στο πλαίσιο μηνύματος, πληκτρολογήστε "Ελπίζω να περνάτε μια υπέροχη μέρα, ".

  9. Επιλέξτε το εικονίδιο Εισαγωγής μεταβλητής ({x}) και, στη συνέχεια, επιλέξτε customerName.

  10. Επιλέξτε το διάστημα μετά τη μεταβλητή και εισαγάγετε ένα θαυμαστικό (!).

  11. Αποθηκεύστε το θέμα.

Ρυθμίστε το θέμα προέλευσης

Το θέμα προέλευσης είναι το θέμα που ανακατευθύνει σε ένα άλλο θέμα. Παρέχει την τιμή και την διαβιβάζει στο θέμα προορισμού. Σε αυτό το παράδειγμα, είναι Χαιρετισμός.

  1. Μεταβείτε στο θέμα Χαιρετισμός και διαγράψτε τους προεπιλεγμένους κόμβους, εκτός από τον κόμβο Έναυσμα.

  2. Προσθέστε έναν κόμβο ερώτησης και πληκτρολογήστε "Πώς σε λένε;" για το μήνυμα.

  3. Στην περιοχή Προσδιορισμός, επιλέξτε την προκατασκευασμένη οντότητα Όνομα προσώπου.

  4. Αντικαταστήστε το προεπιλεγμένο όνομα με customerNameFromGreeting.

  5. Προσθέστε έναν κόμβο Μήνυμα.

  6. Στο πλαίσιο μηνύματος, πληκτρολογήστε "Χαίρομαι που σας γνωρίζω, ".

  7. Επιλέξτε το εικονίδιο Εισαγωγής μεταβλητής ({x}) και, στη συνέχεια, επιλέξτε customerNameFromGreeting.

  8. Επιλέξτε το διάστημα μετά τη μεταβλητή και εισαγάγετε ένα θαυμαστικό (!).

  9. Προσθέστε έναν κόμβο Ανακατεύθυνσης και επιλέξτε το θέμα προορισμού Συνομιλία με τον πελάτη.

  10. Επιλέξτε Προσθήκη εισόδου, και έπειτα επιλέξτε τη μεταβλητή από το θέμα προορισμού στο οποίο θέλετε να μεταβιβάσετε μια τιμή.

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

  11. Επιλέξτε το > εικονίδιο και, στη συνέχεια, επιλέξτε τη μεταβλητή της οποίας την τιμή θέλετε να διαβιβάσετε, customerNameFromGreeting, σε αυτό το παράδειγμα.

    Ο κόμβος Ανακατεύθυνση θα πρέπει να έχει την εξής εμφάνιση:

    Στιγμιότυπο οθόνης του ολοκληρωμένου κόμβου ανακατεύθυνσης στο θέμα χαιρετισμού.

  12. Αποθηκεύστε το θέμα.

Επιστροφή τιμών στα αρχικά θέματα

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

Ας συνεχίσουμε με το παράδειγμα από την προηγούμενη ενότητα. Υποβάλετε μια νέα ερώτηση στο θέμα Συζήτηση στον πελάτη και, στη συνέχεια, επιστρέψτε την απάντηση στο θέμα Χαιρετισμός .

Ρύθμιση του θέματος προέλευσης για μια μεταβλητή που επιστρέφεται

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

  1. Μεταβείτε στο θέμα προέλευσης.

  2. Προσθέστε έναν κόμβο ερώτησης και πληκτρολογήστε "Σε ποια πόλη μένεις;" για το μήνυμα.

  3. Στην περιοχή Προσδιορισμός, επιλέξτε την προκατασκευασμένη οντότητα Πόλη.

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

    Στιγμιότυπο οθόνης του θέματος Συζήτηση με τον πελάτη με τη μεταβλητή customerCity και τις ιδιότητές της επισημασμένες.

  5. Προσθέστε έναν κόμβο Μήνυμα.

  6. Επιλέξτε το εικονίδιο Εισαγωγής μεταβλητής ({x}) και, στη συνέχεια, επιλέξτε customerCity.

  7. Μετά τη μεταβλητή στο πλαίσιο μηνύματος, πληκτρολογήστε "πρέπει να είναι όμορφη αυτή την εποχή του χρόνου!".

  8. Αποθηκεύστε το θέμα.

Ρύθμιση του θέματος προορισμού για μια μεταβλητή που επιστρέφεται

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

  1. Μεταβείτε στο θέμα προορισμού.

  2. Η μεταβλητή που επιλέξατε στο θέμα προέλευσης εμφανίζεται στον κόμβο Ανακατεύθυνση ως μεταβλητή εξόδου.

    Στιγμιότυπο οθόνης της ροής συνομιλίας του θέματος Χαιρετισμός με μια μεταβλητή που επιστρέφεται σε έναν κόμβο ανακατεύθυνσης.

  3. Αποθηκεύστε το θέμα.

Ανάλυση τιμών

Ο κόμβος τιμής ανάλυση μετατρέπει μια τιμή από έναν τύπο σε έναν άλλο. Μια συνηθισμένη περίπτωση χρήσης για τον κόμβο τιμής ανάλυσης είναι η μετατροπή ακατέργαστου JSON. Για παράδειγμα, ένας παράγοντας καλεί μια ροή που καλεί ένα API. Το API επιστρέφει ένα αποτέλεσμα. Χρειάζεστε έναν τρόπο να αναλύσετε αυτό το αποτέλεσμα και να επιστρέψετε μία ή περισσότερες στοιχειώδεις μεταβλητές. Χρησιμοποιώντας τον κόμβο τιμής Ανάλυση , μπορείτε να στείλετε ολόκληρο το αποτέλεσμα API ως συμβολοσειρά, όπως το εξής:

{
    "Name": "Parker",
    "Position": "Product manager",
    "Company": "Contoso",
    "FormerPositions": [{
            "Position": "Customer service representative"
        }
    ]
}

Ο κόμβος τιμής ανάλυσης μετατρέπει τη μεταβλητή συμβολοσειράς σε μια μεταβλητή τύπου Εγγραφή. Το πρόγραμμα επεξεργασίας Power Fx παρέχει ολοκλήρωση κώδικα IntelliSense και προτάσεις για αυτόν τον τύπο.

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

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

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

  1. Επιλέξτε το εικονίδιο Προσθήκη κόμβου κάτω από τον κόμβο, μετά από το οποίο θέλετε να αναλύσετε μια τιμή. Τοποθετήστε τον σημείο στη Διαχείριση μεταβλητών και επιλέξτε Ανάλυση τιμής.

  2. Προσθέστε έναν κόμβο ανάλυσης τιμής και επιλέξτε τη μεταβλητή που θέλετε να αναλύσετε.

    Στιγμιότυπο που δείχνει την επιλογή της μεταβλητής προς ανάλυση.

  3. Για τον τύπο δεδομένων, επιλέξτε Από δείγμα δεδομένων.

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

  4. Επιλέξτε Λήψη σχήματος από το Δείγμα JSON, εισαγάγετε το επιθυμητό παράδειγμα JSON στο πρόγραμμα επεξεργασίας που ανοίγει και επιλέξτε Επιβεβαίωση.

    Στιγμιότυπο οθόνης που εμφανίζει το πρόγραμμα επεξεργασίας όπου εισάγετε δείγμα δεδομένων JSON.

  5. Επιλέξτε τη μεταβλητή για να διατηρήσετε την αναλυμένη τιμή. Συνήθως, δημιουργείτε μια νέα μεταβλητή.

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

    Η μεταβλητή εξόδου έχει τώρα τον αναμενόμενο τύπο: εγγραφή.

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