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

Παράδειγμα προσθηκών χαμηλών απαιτήσεων κώδικα Dataverse (έκδοση προεπισκόπησης)

[Αυτό το θέμα αποτελεί τεκμηρίωση προέκδοσης και υπόκειται σε αλλαγές.]

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

Σημαντικό

  • Οι άμεσες προσθήκες χαμηλών απαιτήσεων κώδικα δεν έχουν προτεραιότητα και δεν παρέχονται ως δυνατότητα. Οι άμεσες προσθήκες χαμηλών απαιτήσεων κώδικα αντικαθίστανται με λειτουργίες. Περισσότερες πληροφορίες: Λειτουργίες στο Microsoft Dataverse (έκδοση προεπισκόπησης)
  • Αυτή είναι μια δυνατότητα προεπισκόπησης.
  • Οι λειτουργίες προεπισκόπησης δεν προορίζονται για παραγωγική χρήση και ενδέχεται να έχουν περιορισμένη λειτουργικότητα. Αυτές οι δυνατότητες είναι διαθέσιμες πριν από μια επίσημη κυκλοφορία έτσι ώστε οι πελάτες να έχουν πρόσβαση από νωρίς και να κάνουν σχόλια.

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

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

Σημείωμα

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

Επιστροφή μη αρνητικής τιμής

Αυτό το παράδειγμα χρησιμοποιεί τη συνάρτηση Abs() για να επιστρέψει τη μη αρνητική τιμή του ορίσματός της. Εάν ένας αριθμός είναι αρνητικός, η συνάρτηση Abs επιστρέφει την αντίστοιχη θετική τιμή.

  1. Αναπαραγωγή της εφαρμογής Επιταχυντή Dataverse, στη γραμμή εντολών, επιλέξτε Νέα ενέργεια>Άμεση προσθήκη.

  2. Δώστε ένα εμφανιζόμενο όνομα, όπως το όνομα του τύπου και περιγραφή.

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

  4. Στο πρόγραμμα επεξεργασίας τύπων, συσκευάστε την παράμετρο Out σε αγκύλες:

    {Out: "" }

  5. Εισαγάγετε μια παράσταση που ελέγχει τον τύπο:

    • Επιβεβαιώστε ότι το intellisense αποδέχεται τον τύπο (το κείμενο γίνεται μπλε χρώμα).
    • Εφαρμόστε μια παράσταση που παρέχει ένα αποτέλεσμα για να επικυρώσετε, για παράδειγμα, το αποτέλεσμα.
    {Out: "Abs(-5) = 5: " & Text( Abs(-5) = 5 )  }

  6. Επιλέξτε Επόμενο και, στη συνέχεια, επιλέξτε Αποθήκευση.

  7. Επιλέξτε Δοκιμή για να δοκιμάσετε τον τύπο. Χρησιμοποιήστε την παράμετρο εξόδου για να επικυρώσετε το αποτέλεσμα.

Επικύρωση στοιχείων εισόδου και προσαρμοσμένα σφάλματα

Εντοπισμός διπλοτύπων

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

  1. Αναπαραγωγή της εφαρμογής Επιταχυντή Dataverse, στη γραμμή εντολών, επιλέξτε Νέα ενέργεια>Αυτοματοποιημένη προσθήκη.
  2. Στο πλαίσιο Όνομα, πληκτρολογήστε Έλεγχος διπλοτύπων.
  3. Για Πίνακα, επιλέξτε Επαφή.
  4. Για να Εκτελέσετε αυτήν την προσθήκη όταν η γραμμή είναι, επιλέξτε Δημιουργήθηκε.
  5. Στο πλαίσιο Τύπος, εισαγάγετε αυτόν τον τύπο:
 If( !IsBlank(LookUp([@Contacts],'Last Name'=ThisRecord.'Last Name' && 'First Name'=ThisRecord.'First Name')),
    Error("You have existing contacts with the same first name and last name")
)
  1. ΕπιλέξτεΑποθήκευση.

Δοκιμάστε την προσθήκη

  1. Για να δοκιμάσετε την προσθήκη, δημιουργήστε μια εφαρμογή καμβά χρησιμοποιώντας τον πίνακα επαφών ακολουθώντας τα βήματα εδώ: Καθορισμός πίνακα.
  2. Δημιουργήστε μια γραμμή επαφής.
  3. Δημιουργήστε μια άλλη επαφή με όνομα ίδιο με αυτό στο προηγούμενο βήμα.
  4. Εμφανίζεται ένα μήνυμα που υποδεικνύει ότι βρέθηκαν διπλότυπες καρτέλες. Επιλέξτε Παράβλεψη και αποθήκευση στην προτροπή για μήνυμα σφάλματος.

Εμφανίζεται αυτό το προσαρμοσμένο μήνυμα σφάλματος: Έχετε δύο επαφές με το ίδιο όνομα και επώνυμο.

Επικύρωση δεδομένων

