Δημιουργία νέας υπηρεσίας παροχής

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

Ορισμός αρχιτεκτονικής υπηρεσίας παροχής

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

Χρησιμοποιήστε τον παρακάτω πίνακα για να προσδιορίσετε ποια στοιχεία θα χρειαστείτε.

Συνθήκη	Στοιχείο που απαιτείται
Η υπηρεσία για την οποία θέλετε να δημιουργήσετε μια υπηρεσία παροχής δεν διαθέτει σύνδεση στο Power Automate. Για περισσότερες πληροφορίες, ανατρέξτε στην ενότητα Λίστα όλων των συνδέσεων Power Automate.	Δημιουργία μιας σύνδεσης πελάτη ή χρήση μιας γενικής σύνδεσης.
Ο πάροχος σας θα ανταλλάξει δεδομένα μεταξύ μιας εξωτερικής υπηρεσίας και του Microsoft Dataverse.	Η υπηρεσία παροχής σας θα χρειαστεί μετασχηματισμό παρόχου. Προσθέστε ένα στοιχείο μετασχηματισμού υπηρεσίας παροχής για κάθε μετασχηματισμό.
Η υπηρεσία παροχής σας θα εκτελέσει τη λογική από το εργαλείο σχεδίασης συντονισμού.	Δημιουργήστε μια ξεχωριστή ροή Power Automate για την αναπαράσταση καθεμιάς από τις ενέργειες.
Η υπηρεσία παροχής πρέπει να επεξεργάζεται μηνύματα από εξωτερική υπηρεσία.	Δημιουργήστε μια ροή προγράμματος χειρισμού μηνυμάτων Power Automate.
Η υπηρεσία παροχής σας θα λαμβάνει μηνύματα από μια εξωτερική υπηρεσία σε τακτά χρονικά διαστήματα.	Δημιουργήστε μια ροή προγράμματος λήψης μηνυμάτων Power Automate.
Η υπηρεσία παροχής σας θα παρουσιάσει επιχειρηματικές εκδηλώσεις που δεν ορίζονται επί του παρόντος στο Intelligent Order Management.	Δημιουργήστε έναν νέο ορισμό επιχειρηματικής εκδήλωσης και προσθέστε υφιστάμενες εκδηλώσεις.

Όταν κατανοήσετε επαρκώς τις λύσεις, μπορείτε να προχωρήσετε στην εφαρμογή της υπηρεσίες παροχής σας.

Δημιουργία λύσης υπηρεσίας παροχής

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

• Ρύθμιση παραμέτρων μιας προσαρμοσμένης υπηρεσίας παροχής.

• Προσθέστε έναν ορισμό υπηρεσίας παροχής.

• Προσθέστε τα στοιχεία στη λύση σας.

Ρύθμιση παραμέτρων μιας προσαρμοσμένης υπηρεσίας παροχής

Δημιουργήστε μια λύση στο Power Apps που θα περιέχει τα στοιχεία της υπηρεσίας παροχής. Για να δημιουργήσετε μια νέα λύση στο Power Apps, ακολουθήστε τα βήματα στη Δημιουργία λύσης στο Power Apps.

Προσθέστε έναν ορισμό υπηρεσίας παροχής

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

1. Στη λύση υπηρεσίας παροχής που δημιουργήσατε, επιλέξτε Νέος.

2. Επιλέξτε IOMορισμός υπηρεσίας παροχής.

3. Προσθέστε τις ακόλουθες λεπτομέρειες:

   1. Εμφανιζόμενο όνομα: Το όνομα που θέλετε να δώσετε στον πάροχο σας, για παράδειγμα, "Δοκιμή Provider".

   2. Λογικό όνομα: Το κλειδί εξαγωγής για τον πάροχο σας.

   3. Περιγραφή: Κείμενο για να περιγράψετε τι κάνει ο πάροχος σας.

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

5. Εάν θέλετε να προσθέσετε ένα λογότυπο, στείλτε την εικόνα.

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

7. Επιβεβαιώστε ότι ο ορισμός της υπηρεσίας παροχής σας εμφανίζεται στον κατάλογο υπηρεσιών παροχής. Εάν ορίσετε το πεδίο Είναι ενεργό σε Ναι, ο ορισμός της υπηρεσίας παροχής σας θα εμφανιστεί στον Κατάλογο υπηρεσιών παροχής. Ανοίξτε το Intelligent Order Management. Μεταβείτε στις Υπηρεσίες παροχής > Κατάλογος. Βεβαιωθείτε ότι εμφανίζεται ο ορισμός της υπηρεσίας παροχής σας.

Προσθέστε στοιχεία στη λύση

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

1. Μεταβείτε στη λύση σας.

2. Επιλέξτε Προσθήκη υφιστάμενου.

