as Microsoft Magento Dynamics Introduction ‘AX 2012 SOAP AIF web-services en tant que services RESTful, le rendant facilement consammable par n'importe quel client / plateforme et facilement étendu. Fonctionne avec les services AIF Document, les services systéme et les services personnalisés. ‘Compatibilité L'API a 6t6 créée pour étre utilisée avec AX 2012 (toute version). Aucune version pour AX7 ne sera effectuée, car elle fonctionne déja a l'aide des services REST / OData. Une portabilité vers AX 2009 est techniquement possible mais hors de portée de ce projet. Awrapper, exposing AX 2012 AIF services (SOAP) as RESTful web-services. | Dynamics AX AOS (AIF/WCF Services) VPN or Hybrid Connection (Tee / HTTPS) Azure Deployment (Web App / API App} ‘On-Prem Deployment (Web App) Internal / External Clientsaa Microsoft oO Magento Dynamics «2012 Installation Pre-requirements - Visual Studio 2015/Visual Studio Community; - Accés administrateur a une instance d'AX 2012 pour configurer les ports entrants AIF; - Accés administrateur a la machine virtuelle exécutant 'AOS pour ouvrir les ports du pare-feu (si nécessaire); = Abonnement Azure pour le déplolement cloud (si nécessaire). Déploiement Le déploiement peut étre effectué sur un serveur Web local (IIS / IIS Express) ou sur le cloud (application Web Azure}. D'autres solutions (par exemple Apache, AWS) sont techniquement possibles mais non testées. Remarque: si vous déployez sur Azure, vous pouvez pointer votre API vers n'importe quel AOS exécuté sur une machine virtuelle ou aceéder votre AOS local via VPN ou activer la connexion hybride entre votre application Web et le serveur AOS, ‘client Applications. (WEE API Merged with MVC 6 id coPr om Magento Microsoft Dynamics «201 Fonctionnement Authentification Un identifiant d'utlisateur Trusted Intermediary doit étre spécifié dans le fichier Web.Cenfig. Uutilisateur de revendications doit étre eréé sur AX et l'utilisateur intermédiaire de confiance dott étre activé sur chaque port entrant AIF exposé. Le compte utilisateur authentifié est automatiquement identifié par 'API et doit correspondre aux détails de la revendication d'utilisateur sur AX. Recommandé pour les services exécutés sur Internet qui contiennent des données individuelles et sensibles. Web. Config file Ouvrez le fichier Web. Config a aide des parametres suivants pour configurer un utilisateur prédéfini (si nécessaire). Sil n'est pas spécifié, les informations didentification doivent étre transmises via l'en-téte de demande, “API_AUTH_USER_DOMAIN™ value=" /> ‘API_AUTH_USER_NAME” value="" /> API_AUTH_USER_DOMAIN, API_AUTH_USER_NAME et API_AUTH_USER_PASSWORD informations d'identification de l'utilisateur Dynamics AX Les parametres avancés sont disponibles uniquement pour les ports entrants améliorés - si ‘yous avez déployé un port de service en lant que base (créé via des groupes de services), ‘vous devez le redéployer manuellement.y Microsoft om Magento Dynamics «201 Fonctionnement Ajouter l'utilisateur de revendications La premigre étape pour ajouter Iutilisateur de révendications consiste a identifier les informations a utiliser sur AX. ‘Ouvrez la vérification d'authentification disponible sur: https:// /user/auth/ GET https://localhost:44300/user/auth Le «domaine réseau» sur AX doit correspondre au champ «AuthenticationType» de API, et le champ «Alias» sur AX doit correspondre au champ «Nom» de API. ‘200 Gener (| en (cae woore eater Dea cero [sw yl Neswork domi [googie inate # sae [semaardprotcom Conn pation a pani bert Usa ve fed Aisign roles 7K a foes iter mere Systeen wie Réglez le «Type de compte» sur «Réclamation utlisateurs, sélectionnez n'importe quel «ID utilisateur» et «Nom diutilisateurs (jis ne sont pas pertinents pour le processus d'authentification), cochez option «Activés, définissez la «Société par défaut» et Vutilisateur les réles.dat im} Magento Dynamics 4201 Fonctionnement Points de terminaison de service 1. UserSession controller : Récupére des informations sur la session utilisateur en cours. Deux opérations sont disponibles: https:// /user Appelle les opérations de service «GetUserSessioninfo» a partir du service systéme standard «UserSessionServices. https:///user/auth Récupére l'identité de l'utilisateur actuellement connecte et répertorie toutes les revendications: disponibles. 2. Contréleur des produits (exemple functionelle sur une entité): Un exemple simple pour montrer comment consommer un service AIF a l'aide du port entrant de base «Produits Services». Trois operations sont disponibles en utilisant différentes actions (GET, PUT, DELETE, POST). https:// /produit/ https:// /produit/{idh https:// /produit/{id}/submit 3. Documentation en temps réel L’app utilise Swagger pour la documentation interactive et la génération de SDK client. Pour y accéder il suffit d'ouvrir 'adresse: https:// /swagger Magento consommera c'est web service en temps rée! ou Par des cron job, pour manipuler les différents entités de Microsoft AX.