Uuden palveluntarjoajan luominen

2025-05-21

Jäljempänä on ohjeet uuden palveluntarjoajan luomiseen. Näiden ohjeiden avulla voidaan myös tehdä lisäyksiä aiemmin luotuihin palveluntarjoajiin.

Palveluntarjoaja-arkkitehtuurin määrittäminen

Ennen palveluntarjoajan luontia on tärkeä hahmottaa, mitä palveluntarjoajan halutaan tekevän ja mihin sitä halutaan käyttää. palveluntarjoajissa on useita osia, mutta kaikkia niistä ei ehkä tarvita.

Seuraava taulukko auttaa määrittämään, mitkä osat ovat tarpeellisia.

Olosuhteet	Tarvittava osa
Palvelulla, jota varten palveluntarjoaja luodaan, ei ole yhdistintä Power Automatessa. Lisätietoja on kohdassa Kaikki Power Automate -yhdistimet sisältävä luettelo.	Luo mukautettu yhdistin tai käytä yleistä yhdistintä.
Palveluntarjoaja vaihtaa tietoja ulkoisen palvelun ja Microsoft Dataversen välillä.	Palveluntarjoaja tarvitsee palveluntarjoajan muunnoksen. Lisää palveluntarjoajan muunnososa kuhunkin muunnokseen.
Palveluntarjoaja suorittaa logiikkaa hallinnan suunnittelutoiminnosta.	Luo erillinen Power Automate -työnkulku kullekin toiminnolle.
Palveluntarjoajan on käsiteltävä ulkoisen palvelun sanomia.	Luo Power Automaten sanomakäsittelijän työnkulku.
Palveluntarjoaja vastaanottaa sanomia ulkoisesta palvelusta säännöllisin välein.	Luo Power Automaten sanomien vastaanoton työnkulku.
Palveluntarjoaja käynnistää liiketoimintatapahtumia, joita ei ole tällä hetkellä määritetty Intelligent Order Managementissa.	Luo uusi liiketoimintatapahtuman määritys ja lisää aiemmin luodut tapahtumat.

Kun ratkaisut on hahmotettu hyvin, palveluntarjoajan toteuttaminen voidaan aloittaa.

Palveluntarjoajaratkaisun luominen

Palveluntarjoajaratkaisun luominen edellyttää, että seuraavat tässä osassa olevat tehtävät suoritetaan.

Mukautetun palveluntarjoajan määrittäminen.
Palveluntarjoajan määritelmän lisääminen.
Osien lisääminen ratkaisuun.

Mukautetun palveluntarjoajan määrittäminen

Luo Power Appsissa palveluntarjoajan osat sisältävä ratkaisu. Lisätietoja uuden ratkaisun luomisesta Power Appsissa on kohdassa Ratkaisun luominen Power Appsissa.

Palveluntarjoajan määritelmän lisääminen

Palveluntarjoajan määritelmä sisältää tietoja tarjoajasta. Määritelmä määrittää, miten palveluntarjoaja näkyy palveluluettelossa.

Valitse luodussa palveluntarjoajaratkaisussa Uusi.
Valitse IOMPalveluntarjoajan määritelmä.
Lisää seuraavat tiedot:
1. Näyttönimi: palvelulle annettava nimi, kuten Testauspalvelu.
2. Looginen nimi: palveluntarjoajan vientiavain.
3. Kuvaus: palveluntarjoajan toimintaa kuvaileva teksti.
Valitse Tallenna.
Lataa kuva, johon haluat lisätä logon.
Tarkista, että palveluntarjoajan määritelmä näkyy ratkaisussa. Näkyvissä pitäisi olla tietue, jonka osatyyppi on IOM-palveluntarjoajan määritelmä. Jos se ei ole näkyvissä, valitse Lisää aiemmin luotu ja valitse sitten juuri luotu tietue.
Tarkista, että palveluntarjoaja näkyy palveluluettelossa. Jos On aktiivinen -kentän määrityksenä on Kyllä, palveluntarjoajan määritelmä näkyy palveluluettelossa. Avaa Intelligent Order Management. Valitse Palvelut > Luettelo. Tarkista, että palveluntarjoajan määritelmä on näkyvissä.