3. Επιλέξτε τον τύπο στοιχείου Intelligent Order Management και μετά επιλέξτε την καρτέλα που μόλις δημιουργήσατε.

Δημιουργία μετασχηματισμού υπηρεσίας παροχής

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

1. Στη λύση υπηρεσίας παροχής σας, επιλέξτε Νέος.

2. Επιλέξτε Μετασχηματισμός ορισμού υπηρεσίας παροχής IOM.

3. Προσθέστε τις ακόλουθες λεπτομέρειες:

   1. Εμφανιζόμενο όνομα: Το όνομα του μετασχηματισμού του παρόχου σας, για παράδειγμα, "Transform Sales Orders".

   2. Λογικό όνομα: Το μοναδικό αναγνωριστικό του παρόχου σας. Αυτή η τιμή θα είναι το κλειδί εισαγωγής και εξαγωγής των δεδομένων. Θα πρέπει να ξεκινά με το πρόθεμα του εκδότη. Για παράδειγμα, η Microsoft χρησιμοποιεί το πρόθεμα εκδότη msdyn_. Παραδείγματα για το λογικό όνομα είναι: msdyn_flexe_fulfillmentorderproduct_orderline και msdyn_flexe_fulfillmentorder_order.

   3. Προέλευση type: Αυτό το πεδίο υποδεικνύει τον τύπο δεδομένων που λαμβάνονται. Υπάρχουν δύο επιλογές: JsonDocument ή Οντότητα Dataverse. Εάν τα δεδομένα σας βρίσκονται ήδη στο Dataverse, επιλέξτε Οντότητα Dataverse. Αν όχι, επιλέξτε JsonDocument. Αυτές οι πληροφορίες θα χρησιμοποιηθούν στο στοιχείο Power Automate που ορίζετε για την αναζήτηση του μετασχηματισμού.

   4. Προέλευση όνομα αντικειμένου: Το όνομα των δεδομένων που μετασχηματίζετε. Εάν μετασχηματίζετε μια καρτέλα Dataverse, βεβαιωθείτε ότι το Όνομα αντικειμένου προέλευσης είναι το ίδιο όνομα με τον πίνακα Dataverse.

   5. Όνομα αντικειμένου προορισμού: Ο προορισμός της εγγραφής που θέλετε να μετατρέψετε.

   6. Transformation: Το Power Query Online MQuery που θα χρησιμοποιηθεί για τον μετασχηματισμό των δεδομένων εισόδου. Για πληροφορίες σχετικά με τα Power Query και MQuery, δείτε Τι είναι το Power Query; και Αναφορά γλώσσας τύπου Power Query Μ. Το παρακάτω είναι ένα παράδειγμα ενός MQuery που μετασχηματίζει μια εντολή πώλησης από υπηρεσία εξωτερικής παραγγελίας σε εντολή πώλησης στο Intelligent Order Management.

shared TransformSourceData =

let

orderItems = Source\[OrderItems\],

orderheader =

Record.FromTable

(

Table.SelectRows

(

Record.ToTable

(

\[

ordernumber = Record.FieldOrDefault(Source, "SellerOrderId", Text.From(Source\[OrderServiceOrderId\])),

name = ordernumber,

msdyn\_ExternalOrderId = Text.From(Source\[OrderServiceOrderId\]),

\#"customerid\_account@odata.bind" = "/accounts(" & Text.From(Source\[accountid\]) & ")",

\#"pricelevelid@odata.bind" = "/pricelevels(" & Text.From(Source\[pricelevelid\]) & ")",

totalamount = if Record.HasFields(Source, "OrderTotal") then Decimal.From(Record.FieldOrDefault(Source\[OrderTotal\], "Amount")) else null,

shipto\_name = if Record.HasFields(Source, "ShippingAddress") then Record.FieldOrDefault(Source\[ShippingAddress\], "Name") else null,

shipto\_contactname = shipto\_name,

shipto\_line1 = if Record.HasFields(Source, "ShippingAddress") then Record.FieldOrDefault(Source\[ShippingAddress\], "AddressLine1") else null,

shipto\_line2 = if Record.HasFields(Source, "ShippingAddress") then Record.FieldOrDefault(Source\[ShippingAddress\], "AddressLine2") else null,

shipto\_line3 = if Record.HasFields(Source, "ShippingAddress") then Record.FieldOrDefault(Source\[ShippingAddress\], "AddressLine3") else null,

shipto\_city = if Record.HasFields(Source, "ShippingAddress") then Record.FieldOrDefault(Source\[ShippingAddress\], "City") else null,

shipto\_stateorprovince = if Record.HasFields(Source, "ShippingAddress") then Record.FieldOrDefault(Source\[ShippingAddress\], "StateOrRegion") else null,

shipto\_country = if Record.HasFields(Source, "ShippingAddress") then Record.FieldOrDefault(Source\[ShippingAddress\], "CountryCode") else null,

shipto\_postalcode = if Record.HasFields(Source, "ShippingAddress") then Record.FieldOrDefault(Source\[ShippingAddress\], "PostalCode") else null,

shipto\_telephone = if Record.HasFields(Source, "ShippingAddress") then Record.FieldOrDefault(Source\[ShippingAddress\], "Phone") else null,

overriddencreatedon = Record.FieldOrDefault(Source, "PurchaseDate")

\]

), each \[Value\] \<\> null

)

),

