Sissetulevate ja väljaminevate saadetiste tellimuste kasutamise näide

Paberraha

Azure Active Directory on nüüd Microsoft Entra ID. Lisateave

See artikkel annab näidestsenaariumi, mis näitab, kuidas luua sissetulevaid ja väljaminevaid saadetisetellimusi sõnumi töötlemise kaudu. See kasutab standardseid valimiandmeid, mis on seotud USMF näidisjuriidilise isikuga (ettevõttega).

Kuidas testida loomisprotsessi

Sissetulevate ja väljaminevate saadetiste loomise protsessi proovimiseks teadete kaudu seadke lähtesüsteemi kirje puhul valik Luba käsitsi väljamineva saadetise tellimuse sõnumi loomine ja Luba sissetuleva saadetise tellimuse sõnumi käsitsi loomise suvandid väärtusele Jah. Seejärel saate luua saadetise tellimuse teated otse väljaminevate saadetiste tellimusteadetele ja sissetulevate saadetise tellimuste teadete lehtedele .

Teine kiire viis näidisteadete sisestamiseks on kasutada Open Data Protocoli (OData) taotlusi .

Mõlemal juhul töötleb Microsofti sõnumiprotsessor Dynamics 365 Supply Chain Management teateid ja loob tellimused laosüsteemis.

Näpunäide

Kui soovite saadetise tellimuse loomise protsessi teadete kaudu täielikult vahele jätta, saate luua sissetulevad saadetisetellimused ja väljaminevad saadetisetellimused otse tellimuse lehtedele, lubades nii, et lubate sissetulevate saadetiste käsitsi loomise ja lubate lähtesüsteemi käsitsi väljamineva saadetise tellimuse loomise sätted.

Sama sõnumistruktuuri loogika kehtib nii sissetuleva kui ka väljamineva saadetise tellimuse sõnumite kohta:

• Tellimuse päis

  • Tellimuse rida 1

  • Tellimuse rida 2

    …

  • Tellimuse rida n

• Valmis

Näpunäide

Veel näiteid HTTP-taotluste kohta teadete loomiseks ning varude ja toote koondandmete integreerimiseks minge GitHub dynamics365scm-lao hoidlasse.

Eeltingimused

Enne selle näite läbitöötamist tarneahela Supply Chain Managementi keskkonna abil peate oma süsteemi ette valmistama järgmisel viisil.

• Kontrollige versiooninõudeid ja lubage funktsioon, nagu on kirjeldatud jaotises Ainult laohaldusrežiimi lubamine ja konfigureerimine.
• Töötage süsteemis, kuhu demoandmed on installitud ja valige juriidiline isik USMF.
• Seadistage lehel Allikasüsteemid vähemalt üks kirje. See näidisstsenaarium eeldab, et olete seadistanud lähtesüsteemi, kus välja Allikassüsteem on määratud väärtusele ERP. Lisateabe saamiseks vt Allikasüsteemi konfigureerimine.
• Seadistage vajalikud numbrijadad, nagu on kirjeldatud jaotises Numbrijadade seadistamine.

Seadistage autentimine näite jaoks

Määrake lehel Microsoft Entra ID-rakendused kasutaja Administraator kliendile, mida kasutatakse tarnega suhtlemise ajal autentimiseks Supply Chain Managementi keskkonnavälisest allikast. Teise võimalusena määrake integreerimissõnumitele teine ​​kasutaja, kellel on autentimisjuurdepääs, näiteks vaikeroll Laosüsteemi integreerimise operaator. Kui kasutate toote põhiandmete importimisel sama kasutajat, tuleb rollile Laosüsteemi integreerimise operaator lisada rohkem privileege, mis on seotud toote põhiandmete olemitega.

Kui sisestate üksusi OData kaudu, peate tagama, et kasutaja vaikeettevõte ühtiks ettevõttega, kuhu üksus sisestatakse, või et ettevõte (dataAreaId väärtus) on määratud kasuliku koormuse päringu sõnumites. Mõlemal juhul saab saadetise tellimuse sõnumeid täita ainult siis, kui ettevõte (dataAreaId väärtus) on määratud.

Looge saadetise tellimise sõnumeid

Näide lihtsast sissetuleva saadetise tellimuse sõnumist

InboundShipmentOrderMessages sissetuleva saadetise tellimuse päise sõnumi jaoks peate esitama vähemalt järgmised andmed.

• MessageId: M1
• dataAreaId: USMF (Valikuline, olenevalt vaikeautoriseerimise kasutajaettevõttest)
• SourceSystemId: ERP
• OrderNumber: IO1
• ReceivingWarehouseId: 51

Muutujate kasutamisel sarnaneb InboundShipmentOrderMessages teade järgmise näitega.