Osien lisääminen ratkaisuun

Kun palveluntarjoajan määritelmä on luotu, palveluntarjoajan osat lisätään ratkaisuun.

Siirry ratkaisuun.
Valitse Lisää aiemmin luotu.
Valitse osatyypiksi Intelligent Order Management ja valitse sitten juuri luotu tietue.

Palveluntarjoajan muunnoksen luominen

Jos palveluntarjoaja edellyttää muunnosta, palveluntarjoajan muunnososa on lisättävä ratkaisuun. Muunnoksia on ehkä luotava useita.

Valitse palveluntarjoajaratkaisussa Uusi.
Valitse IOM-palveluntarjoajan määritelmän muunnos.
Lisää seuraavat tiedot:
1. Näyttönimi: palveluntarjoajan muunnokselle annettava nimi, kuten Myyntitilausten muunnos.
2. Looginen nimi: Palveluntarjoajan yksilöivä tunnus. Tämä arvo on tietojen tuonti- ja vientiavain. Sen alussa on oltava julkaisijan etuliite. Esimerkiksi Microsoftin julkaisijan etuliite on msdyn_. Esimerkkejä loogisista nimistä: msdyn_flexe_fulfillmentorderproduct_orderline ja msdyn_flexe_fulfillmentorder_order.
3. Lähdetyyppi: Tämä kenttä ilmaisee vastaanotettujen tietojen tyypin. Vaihtoehtoja on kaksi: JsonDocument ja Dataverse Entiteetti. Jos tiedot ovat jo Dataversessa, valitse Dataverse-entiteetti. Valitse muussa tapauksessa JsonDocument. Näitä tietoja käytetään Power Automate -elementissä, joka määritetään hakemaan muunnos.
4. Lähdeobjektin nimi: muunnettavien tietojen nimi. Jos muunnettavana on Dataverse-tietue, varmista, että Lähdeobjektin nimi on sama kuin Dataverse-taulukossa oleva nimi.
5. Kohdeobjektin nimi: muunnettavan tietueen kohteen nimi.
6. Muunnos: Power Query Online MQuery, jota käytetään syötetietojen muuntamiseen. Lisätietoja Power Querysta ja MQuerysta on kohdissa Mikä on Power Query? ja Power Query M -kaavakielen viittaus. Seuraava MQuery-esimerkki muuntaa ulkoisen tilauspalvelun myyntitilauksen Intelligent Order Managementiin myyntitilaukseksi.

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));

Valitse Tallenna.
Tarkista, että muunnososa näkyy oikein. Näkyvissä pitäisi olla osatyyppi IOM-palveluntarjoajan määritelmän muunnos ja muunnoksen nimi. Jos se ei ole näkyvissä, valitse Lisää aiemmin luotu ja valitse sitten juuri luotu muunnos.

Liiketoimintapahtumien määritelmien lisääminen

Jos palveluntarjoaja luo tai käyttää uusia liiketoimintatapahtumia, IOM-palveluntarjoajan määrityksen liiketoimintatapahtuman määritys -osat ratkaisuun. Vain sellaiset liiketoimintatapahtumat on lisättävät, jotka eivät vielä ole Intelligent Order Managementissa.

Jos haluat luoda liiketoimintatapahtuman, jota ei ole vielä Intelligent Order Managementissa, voit luoda oman tapahtuman.

Valitse Uusi.
Valitse Palveluntarjoajan määrityksen liiketoimintatapahtumamääritys.
Lisää seuraavat tiedot:
1. Nimi: liiketoimintatapahtuman nimi.
2. Palveluntarjoaja: palveluntarjoaja, jolle tämä liiketoimintamääritys luodaan.
3. Liittyvä entiteetti: Intelligent Order Managementin Dataverse-entiteetti, jota luotava tapahtuma muuttaa tai johon sillä on vaikutusta.
4. Liittyvän tilan arvo: jos liittyvän entiteetin tilan halutaan päivittää, kun liiketoimintatapahtuma käynnistetään, tähän kenttään sisällytetään tilan arvo.
5. Liittyvän tilanteen arvo: jos liittyvän entiteetin tilanne halutaan päivittää, kun liiketoimintatapahtuma käynnistetään, tähän kenttään sisällytetään tilanteen arvo.
Valitse Tallenna.
Tarkista, että IOM Palveluntarjoajan liiketoimintatapahtumamääritys -tietue näkyy ratkaisussa. Jos tietue ei näy ratkaisussa, valitse Lisää aiemmin luotu ja valitse sitten juuri luotu tietue.