orderlines = List.Transform(orderItems, each

Record.FromTable

(

Table.SelectRows

(

Record.ToTable

(

\[

isproductoverridden = true,

ispriceoverridden = true,

productdescription = \[OrderItemId\] & "-" & Record.FieldOrDefault(\_, "SellerSKU") & "-" & Record.FieldOrDefault(\_, "Title"),

quantity = \[QuantityOrdered\],

quantityshipped = Record.FieldOrDefault(\_, "QuantityShipped"),

priceperunit = if Record.HasFields(\_, "ItemPrice") then Decimal.From(Record.FieldOrDefault(\[ItemPrice\], "Amount")) else null,

manualdiscountamount = if Record.HasFields(\_, "PromotionDiscount") then Decimal.From(Record.FieldOrDefault(\[PromotionDiscount\], "Amount")) else null,

tax = if Record.HasFields(\_, "ItemTax") then Decimal.From(Record.FieldOrDefault(\[ItemTax\], "Amount")) else null,

shipto\_name = Record.FieldOrDefault(orderheader, "shipto\_name"),

shipto\_contactname = Record.FieldOrDefault(orderheader, "shipto\_contactname"),

shipto\_line1 = Record.FieldOrDefault(orderheader, "shipto\_line1"),

shipto\_line2 = Record.FieldOrDefault(orderheader, "shipto\_line2"),

shipto\_line3 = Record.FieldOrDefault(orderheader, "shipto\_line3"),

shipto\_city = Record.FieldOrDefault(orderheader, "shipto\_city"),

shipto\_stateorprovince = Record.FieldOrDefault(orderheader, "shipto\_stateorprovince"),

shipto\_country = Record.FieldOrDefault(orderheader, "shipto\_country"),

shipto\_postalcode = Record.FieldOrDefault(orderheader, "shipto\_postalcode"),

shipto\_telephone = Record.FieldOrDefault(orderheader, "shipto\_telephone"),

overriddencreatedon = Record.FieldOrDefault(orderheader, "overriddencreatedon")

\]

), each \[Value\] \<\> null

)

)

),

salesorder = Record.AddField(orderheader, "order\_details", orderlines)

in Text.FromBinary(Json.FromValue(salesorder));

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

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

Προσθέσετε ορισμούς επιχειρηματικών εκδηλώσεων

Εάν η υπηρεσία παροχής σας θα δημιουργήσει ή θα χρησιμοποιήσει νέες επιχειρηματικές εκδηλώσεις, πρέπει να προσθέσετε στοιχεία Ορισμού επιχειρηματικής εκδήλωσης ορισμού υπηρεσίας παροχής IOM στη λύση σας. Χρειάζεται μόνο να προσθέσετε επιχειρηματικές εκδηλώσεις που δεν είναι ήδη στο Intelligent Order Management.

Εάν η επιχειρηματική εκδήλωση που θέλετε να δημιουργήσετε δεν βρίσκεται ήδη στο Intelligent Order Management, μπορείτε να δημιουργήσετε τη δική σας.

1. Επιλέξτε Νέα.

2. Επιλέξτε Ορισμός επιχειρηματικών εκδηλώσεων ορισμού παρόχου IOM.

3. Προσθέστε τις ακόλουθες λεπτομέρειες:

   1. Όνομα: Το όνομα της εκδήλωσης της επιχείρησής σας.

   2. Πάροχος: Ο πάροχος για τον οποίο δημιουργείτε αυτόν τον επιχειρηματικό ορισμό.

   3. Συσχετισμένη οντότητα: Η Dataverse οντότητα στην Έξυπνη διαχείριση παραγγελιών που αλλάζει ή επηρεάζεται κατά τη δημιουργία του συμβάντος.

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

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

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

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

Προσθήκη ενός συνδέσμου

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

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

Αφού δημιουργήσετε την προσαρμοσμένη σας σύνδεση, προσθέστε τη στη λύση υπηρεσίας παροχής ως στοιχείο.

1. Μεταβείτε στη λύση υπηρεσίας παροχής σας.

2. Επιλέξτε Προσθήκη υφιστάμενης.

3. Επιλέξτε τη σύνδεση που δημιουργήσατε.

Τύποι ροών Power Automate

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

