Delen via

Ontvangstprovider maken

  • Artikel

In dit onderwerp worden de stappen beschreven die nodig zijn om een ontvangstprovider te maken in Microsoft Dynamics 365 Intelligent Order Management.

Nieuwe providerdefinitie maken

Volg deze stappen om een nieuwe providerdefinitie te maken.

  1. Ga naar Providers > Catalogus.
  2. Selecteer Nieuwe providerdefinitie.
  3. Voer IOMLabOrderIntakeProvider in bij Weergavenaam.
  4. Voer msdyn_IOMLabOrderIntakeProvider in bij Logische naam.
  5. Selecteer IOMLab.png bij Logo.
  6. Voor Servicetype voert u Orderontvangst in.
  7. Voer Orderontvangstprovider voor IOM-lab in bij Beschrijving.
  8. Selecteer Opslaan en sluiten.

Providerdefinitie aan oplossing toevoegen

Ga als volgt te werk om een providerdefinitie toe te voegen aan een oplossing.

  1. Ga naar de portal voor Power Apps-makers en navigeer naar de nieuwe oplossing IOMLabProviders.
  2. Selecteer Bestaande toevoegen > IOM-providerdefinitie.
  3. Selecteer IOMLabOrderIntakeProvider en selecteer Toevoegen om deze aan de oplossing toe te voegen.

Transformatie toevoegen aan de providerdefinitie

Ga als volgt te werk om een transformatie aan de providerdefinitie toe te voegen.

  1. Ga naar Providers > Catalogus.
  2. Selecteer de zojuist gemaakte IOMLabOrderIntakeProvider.
  3. Selecteer Bewerken op de menubalk.
  4. Selecteer het tabblad Transformaties.
  5. Selecteer + Nieuwe transformatie van IOM-providerdefinitie.
  6. Voer IOMLab-order naar Dataverse-order in bij Weergavenaam.
  7. Voer msdyn_IOMLabOrderIntake_Order in bij Logische naam.
  8. Geef IOMLabOrderIntakeProvider op bij Providerdefinitie.
  9. Voer IOMLabOrderIntakeProvider in bij Bronobject.
  10. Voer Dataverse-order in bij Naam doelobject.
  11. Plak de volgende M-querycode bij Transformatie:
shared ImportMappingKey = [
    account = {
			[
				ExternalRecordKey = [ProviderName = "IOMLabOrderIntakeProvider"],
				SelectedFields = {"accountid"}
			]
    },
		pricelevel = {
			[
				ExternalRecordKey = [ProviderName = "IOMLabOrderIntakeProvider"],
				SelectedFields = {"pricelevelid"}
			]
    },
		product = List.Distinct(List.Transform(Source[orderdetails], each
			[
				ExternalRecordKey = [sku = _[sku]],
				SelectedFields = {"productid"}
			])),
		uom = List.Distinct(List.Transform(Source[orderdetails], each
			[
				ExternalRecordKey = [unit = _[unit]],
				SelectedFields = {"uomid"}
			]))
];
shared TransformSourceData =
let
	orderProducts = Source[orderdetails],
	account = IOM.MapRecord(IOM.MappingTables[account], [ProviderName = "IOMLabOrderIntakeProvider"]),
	pricelevel = IOM.MapRecord(IOM.MappingTables[pricelevel], [ProviderName = "IOMLabOrderIntakeProvider"]),
			
	orderheader = Record.FromTable
					(
						Table.SelectRows
						(
							Record.ToTable
							(
								[
									ordernumber = Text.From(Source[ordernumber]),
									name = ordernumber,
									#"customerid_account@odata.bind" = "/accounts(" & Text.From(account[accountid]) & ")",
									#"pricelevelid@odata.bind" = "/pricelevels(" & Text.From(pricelevel[pricelevelid]) & ")",
									billto_city = Record.FieldOrDefault(Source, "billtocity"),
									billto_stateorprovince = Record.FieldOrDefault(Source, "billtostateorprovince"),
									billto_country = Record.FieldOrDefault(Source, "billtocountry"),
									billto_postalcode = Record.FieldOrDefault(Source, "billtozip"),
									shipto_city = Record.FieldOrDefault(Source, "shiptocity"),
									shipto_stateorprovince = Record.FieldOrDefault(Source, "shiptostateorprovince"),
									shipto_country = Record.FieldOrDefault(Source, "shiptocountry"),
									shipto_postalcode = Record.FieldOrDefault(Source, "shiptozip")
								]
							), each [Value] <> null
						)
					),

	orderlines = List.Transform(orderProducts, each
						Record.FromTable
						(
							Table.SelectRows
							(
								Record.ToTable
								(
									[
										ispriceoverridden = true,
										#"productid@odata.bind" = "/products(" & IOM.MapRecord(IOM.MappingTables[product], [sku = Record.FieldOrDefault(_, "sku")])[productid] & ")",
										#"uomid@odata.bind" = "/uoms(" & IOM.MapRecord(IOM.MappingTables[uom], [unit = Record.FieldOrDefault(_, "unit")])[uomid] & ")",
										quantity = [quantity],
										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")
									]
								), each [Value] <> null
							)
						)
					),

	salesorder = Record.AddField(orderheader, "order_details", orderlines)