Lisää yhdistin

Jos palveluntarjoaja tarvitsee yhdistimen, joka ei ole saatavana Power Automatessa, oma yhdistin on luotava. Lisätietoja on kohdassa Kaikkien Power Automate -yhdistimien luettelo.

Lisätietoja oman Power Automate -yhdistimen luomisesta on kohdassa Mukautettujen yhdistimien yleiskatsaus.

Kun mukautettu yhdistin on luotu, se lisätään osana palveluntarjoajaratkaisuun.

Siirry palveluntarjoajaratkaisuun.
Valitse Lisää aiemmin luotu.
Valitse luotu yhdistin.

Power Automate -työnkulkujen tyypit

Mikä tahansa hallinnan suunnittelutoiminnossa suoritettava toiminto ilmaistaan Power Automate -työnkulkuna. Jos Power Automaten halutaan noutavan tiettyjä tietoja tai suorittaman tiettyjä toimintoja, näille toiminnoille on luotava työnkulku. Lisätietoja Power Automatesta on kohdassa Power Automaten ottaminen käyttöön.

Työnkulut lisätään palveluntarjoajaan Palveluntarjoajan määrityksen logiikkamääritys -osina.

Ennen työnkulun luontiprosessin aloittamista kannattaa tutustua Intelligent Order Managementissa käytettäviin työnkulkutyyppeihin.

Palveluntarjoajan sanomakäsittelijä

Näissä työnkuluissa vastaanotetaan ja käsitellään ulkoisen palvelun sanomia sekä käynnistetään soveltuva liiketoimintatapahtuma Intelligent Order Managementin hallintaan ilmoittamista varten. Näiden työnkulkujen käynnistäjä on ulkoinen palvelu.

Seuraava esimerkkirakenne koskee sanomakäsittelijätyyppisen Power Automate -työnkulun luontia.

Määritä Power Automate -käynnistin. Se on yleensä HTTP-päätepiste, joka on webhook-käynnistin (suositus), yhdistinkäynnistin tai Dataverse-lisäyskäynnistin. Käynnistin käynnistetään, kun ulkoisessa palvelussa on Intelligent Order Managementiin lähetettäviä tietoja.

HTTP-käynnistimessä käytettävä JSON-skeema on määritetty alla.

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

Käynnistä sanoman käsittely. Tässä tehtävässä on kaksi vaihetta.
1. Käynnistä suorituksen tulos, jota käytetään sanoman käsittelyn seuraamiseen.
2. Kuittaa palveluntarjoajan sanoma Intelligent Order Managementin, mikä mahdollista käsittelyn tilan seuraamisen, uudelleenyrittämisen ja näyttämisen. Tämä Power Automate -toiminto, jonka Intelligent Order Management ottaa käyttöön. Toiminnon nimi on Kuittaa palveluntarjoajan sanomapyyntö IOM:ssä. Toiminnossa on seuraavat pakolliset parametrit.
  1. PowerAutomateWorkflowId: Sanoman käsittelijän määrityksen WorkflowId. Se voidaan noutaa käyttämällä luontifunktiota, jossa on workflow()['tags'].
  2. PowerAutomateRunId: Sanoman vastaanottaneen Power Automate -suorituksen yksilöivä tunnus, joka antaa putkelle mahdollisuuden yrittää käsittelyä uudelleen ja linkittää suorituslokit. Se voidaan noutaa käyttämällä luontifunktiota, jossa on workflow()['run']?['name'].
  3. ProviderMessageExternalRequestId: Lähetyn sanoman tunnus. Jos tunnusta ei ole, GUID voidaan luoda. Tämän tunnuksen avulla putki voi estää lähettää lähettämässä sanomien kaksoiskappaleita. Tunnus on riippuvainen lähteen tiedoista. Esimerkki: concat(triggerOutputs()?['body']?['type']?['name'], '_', triggerOutputs()?['body']?['id']).