POST {{resource}}/data/InboundShipmentOrderMessages
{
"MessageId": "{{MessageId}}",
"dataAreaId": "{{dataAreaId}}",
"SourceSystemId": "{{SourceSystem}}",
"OrderNumber": "{{OrderNumber}}",
"ReceivingWarehouseId": "{{Warehouse}}"
}

Sõnum InboundShipmentOrderLineMessages näeb välja nagu järgmine näide.

POST {{resource}}/data/InboundShipmentOrderLineMessages
{
"MessageId": "{{MessageId}}",
"dataAreaId": "{{dataAreaId}}",
"SourceSystemId": "{{SourceSystem}}",
"OrderNumber": "{{OrderNumber}}",
"OrderLineNumber": 1,
"ItemNumber": "A0001",
"ExpectedQuantity": 10,
"ExpectedUnitSymbol": "Pcs"
}

Sõnumite kinnitamiseks sisestage päise ja ridade jaoks täielik sõnum. Täielik sõnum näeb välja umbes nagu järgmine näide.

POST {{resource}}/data/InboundShipmentOrderMessages(MessageId='{{MessageId}}', dataAreaId='{{dataAreaId}}',SourceSystemId='{{SourceSystem}}', OrderNumber='{{OrderNumber}}')/Microsoft.Dynamics.DataEntities.Complete?cross-company=true

Märkus.

Väärtust dataAreaId kasutatakse võtme osana, et sobitada väljaantud päise ja rea ​​sõnumitega. Seega peab väärtus dataAreaId olema täpsustatud. Järelliide ?cross-company=true on vajalik ainult sõnumite puhul, kus ettevõte erineb kasutaja vaikeettevõttest, mis on seadistatud lehel Microsoft Entra ID rakendused.

Näide lihtsast väljamineva saadetise tellimuse sõnumist

OutboundShipmentOrderMessages väljatuleva saadetise tellimuse päise sõnumi jaoks peate esitama vähemalt järgmised andmed.

• MessageId: M2
• dataAreaId: USMF (Valikuline, olenevalt vaikeautoriseerimise kasutajaettevõttest)
• SourceSystemId: ERP
• OrderNumber: OO1
• ShipFromWarehouseId: 51
• ConsigneeName või ReceiverName: Microsoft
• ConsigneeCountryRegionId või ReceiverCountryRegionId: USA

Muutujate kasutamisel sarnaneb OutboundShipmentOrderMessages teade järgmise näitega.

POST {{resource}}/data/OutboundShipmentOrderMessages
{
"MessageId": "{{MessageId}}",
"dataAreaId": "{{dataAreaId}}",
"SourceSystemId": "{{SourceSystem}}",
"OrderNumber": "{{OrderNumber}}",
"ShipFromWarehouseId": "{{Warehouse}}",
"ConsigneeName": "{{ConsigneeName}}",
"ConsigneeCountryRegionId": "{{ConsigneeCountryRegionId}}"
}

Sõnum OutboundShipmentOrderLineMessages näeb välja nagu järgmine näide.

POST {{resource}}/data/OutboundShipmentOrderLineMessages
{
"MessageId": "{{MessageId}}",
"dataAreaId": "{{dataAreaId}}",
"SourceSystemId": "{{SourceSystem}}",
"OrderNumber": "{{OrderNumber}}",
"OrderLineNumber": 1,
"ItemNumber": "A0001",
"OrderedQuantity": 10,
"OrderedUnitSymbol": "Pcs"
}

Sõnumite kinnitamiseks sisestage päise jaoks täielik sõnum. Täielik sõnum näeb välja umbes nagu järgmine näide.

POST {{resource}}/data/OutboundShipmentOrderMessages(MessageId='{{MessageId}}', dataAreaId='{{dataAreaId}}',SourceSystemId='{{SourceSystem}}', OrderNumber='{{OrderNumber}}')/Microsoft.Dynamics.DataEntities.Complete?cross-company=true

Märkus.

Väärtust dataAreaId kasutatakse võtme osana, et sobitada väljaantud päise ja rea ​​sõnumitega. Seega peab väärtus dataAreaId olema täpsustatud. Järelliide ?cross-company=true on vajalik ainult sõnumite puhul, kus ettevõte erineb kasutaja vaikeettevõttest, mis on seadistatud lehel Microsoft Entra ID rakendused.

Sõnumiprotsessori sõnumid saadetise tellimuste jaoks

Pärast kahe dokumendi importimist sõnumite järjekorda, peate kasutama sõnumiprotsessorit nende töötlemiseks ja tegelike sissetulevate ja väljaminevate saadetiste tellimuste loomiseks.