Κοινοποίηση μέσω


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

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

Μπορείτε επίσης να χρησιμοποιήσετε μεταβλητές για να δημιουργήσετε λογικές παραστάσεις που δρομολογούν με δυναμικό τρόπο τον πελάτη σε διαφορετικές διαδρομές συνομιλίας. Για παράδειγμα, αποθηκεύστε το όνομα ενός πελάτη σε μια μεταβλητή με το όνομα "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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. Δημιουργήστε ένα νέο θέμα και ονομάστε το "Συζητήστε με τον πελάτη".

  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. Τέλος, επιλέξτε τη μεταβλητή για να διατηρήσετε την αναλυμένη τιμή. Συνήθως θα δημιουργούσατε μια νέα μεταβλητή.

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

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

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