Näyttökuvassa Kuittaa palveluntarjoajan sanomapyyntö -näyttö

Aiemmin määritetty palveluntarjoajan muunnos noutaa syöttötiedot ja muuntaa ne. Intelligent Order Managementissa on käyttövalmis IOM:n palveluntarjoajan muunnos -työnkulku, joka suorittaa muunnoksen. Tapahtuma tai sanoma voidaan käsitellä lisäämällä seuraavat tiedot:
1. Palveluntarjoajan nimi: Sanomakäsittelijään linkitetyn palveluntarjoajan nimi. Tämän arvon on oltava sama kuin palveluntarjoajan muunnoksen nimi.
2. Lähdeobjektin nimi: Suoritettavan muunnoksen lähteen hakuavaimen arvo. Tämän arvon on oltava sama kuin palveluntarjoajan muunnoksessa määritetyn lähdeobjektin nimi.
3. Kohdeobjektin nimi: Suoritettavan muunnoksen kohteen hakuavaimen arvo. Tämän arvon on oltava sama kuin palveluntarjoajan muunnoksessa määritetty arvo.
4. Tiedot: Annetaan JSON-tietoja muunnettaessa. Power Automate edellyttää, että parametrit välitetään sarjoitettuna merkkijonona. Joko Tiedot- tai Tietuetunnus-arvo annetaan, ei molempia.
5. Tietuetunnus: Annetaan Dataverse-tietuetta muunnettaessa. Joko Tiedot- tai Tietuetunnus-arvo annetaan, ei molempia.
Dataverseen voi lisätä tietoja käyttämällä HTTP-pyyntöjä tai Dataverse-yhdistimen Lisää-toimintoa. Jos lisäyksiä on enemmän kuin yksi ja suorituskykyä halutaan parantaa, lisäykset voidaan paketoida muutosjoukoksi, jolloin pyynnöistä muodostaa tapahtumaerä.
Jos työnkulun halutaan käynnistävän liiketoimintatapahtuman, se voidaan tehdä käyttämällä Käynnistä liiketoimintatapahtuma -alityönkulku. Seuraavat tiedot lisätään.
1. BusinessEventName: käynnistettävän tapahtuman nimi.
2. EntityRecordId: juuri luodun ja tapahtumaan liitetyn tietueen tunnus.
Sanoman käsittelytila päivitetään Päivitä palveluntarjoajan sanomapyynnön tila -toiminnolla, jolloin myös käsittelyn suorittamisen tulos tallennetaan. Seuraavat tiedot lisätään.
1. ProviderMessageRequestExecutionId: sanoman käsittelyn edistymistä seuraamaan luodun tietueen tuotostunnus.
2. IsProviderMessageRequestExecutionSuccess: käsittelyn onnistumisen ilmaiseva totuusarvo.

Palveluntarjoajan sanomien vastaanotto

Palveluntarjoajan sanomien vastaanotot ovat Power Automate -työnkulkuja, jotka vastaanottavat säännöllisin väliajoin sanomia ulkoisesta palvelusta.

Huomautus

Sanomakäsittelijä on sanoman vastaanottotyönkulun edellytys.

Seuraava esimerkkirakenne koskee sanoman vastaanottotyyppisen Power Automate -työnkulun luontia.