Προσθέστε τις ροές σας ως στοιχεία Ορισμού λογικού ορισμού υπηρεσίας παροχής στην υπηρεσία παροχής σας.

Πριν ξεκινήσετε τη διαδικασία δημιουργίας ροής, ελέγξτε τους τύπους ροών που χρησιμοποιούνται στο Intelligent Order Management.

Πρόγραμμα χειρισμού μηνυμάτων υπηρεσίας παροχής

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

Το παρακάτω είναι ένα παράδειγμα δομής για τη δημιουργία ενός τύπου προγράμματος χειρισμού μηνυμάτων ροής Power Automate.

1. Προσδιορίστε ένα έναυσμα Power Automate. Αυτό είναι συνήθως ένα τελικό σημείο HTTP που είναι ένα έναυσμα webhook (συνιστάται), ένα έναυσμα σύνδεσης ή ένα έναυσμα εισαγωγής του Dataverse. Το έναυσμα ενεργοποιείται όταν μια εξωτερική υπηρεσία έχει δεδομένα για αποστολή στο Intelligent Order Management.

Το σχήμα JSON που θα χρησιμοποιηθεί στον κανόνα ετικέτας HTTP ορίζεται παρακάτω.

{
    "type": "object",
    "properties": {
        "text": {
            "title": "ProviderActionExecutionEventId",
            "type": "string",
            "x-ms-dynamically-added": true,
            "description": "Please enter your input",
            "x-ms-content-hint": "TEXT"
        },
        "text_1": {
            "title": "EntityRecordId",
            "type": "string",
            "x-ms-dynamically-added": true,
            "description": "Please enter your input",
            "x-ms-content-hint": "TEXT"
        }
    },
    "required": [
        "text",
        "text_1"
    ]
}

2. Ξεκινήστε την επεξεργασία του μηνύματος. Υπάρχουν δύο βήματα που εμπλέκονται σε αυτήν την εργασία.

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

   2. Επιβεβαιώστε το μήνυμα της υπηρεσίας παροχής στο Intelligent Order Management, ώστε να μπορείτε να παρακολουθείτε, να δοκιμάσετε ξανά και να εμφανίσετε την κατάσταση επεξεργασίας. Αυτή είναι μια ενέργεια του Power Automate που παρουσιάζει το Intelligent Order Management. Αυτή η ενέργεια ονομάζεται Επιβεβαίωση αίτησης μηνύματος υπηρεσίας παροχής στο IOM. Αυτή η ενέργεια έχει τις ακόλουθες απαιτούμενες παραμέτρους.

      1. PowerAutomateWorkflowId: Αναγνωριστικό ροής εργασίας στον ορισμό του προγράμματος χειρισμού μηνυμάτων. Μπορείτε να κάνετε ανάκτηση έχοντας μια συνάρτηση σύνθεσης με ροή εργασίας()['tags'].

      2. PowerAutomateRunId: Το μοναδικό αναγνωριστικό για την εκτέλεση Power Automate που έλαβε το μήνυμα και επιτρέπει στο pipeline να δοκιμάσει ξανά την επεξεργασία και να συνδέσει τα αρχεία καταγραφής εκτέλεσης. Μπορείτε να κάνετε ανάκτηση έχοντας μια συνάρτηση σύνθεσης με ροή εργασίας()['run']?['name'].

      3. ProviderMessageExternalRequestId: Ένα αναγνωριστικό για το μήνυμα που στάλθηκε. Εάν δεν υπάρχει αναγνωριστικό, μπορεί να δημιουργηθεί ένα GUID. Αυτό το αναγνωριστικό χρησιμοποιείται από τη διοχέτευση για να αποτρέψει τον αποστολέα από την αποστολή διπλών μηνυμάτων. Το αναγνωριστικό εξαρτάται από το ωφέλιμο φορτίο της προέλευσης. Για παράδειγμα: concat(triggerOutputs()?['body']?['type']?['name'], '_', triggerOutputs()?['body']?['id']).

