Loo töökorraldused Power Automate'i abil

Töökorraldusi saab automaatselt luua Dynamics 365 Field Service'is, kasutades Power Automate'i vooge. See on kasulik, kui töökorraldusi tuleb luua väliste päästikute põhjal, nagu IoT hoiatus, vormi esitamine, teenusetaotlus teisest süsteemist või seotud kirje muutmine.

Power Automate vood kasutavad Microsoft Dataverse ühendust, et suhelda väliteenistuse kirjetega. Lisateabe saamiseks töökorralduste loomise kohta koodi kaudu külastage Töökorralduste loomist kasutades Dataverse'i veebi API-d.

Eeltingimused

  • Power Automate litsents (enamikus Dynamics 365 litsentsides kaasas).
  • Vähemalt üks järgmistest Väliteenistuse turvarollidest, mis on määratud voo ühenduskontole. Loe lähemalt jaotisest Seadista kasutajad ja turvarollid.
    • Väliteenistus – dispetšer
    • Väliteenus – administraator
  • Olemasolevad kirjed otsinguväljade jaoks, mida teie töökorralduse protsess kasutab:
    • Töökorralduse tüüp (msdyn_workordertype üksus)
    • Hinnakiri (pricelevel üksus), kui sinu protsess seda nõuab
    • Teenusekonto (account üksus), kui valitud töökorralduse tüüp nõuab teeninduskontot või soovid kontolt tuletatud konteksti

Variant 1: Loo töökorraldus, kui Dataverse'i kirje muutub

Kasuta seda mustrit, et luua töökorraldus vastusena teisele Dataverse'i tabeli muutusele, näiteks kui kliendi vara staatus muutub.

Seadista päästik

  1. Power Automate vali Create>Automated cloud flow.

  2. Otsi ja vali Kui rida lisatakse, muudetakse või kustutatakse (Microsoft Dataverse ühendus).

  3. Kui küsitakse, logi sisse Microsoft Dataverse ühendusse, kasutades oma Dynamics 365 mandaateandmeid. Kui sul on juba ühendus oma keskkonnaga, vali see rippmenüüst. Päästiku konfiguratsiooniväljad täituvad alles siis, kui aktiivne ühendus on loodud.

  4. Seadista päästik:

    Väli Väärtus
    Muuda tüüpi Muudetud
    Tabeli nimi Kliendivarad
    Ulatus Organisatsioon

  5. Soovi korral lisa Filter reads tingimus, et piirata voolu käivitusaega. Näiteks: msdyn_operationalstatus eq 690970001 (Vajab hooldust).

Näpunäide

Töökorralduse loomise samme testimiseks ilma Dataverse'i kirjet muutmata, loo oma voo koopia ja asenda Dataverse'i käivitaja voo käsitsi käivitamisega. Lisa sisendparameetrid (näiteks tekstisisendid teeninduskonto ID, töökorralduse tüübi ID ja hinnakirja ID), et saaksid voo käivitamisel testiväärtusi läbida. Kui oled veendunud, et töökorraldus on õigesti loodud, lülitu tootmisvoos tagasi Dataverse'i päästikule.