Ajoita käynnistin toistuvan työnkulun avulla.
Hanki Dataverse-tarkistuspiste. Tarkistuspisteet seuraavat, minkä sanoman vastaanottoa ulkoisesta palvelusta on onnistunut. Seuraavat tiedot lisätään.
1. Toiminnon nimi: tarkistuspisteen nimi.
2. WorkflowId: nämä tiedot noudetaan määrittämällä seuraava luontifunktio: workflow()['tags']['xrmWorkflowId'].
Luo ulkoiseen palveluntarjoajaan HTTP post -pyyntö sanomien vastaanottoa varten. Seuraavat tiedot lisätään.
1. Menetelmä: kentän arvoksi määritetään POST.
2. URL-osoite: ulkoisen palveluntarjoajan päätepiste.
3. Tekstiosa: JSON-pyynnössä on käytettävä seuraavaa kaavaa: if(empty(outputs('Get_Checkpoint')?['body/Checkpoint']), 0, int(outputs('Get_Checkpoint')?['body/Checkpoint'])).
Jäsennä vaiheessa 3 vastaanotetut sanomat. Seuraavat tiedot lisätään.
1. Sisältö: vaiheessa 3 noudettu tekstiosa.
2. Rakenne: vaiheessa 3 noudetun tekstiosan rakenne.
Käsittele sanomat niin, että kukin vaiheen 4 sanoma on mukana silmukassa.
Jäsennä jokainen edellisten vaiheiden sanoma. Lisää seuraavat tiedot.
1. Sisältö: nykyinen kohde Käsittele sanomat -toiminnossa.
2. Rakenne: yksi JSON-muotoinen sanoma.
Kutsu edellytyksissä määritettyä liitettyä palveluntarjoajan sanomakäsittelijää. Lisää seuraavat tiedot.
1. Alityönkulku: palveluntarjoajan sanomakäsittelijän valinta.
2. Sanoma: vaiheen 6 jäsennetty sanoma.
Tallenna tarkistuspiste Dataverseen. Lisää seuraavat tiedot.
1. Tarkistuspiste: Jokin merkkijonon arvo (enintään 100). Tässä esimerkissä se on viimeksi käsitellyn sanoman tunnus.
2. WorkFlowId: tämä tunnus voidaan noutaa lisäämällä luontifunktio workflow()['tags']['xrmWorkflowId'].

Palveluntarjoajan toiminto

Palveluntarjoajan toimintotyökulut käynnistetään hallinnan suunnittelutoiminnosta. Näissä työnkuluissa tehdään tyypillisesti kutsuja Intelligent Order Managementista ulkoisiin palveluihin.

Palveluntarjoajan sanomakäsittelijän ja palveluntarjoajan toiminnon keskeinen ero on se, että vaikka sanomakäsittelijä voi tehdä ilmoituksia hallinnan suunnittelutoiminto, hallinnan suunnittelutoiminnon toimintoruutu ei voi käynnistää sitä, kun taas se on mahdollista palveluntarjoajan toiminnon kohdalla.

Seuraava on palveluntarjoajan toiminnon Power Automate -työnkulun esimerkkirakenne.

Aloita HTTP-käynnistimen avulla. Hallintapalvelu välittää seuraavat tiedot suorituksen aikana. Tekstiosassa käytetään seuraavaa JSON-skeemaa:

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

Käynnistä toiminnon käsittely.
1. Käynnistä suoritustulos ja muut mahdolliset käsittelymuuttujat.
2. Kuittaa toiminnon suorittaminen alkaminen Aloita palveluntarjoajan toiminnon suorittaminen Dataverse -toiminnon avulla. Tällä tavoin putki voi seurata, yrittää uudelleen ja näyttää käsittelyn tilan Intelligent Order Managementissa. Lisää seuraavat tiedot.
  1. ProviderActionExecutionEventId: tämä arvo välitettiin toimintoon syöttöparametrina vaiheessa 1.
  2. PowerAutomateRunID: Power Automate -toiminnon yksilöivä suoritus. Tämä mahdollistaa putken linkittämisen suorituslokeihin. Nämä tiedot saadaan määrittämällä kenttään Power Automate -lausekkeen worflow()['run']?['name'].
