Δημιουργία παραγγελιών εργασίας με χρήση του Power Automate

Μπορείτε να δημιουργήσετε αυτόματα παραγγελίες εργασίας σε Dynamics 365 Field Service χρησιμοποιώντας Power Automate ροές. Αυτό είναι χρήσιμο όταν πρέπει να δημιουργηθούν παραγγελίες εργασίας με βάση εξωτερικά εναύσματα, όπως μια ειδοποίηση IoT, μια υποβολή φόρμας, μια αίτηση εξυπηρέτησης από άλλο σύστημα ή μια αλλαγή σε μια σχετική εγγραφή.

Power Automate οι ροές χρησιμοποιούν τον συνδετήρα Microsoft Dataverse για αλληλεπίδραση με εγγραφές της επιτόπιας υπηρεσίας. Για πληροφορίες σχετικά με τη δημιουργία παραγγελιών εργασίας μέσω κώδικα, μεταβείτε στη Δημιουργία παραγγελιών εργασίας χρησιμοποιώντας το Dataverse Web API.

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

  • Μια άδεια χρήσης Power Automate (περιλαμβάνεται με τις περισσότερες άδειες χρήσης Dynamics 365).
  • Τουλάχιστον ένας από τους ακόλουθους ρόλους ασφαλείας Field Service που έχουν εκχωρηθεί στον λογαριασμό σύνδεσης της ροής. Μάθετε περισσότερα στο θέμα Ρύθμιση χρηστών και ρόλων ασφαλείας.
    • Field Service - Αποστολέας
    • Field Service - Διαχειριστής
  • Υπάρχουσες καρτέλες για τα πεδία αναζήτησης που χρησιμοποιούνται από τη διαδικασία παραγγελίας εργασίας:
    • Τύπος παραγγελίας εργασίας (msdyn_workordertype οντότητα)
    • Τιμοκατάλογος (pricelevel οντότητα), εάν το απαιτεί η διεργασία σας
    • Λογαριασμός υπηρεσίας (account οντότητα), εάν ο επιλεγμένος Τύπος παραγγελίας εργασίας απαιτεί Λογαριασμό υπηρεσίας ή εάν θέλετε περιβάλλον που προέρχεται από λογαριασμό

Επιλογή 1: Δημιουργία σειράς εργασίας όταν αλλάζει μια εγγραφή dataverse

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

Ρύθμιση του ενεργοποιητή

  1. Στο Power Automate, επιλέξτε Δημιουργία>Αυτόματη ροή cloud.

  2. Αναζητήστε και επιλέξτε Όταν μια γραμμή προστίθεται, τροποποιείται ή διαγράφεται (Microsoft Dataverse σύνδεση).

  3. Όταν σας ζητηθεί, εισέλθετε στο Microsoft Dataverse σύνδεση χρησιμοποιώντας τα διαπιστευτήρια Dynamics 365 σας. Εάν έχετε ήδη μια σύνδεση στο περιβάλλον σας, επιλέξτε την από την αναπτυσσόμενη λίστα. Τα πεδία ρύθμισης παραμέτρων του εναύσματος δεν συμπληρώνονται μέχρι να δημιουργηθεί μια ενεργή σύνδεση.

  4. Ρυθμίστε τον ενεργοποιητή:

    Πεδίο Τιμή
    Αλλαγή τύπου Τροποποιήθηκε
    Όνομα πίνακα Περιουσιακά στοιχεία πελατών
    Πεδίο εφαρμογής Εταιρεία

  5. Προαιρετικά, προσθέστε μια συνθήκη Γραμμές φίλτρου για να περιορίσετε την εκτέλεση της ροής. Για παράδειγμα: msdyn_operationalstatus eq 690970001 (Χρειάζεται υπηρεσία).

Υπόδειξη

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