Lisa Loo töökorralduse tegevus

  1. Vali + Uus samm ja otsi Lisa uus rida (Microsoft Dataverse ühendus).

  2. Vali sama Dataverse'i ühendus, mida kasutasid päästiku jaoks. Tabeli nime väli ilmub alles pärast ühenduse valimist.

  3. Sea tabeli nimitöökorraldusteks.

  4. Täida vajalikud väljad:

    Väli Väärtus
    Töökäsu number Võta avaldis guid() sisse kui kohatäitja. Töökorralduse numbri väli on vajalik Dataverse'i ühenduse kasutajaliideses, kuid Field Service'i automaatnumbri plugin määrab automaatselt õige järjestikuse töökorralduse numbri, kui kirje salvestatakse. Avaldise sisestamiseks vali väli, lülitu dünaamilise sisupaneeli Expression vahekaardile, kirjuta guid(), ja vali OK.
    Teenuse konto Vajalik ainult siis, kui valitud töökorralduse tüüp nõuab teeninduskontot. Vali konto otsinguvälja kaudu või sisesta avaldis concat('/accounts(', 'service-account-guid', ')')Expression vahekaardile, kui vajad kõvakodeeritud või dünaamilist GUID-i. Jäta see väli tühjaks töökorralduste tüüpide puhul, kus teeninduskontot ei nõuta ja töökorraldus kasutab teist teenusekonteksti.
    Töökäsu tüüp Vali töökorralduse tüüp otsinguvälja kaudu või sisesta concat('/msdyn_workordertypes(', 'work-order-type-guid', ')') avaldis Expression vahekaardile, kui vajad kõvakodeeritud või dünaamilist GUID-i. Vaata allpool, kuidas seda leida.
    Hinnakiri Vali hinnakiri otsinguvälja kaudu või sisesta avaldis concat('/pricelevels(', 'your-price-list-guid', ')')vahekaardile Expression , kui vajad kõvakodeeritud või dünaamilist GUID-i. Kui sa tood hinnakirja dünaamiliselt nimekirja ridade toimingu abil iga tsükli sees , kasuta concat('/pricelevels(', items('YourLoopName')?['pricelevelid'], ')') seda selle asemel ja asenda YourLoopName oma silmuse nimega. Vaata allpool, kuidas seda leida.
    Süsteemi olek 690970000 (Graafikuta)
    Maksustatav false
    Juhised Kasuta dünaamilist sisu päästikust, näiteks vara nime

    Teeninduskonto: Sisesta konto nimi otse teeninduskonto väljale, et otsida ja valida. Kui vallandajaks on kliendi vara muudatus ja vara on seotud kontoga, saad dünaamilisest sisupaneelist valida Konto (Kliendi varad ). Kui vajad GUID-i otse, mine Service Area>Customers>Accounts in Field Service'i, ava konto ja kopeeri kirje ID brauseri URL-ist (väärtus vahemikus %7B ja %7D, või tavaline GUID, kui URL on kodeerimata). Loe lähemalt jaotisest "Seadista teeninduskonto nõuded töökorraldustele".

    Töökorralduse tüüp: Sisesta töökorralduse tüübi nimi otse töökorralduse tüübi väljale, et seda otsida ja valida. Kui vajad GUID-i otse, mine Seadete ala >Töökorralduse>töökorralduse tüübid Väliteenistuses, ava töökorralduse tüüp ja kopeeri kirje ID brauseri URL-ist.

    Hinnakiri: Sisesta hinnakiri otse hinnakirja väljale , et otsida ja valida. Kui vajad GUID-i otse, mine Field Service'is Seadete>Üldised>hinnakirjad , ava hinnakiri ja kopeeri kirje ID brauseri URL-ist.

    Märkus.

    Dataverse'i ühendus nõuab, et otsinguvälju kasutatakse OData entiteedi viiteteed (näiteks /accounts(guid)), mitte tavalist GUID-i. Lihtsa GUID-i sisenemine põhjustab käivitusaja.ODataUnrecognizedPathException Ülaltoodud concat avaldised konstrueerivad õige tee formaadi.

  5. Salvestage ja testige voolu.

Variant 2: Loo töökorraldus HTTP-päringust

Kasuta seda mustrit, et luua töökorraldus välisest süsteemist, näiteks kliendiportaalist, piletisüsteemist või IoT platvormist.

Seadista päästik

  1. Power Automate. aastal vali Create>Instant cloud flow.

  2. Nimeta voog ja vali Kui HTTP-päring saabub päästikuna.

  3. Valige Loo.

  4. Request Body JSON skeemi väljale kleepi järgmine skeem:

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

    Lisa serviceAccountId , millal valitud töökorralduse tüüp vajab teeninduskontot või millal soovid, et töökorraldus kasutaks kontopõhist konteksti. Jäta see välja töökorralduste puhul, kus teeninduskontot ei nõuta.

  5. Kes saab voolu käivitada, vali üks järgmistest valikutest:

    Suvand Millal kasutada?
    Ainult kasutajad minu üürnikus Soovitatav tootmiseks. Helistajad peavad autentima Microsoft Entra ID-ga ja esitama kehtiva OAuth kandja tokeni. Kasuta seda sisemiste süsteemide või usaldusväärsete teenusepõhimõtete jaoks.
    Keegi URL ise toimib volitusena — täiendavat autentimise päist ei ole vaja. Kasuta ainult siis, kui kutsuv süsteem ei saa Entra ID tokenit ja saad tagada, et URL on turvaliselt salvestatud.

    Loe lähemalt HTTP-käivitatud voogude turvalisuse kohta artikli "Add OAuth autentimine HTTP päringute käivitajate jaoks".

  6. HTTP URL-i väli on ainult lugemiseks — ära täida seda. Power Automate täidab selle automaatselt, kui salvestad voo esimest korda.

  7. Voo salvestamine. HTTP URL-väli on nüüd täidetud lõpp-punkti URL-iga. Kopeeri see URL ja anna see sellele, kes konfigureerib välise süsteemi (näiteks arendajale või süsteemiadministraatorile). Väline süsteem käivitab voo, saates sellele URL-ile HTTP POST päringu koos JSON-kehaga, mis vastab teie määratud skeemile. Näide:

    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"
}

    Iga kord, kui väline süsteem selle päringu saadab, käivitab Power Automate voo ja loob Field Service'is töökorralduse.