Suorita toiminto.
1. Muunna tietueet tarvittaessa käyttämällä Muunna sanoma Power Query Onlinen avulla -alityönkulkua.
  1. Palveluntarjoajan nimi: Toimintoon linkitettävän palveluntarjoajan nimi. Nimen on oltava sama kuin palveluntarjoajan määrityksen nimi.
  2. Lähdeobjektin nimi: Suoritettavan muunnoksen lähteen nimi. Tämän nimen on oltava sama kuin Power Automate -muunnoksessa määritetty lähdeobjekti.
  3. Kohdeobjektin nimi: Suoritettavan muunnoksen kohteen hakuavaimen arvo. Tämän nimen on oltava sama kuin palveluntarjoajan muunnoksessa määritetty arvo.
  4. Tiedot: Annetaan saapuvia JSON-tietoja muunnettaessa. Power Automate edellyttää, että parametrit välitetään sarjoitettuna merkkijonona. Joko Tiedot- tai Tietuetunnus-arvo lisätään, ei molempia.
  5. Tietuetunnus: Annetaan lähtevää Dataverse-tietuetta muunnettaessa. Joko Tiedot- tai Tietuetunnus-arvo lisätään, ei molempia.
2. Suorita mahdollisesti määritetyt mukautetut toiminnot. Ne ovat käytettävässä Power Automate -yhdistimessä olevia toimintoja.
3. Käynnistä toimintokohtainen liiketoimintatapahtuma. Käytä Käynnistä liiketoimintatapahtuma -alityönkulkua. Lisää seuraavat tiedot.
  1. BusinessEventName: käynnistettävän tapahtuman nimi.
  2. EntityRecordId: tapahtumaan liitetyn tietueen tunnus.
Suorita toiminto ja tallenna tulokset. Hallinnan suunnittelutoiminto käsittelee tulokset. Lisää seuraavat tiedot.
1. ExecutionResult: käsittelyn onnistumisen ilmaiseva totuusarvo.
2. ExecutionDetails: valinnaiset lokitiedot testausta ja virheenkorjausta varten.
3. ProviderActionExecutionEventId: tämä arvo välitettiin toimintoon vaiheessa 1 määritettynä syöttöparametrina.

Alityönkulku

Alityönkulku on alisteinen työnkulku, johon muut Power Automate -työnkulut viittaavat. Alityönkulku kannattaa määrittää, jos tiettyjä vaiheita toistetaan useilla alueilla. Alityönkuluille ei ole tiettyä mallia tai suositeltua prosessia, sillä niiden avulla voidaan lähinnä konsolidoida kätevästi samankaltaisia vaiheita.

Palveluntarjoajan alityönkulut eivät voi kutsua toisen palveluntarjoajan alityönkulkuja.

Pilvityönkulkujen luominen

Kun luotavat työnkulkutyypit on hahmotettu, ollaan valmiita luomaan pilvityönkulkuja. Ne luodaan seuraavasti:

Avaa oletusratkaisu Power Apps -ympäristössä.

Tärkeä

Näitä ratkaisuja ei lisätä palveluntarjoajaratkaisuun.

Valitse ensin Uusi ja sitten Pilvityönkulku.
Muodosta Power Automate -työnkulku. Käytä edellisen osan malleja apuna.
Tallenna työnkulut seuraavan osan ohjeiden mukaisesti.

Power Automate -määrityksen tallentaminen

Kun työnkulut on luotu, ne on tallennettava Palveluntarjoajan määrityksen logiikkamääritys -osina. Tämä osa tyyppi tuo Intelligent Order Managementiin toiminnot, jotka otetaan käyttöön palveluntarjoajan aktivoinnin aikana.

Seuraavien edellytysten on toteuduttava ennen työnkulkujen tallentamista.

Power Automate -logiikkamääritysten tallentamista varten on tehtävä OData-pyyntöjä. Sitä varten tarvitaan PostMan-tili tai vastaavan palvelun tili.
GET- ja POST-pyyntöjen tekeminen edellyttää Dataverse-ympäristön käyttöoikeustietueen luontia.
- Määritä Azure-tili, jossa on aktiivinen tilaus. Jos aktiivista tiliä ei ole, se on määritettävä Azure-sivustossa.
- PowerShell on oltava asennettuna. Lisätietoja on kohdassa PowerShellin asentaminen.
- Käyttöoikeustietue saadaan syöttämällä PowerShelliin seuraava komento: az login --allow-no-subscriptions account get-access-token --resource=https://YourDataverseTenantURL.api.crm.dynamics.com/ --query=accessToken --output=tsv | Set-Clipboard.

Power Automate -määritys tallennetaan seuraavasti.