3. Ο μετασχηματισμός υπηρεσίας παροχής που ορίσατε νωρίτερα θα ανακτήσει τα δεδομένα εισόδου και θα τα μετασχηματίσει. Το Intelligent Order Management παρέχει μια έτοιμη θυγατρική ροή που ονομάζεται Μετασχηματισμός υπηρεσίας παροχής IOM που θα εκτελέσει τον μετασχηματισμό. Προσθέστε τις ακόλουθες λεπτομέρειες για την επεξεργασία του συμβάντος ή του μηνύματος:

   1. Όνομα παρόχου: Το όνομα του παρόχου που συνδέεται με το πρόγραμμα χειρισμού μηνυμάτων. Αυτή η τιμή πρέπει να είναι η ίδια με τον όνομα του μετασχηματισμού της υπηρεσίας παροχής σας.

   2. Προέλευση όνομα αντικειμένου: Η τιμή του κλειδιού αναζήτησης πηγής για την εκτέλεση του μετασχηματισμού. Αυτή η τιμή πρέπει να είναι ίδια με το όνομα του αντικειμένου προέλευσης που ορίζεται στον μετασχηματισμό της υπηρεσίας παροχής σας.

   3. Όνομα αντικειμένου προορισμού: Η τιμή του κλειδιού αναζήτησης προορισμού για την εκτέλεση του μετασχηματισμού. Αυτή η τιμή πρέπει να είναι ίδια με την τιμή που ορίζεται στον μετασχηματισμό της υπηρεσίας παροχής σας.

   4. Ωφέλιμο φορτίο: Παρέχεται κατά τη μετατροπή ενός ωφέλιμου φορτίου JSON. Το Power Automate απαιτεί να διαβιβαστούν οι παράμετροι ως σειριακή συμβολοσειρά. Δώστε μια τιμή για το Ωφέλιμο φορτίο ή μια τιμή για το Αναγνωριστικό καρτέλας, όχι και για τα δύο.

   5. Αναγνωριστικό εγγραφής: Παρέχεται κατά τη μετατροπή μιας Dataverse εγγραφής. Δώστε μια τιμή για το Ωφέλιμο φορτίο ή μια τιμή για το Αναγνωριστικό καρτέλας, όχι και για τα δύο.
      

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

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

   1. BusinessEventName: Όνομα του συμβάντος που θέλετε να αυξηθεί.

   2. EntityRecordId: Το αναγνωριστικό της εγγραφής που μόλις δημιουργήθηκε και συσχετίστηκε με το συμβάν.

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

   1. ProviderMessageRequestExecutionId: Το αναγνωριστικό εξόδου της εγγραφής που δημιουργήθηκε για την παρακολούθηση της προόδου της επεξεργασίας του μηνύματος.

   2. IsProviderMessageRequestExecutionSuccess: δυαδική τιμή τιμή για να υποδείξει εάν η επεξεργασία ήταν επιτυχής.

Ροή έλξης μηνυμάτων παρόχου

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

Σημείωση

Το πρόγραμμα διαχείρισης μηνυμάτων είναι απαραίτητη προϋπόθεση για τη ροή του προγράμματος έλξης μηνυμάτων.

Το παρακάτω είναι ένα παράδειγμα δομής για τη δημιουργία ενός τύπου προγράμματος έλξης μηνυμάτων ροής Power Automate.

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

2. Λάβετε ένα σημείο ελέγχου από το Dataverse. Τα σημεία ελέγχου παρακολουθούν ποια μηνύματα έχουν ληφθεί με επιτυχία από την εξωτερική υπηρεσία παροχής. Προσθέστε τις ακόλουθες λεπτομέρειες.

   1. Όνομα ενέργειας: Όνομα για το σημείο ελέγχου.

   2. WorkflowId: Ορίστε την ακόλουθη συνάρτηση σύνθεσης για να ανακτήσετε αυτές τις πληροφορίες: workflow()['tags']['xrmWorkflowId'].
      

3. Δημιουργήστε μια αίτηση ανάρτησης HTTP σε εξωτερική υπηρεσία παροχής για έλξη μηνυμάτων. Προσθέστε τις ακόλουθες λεπτομέρειες.

   1. Μέθοδος: Ορίστε αυτό το πεδίο σε POST.

   2. URL: Το τελικό σημείο του εξωτερικού παρόχου.

   3. Body: Το αίτημα JSON πρέπει να έχει τον ακόλουθο τύπο: if(empty(outputs('Get_Checkpoint')?['body/Checkpoint']), 0, int(outputs('Get_Checkpoint')?[ «σώμα/σημείο ελέγχου»])).
      

4. Αναλύστε τα μηνύματα που έλξατε στο βήμα 3. Προσθέστε τις ακόλουθες λεπτομέρειες.

   1. Περιεχόμενο: Το σώμα ανακτήθηκε από το βήμα 3.

   2. Σχήμα: Η δομή του σώματος που ανακτήθηκε στο βήμα 3.
      

5. Επεξεργαστείτε τα μηνύματα για επανάληψη κάθε μηνύματος από το βήμα 4.

6. Αναλύστε κάθε μήνυμα από τα προηγούμενα βήματα. Προσθέστε τις ακόλουθες πληροφορίες.

   1. Περιεχόμενο: Τρέχον στοιχείο από Διεργασία Μηνύματα.

   2. Schema: Ένα μεμονωμένο μήνυμα σε μορφή JSON.
      