Lisa Loo töökorralduse tegevus

  1. Vali + Uus samm ja otsi Lisa uus rida (Microsoft Dataverse ühendus).

  2. Logi sisse Microsoft Dataverse'i ühendusse või vali olemasolev ühendus. Tabeli nime väli ilmub alles pärast ühenduse valimist.

  3. Sea tabeli nimitöökorraldusteks.

  4. Kaardista HTTP päringu keha väljad töökorralduse väljadega:

    Töökorralduse väli Väärtus
    Töökäsu number Võta avaldis guid() sisse kui kohatäitja. Töökorralduse numbri väli on vajalik Dataverse'i ühenduse kasutajaliideses, kuid Field Service'i automaatnumbri plugin määrab automaatselt õige järjestikuse töökorralduse numbri, kui kirje salvestatakse. Avaldise sisestamiseks vali väli, lülitu dünaamilise sisupaneeli Expression vahekaardile, kirjuta guid(), ja vali OK.
    Teenuse konto Kasuta concat('/accounts(', triggerBody()?['serviceAccountId'], ')') ainult siis, kui serviceAccountId see on olemas. Kui teeninduskontot ei nõuta valitud töökorralduse tüübi jaoks ja päring ei sisalda serviceAccountId, ära kaardista seda otsinguvälja.
    Töökäsu tüüp concat('/msdyn_workordertypes(', triggerBody()?['workOrderTypeId'], ')')
    Hinnakiri concat('/pricelevels(', triggerBody()?['priceListId'], ')')
    Süsteemi olek 690970000 (Graafikuta)
    Juhised @{triggerBody()?['instructions']}

  5. Soovi korral lisa vastustegevus , et tagastada uus töökorralduse ID kutsuvale süsteemile:

    1. Vali + Uus samm ja otsi Vastust ( päringu ühendusest).
    2. Sea olekukood .200
    3. Body väljal vali dünaamilise sisu ikoon ja vali msdyn_workorderidLisa uus rida samm. See on just loodud töökorralduse unikaalne ID.

    Ilma selle sammuta ei saa kõnesüsteem vastust ja HTTP päring aegub pärast ootamist. Kui lisad selle sammu, saab 200 kutsuv süsteem vastuse töökorralduse ID-ga kohe, kui voog on lõppenud.

Süsteemi oleku valikute komplekti väärtused

Kasuta neid täisarvulisi väärtusi, kui määrad süsteemi oleku voos või API kutses.

Silt Väärtus
Kavandamata 690970000
Plaanitud 690970001
Pooleli 690970002
Lõpetatud 690970003
Sisestatud 690970004
Tühistatud 690970005

Arvestused

Voo ühenduse konto omamine

Voo poolt loodud töökorraldused kuuluvad ühenduskontole, mida kasutatakse Dataverse'i ühenduses. Veendu, et sellel kontol oleks õige turvaroll ja et voo poolt loodud töökorraldused ilmuksid oodatud vaadetes ja järjekordades.

Laste andmed

Uue rea lisamise tegevus loob ainult töökorralduse päise. Töötellimuste toodete, teenuste või teenindusülesannete lisamiseks lisa iga alamtabeli jaoks eraldi Lisa uus rida sammud (msdyn_workorderproduct, msdyn_workorderservice, msdyn_workorderservicetask) ja määra Töökorralduse otsinguväli ID-ks, mis tagastatakse loomise sammu juures.

API kiiruse piirangud

Power Automate'i voogudele kehtivad Dataverse API piirangud. Suure mahuga stsenaariumite puhul kaalu Dataverse'i Web API partii-lõpp-punkti kasutamist või voogude levitamist ajastatud päästikuga koos partiitöötlusega.

Topelttöökorralduste vältimine

Kui voog jookseb sageli samal päästikul, lisa tingimus, et kontrollida, kas töökorraldus on juba olemas, enne uue loomist. Kasuta loendi ridade tegevust, mis filtreerib lähtekirje ID järgi, et kontrollida olemasolevaid töökorraldusi.

Vigade käsitlemine

Tootmisvoogude puhul mähkige Scope tegevuses 'Lisa uus rida' samm ja lisa paralleelne haru, mis on seadistatud käivituma. Kasuta seda haru, et logida viga või saata teavitus. HTTP-käivitatud voogude puhul lisa alati vastustegevus , et kutsuv süsteem saaks õnnestumise või ebaõnnestumise staatuskoodi, mitte ei võta aega maha.

Järgmised sammud

  • Last updated on