Création et déploiement d'un nouveau port sur IIS

Le connecteur Microsoft Dynamics AX n'utilise que les services qui sont créés dans l'application Dynamics AX Application et hébergés sur le gestionnaire IIS. Un nouveau port doit être créé à l'aide d'un adaptateur HTTP.

Création d'un port sur le service HTTPS

Procédure de création de port :
  1. Ouvrez l'application Microsoft Dynamics AX 2012, puis accédez au formulaire System Administration.
  2. Accédez à Service and Application Integration Framework, cliquez sur Inbound port.
  3. Cliquez sur le bouton New.
  4. Renseignez les zones suivantes :
    1. Port Name : entrez un nom unique pour le port.
    2. Sélectionnez HTTP pour Adapter.
    3. Pour l'URI :
      1. Cliquez sur la liste déroulante. Une petite fenêtre Select Web site s'affiche en incrustation.
      2. Cliquez sur la liste déroulante et sélectionnez le site Web https.
      3. Cliquez sur OK.
    4. Cliquez sur le bouton Configure (situé au-dessus de la liste déroulante URI).
      1. Si un message s'affiche en incrustation, cliquez sur Yes.
      2. Cliquez sur Bindings sous la section Configuration.
      3. Cliquez sur le lien Create New Binding Configuration sous la section de configuration. La fenêtre Create a New Binding apparaît.
      4. Cliquez sur l'option basicHttpBinding dans la liste.
      5. Cliquez sur OK.
      6. Sélectionnez la nouvelle liaison créée.
      7. Dans l'onglet Security, paramétrez Mode sur Transport en choisissant l'option dans la liste déroulante Mode.
      8. Dans la section Security, paramétrez Transport Client credential type sur Ntlm dans la liste déroulante.
      9. Dans la section de configuration, développez le noeud Services.
      10. Développez le noeud de service qu'il contient pour obtenir le noeud Endpoints.
      11. Sélectionnez et cliquez avec le bouton droit sur le noeud Endpoints.
      12. Cliquez sur l'option New Service Endpoint.
      13. Dans la configuration du nouveau noeud final de service, entrez un nom valide.
      14. Sélectionnez l'option basicHttpBinding créée à l'étape (iv).
      15. Pour la liaison, sélectionnez la nouvelle liaison créée à l'étape (v).
      16. Développez le noeud Advanced sous la section Configuration.
      17. Développez le sous-noeud Service Behaviors.
      18. Développez le sous-noeud routingServiceBehavior.
      19. Sélectionnez le sous-noeud serviceMetaData.
      20. Remplacez la valeur par défaut false de HttpsGetEnabled par true.
      21. Fermez la fenêtre. Une fenêtre en incrustation apparaît pour la sauvegarde des modifications. Cliquez sur Yes.
    5. Dans Service contract customization, cliquez sur le bouton Service operations.
      1. Sélectionnez les opérations de service que vous souhaitez appeler.
      2. Cliquez sur Close.
  5. Cliquez sur le bouton Activate dans le menu principal, afin d'activer le port.
  6. Une fois le port activé, notez l'URI WSDL. Exemple : https://<nom_hôte>:443/MicrosoftDynamicsAXAif60/FixedAssetTest/xppservice.svc
  7. Ajoutez ?wsdl à l'URI et vérifiez si vous pouvez accéder à cet URI sur le navigateur local.

Création d'un port sur le service HTTP

Procédure de création de port :
  1. Ouvrez l'application Microsoft Dynamics AX 2012, puis accédez au formulaire System Administration.
  2. Accédez à Service and Application Integration Framework, cliquez sur Inbound port.
  3. Cliquez sur le bouton New.
  4. Renseignez les zones suivantes :
    1. Port Name : entrez un nom unique pour le port.
    2. Sélectionnez HTTP pour Adapter.
    3. Pour l'URI :
      1. Cliquez sur la liste déroulante. Une petite fenêtre Select Web site s'affiche en incrustation.
      2. Cliquez sur la liste déroulante et sélectionnez le site Web http.
      3. Cliquez sur OK.
    4. Cliquez sur le bouton Configure (situé au-dessus de la liste déroulante URI).
      1. Si un message s'affiche en incrustation, cliquez sur Yes.
      2. Développez Bindings et sélectionnez basicHttpBinding.
      3. Dans le panneau de droite, accédez à l'onglet Security. Paramétrez TransportClientCredentialType sur Ntlm.
      4. Fermez la fenêtre. Une fenêtre en incrustation apparaît pour la sauvegarde des modifications. Cliquez sur Yes.
    5. Dans Service contract customization, cliquez sur le bouton Service operations.
      1. Sélectionnez les opérations de service que vous souhaitez appeler.
      2. Cliquez sur Close.
  5. Cliquez sur le bouton Activate dans le menu principal, afin d'activer le port.
  6. Une fois le port activé, notez l'URI WSDL. Exemple : http://<nom_hôte>:8085/AXHttpAppPool/AssetConditionService/xppservice.svc
  7. Ajoutez ?wsdl à l'URI et vérifiez si vous pouvez accéder à cet URI sur le navigateur local.

Caractéristiques du noeud final

Voici les caractéristiques du noeud final si l'URI WSDL est http://<XYZ>:8085/AXHttpAppPool/AssetConditionService/xppservice.svc?wsdl :
  • Nom d'hôte : XYZ
  • Numéro de port : 8085
  • Pool d'applications : AXHttpAppPool
  • Nom de port : AssetConditionService

Ajoutez les détails d'authentification.

Ajoutez les détails de proxy, si nécessaire.

Pour le service HTTPs, ajoutez les détails dans Security Panel.

Cliquez sur le bouton Download/Update WSDL. Après avoir téléchargé le fichier WSDL à partir du noeud final, vous pouvez continuer et appeler le service.