in Text.FromBinary(Json.FromValue(salesorder));
  1. Voer JsonPayload in bij Brontype transformatie.
  2. Selecteer Opslaan.
  3. Maak een JSON-bestand, plak hierin de volgende code en sla het op.
{
  "ordernumber": "IOMLabOrder001",
  "shiptocity": "BELLEVUE",
  "shiptostateorprovince": "WA",
  "shiptocountry": "US",
  "shiptozip": "98007",
  "billtocity": "BELLEVUE",
  "billtostateorprovince": "WA",
  "billtocountry": "US",
  "billtozip": "98007",
  "orderdetails": [
    {
      "sku": "883988211855",
      "unit": "each",
      "quantity": 11
    }
  ]
}
  1. Selecteer naast het veld Voorbeeldgegevens de optie Bestand kiezen en upload het JSON-bestand dat u hebt gemaakt.
  2. Selecteer Opslaan en sluiten.

Transformatie van providerdefinitie toevoegen aan oplossing

Ga als volgt te werk om een transformatie van een providerdefinitie toe te voegen aan een oplossing.

  1. Ga naar de portal voor Power Apps-makers en navigeer naar de nieuwe oplossing IOMLabProviders.
  2. Selecteer Bestaande toevoegen > Transformatie voor IOM-providerdefinities.
  3. Selecteer IOMLab-order naar Dataverse-order en selecteer Toevoegen om deze aan de oplossing toe te voegen.

Berichtenhandler voor providers maken

