Κοινή χρήση μέσω

Επαναχρησιμοποίηση μεταβλητών σε θέματα

  • Άρθρο

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

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

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

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

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

Δημιουργείτε μια καθολική μεταβλητή αλλάζοντας το πεδίο μιας μεταβλητής θέματος.

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

  2. Στον πίνακα Ιδιότητες μεταβλητής, επιλέξτε Παγκόσμιο (οποιοδήποτε θέμα μπορεί να προσπελαστεί).

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

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

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

Χρήση καθολικών μεταβλητών

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

Εύρεση όλων των θεμάτων με τη χρήση καθολικής μεταβλητής

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

  1. Επιλέξτε την επιθυμητή καθολική μεταβλητή στον καμβά σύνταξης ή στον πίνακα Μεταβλητές.

  2. Στον πίνακα ιδιοτήτων μεταβλητής, στην ενότητα Αναφορά, επιλέξτε Προβολή όλων των αναφορών.

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

Κύκλος ζωής καθολικών μεταβλητών

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

Ορισμός της τιμής μιας καθολικής μεταβλητής από εξωτερικές πηγές

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

  1. Επιλέξτε μια καθολική μεταβλητή.

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

Καθορισμός καθολικών μεταβλητών σε ενσωματωμένο παράγοντα

Εάν ενσωματώσετε τον παράγοντα σας σε μια απλή ιστοσελίδα, μπορείτε να προσαρτήσετε μεταβλητές και τους ορισμούς τους στη διεύθυνση URL του παράγοντα. Εναλλακτικά, αν θέλετε λίγο περισσότερο έλεγχο, μπορείτε να χρησιμοποιήσετε ένα μπλοκ κώδικα <script> για να καλέσετε και να χρησιμοποιήσετε μεταβλητές μέσω προγραμματισμού.

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

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

Προσαρτήστε τις μεταβλητές και τους ορισμούς τους στη διεύθυνση URL του παράγοντα ως παραμέτρους συμβολοσειράς ερωτήματος με τη μορφή του botURL?variableName1=variableDefinition1&variableName2=variableDefinition2.

Για παράδειγμα:

Το όνομα της παραμέτρου έχει διάκριση πεζών-κεφαλαίων. Το username=Ana θα λειτουργούσε επίσης σε αυτό το παράδειγμα.

Προσθέσετε καθολικές μεταβλητές σε έναν προσαρμοσμένο καμβά

Μπορείτε επίσης να προσθέσετε τη μεταβλητή σε έναν προσαρμοσμένο καμβά.

  1. Στην ενότητα <script> στη σελίδα όπου έχετε το παράγοντα, καθορίστε τις μεταβλητές ως εξής, αντικαθιστώντας το variableName1 για το όνομα της μεταβλητής χωρίς πρόθεμα Global. και το variableDefinition1 για τον ορισμό. Χωρίστε πολλές μεταβλητές με κόμματα (,).

       const store = WebChat.createStore({}, ({ dispatch }) => next => action => {
     if (action.type === 'DIRECT_LINE/CONNECT_FULFILLED') {
       dispatch({
          type: "WEB_CHAT/SEND_EVENT",
          payload: {
            name: "pvaSetContext",
            value: {
               "variableName1": "variableDefinition1",
               "variableName2": "variableDefinition2"
            }
          },
        });
      }
        return next(action);
    });

  2. Στην ενότητα <script>, καλέστε το store όταν ενσωματώσετε τον παράγοντα σας όπως στο παρακάτω παράδειγμα, όπου το store καλείται ακριβώς πριν από το σημείο που καλείται το styleOptions ( θα πρέπει να αντικαταστήσετε το BOT_ID με το αναγνωριστικό παράγοντα):

    const BOT_ID = "12345-5678";
const theURL = "https://powerva.microsoft.com/api/botmanagement/v1/directline/directlinetoken?botId=" + BOT_ID;

fetch(theURL)
    .then(response => response.json())
    .then(conversationInfo => {
        window.WebChat.renderWebChat(
            {
                directLine: window.WebChat.createDirectLine({
                    token: conversationInfo.token,
                }),
                store,
                styleOptions
            },
            document.getElementById('webchat')
        );
    })
    .catch(err => console.error("An error occurred: " + err));

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