7. Καλέστε το πρόγραμμα χειρισμού μηνυμάτων της συσχετισμένης υπηρεσίας παροχής που έχετε ρυθμίσει στις προϋποθέσεις. Προσθέστε τις ακόλουθες πληροφορίες.

   1. θυγατρική ροή: Επιλέξτε το πρόγραμμα χειρισμού μηνυμάτων του παρόχου σας.

   2. Μήνυμα: Το μήνυμα αναλύθηκε από το βήμα 6.
      

8. Αποθηκεύστε το σημείο ελέγχου στο Dataverse. Προσθέστε τις ακόλουθες πληροφορίες.

   1. Σημείο ελέγχου: Αυτή μπορεί να είναι οποιαδήποτε τιμή συμβολοσειράς (μέγιστο 100). Σε αυτό το παράδειγμα, αυτό είναι το αναγνωριστικό του τελευταίου επεξεργασμένου μηνύματος.

   2. WorkFlowId: Μπορείτε να ανακτήσετε αυτό το αναγνωριστικό προσθέτοντας μια συνάρτηση σύνθεσης που έχει οριστεί στη ροή εργασίας()['tags']['xrmWorkflowId'].
      

Ενέργεια παρόχου

Οι ροές ενεργειών της υπηρεσίας παροχής επικαλούνται από το εργαλείο σχεδίασης συντονισμού. Αυτές οι ροές πραγματοποιούν συνήθως κλήσεις από το Intelligent Order Management σε εξωτερικές υπηρεσίες.

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

Το παρακάτω είναι ένα παράδειγμα δομής για μια ροή ενέργειας υπηρεσίας παροχής Power Automate.

1. Ξεκινήστε με ένα έναυσμα HTTP. Οι παρακάτω πληροφορίες θα διαβιβαστούν κατά τη διάρκεια της εκτέλεσης από την υπηρεσία ενορχήστρωσης. Το ακόλουθο σχήμα JSON θα χρησιμοποιηθεί για το σώμα:

{
    "type": "object",
    "properties": {
        "text": {
            "title": "ProviderActionExecutionEventId",
            "type": "string",
            "x-ms-dynamically-added": true,
            "description": "Please enter your input",
            "x-ms-content-hint": "TEXT"
        },
        "text_1": {
            "title": "EntityRecordId",
            "type": "string",
            "x-ms-dynamically-added": true,
            "description": "Please enter your input",
            "x-ms-content-hint": "TEXT"
        }
    },
    "required": [
        "text",
        "text_1"
    ]
}

2. Ξεκινήστε την επεξεργασία της ενέργειας.

   1. Αρχικοποιήστε το αποτέλεσμα εκτέλεσης και οποιεσδήποτε άλλες μεταβλητές επεξεργασίας.

   2. Επιβεβαιώστε την έναρξη της εκτέλεσης της ενέργειας χρησιμοποιώντας την ενέργεια του Dataverse Έναρξη εκτέλεσης ενέργειας υπηρεσίας παροχής. Αυτό θα επιτρέψει στη διοχέτευση να παρακολουθεί, να ξαναδοκιμάζει και να εμφανίζει την κατάσταση επεξεργασίας εντός του Intelligent Order Management. Προσθέστε τις ακόλουθες πληροφορίες.

      1. ProviderActionExecutionEventId: Αυτή η τιμή μεταβιβάστηκε στην ενέργεια ως παράμετρος εισόδου στο βήμα 1.

      2. PowerAutomateRunID: Η μοναδική εκτέλεση της ενέργειας Power Automate . Αυτό επιτρέπει στη διοχέτευση να συνδέσει τα αρχεία καταγραφής εκτέλεσης. Λάβετε αυτές τις πληροφορίες ορίζοντας το πεδίο σε μια έκφραση Power Automate worflow()['run']?['name'].