Εμφάνιση συγκεκριμένων τύπων σφαλμάτων χρησιμοποιώντας την απαρίθμηση ErrorΟd.

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

  2. Δώστε τις παρακάτω τιμές:

    • Όνομα: Επικύρωση εισόδου
    • Περιγραφή: Ελέγχει για έγκυρη ημερομηνία και εμφανίζει ένα σφάλμα εάν δεν είναι έγκυρο
    • Πίνακας: Συνάντηση
    • Εκτέλεση αυτής της προσθήκης όταν η γραμμή είναι: Ενημερωμένη

  3. Εισαγάγετε τον τύπο παρακάτω: 

    If(ThisRecord.'Due Date' < Now(), 
 Error({ Kind: ErrorKind.Validation , Message: "The due date cannot be in the past" })
);

  4. Στην περιοχή Επιλογές για προχωρημένους, ορίστε Πότε πρέπει να εκτελείται αυτό σε Προ-λειτουργία. Θέλετε να εκτελέσετε αυτόν τον κανόνα πριν την αποθήκευση δεδομένων για την αποτροπή μη έγκυρων δεδομένων.

  5. ΕπιλέξτεΑποθήκευση.

Μεταβείτε στη συνάρτηση Error() για να μάθετε περισσότερα για τα προσαρμοσμένα σφάλματα.

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

Προϋποθέσεις:

Παράδειγμα προτύπου ηλεκτρονικού ταχυδρομείου

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

  • Τύπος προτύπου: Καθολικό
  • Όνομα: Ευχαριστούμε για την παραγγελία
  • Περιγραφή: Χρησιμοποιήστε αυτό το πρότυπο για να ευχαριστήσετε έναν πελάτη για την πραγματοποίηση μιας παραγγελίας από εσάς.
  • Θέμα: Thank you for your order <orderconfirmation-{!salesorder:Order Number; }>
  • Σώμα: Χρησιμοποιήστε αυτόν τον κώδικα.
   Hello {!Sales Order:First Name;},
   Order Type: {! Sales Order: Order Type;},
   Location Type: {! Sales Order: Location Type;},
   Address1: {! Sales Order: Address 1;},
   Address2: {! Sales Order: Address 2;},
   Preferred Service Start Date 1: {! Sales Order: Preferred Service Start Date;},
   Next Step- We take upto 48 hrs to schedule an in-person and will notify you as soon as we have a In-person Technician allocated at your site. For any questions, please contact us at 1-800-CON-SOLAR
   Yours Sincerely, 
   Contoso Sales

Δημιουργήστε την αυτοματοποιημένη προσθήκη

  1. Κάντε αναπαραγωγή της εφαρμογής Επιταχυντή Dataverse και, στη συνέχεια, επιλέξτε +Νέα προσθήκη στην ενότητα Αυτοματοποιημένες προσθήκες.
  2. Πληκτρολογήστε τις παρακάτω πληροφορίες:

    • Όνομα: SendEmailUponCreate

    • Πίνακας: Επιλέξτε το όνομα του λογικού πίνακα των παραγγελιών πωλήσεων, το οποίο είναι SalesOrder. Αυτό το συμβάν βασίζεται εκτός του πίνακα "Παραγγελίες πωλήσεων".

    • Εκτέλεση αυτής της προσθήκης με τη γραμμή είναι: Δημιουργημένη

    • Τύπος: Επικολλήστε τον παρακάτω κώδικα στο πλαίσιο Τύπος. Για περισσότερες πληροφορίες, ανατρέξτε στη λειτουργία SendEmailFromTemplate, στην ενέργεια SendEmailFromTemplate.

      XSendEmailFromTemplate(
    LookUp('Email Templates',StartsWith(title,"Order Thank You")).'Email Template',
ThisRecord,
LookUp(Users,'Primary Email'="sampleemail@sample.com"),[ThisRecord.Email]
)
  3. Επιλέξτε Για προχωρημένους>Μετα-λειτουργία.
  4. ΕπιλέξτεΑποθήκευση.

Εμφανίζεται το μήνυμα επιβεβαίωσης Η προσθήκη αποθηκεύτηκε με επιτυχία.