Προσθέστε την ενέργεια Δημιουργία σειράς εργασίας

  1. Επιλέξτε + Νέο βήμα και κάντε αναζήτηση για Προσθήκη νέας γραμμής (σύνδεση Microsoft Dataverse).

  2. Επιλέξτε την ίδια σύνδεση Dataverse που χρησιμοποιήσατε για το έναυσμα. Το πεδίο Όνομα πίνακα εμφανίζεται μόνο μετά την επιλογή μιας σύνδεσης.

  3. Ορίστε το Όνομα πίνακα σε Παραγγελίες εργασίας.

  4. Συμπληρώστε τα απαιτούμενα πεδία:

    Πεδίο Τιμή
    Αριθμός παραγγελίας εργασίας Εισαγάγετε την παράσταση guid() ως σύμβολο κράτησης θέσης. Το πεδίο Αριθμός παραγγελίας εργασίας απαιτείται από το περιβάλλον εργασίας χρήστη της σύνδεσης Dataverse, αλλά η προσθήκη αυτόματης αρίθμησης της Υπηρεσίας πεδίου αντιστοιχίζει αυτόματα τον σωστό αριθμό διαδοχικής παραγγελίας εργασίας όταν αποθηκεύεται η εγγραφή. Για να εισαγάγετε μια παράσταση, επιλέξτε το πεδίο, μεταβείτε στην καρτέλα Παράσταση στον πίνακα δυναμικού περιεχομένου, πληκτρολογήστε guid()και επιλέξτε OK.
    Λογαριασμός υπηρεσίας Απαιτείται μόνο όταν ο επιλεγμένος Τύπος παραγγελίας εργασίας απαιτεί Λογαριασμό υπηρεσίας. Επιλέξτε το λογαριασμό χρησιμοποιώντας το πεδίο αναζήτησης ή πληκτρολογήστε την έκφραση concat('/accounts(', 'service-account-guid', ')') στην καρτέλα Παράσταση , εάν θέλετε να χρησιμοποιήσετε ένα ενσωματωμένο ή δυναμικό GUID. Αφήστε αυτό το πεδίο κενό για τύπους παραγγελιών εργασίας όπου δεν απαιτείται λογαριασμός εξυπηρέτησης και η παραγγελία εργασίας χρησιμοποιεί άλλο περιβάλλον εξυπηρέτησης.
    Τύπος παραγγελίας εργασίας Επιλέξτε τον τύπο σειράς εργασίας χρησιμοποιώντας το πεδίο αναζήτησης ή πληκτρολογήστε την παράσταση concat('/msdyn_workordertypes(', 'work-order-type-guid', ')') στην καρτέλα Παράσταση , εάν θέλετε να χρησιμοποιήσετε ένα ενσωματωμένο ή δυναμικό GUID. Δείτε παρακάτω πώς μπορείτε να το βρείτε αυτό.
    Τιμοκατάλογος Επιλέξτε τον τιμοκατάλογο χρησιμοποιώντας το πεδίο αναζήτησης ή πληκτρολογήστε την παράσταση concat('/pricelevels(', 'your-price-list-guid', ')') στην καρτέλα Παράσταση , εάν θέλετε να χρησιμοποιήσετε ένα ενσωματωμένο ή δυναμικό GUID. Εάν ανακτήσετε τον τιμοκατάλογο δυναμικά χρησιμοποιώντας μια ενέργεια List rows μέσα σε έναν βρόχο Για κάθε βρόχο, χρησιμοποιήστε concat('/pricelevels(', items('YourLoopName')?['pricelevelid'], ')') το αντί για αυτό, αντικαθιστώντας YourLoopName το με το όνομα του βρόχου. Δείτε παρακάτω πώς μπορείτε να το βρείτε αυτό.
    Κατάσταση συστήματος 690970000 (Μη προγραμματισμένη)
    Φορολογήσιμος false
    Οδηγίες Χρήση δυναμικού περιεχομένου από το έναυσμα, για παράδειγμα, το όνομα του πόρου

    Λογαριασμός υπηρεσίας: Πληκτρολογήστε το όνομα του λογαριασμού απευθείας στο πεδίο Λογαριασμός υπηρεσίας για να τον αναζητήσετε και να τον επιλέξετε. Εάν το έναυσμα είναι μια αλλαγή στο Στοιχείο πελάτη και το στοιχείο συνδέεται με έναν λογαριασμό, μπορείτε να επιλέξετε Λογαριασμός (Στοιχεία πελάτη) από τον πίνακα δυναμικού περιεχομένου. Εάν θέλετε να χρησιμοποιήσετε ένα GUID απευθείας, μεταβείτε στην περιοχή>>Λογαριασμοί πελατών στην επιτόπια υπηρεσία, ανοίξτε το λογαριασμό και αντιγράψτε το αναγνωριστικό εγγραφής από τη διεύθυνση URL του προγράμματος περιήγησης (η τιμή μεταξύ %7B του και %7Dτου ή του απλού GUID εάν η διεύθυνση URL δεν έχει κωδικοποιηθεί). Μάθετε περισσότερα στο θέμα Ρύθμιση παραμέτρων απαιτήσεων λογαριασμού εξυπηρέτησης για παραγγελίες εργασίας.

    Τύπος παραγγελίας εργασίας: Πληκτρολογήστε το όνομα τύπου παραγγελίας εργασίας απευθείας στο πεδίο Τύπος παραγγελίας εργασίας για να τον αναζητήσετε και να τον επιλέξετε. Εάν θέλετε να χρησιμοποιήσετε ένα GUID απευθείας, μεταβείτε στην περιοχή > Ρυθμίσεις Τύποι παραγγελιών εργασίας παραγγελίας>εργασίας στην επιτόπια υπηρεσία, ανοίξτε τον τύπο παραγγελίας εργασίας και αντιγράψτε το αναγνωριστικό εγγραφής από τη διεύθυνση URL του προγράμματος περιήγησης.

    Τιμοκατάλογος: Πληκτρολογήστε το όνομα του τιμοκαταλόγου απευθείας στο πεδίο Τιμοκατάλογος για να αναζητήσετε και να το επιλέξετε. Εάν θέλετε να χρησιμοποιήσετε ένα GUID απευθείας, μεταβείτε στις Ρυθμίσεις Γενικοί>> στην Υπηρεσία πεδίου, ανοίξτε τον τιμοκατάλογο και αντιγράψτε το αναγνωριστικό εγγραφής από τη διεύθυνση URL του προγράμματος περιήγησης.

    Σημείωμα

    Η σύνδεση Dataverse απαιτεί πεδία αναζήτησης για τη χρήση μιας διαδρομής αναφοράς οντότητας OData (για παράδειγμα, /accounts(guid)) αντί για ένα απλό GUID. Η εισαγωγή ενός απλού GUID προκαλεί ένα σφάλμα χρόνου εκτέλεσης ODataUnrecognizedPathException. Οι concat παραπάνω παραστάσεις κατασκευάζουν τη σωστή μορφή διαδρομής.

  5. Αποθηκεύστε και δοκιμάστε τη ροή.