Volg deze stappen om een berichtenhandler voor providers te maken.

  1. Ga naar de portal voor Power Apps-makers, navigeer naar Oplossingen en open de standaardoplossing.

  2. Selecteer Nieuw.

  3. Selecteer Cloudstroom en geef deze de naam Handler voor berichtaanvragen voor orderontvangst van IOM-lab.

  4. Selecteer het triggertype als Outlook.com - Wanneer een nieuw e-mailbericht binnenkomt (V2) en meld u aan met accountreferenties voor outlook.com.

  5. Selecteer Postvak IN voor Map.

  6. Selecteer e-mailadressen van geadresseerden gescheiden door puntkomma's bij Aan.

  7. Selecteer e-mailadressen van CC-ontvangers gescheiden door puntkomma's bij CC.

  8. Selecteer e-mailadressen van geadresseerden of CC-ontvangers gescheiden door puntkomma's bij Aan of CC.

  9. Selecteer e-mailadressen van afzenders gescheiden door puntkomma's bij Van.

  10. Selecteer Ja bij Bijlagen toevoegen.

  11. Select IOMLabOrderIntakeOrder voor Onderwerpfilter.

  12. Selecteer Willekeurig bij Belang.

  13. Selecteer Ja bij Alleen met bijlage.

    Outlook-trigger

  14. Selecteer Nieuwe stap en voeg 'JSON parseren' toe.

  15. Plak de volgende code bij Inhoud:

    {
"ProviderId": "00000000-0000-0000-0000-000000000000"
}

  16. Plak rechtstreeks de volgende voorbeeldschemacode:

    {
  "type": "object",
  "properties": {
    "ProviderId": {
      "type": "string"
    }
  }
}

  17. Selecteer Gereed.

  18. Selecteer het weglatingsteken (...) en selecteer Naam wijzigen.

  19. Geef de actie de naam IOM-systeemeigenschappen.

  20. Selecteer Opslaan.

    De actie Systeemeigenschappen

  21. Selecteer Nieuwe stap, voeg een actie JSON parseren toe en wijzig de naam in Providervariabelen initialiseren.

  22. Plak de volgende code bij Inhoud:

    {
  "SourceObjectName": "IOMLabOrderIntakeProvider",
  "DestinationObjectName": "Dataverse Order"
}

  23. Selecteer Opslaan.

  24. Selecteer Nieuwe stap, voeg een actie Variabele initialiseren toe en wijzig de naam in Uitvoeringsresultaat van verwerking initialiseren.

  25. Voer ExecutionResult in bij Naam.

  26. Selecteer Booleaans bij Type.

  27. Selecteer waar bij Waarde.

  28. Selecteer Opslaan.

    Uitvoeringsresultaat van verwerking initialiseren

  29. Selecteer Nieuwe stap, voeg Bereik toe en wijzig de naam in Proberen.

  30. Selecteer Een actie toevoegen in het bereik Proberen.

  31. Voeg Een niet-gebonden actie uitvoeren toe vanuit de Dataverse-connector en geef deze de naam Het bericht van de provider bevestigen in de IOM.

  32. Voer msdyn_CreateProviderMessageRequestExecution in bij Actienaam.

  33. Voer workflow()['tags']['xrmWorkflowId'] in als expressie voor PowerAutomateWorkflowId.

  34. Voer workflow()['run']?['name'] in als expressie voor PowerAutomateRunId.

  35. Voer guid() in als expressie voor ProviderExternalRequestId.

  36. Selecteer Opslaan.

    Providerbericht bevestigen

  37. Selecteer Een actie toevoegen en voeg vervolgens een besturingselement Toepassen op elke toe.

  38. Selecteer Bijlagen bij Uitvoer uit vorige stappen selecteren.

    Het besturingselement Toepassen op elke

  39. Selecteer Een actie toevoegen in de lus Toepassen op elke, voeg Een onderliggende stroom uitvoeren vanuit de connector Stroom toe en geef deze de naam Bericht transformeren met Power Query Online.

  40. Selecteer de onderliggende stroom IOM-providertransformator.

  41. Selecteer de variabele ProviderId bij Provider-id.

  42. Selecteer de variabele SourceObjectName bij Naam bronobject.

  43. Selecteer de variabele DestinationObjectName bij Naam doelobject.

  44. Voer decodeBase64(items('Apply_to_each')?['ContentBytes']) in als expressie voor Payload.

  45. Selecteer Opslaan.

    Bericht transformeren met Power Query

  46. Na de transformatiestap selecteert u Een actie toevoegen, voegt u Een onderliggende stroom uitvoeren toe vanuit de connector Stroom en geef deze de naam Order maken.

  47. Voer IOM-verkooporder maken in voor Onderliggende stroom.

  48. Voer string(json(outputs('Transform_Message_with_Power_Query_Online')?['Body']?['result'])?[0][0]) in als expressie voor Payload.

  49. Selecteer Opslaan.

    Order maken

  50. Vouw het bereik Proberen samen door de titelbalk te selecteren.

  51. Selecteer Nieuwe stap, voeg nog een bereik toe en geef deze de naam Vangen.

  52. Selecteer in het bereik Vangen het weglatingsteken (...) en selecteer Uitvoering configureren na.

  53. Schakel de selectievakjes is mislukt en is verlopen in en selecteer de optie Gereed.

    Uitvoering configureren na

  54. Selecteer in het bereik Vangen de optie Een actie toevoegen, voeg een actie Variabele instellen toe en wijzig de naam in Het resultaat van de uitvoering instellen op mislukt.

  55. Voer Executionresult in bij Naam.

  56. Selecteer Onwaar bij Waarde.

  57. Selecteer Opslaan.

    Actie Variabele instellen

  58. Vouw het bereik Vangen samen door de titelbalk te selecteren.

  59. Selecteer Nieuwe stap, voeg nog een bereik toe en geef deze de naam Tot slot.

  60. Selecteer in het bereik Tot slot het weglatingsteken (...) en selecteer Uitvoering configureren na.

  61. Schakel de selectievakjes is uitgevoerd, is mislukt, is overgeslagen en is verlopen in en selecteer de optie Gereed.

    Uitvoering configureren na (bereik Tot slot)

  62. Selecteer in het bereik Tot slot de optie Een actie toevoegen, voeg een actie Een niet-gebonden actie uitvoeren toe en wijzig de naam in Resultaat van uitvoering van berichtaanvragen voor providers opslaan.

  63. Voer msdyn_UpdateProviderMessageRequestStatus in bij Actienaam.

  64. Voer @outputs('Acknowledge_the_Provider_Message_in_IOM')?["body/ProviderMessageRequestExecutionId'] in bij ProviderMessageRequestExecutionId.

  65. Selecteer Opslaan.

    Resultaat van uitvoering van berichtaanvragen voor providers opslaan

Logicadefinitie voor providerdefinities toevoegen aan de providerdefinitie

Ga als volgt te werk om een logicadefinitie voor providerdefinities toe te voegen aan de providerdefinitie.

  1. Ga in uw Intelligent Order Management-toepassing naar Leveranciers > Catalogus.
  2. Selecteer de zojuist gemaakte IOMLabOrderIntakeProvider.
  3. Selecteer Bewerken op de menubalk.
  4. Selecteer het tabblad Logicadefinities.
  5. Selecteer + Nieuwe logicadefinitie voor IOM-providerdefinities.
  6. Voer Handler voor berichtaanvragen voor orderontvangst van IOM-lab in bij Weergavenaam.
  7. Voer msdyn_LabOrderIntakeMessageRequestHandler in bij Logische naam.
  8. Voer IOMLabOrderIntakeProvider in bij Providerdefinitie.
  9. Voer Berichtenhandler voor providers in bij Type logica.
  10. Voer Handler voor berichtaanvragen voor orderontvangst van IOM-lab in bij Werkstroomnaam.
  11. Voer 2 in bij Time-outminuten.
  12. Voer 3 in bij Maximum aantal pogingen.
  13. Voer Handler voor berichtaanvragen voor orderontvangst van IOM-lab in bij Beschrijving.
  14. Selecteer Opslaan. Hierdoor wordt een JSON-representatie gegenereerd van de cloudstroom van de berichtenhandler en wordt het veld Clientgegevens ingevuld.
  15. Selecteer Opslaan en sluiten.
  16. Selecteer Verbindingen. A;ls het goed is, wordt zowel Microsoft Dataverse als Outlook.com weergegeven als gedefinieerde verbindingsverwijzing.

Notitie

Als u andere gedefinieerde verbindingsverwijzingen ziet dan Microsoft Dataverse en Outlook.com, gebruikt u meer dan één Dataverse-verbindingsverwijzing in uw berichthandlerstroom voor orderontvangst. U lost dit op door naar uw stroom te gaan en ervoor te zorgen dat alle Dataverse-acties dezelfde verbindingsverwijzing gebruiken.

Logicadefinitie voor providerdefinities toevoegen aan IOMLabProviders-oplossing

Ga als volgt te werk om een logicadefinitie voor providerdefinities toe te voegen aan de IOMLabProviders-oplossing.

  1. Ga naar de portal voor Power Apps-makers en navigeer naar de nieuwe oplossing IOMLabProviders.
  2. Selecteer Bestaande toevoegen > Logicadefinitie voor IOM-providerdefinities.
  3. Selecteer Handler voor berichtaanvragen voor orderontvangst van IOM-lab en selecteer Toevoegen om het aan de oplossing toe te voegen.

Verbindingsverwijzing voor providerdefinities toevoegen aan IOMLabProviders-oplossing

Ga als volgt te werk om een verbindingsverwijzing voor providerdefinities toe te voegen aan de IOMLabProviders-oplossing.

  1. Ga naar de portal voor Power Apps-makers en navigeer naar de nieuwe oplossing IOMLabProviders.
  2. Selecteer Bestaande toevoegen > Verbindingsverwijzing voor IOM-providerdefinities.
  3. Selecteer de verbindingsverwijzingsdefinities Microsoft Dataverse en Outlook.com en selecteer Toevoegen om ze aan de oplossing toe te voegen.

Volgende stap in lab voor snel starten: Afhandelingsprovider maken