Partager via

Créer un nouveau fournisseur de prise de commande

  • Article

Cette rubrique décrit les étapes requises pour créer un fournisseur de prise de commande dans Microsoft Dynamics 365 Intelligent Order Management.

Créer une nouvelle définition de fournisseur

Pour créer une nouvelle définition de fournisseur, procédez comme suit.

  1. Accédez à Fournisseurs > Catalogue.
  2. Sélectionnez Nouvelle définition de fournisseur.
  3. Pour Nom d’affichage, saisissez "IOMLabOrderIntakeProvider".
  4. Pour Nom logique, saisissez "msdyn_IOMLabOrderIntakeProvider".
  5. Pour Logo, sélectionnez "IOMLab.png".
  6. Pour Type de service, saisissez "Prise de commande".
  7. Pour Description, saisissez "Fournisseur de prise de commande de laboratoire IOM".
  8. Sélectionnez Enregistrer et fermer.

Ajouter une définition de fournisseur à la solution

Pour ajouter une définition de fournisseur à une solution, procédez comme suit.

  1. Accédez au Portail Power App Maker et accédez à la solution nouvellement créée IOMLabProviders.
  2. Sélectionnez Ajouter une > définition du fournisseur IOM existant.
  3. Sélectionnez IOMLabOrderIntakeProvider, puis sélectionnez Ajouter pour l’ajouter à la solution.

Ajouter une transformation à la définition du fournisseur

