Δημιουργία διαδρομής

Ισχύει για: Dynamics 365 Customer Insights

Σημείωμα

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

Χρησιμοποιήστε αυτήν τη δυνατότητα όταν έχετε έναν πλήρη ορισμό διαδρομής Customer Insights και θέλετε να επικυρώσετε και να δημιουργήσετε τη διαδρομή στο Dataverse.

Τι κάνει

Αυτή η δυνατότητα επικυρώνει το παρεχόμενο JSON διαδρομής, το εμπλουτίζει με μετα-δεδομένα Customer Insights, επικυρώνει τον εμπλουτισμένο ορισμό και δημιουργεί μια καρτέλα διαδρομής μόνο όταν η επικύρωση είναι επιτυχής. Επιστρέφει το δημιουργημένο αναγνωριστικό διαδρομής και το αποτέλεσμα επικύρωσης. Ο ορισμός εμπλουτισμένης διαδρομής και οι τροποποιημένες ιδιότητες δεν περιλαμβάνονται στην απόκριση ορατής μοντελοποίησης.

Η δημιουργία της καρτέλας δεν δημοσιεύει ούτε ξεκινά τη διαδρομή. Εξετάστε τη διαδρομή που δημιουργήθηκε στο Customer Insights πριν από την ενεργοποίηση.

Δοκιμάστε προτροπές όπως

• Δημιουργήστε μια διαδρομή Customer Insights από αυτό το JSON πλήρους διαδρομής.
• Επικυρώστε, εμπλουτίστε και δημιουργήστε αυτόν τον ορισμό ταξιδιού μίας χρήσης.
• Δημιουργήστε αυτό το ταξίδι αφού ελέγξετε ότι η σύμβασή του είναι έγκυρη.

Τι θα δείτε στη συνομιλία

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

Χρήσιμες συμβουλές

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

Τι συμβαίνει στη συνέχεια

Ανοίξτε τη διαδρομή που δημιουργήθηκε στο Customer Insights για να εξετάσετε το κοινό, το περιεχόμενο, το χρονοδιάγραμμα, τις ρυθμίσεις συγκατάθεσης και την ετοιμότητα ενεργοποίησης.

Αλλάζει αυτό τα δεδομένα;

Ναι. Αυτή η δυνατότητα δημιουργεί μια καρτέλα διαδρομής Customer Insights.

Η επιχείρηση δεν είναι ανίκανη. Η επανάληψη του ίδιου αιτήματος μπορεί να δημιουργήσει μια άλλη διαδρομή. Δεν δημοσιεύει, δεν ενεργοποιεί ή δεν στέλνει τη διαδρομή.

Προαπαιτούμενα

Αυτό το εργαλείο είναι διαθέσιμο στον διακομιστή Dynamics 365 Customer Insights MCP. Οι διαδρομές Customer Insights πρέπει να παρέχονται για το επιλεγμένο περιβάλλον. Χρειάζεστε δικαιώματα για να εκτελέσετε τα API επικύρωσης και εμπλουτισμού διαδρομής και να δημιουργήσετε καρτέλες διαδρομής. Το JSON διαδρομής πρέπει να αναφέρεται σε έγκυρο κοινό, περιεχόμενο, συμμόρφωση και σχετικά αναγνωριστικά για συγκεκριμένο περιβάλλον.

Σύνοψη εργαλείου

Ιδιοκτησία	Τιμή
Όνομα χρήστη	Δημιουργία διαδρομής
Όνομα εσωτερικού εργαλείου	create_journey
Σκοπός	Επικυρώνει, εμπλουτίζει, επικυρώνει ξανά και δημιουργεί μια καρτέλα διαδρομής Customer Insights

Συμπεριφορά εργαλείου

Καλεί το API επικύρωσης διαδρομής Customer Insights, εμπλουτίζει τον αποδεκτό ορισμό, επικυρώνει τον εμπλουτισμένο ορισμό και δημιουργεί την καρτέλα που προκύπτει msdynmkt_journey . Οι αποτυχίες επικύρωσης επιστρέφουν χωρίς τη δημιουργία καρτέλας.

Σχολιασμούς

Σχόλια	Τιμή	Έννοια
readOnlyHint	false	Δημιουργεί μια καρτέλα διαδρομής.
destructiveHint	false	Δημιουργεί μια καρτέλα, αλλά δεν διαγράφει ή αντικαθιστά μια υπάρχουσα διαδρομή.
idempotentHint	false	Η επανάληψη μιας επιτυχημένης αίτησης μπορεί να δημιουργήσει μια άλλη διαδρομή.
openWorldHint	Δεν έχει οριστεί	Χρησιμοποιεί την προεπιλογή επειδή καλεί API Customer Insights μέσω του Dataverse.

Έννοιες εισόδου

Δεδομένα εισόδου	Περιγραφή	Υποχρεωτικό
journeyJson	Ολοκληρώστε τον ορισμό διαδρομής Customer Insights σειριακοποιημένο ως JSON.	Ναι
shouldValidateContract	Εάν και οι δύο κλήσεις επικύρωσης θα πρέπει να επικυρώνουν τη σύμβαση ταξιδιού. Η προεπιλογή είναι true.	Όχι

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

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

Τύπος απόκρισης

Αποτέλεσμα δημιουργίας ταξιδιού.

Η απόκριση περιέχει το αναγνωριστικό διαδρομής που δημιουργήθηκε και το αποτέλεσμα επικύρωσης. Δεν εκθέτει το ωφέλιμο φορτίο JSON εμπλουτισμένης διαδρομής ή τροποποιημένων ιδιοτήτων στο μοντέλο.

Σημειώσεις δρομολόγησης

Χρήση create_journey για:

• Επικύρωση, εμπλουτισμός και δημιουργία ενός ταξιδιού από έναν πλήρη ορισμό JSON ταξιδιού.

Μην το χρησιμοποιείτε create_journey όταν:

• Ο χρήστης θέλει να ελέγξει τη συγκατάθεση του παραλήπτη—δρομολόγηση προς check_consent.
• Ο χρήστης χρειάζεται μια διεύθυνση URL κατάργησης εγγραφής—δρομολόγηση προς get_unsubscribe_link.
• Ο χρήστης θέλει να δημοσιεύσει, να ενεργοποιήσει, να θέσει σε παύση ή να διαγράψει μια υπάρχουσα διαδρομή. Αυτή η δυνατότητα δεν εκτελεί αυτές τις ενέργειες.

Σχετικά εργαλεία

Εργαλείο	Σχέση
check_consent	Ελέγχει τη συγκατάθεση του παραλήπτη πριν από την επικοινωνία του ταξιδιού
get_unsubscribe_link	Δημιουργεί μια συμβατή σύνδεση κατάργησης εγγραφής για ένα μήνυμα διαδρομής
get_customer_segments	Παραθέτει τμήματα που μπορούν να βοηθήσουν στον προσδιορισμό ενός κοινού διαδρομής

Ταξινόμηση μεταλλάξεων δεδομένων

Μετάλλαξη μόνο για δημιουργία.

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