Configure services

Application Integration Framework (AIF) includes a number of services for integrating your system in common business processes. In order to enable an exchange using a service, you must first enable the service. For external systems to consume the service, you must generate it and make it available to external callers.

Enable and generate the service

Use the following steps to enable and generate a service.

  1. Click Basic > Setup > Application Integration Framework > Services. The first time the form opens, you must click Refresh to load the services. There may be a delay while the services load.

  2. Select the Enabled check box for each service that you want to use in an exchange.

  3. Click Generate to generate the service artifacts for each enabled service. The generation process copies the service and all the generated files to <Microsoft Dynamics AX installation path>\Application\Appl\DynamicsAx\ServiceGeneration folder. If there are Web sites configured in the Web sites form, the service is copied to the content directory specified for each Web site (by default this directory is <Microsoft Dynamics AX installation path>\AifWebservices). This enables external callers to consume the service and is only necessary for document exchanges using Web services.

The service artifacts that are generated include the following:

  • The .svc file

  • The schemas for the service operation parameters and return values

  • The web.config file

Test the service

After you have generated a service, you can test that it is functioning in Internet Information Services (IIS) by browsing to the service.

  1. Click Start > Administrative tools > Internet Information Services (IIS) Manager.

  2. Expand the Default Web Site node or the Web site node that contains the AIF Web services virtual directory.

  3. Navigate to the virtual directory MicrosoftDynamicsAXAif50. The services appear in the pane on the right side of the screen and have a file name extension of .svc.

  4. Right-click the .svc file and select Browse. An Internet Explorer browser window appears with the service name at the top. If the Web service is correctly configured in IIS, you will see a link to the Web service WSDL. If the Web service is not correctly configured in IIS, you will see a service error in the browser.

If you receive HTTP Error 404.3

If you have installed AIF Web services, done the necessary configuration to expose a service as a Web Service, and you receive an HTTP Error 404.3 when you try to call the service, you may need to register Windows Communication Foundation (WCF) with IIS.

If IIS is installed after the .NET Framework is installed, you must register WCF with IIS and ASP.NET on the computer where Web services are installed by following these steps.

Operating system

Steps

Windows Server 2003

Windows Server 2008

Use the ServiceModelReg tool by entering the following command at a command prompt:

ServiceModelReg.exe /i /x.

This command line tool is located in the WCF directory, for example, C:\Windows\Microsoft.NET\Framework\v3.0\Windows Communication Foundation.

Refresh the services

If you make any changes to a service, or if you add a custom service in the AOT, you must refresh the services for those changes to be reflected in AIF. To refresh the services, click Refresh.

The refresh process scans the AOT and refreshes the list of services reflecting any changes to services in the AOT Services node. There may be a delay while the services are refreshed.

Configure the Web service

The AIF services support WCF and WCF-based Web services, so after you have generated a service, you can configure the WCF properties. To modify the WCF configuration, click Configure.

If the Windows SDK is installed, the WCF Service Configuration Editor (SvcConfigEditor.exe) opens and enables you to modify the configuration. If the SDK is not installed, the configuration opens in Notepad.

View service operations

Service operations define what actions you can perform on a service. Service operations are implemented as methods on the service.

To view the service operations available for an AIF service, click Service operations. In the Service Operations form, you can view the following items:

  • The service operations (methods)

  • The parameters and return value for each operation

  • The schema for each parameter and return value

Service naming conventions

The AIF Services form contains all the services that are included with Microsoft Dynamics AX. The following table illustrates the naming conventions used for the service name and the external name (the service name exposed outside of Microsoft Dynamics AX).

Tab

Naming convention

Example

Service name

<Prefix> + <Document Name> + "Service"

CustCustomerService

External name

<Document Name> + "Service"

CustomerService

See Also

Configure Web sites for document exchange