Αποστολή ειδοποιήσεων εντός εφαρμογής βάσει μιας άμεσης ενέργειας

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

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

  1. Κάντε αναπαραγωγή της εφαρμογής επιταχυντή Dataverse και, στη συνέχεια, επιλέξτε +Νέα προσθήκη στην ενότητα Άμεσες προσθήκες.
  2. Εισαγάγετε τις παρακάτω πληροφορίες, επιλέξτε Επόμενο:
    • Όνομα: NotifyTechnican1
    • Περιγραφή: Αυτή η άμεση προσθήκη ειδοποιεί τον χρήστη της εφαρμογής.
  3. Στη σελίδα Ορισμοί , δημιουργήστε παραμέτρους εισόδου με αυτούς τους τύπους δεδομένων:
    • OrderID: Συμβολοσειρά
    • TechnicianEmail: Συμβολοσειρά
  4. Τύπος. Επικολλήστε τον ακόλουθο κώδικα στο πλαίσιο Τύπος. Για περισσότερες πληροφορίες σχετικά με αυτήν τη συνάρτηση, μεταβείτε στην ενέργεια SendAppNotification. 
     XSendAppNotification(
 	"New service",
 	LookUp(Users,'Primary Email'=TechnicianEmail),
 	"You have a new solar panel installation scheduled on "& LookUp('Scheduling Results','OrderId'=OrderID).'ServiceDate'&" in "& LookUp('Service Orders','Order Number'=OrderID).City &". Contact the coordinator with any questions.",
 [
 	XCreateSidePaneActionForEntity(
     		"View order",
 		OrderID,
 		"Sales Order",
 		"cr8b8_serviceorder1",
 		LookUp('Service Orders','Order Number'=OrderID).'Service Order'
     	)
 	]
 )
  5. Επιλέξτε Επόμενο.
  6. Στη σελίδα Σύνοψη, επιλέξτε Αποθήκευση.

Κλήση της άμεσης ενέργειας ειδοποίησης εντός εφαρμογής

  1. Επιλέξτε μια εφαρμογή καμβά και, στη συνέχεια, επιλέξτε Επεξεργασία στη γραμμή εντολών (ή δημιουργήστε μία νέα).
  2. Επιλέξτε οθόνη στο αριστερό τμήμα παραθύρου περιήγησης ή δημιουργήστε ένα νέο.
  3. Στο μενού Εισαγωγή, προσθέστε ένα Κουμπί στη σελίδα χρησιμοποιώντας το ΚείμενοΕιδοποίηση τεχνικού.
  4. Επιλέξτε το κουμπί και εισαγάγετε τα παρακάτω στη γραμμή τύπων fx, όπου DataCardValue17 είναι η στήλη που περιέχει το αναγνωριστικό παραγγελίας και το DataCardValue15 είναι η στήλη που περιέχει τη διεύθυνση ηλεκτρονικού ταχυδρομείου του τεχνικού. Σε αυτό το παράδειγμα, χρησιμοποιείται μια εφαρμογή καμβά με το όνομα Εφαρμογή παραγγελίας υπηρεσίας. 
     Environment.cr8b8_Notifytechnician1({
       OrderID: DataCardValue17.Text,
    TechnicianEmail: DataCardValue15.Text 
 });

   	Notify("The technician was notified!", NotificationType.Success, 2000);
    Προσθήκη κουμπιού με τύπο Power Fx για αποστολή ειδοποίησης σε τεχνικό
  5. Αποθηκεύστε και δημοσιεύστε τις αλλαγές σας.

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

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

Δείγμα άμεσης προσθήκης με τη σύνδεση MSN Weather

Αυτή η προσθήκη επιστρέφει τον τρέχοντα καιρό για μια συγκεκριμένη τοποθεσία με χρήση της σύνδεσης MSN Weather.

Προϋποθέσεις:

  1. Δημιουργήστε μια αναφορά σύνδεσης για το MSN Weather, εάν δεν είναι ακόμα διαθέσιμη στο περιβάλλον: Δημιουργία αναφοράς σύνδεσης στην εφαρμογή από το πίνακα αναφορών σύνδεσης στα δεξιά

  2. Αντιγραφή τμήματος κώδικα: Αντιγραφή του τμήματος κώδικα ενέργειας από το πίνακα συνδέσεων

  3. Ολοκληρώστε την επεξεργασία της φόρμουλας χρησιμοποιώντας το Intellisense και χρησιμοποιήστε τις ιδιότητες απόκρισης σύνδεσης όπως απαιτείται: Συμπληρώστε τον ορισμό της προσθήκης στο πρόγραμμα επεξεργασίας

  4. Αποθήκευση

  5. Δοκιμάστε την προσθήκη

Φιλοδώρημα

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

With({ /* Capture current weather response from connector */
c: new_MsnWeather.CurrentWeather( Location, "Imperial" ).responses.weather.current
},{	/* Return concatenated weather details */
Out: "Current temp: " & c.temp & " degrees. Feels like " & c.feels & " degrees. Wind speed is " & c.windSpd & " mph."
})

Βέλτιστες πρακτικές

Χειρισμός σφαλμάτων ατέρμονων βρόχων σε αυτοματοποιημένες προσθήκες χαμηλών απαιτήσεων κώδικα

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

Προβληματικό μοτίβο: Η χρήση του τύπου Patch() ενεργοποιεί μια άλλη ενημέρωση.

Συνιστώμενο μοτίβο: Χρησιμοποιήστε τον τύπο Set() αντί για να αποφύγετε αυτό το ζήτημα.

Δείτε επίσης

Προσθήκες χαμηλών απαιτήσεων κώδικα Power Fx (έκδοση προεπισκόπησης)

  • Last updated on