Etsi tallennettavan Power Automate -työnkulun työnkulkutunnus. Tee jompikumpi seuraavista.
1. Etsi työnkulkutunnus Power Automate -toiminnon avulla.
  1. Luo Power Automate -työnkulun loppuun workflow()-lauseke käyttämällä luontitoimintoa.
  2. Suorita Power Automate.
  3. Suorituksen tulosten xrmWorkflowId-ominaisuus sisältää työnkulkutunnuksen.
  4. Estä tämän toiminnon suorittaminen uudelleen poistamalla se työnkulusta.
2. Vaihtoehtoisesti voidaan tehdä Get OData -pyyntö.
  1. Siirry työnkulkuun, jonka työnkulkutunnus halutaan tallentaa. Etsi yksilöivä tunnus URL-osoitteesta. Tämä tunnus näkyy URL-osoitteessa ../flows/-kohdan jälkeen.
  2. Nouda työnkulun metatiedot tekemällä OData-pyyntö. Seuraava on GET-pyyntöesimerkki.
    GET {Env url}/api/data/v9.1/workflows?$filter=workflowidunique eq '{Unique Workflow Id from the Power Automate U}'&$select=workflowid,workflowidunique
  3. Tallenna palautettu workflowid-ominaisuus.
Etsi palveluntarjoajan määritystunnus.
1. Valitse palveluntarjoajan määritys, johon työnkulku halutaan tallentaa.
2. Kopioi palveluntarjoajan määritystunnus URL-osoitteesta. Kyse on tästä URL-osoitteen osasta: ../id={example number}/.
Kirjoita tallennettavan Power Automate -tyypin asetusjoukon arvo muistiin.
1. Alityönkulku: 192350002
2. Palveluntarjoajan toiminto: 192350001
3. Palveluntarjoajan sanomakäsittelijä: 192350000
4. Palveluntarjoajan sanomien vastaanotto: 192350003
Tallenna Power Automate -määritys tekemällä POST-pyyntö. Seuraava on esimerkkipyyntö.

    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}

}

Tarkista, että Palveluntarjoajan määrityksen logiikkamääritys -osa on lisätty. Ne luodaan seuraavasti:
1. Siirry palveluntarjoajaratkaisuun.
2. Tarkista, että luotu palveluntarjoajan määrityksen logiikkamääritys on lisätty. Jos sitä ei ole lisätty, valitse Lisää aiemmin luotu ja lisää sitten luotu osa.

Yhteysviitteiden tallentaminen

Jos palveluntarjoaja käyttää asiakkaan Power Automate -yhdistimiä, yhteysviitteet on tallennettava Power Automate -ratkaisuun seuraavien ohjeiden mukaisesti.

Nouda yhteysviitteen tunnus tekemällä GET-pyyntö. Esimerkiksi:

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

Jos suodatusta halutaan tarkentaa, suodatusperusteena voi käyttää yhteysviitteen nimeä. Esimerkiksi:

    {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

Tarkista, että oikea yhteysviitteen tunnus noudettiin tekemällä haku Power Automate -asiakastiedoissa.
1. Siirry aiemmin tallennettuun Palveluntarjoajan määrityksen logiikkamääritys -osaan.
2. Tarkista asiakastiedoista, että connectionReferenceLogicalName on näkyvissä.
Etsi palveluntarjoajan määritystunnus. Tämä on se arvo, jolla Power Automaten logiikkamääritykset tallennettiin vaiheessa 2.
Tallenna yhteysviite tekemällä post-pyyntö. Esimerkiksi:

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

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

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

}

Tarkista, että Palveluntarjoajan määrityksen logiikkamääritys -osa on lisätty.
1. Siirry palveluntarjoajaratkaisuun.
2. Tarkista, että luotu Palveluntarjoajan määrityksen logiikkamääritys -osa on lisätty. Jos sitä ei ole lisätty, valitse Lisää aiemmin luotu ja lisää sitten juuri luotu osa.

Jos palveluntarjoajan määritystä halutaan käyttää toisessa ympäristössä tai ratkaisu halutaan jakaa, palveluntarjoajaratkaisu voidaan viedä. Lisätietoja on kohdassa Ratkaisujen vieminen.