Pour ajouter une transformation à la définition du fournisseur, procédez comme suit.

  1. Accédez à Fournisseurs > Catalogue.
  2. Sélectionnez le nouveau IOMLabOrderIntakeProvider créé.
  3. Sélectionnez Modifier dans la barre de menus.
  4. Sélectionnez l’onglet Transformations.
  5. Sélectionnez +Nouvelle transformation de définition de fournisseur IOM.
  6. Pour Nom d’affichage, saisissez "Commande IOMLab en Commande Dataverse".
  7. Pour Nom logique, saisissez "msdyn_IOMLabOrderIntake_Order".
  8. Pour Définition du fournisseur, entrez ou sélectionnez IOMLabOrderIntakeProvider.
  9. Pour Nom d’objet source, saisissez "IOMLabOrderIntakeProvider".
  10. Pour Nom de l’objet de destination, saisissez "Commande Dataverse".
  11. Pour Transformation, collez le code de requête M suivant :
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. Pour Type de source de transformation, entrez "JsonPayload".
  2. Sélectionnez Enregistrer.
  3. Créez un fichier JSON, collez le code suivant et enregistrez-le.
{
  "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. À côté du champ Exemple de données, sélectionnez Choisir le fichier et téléchargez le fichier JSON que vous avez créé.
  2. Sélectionnez Enregistrer et fermer.

Ajouter une transformation de la définition du fournisseur à la solution

Pour ajouter une transformation de la définition de fournisseur à une solution, procédez comme suit.

  1. Accédez au Portail Power App Maker et accédez à la solution nouvellement créée IOMLabProviders.
  2. Sélectionnez Transformation de la > définition du fournisseur IOM existant.
  3. Sélectionnez Commande IOMLab en Commande Dataverse, puis sélectionnez Ajouter pour l’ajouter à la solution.

Créer un gestionnaire de messages pour le fournisseur

Pour créer un gestionnaire de messages fournisseur, procédez comme suit.

  1. Accédez au Portail Power App Maker, accédez à Solutions, puis ouvrez la Solution par défaut.

  2. Sélectionnez Nouveau.

  3. Sélectionnez Flux de cloud, puis nommez-le " Laboratoire IOM - Gestionnaire de demandes de message pour la prise de commande".

  4. Sélectionnez le type de déclencheur comme Outlook.com – Lorsqu’un nouvel e-mail arrive (V2), puis connectez-vous avec les informations d’identification de votre compte outlook.com.

  5. Pour Dossier, sélectionnez Boîte de réception.

  6. Pour À, sélectionnez Adresses e-mail des destinataires séparées par des points-virgules.

  7. Pour À, sélectionnez Adresses e-mail des destinataires CC séparées par des points-virgules.

  8. Pour À ou CC, sélectionnez Adresses e-mail des destinataires CC séparées par des points-virgules.

  9. Pour De, sélectionnez Adresses e-mail des destinataires séparées par des points-virgules.

  10. Pour Inclure les pièces jointes, sélectionnez Oui.

  11. Pour Filtre d’objet, sélectionnez IOMLabOrderIntakeOrder.

  12. Pour Importance, sélectionnez Tout.

  13. Pour Uniquement avec pièce jointe, sélectionnez Oui.

    Déclencheur Outlook)

  14. Sélectionnez Nouvelle étape et ajoutez « Analyser JSON ».

  15. Pour Teneur, collez le code suivant :

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

  16. Collez directement l’exemple de code de schéma suivant :

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

  17. Sélectionnez Terminé.

  18. Sélectionnez le bouton représentant des points de suspension (...), puis sélectionnez Renommer.

  19. Renommez l’action "Propriétés système IOM".

  20. Sélectionnez Enregistrer.

    Action sur les propriétés système)

  21. Sélectionnez Nouvelle étape, ajoutez une action Analyser JSON et renommez-le en "Initialiser les variables du fournisseur".

  22. Pour Teneur, collez le code suivant :

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

  23. Sélectionnez Enregistrer.

  24. Sélectionnez Nouvelle étape, ajoutez une action Initialiser la variable et renommez-la en "Initialiser le résultat de l’exécution du traitement".

  25. Pour Nom, entrez "ExecutionResult".

  26. Pour Type, sélectionnez Booléen.

  27. Pour Valeur, sélectionnez true.

  28. Sélectionnez Enregistrer.

    Initialiser le résultat de l’exécution du traitement

  29. Sélectionnez Nouvelle étape, ajoutez "étendue" et renommez-le en "Essayer".

  30. Dans l’étendue Essayer, sélectionnez Ajouter une action.

  31. Ajoutez "effectuer une action non liée" à partir du connecteur Dataverse et renommez-le "Acquitter le message du fournisseur dans l’IOM".

  32. Pour Nom de l’action, saisissez "msdyn_CreateProviderMessageRequestExecution".

  33. Pour PowerAutomateWorkflowId, entrez workflow()['tags']['xrmWorkflowId'] comme expression.

  34. Pour PowerAutomateRunId, entrez workflow()['run']?['name'] comme expression.

  35. Pour ProviderExternalRequestId, entrez guid() comme expression.

  36. Sélectionnez Enregistrer.

    Accepter la requête de message du fournisseur

  37. Sélectionnez Ajouter une action, puis ajoutez un contrôle Appliquer à chacun.

  38. Pour Sélectionnez une sortie des étapes précédentes, sélectionnez Pièces jointes.

    Appliquer à chaque contrôle

  39. Sélectionnez Ajouter une action au sein de la boucle Appliquer à chacun, ajoutez Exécuter un flux enfant du connecteur Flux et renommez-le "Transformer le message avec Power Query Online".

  40. Sélectionnez le flux enfant Transformateur de fournisseur d’IOM.

  41. Pour Identifiant du fournisseur, sélectionnez la variable ProviderId.

  42. Pour Nom de l’objet source, sélectionnez la variable SourceObjectName.

  43. Pour Nom de l’objet de destination, sélectionnez la variable DestinationObjectName.

  44. Pour Charge utile, saisissez decodeBase64(items('Apply_to_each')?['ContentBytes']) comme expression.

  45. Cliquez sur Enregistrer.

    Transformer le message avec Power Query

  46. Après l’étape de transformation, sélectionnez Ajouter une action, ajoutez Exécuter un flux enfant à partir du connecteur Flux, et renommez-le "Créer une commande".

  47. Pour Flux enfant, saisissez "Création de commande client IOM".

  48. Pour Charge utile, saisissez string(json(outputs('Transform_Message_with_Power_Query_Online')?['Body']?['result'])?[0][0]) comme expression.

  49. Sélectionnez Enregistrer.

    Créer une commande

  50. Réduisez l’étendue Essayer en sélectionnant sa barre de titre.

  51. Sélectionnez Nouvelle étape, ajoutez une étendue et renommez-la "Variable".

  52. Dans l’étendue Variable, sélectionnez les points de suspension ("..."), puis sélectionnez Configurer l’exécution après.

  53. Sélectionnez les cases a échoué et a expiré, puis sélectionnez Terminé.

    Configurer l’exécution après

  54. Dans l’étendue Variable, sélectionnez Ajouter une action, ajoutez une action Définir la variable, et renommez-la "Définir le résultat de l’exécution comme ayant échoué".

  55. Pour Nom, entrez "Executionresult".

  56. Pour Valeur, sélectionnez False.

  57. Sélectionnez Enregistrer.

    Définir l’action variable

  58. Réduisez l’étendue Variable en sélectionnant sa barre de titre.

  59. Sélectionnez Nouvelle étape, ajoutez une étendue et renommez-la "Enfin".

  60. Dans l’étendue Enfin, sélectionnez les points de suspension ("..."), puis sélectionnez Configurer l’exécution après.

  61. Cochez les cases est réussi, a échoué, est ignoré et a expiré, puis sélectionnez Terminé.

    Configurer l’exécution après (Étendue Enfin)

  62. Dans l’étendue Enfin, sélectionnez Ajouter une action, ajoutez une action Effectuer une action non liée et renommez-la "Enregistrer le résultat de l’exécution de la demande de message du fournisseur".

  63. Pour Nom de l’action, saisissez "msdyn_UpdateProviderMessageRequestStatus".

  64. For ProviderMessageRequestExecutionId, saisissez @outputs('Acknowledge_the_Provider_Message_in_IOM')?["body/ProviderMessageRequestExecutionId'].

  65. Sélectionnez Enregistrer.

    Enregistrer les exécutions des demandes de messages du fournisseur

Ajouter une définition de logique de définition de fournisseur à la définition de fournisseur

Pour ajouter une définition de logique de définition de fournisseur à la définition de fournisseur, suivez cette procédure.

  1. Dans votre application Intelligent Order Management, accédez à Fournisseurs > Catalogue.
  2. Sélectionnez le nouveau IOMLabOrderIntakeProvider créé.
  3. Sélectionnez Modifier dans la barre de menus.
  4. Sélectionnez l’onglet Définitions logiques.
  5. Sélectionnez + Nouvelle définition de la logique de la définition du fournisseur IOM.
  6. Pour Afficher un nom, entrez "Gestionnaire de demande de message de prise de commande du laboratoire IOM".
  7. Pour Nom logique, saisissez "msdyn_LabOrderIntakeMessageRequestHandler".
  8. Pour Définition du fournisseur, entrez ou sélectionnez "IOMLabOrderIntakeProvider".
  9. Pour Type de logique, saisissez "Fournir un gestionnaire de messages".
  10. Pour Nom du workflow, entrez "Gestionnaire de demande de message de prise de commande du laboratoire IOM".
  11. Pour Minutes d’expiration, entrez "2".
  12. Pour Nombre maximal de tentatives, entrez "3".
  13. Pour Description, entrez "Gestionnaire de demande de message de prise de commande du laboratoire IOM".
  14. Sélectionnez Enregistrer. Cela génère une représentation JSON du flux cloud du gestionnaire de messages et remplit le champ Données client.
  15. Sélectionnez Enregistrer et fermer.
  16. Sélectionnez Connexions. Vous devriez voir à la fois les définitions de référence de connexion Microsoft Dataverse et Outlook.com répertoriées.

Note

Si vous voyez des définitions de référence de connexions autres que Microsoft Dataverse et Outlook.com, cela signifie que vous utilisez plusieurs références de connexion Dataverse dans le flux de votre gestionnaire de messages de prise de commande. Pour résoudre ce problème, accédez à votre flux et assurez-vous que toutes les actions Dataverse utilisent la même référence de connexion.

Ajouter une définition de logique de définition de fournisseur à la solution IOMLabProviders

Pour ajouter une définition de logique de définition de fournisseur à la solution IOMLabProviders, suivez cette procédure.

  1. Accédez au Portail Power App Maker et accédez à la solution nouvellement créée IOMLabProviders.
  2. Sélectionnez Définition logique de la > définition du fournisseur IOM existant.
  3. Sélectionnez Gestionnaire de demande de message de prise de commande du laboratoire IOM, puis sélectionnez Ajouter pour l’ajouter à la solution.

Ajouter une référence de connexion à la définition du fournisseur à la solution IOMLabProviders

Pour ajouter une référence de connexion à la définition à la solution IOMLabProviders, suivez cette procédure.

  1. Accédez au Portail Power App Maker et accédez à la solution nouvellement créée IOMLabProviders.
  2. Sélectionnez Référence de connexion de la > définition du fournisseur IOM existant.
  3. Sélectionnez les deux définitions de référence de connexion Microsoft Dataverse et Outlook.com, puis sélectionnez Ajouter pour les ajouter à la solution.

Prochaine étape du laboratoire de démarrage rapide : Créer un fournisseur d’exécution.