Επιλογή 2: Δημιουργία παραγγελίας εργασίας από αίτηση HTTP

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

Ρύθμιση του ενεργοποιητή

  1. Στο Power Automate, επιλέξτε Δημιουργία>Εύρυθμη ροή cloud.

  2. Ονομάστε τη ροή και επιλέξτε Κατά τη λήψη μιας αίτησης HTTP ως έναυσμα.

  3. Επιλέξτε Δημιουργία.

  4. Στο πεδίο Σχήμα JSON σώματος αίτησης , επικολλήστε το ακόλουθο σχήμα:

    {
  "type": "object",
  "properties": {
    "serviceAccountId": { "type": "string" },
    "workOrderTypeId": { "type": "string" },
    "priceListId": { "type": "string" },
    "instructions": { "type": "string" }
  },
  "required": ["workOrderTypeId", "priceListId"]
}

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

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

    Επιλογή Πότε να χρησιμοποιήσετε
    Μόνο χρήστες στον μισθωτή μου Συνιστάται για παραγωγή. Οι καλούντες πρέπει να κάνουν έλεγχο ταυτότητας με Microsoft Entra ID και να παρουσιάσουν ένα έγκυρο διακριτικό φορέα OAuth. Χρησιμοποιήστε το για εσωτερικά συστήματα ή αξιόπιστες οντότητες υπηρεσίας.
    Κάποιος Η ίδια η διεύθυνση URL λειτουργεί ως διαπιστευτήρια — δεν απαιτείται επιπλέον κεφαλίδα ελέγχου ταυτότητας. Χρησιμοποιείται μόνο όταν το σύστημα κλήσεων δεν μπορεί να λάβει διακριτικό Entra ID και μπορείτε να εξασφαλίσετε ότι η διεύθυνση URL αποθηκεύεται με ασφάλεια.

    Μάθετε περισσότερα σχετικά με την ασφάλεια των ροών που ενεργοποιούνται από HTTP στο θέμα Προσθήκη ελέγχου ταυτότητας OAuth για εναύσματα αιτήσεων HTTP.

  6. Το πεδίο διεύθυνσης URL HTTP είναι μόνο για ανάγνωση, μην το συμπληρώσετε. Power Automate το συμπληρώνει αυτόματα όταν αποθηκεύετε τη ροή για πρώτη φορά.

  7. Αποθήκευση της ροής. Το πεδίο διεύθυνσης URL HTTP συμπληρώνεται τώρα με τη διεύθυνση URL τελικού σημείου. Αντιγράψτε αυτήν τη διεύθυνση URL και δώστε τη σε οποιονδήποτε ρυθμίζει τις παραμέτρους του εξωτερικού συστήματος (όπως προγραμματιστή ή διαχειριστή συστήματος). Το εξωτερικό σύστημα ενεργοποιεί τη ροή στέλνοντας μια αίτηση HTTP POST σε αυτήν τη διεύθυνση URL με ένα σώμα JSON που συμφωνεί με το σχήμα που ορίσατε. Για παράδειγμα:

    POST <paste the HTTP URL here>