3. Εκτελέστε την ενέργεια.

   1. Εάν είναι απαραίτητο, μετασχηματίστε τις καρτέλες χρησιμοποιώντας το Μήνυμα μετασχηματισμού με τη θυγατρική ροή του Power Query Online.

      1. Όνομα παρόχου: Το όνομα του παρόχου που θα συνδεθεί με την ενέργεια. Το όνομα πρέπει να είναι το ίδιο με τον ορισμό της υπηρεσίας παροχής σας.

      2. Προέλευση όνομα αντικειμένου: Το όνομα προέλευσης του μετασχηματισμού που θα εκτελεστεί. Αυτό το όνομα πρέπει να είναι το ίδιο αντικείμενο προέλευσης που ορίζεται στον Power Automate μετασχηματισμό σας.

      3. Όνομα αντικειμένου προορισμού: Η τιμή του κλειδιού αναζήτησης προορισμού για την εκτέλεση του μετασχηματισμού. Αυτό το όνομα πρέπει να είναι ίδιο με την τιμή που ορίζεται στον μετασχηματισμό της υπηρεσίας παροχής σας.

      4. Ωφέλιμο φορτίο: Παρέχεται κατά τη μετατροπή ενός εισερχόμενου ωφέλιμου φορτίου JSON. Το Power Automate απαιτεί να διαβιβαστούν οι παράμετροι ως σειριακή συμβολοσειρά. Προσθέστε μια τιμή για το Ωφέλιμο φορτίο ή μια τιμή για το Αναγνωριστικό καρτέλας, όχι και για τα δύο.

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

   2. Εκτελέστε τυχόν προσαρμοσμένες ενέργειες που έχετε ορίσει. Αυτές είναι ενέργειες που υπάρχουν στην Power Automate σύνδεση που χρησιμοποιείτε.

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

      1. BusinessEventName: Το όνομα του συμβάντος που θέλετε να αυξήσετε.

      2. EntityRecordId: Το αναγνωριστικό της εγγραφής που σχετίζεται με το συμβάν.

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

   1. ExecutionResult: τιμή δυαδική τιμή για να υποδείξει εάν η επεξεργασία ήταν επιτυχής.

   2. ExecutionDetails: Προαιρετικά στοιχεία καταγραφής για σκοπούς δοκιμής και εντοπισμού σφαλμάτων.

   3. ProviderActionExecutionEventId: Αυτή η τιμή μεταβιβάστηκε στην ενέργεια ως παράμετρος εισόδου που ορίστηκε στο βήμα 1.
      

Θυγατρική ροή

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

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

Δημιουργία ροών cloud

Όταν κατανοήσετε τους τύπους ροών που θέλετε να δημιουργήσετε, είστε έτοιμοι να δημιουργήσετε ροές cloud. Για να το κάνετε αυτό, ακολουθήστε αυτά τα βήματα:

1. Ανοίξτε την προεπιλεγμένη λύση στο Power Apps περιβάλλον σας.

Σημαντικό

Μην προσθέτετε αυτές τις λύσεις στη λύση της υπηρεσίας παροχής σας.

2. Επιλέξτε Νέα και μετά επιλέξτε Ροή cloud.

3. Δημιουργήστε την Power Automate ροή σας. Χρησιμοποιήστε τα πρότυπα στην προηγούμενη ενότητα για αναφορά.

4. Ανατρέξτε στην παρακάτω ενότητα για να αποθηκεύσετε τις ροές σας.

Αποθηκεύστε τον ορισμό Power Automate

Αφού δημιουργήσετε τις ροές σας, πρέπει να τις αποθηκεύσετε ως στοιχεία Λογικός ορισμός υπηρεσίας παροχής. Αυτός ο τύπος στοιχείου παρέχει στο Intelligent Order Management τις ενέργειες που πρέπει να αναπτυχθούν κατά την ενεργοποίηση της υπηρεσίας παροχής.

Πρέπει να έχετε τις ακόλουθες προϋποθέσεις για να μπορέσετε να αποθηκεύσετε τις ροές σας.

• Για να αποθηκεύσετε τους λογικούς ορισμούς του Power Automate, θα χρειαστεί να εκδώσετε αιτήσεις OData. Για να το κάνετε αυτό, χρειάζεστε έναν λογαριασμό στο PostMan ή μια παρόμοια υπηρεσία.

• Θα χρειαστεί να δημιουργήσετε ένα διακριτικό πρόσβασης στο Dataverse περιβάλλον σας για να εκδώσετε αιτήσεις GET και POST.

  • Ρυθμίστε έναν λογαριασμό Azure με μια ενεργή συνδρομή. Εάν δεν έχετε ενεργό λογαριασμό, πρέπει να δημιουργήσετε έναν λογαριασμό στον ιστότοπο του Azure.

  • Πρέπει να εγκατασταθεί το PowerShell. Για περισσότερες πληροφορίες, δείτε Εγκατάσταση του PowerShell.

  • Εισαγάγετε την ακόλουθη εντολή στο PowerShell για να λάβετε ένα διακριτικό πρόσβασης: az login --allow-no-subscriptions account get-access-token --resource=https://YourDataverseTenantURL.api.crm.dynamics.com/ --query=accessToken --output=tsv | Set-Clipboard.

Για να αποθηκεύσετε τον Power Automate ορισμό σας, κάντε τα εξής.