Content-Type: application/json

{
  "workOrderTypeId": "<work order type record GUID>",
  "priceListId": "<price list record GUID>",
  "serviceAccountId": "<optional account record GUID>",
  "instructions": "Reported issue: equipment not functioning"
}

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

Προσθέστε την ενέργεια Δημιουργία σειράς εργασίας

  1. Επιλέξτε + Νέο βήμα και κάντε αναζήτηση για Προσθήκη νέας γραμμής (σύνδεση Microsoft Dataverse).

  2. Εισέλθετε στη σύνδεση Microsoft Dataverse ή επιλέξτε μια υπάρχουσα σύνδεση. Το πεδίο Όνομα πίνακα εμφανίζεται μόνο μετά την επιλογή μιας σύνδεσης.

  3. Ορίστε το Όνομα πίνακα σε Παραγγελίες εργασίας.

  4. Αντιστοιχίστε τα πεδία σώματος αίτησης HTTP στα πεδία παραγγελίας εργασίας:

    Πεδίο παραγγελίας εργασίας Τιμή
    Αριθμός παραγγελίας εργασίας Εισαγάγετε την παράσταση guid() ως σύμβολο κράτησης θέσης. Το πεδίο Αριθμός παραγγελίας εργασίας απαιτείται από το περιβάλλον εργασίας χρήστη της σύνδεσης Dataverse, αλλά η προσθήκη αυτόματης αρίθμησης της Υπηρεσίας πεδίου αντιστοιχίζει αυτόματα τον σωστό αριθμό διαδοχικής παραγγελίας εργασίας όταν αποθηκεύεται η εγγραφή. Για να εισαγάγετε μια παράσταση, επιλέξτε το πεδίο, μεταβείτε στην καρτέλα Παράσταση στον πίνακα δυναμικού περιεχομένου, πληκτρολογήστε guid()και επιλέξτε OK.
    Λογαριασμός υπηρεσίας Χρησιμοποιήστε concat('/accounts(', triggerBody()?['serviceAccountId'], ')') μόνο όταν serviceAccountId παρέχεται. Εάν ο λογαριασμός εξυπηρέτησης δεν απαιτείται για τον επιλεγμένο τύπο παραγγελίας εργασίας και η αίτηση δεν περιλαμβάνει serviceAccountId, μην αντιστοιχίσετε αυτό το πεδίο αναζήτησης.
    Τύπος παραγγελίας εργασίας concat('/msdyn_workordertypes(', triggerBody()?['workOrderTypeId'], ')')
    Τιμοκατάλογος concat('/pricelevels(', triggerBody()?['priceListId'], ')')
    Κατάσταση συστήματος 690970000 (Μη προγραμματισμένη)
    Οδηγίες @{triggerBody()?['instructions']}

  5. Προαιρετικά, προσθέστε μια ενέργεια Απόκριση για να επιστρέψετε το νέο αναγνωριστικό παραγγελίας εργασίας στο σύστημα κλήσεων:

    1. Επιλέξτε + Νέο βήμα και κάντε αναζήτηση για Απόκριση (από τη σύνδεση Αίτηση ).
    2. Ορίστε τον Κωδικό κατάστασης σε 200.
    3. Στο πεδίο Σώμα , επιλέξτε το εικονίδιο δυναμικού περιεχομένου και επιλέξτε msdyn_workorderid από το βήμα Προσθήκη νέας γραμμής . Αυτό είναι το μοναδικό αναγνωριστικό της σειράς εργασίας που μόλις δημιουργήθηκε.

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

Τιμές συνόλου επιλογών κατάστασης συστήματος

Χρησιμοποιήστε αυτές τις ακέραιες τιμές κατά τον ορισμό κατάστασης συστήματος σε μια κλήση ροής ή API.

Ετικέτα Τιμή
Μη προγραμματισμένο 690970000
Προγραμματίστηκε 690970001
Σε εξέλιξη 690970002
Ολοκληρώθηκε 690970003
Καταχωρήθηκε 690970004
Ακυρώθηκε 690970005

Παράγοντες που πρέπει να ληφθούν υπόψη

Κυριότητα λογαριασμού σύνδεσης Flow

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

Θυγατρικές εγγραφές

Η ενέργεια Προσθήκη νέας γραμμής δημιουργεί μόνο την κεφαλίδα παραγγελίας εργασίας. Για να προσθέσετε προϊόντα παραγγελίας εργασίας, υπηρεσίες ή εργασίες εξυπηρέτησης, προσθέστε ξεχωριστά Βήματα προσθήκης νέας γραμμής για κάθε θυγατρικό πίνακα (msdyn_workorderproduct, msdyn_workorderservice, msdyn_workorderservicetask) και ορίστε το πεδίο αναζήτησης Παραγγελία εργασίας στο αναγνωριστικό που επιστρέφεται από το βήμα δημιουργίας.

Όρια ρυθμού API

Power Automate ροές υπόκεινται στα όρια του API dataverse. Για σενάρια μεγάλου όγκου, εξετάστε το ενδεχόμενο να χρησιμοποιήσετε το τελικό σημείο δέσμης API Web Dataverse ή να διαδώσετε εκτελέσεις ροής χρησιμοποιώντας ένα προγραμματισμένο έναυσμα με επεξεργασία δέσμης.

Αποφυγή διπλότυπων παραγγελιών εργασίας

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

Χειρισμός σφαλμάτων

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

Επόμενα βήματα

  • Last updated on