1. Βρείτε το αναγνωριστικό ροής εργασίας της Power Automate ροής που θέλετε να αποθηκεύσετε. Κάντε ένα από τα παρακάτω.

   1. Βρείτε το αναγνωριστικό ροής εργασίας χρησιμοποιώντας μια Power Automate ενέργεια.

      1. Δημιουργία μια ενέργεια σύνθεσης με την έκφραση workflow() στο τέλος της Power Automate ροής σας.
         

      2. Εκτελέστε το Power Automate.

      3. Η ιδιότητα xrmWorkflowId από τα αποτελέσματα της εκτέλεσης θα περιέχει το αναγνωριστικό ροής εργασίας.
         

      4. Διαγράψτε αυτήν την ενέργεια από τη ροή για να μην εκτελεστεί ξανά.

   2. Προαιρετικά, μπορείτε να εκδώσετε ένα αίτημα λήψης OData.

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

      2. Υποβάλετε μια αίτηση OData για την ανάκτηση των μεταδεδομένων της ροής εργασίας. Ακολουθεί ένα παράδειγμα αίτησης GET.
         GET {Env url}/api/data/v9.1/workflows?$filter=workflowidunique eq '{Unique Workflow Id from the Power Automate U}'&$select=workflowid,workflowidunique

      3. Αποθηκεύστε την επιστρεφόμενη ιδιότητα workflowid.

2. Βρείτε το αναγνωριστικό ορισμού υπηρεσίας παροχής.

   1. Επιλέξτε τον ορισμό της υπηρεσίας παροχής στην οποία θέλετε να αποθηκεύσετε τη ροή.

   2. Αντιγράψτε τον ορισμό της υπηρεσίας παροχής από τη διεύθυνση URL. Αυτό είναι τμήμα του URL ../id={example number}/.
      

3. Σημειώστε την τιμή συνόλου επιλογών για τον τύπο Power Automate που αποθηκεύετε.

   1. θυγατρική ροή: 192350002

   2. Ενέργεια παρόχου: 192350001

   3. Χειριστής μηνυμάτων παρόχου: 192350000

   4. ροή έλξης μηνυμάτων παρόχου: 192350003

4. Υποβάλετε ένα αίτημα POST για αποθήκευση του Power Automate ορισμού σας. Ακολουθεί ένα παράδειγμα αίτησης.

    POST: {Env url}/api/data/v9.1/msdyn\_SaveProviderDefinitionLogicDefinition  
    Body:  
    {

"ProviderDefinitionId": "{ProviderId previously found}",

"WorkflowId": "{Power Automate WorkflowId previously found}",

"LogicalName": "{Export prefix \_ Power Automate Export Name}",

"LogicType": {Logic Type},

"MaxRetryAttempts": {Max number of attempts},

"TimeoutMinutes": {Timeout number ex: 5}

}

5. Επιβεβαιώστε ότι το στοιχείο Ορισμός λογικού ορισμού υπηρεσίας παροχής προστέθηκε. Για να το κάνετε αυτό, ακολουθήστε αυτά τα βήματα:

   1. Μεταβείτε στη λύση υπηρεσίας παροχής σας.

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

Αποθηκεύστε τις αναφορές σύνδεσης

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

1. Υποβάλετε μια αίτηση GET για να ανακτήσετε το αναγνωριστικό αναφοράς της σύνδεσής σας. Για παράδειγμα:

GET {Env url}/api/data/v9.2/connectionreferences

Εάν θέλετε να φιλτράρετε περαιτέρω, μπορείτε να φιλτράρετε με βάση το όνομα αναφοράς σύνδεσης. Για παράδειγμα:

    {Env url}/api/data/v9.2/connectionreferences?$[connectionreferences?$filter=connectionreferencedisplayname](https://orgdb90e3a2.api.crm10.dynamics.com/api/data/v9.2/connectionreferences?$filter=connectionreferencedisplayname) eq 'Provider Example'&$select=connectionreferencelogicalname,connectionreferencedisplayname,connectionreferenceid,connectorid

2. Επιβεβαιώστε ότι το σωστό αναγνωριστικό αναφοράς σύνδεσης ανακτήθηκε αναζητώντας τα δεδομένα πελάτη σας Power Automate.

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

   2. Ελέγξτε τα δεδομένα πελάτη για να επαληθεύσετε ότι εμφανίζεται το connectionReferenceLogicalName.

3. Βρείτε το αναγνωριστικό ορισμού της υπηρεσίας παροχής. Αυτή είναι η ίδια τιμή που χρησιμοποιήσατε στο Βήμα 2 για να αποθηκεύσετε τους Power Automate λογικούς σας ορισμούς.

4. Υποβάλετε μια αίτηση ανάρτησης για να αποθηκεύσετε την αναφορά σύνδεσης. Για παράδειγμα:

POST {Env url}/api/data/v9.1/msdyn\_SaveProviderDefinitionConnectionReference  
    Body:  
    {

"ProviderDefinitionId": "{ProviderId previously found}",

"ConnectionReferenceId": "{Connection reference id previously found}"

}

5. Επιβεβαιώστε ότι το στοιχείο Ορισμός λογικού ορισμού υπηρεσίας παροχής προστέθηκε.

   1. Μεταβείτε στη λύση υπηρεσίας παροχής σας.

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

Κοινοποιήστε τις υπηρεσίες παροχής σας

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