Over View
Application Integration Framework (AIF) services are used to communicate with external systems or applications. Microsoft Dynamics AX 2012 has the following types of services:
- Document services
- Custom services
- System services
An AIF service can be Inbound or Outbound. An Inbound service is used when you want to send data to an external system and Outbound services are used when you want to retrieve data. This tutorial will guide you in creating Custom Inbound AIF services in Microsoft Dynamics AX 2012. Custom services are used when:
- The complexity of the entities is relatively low.
- When you want to have full control of the service contract.
- When data contracts needs to be shared with different entities.
Pre-requisites
- Microsoft Dynamics AX 2012
- AIF services must be installed and configured on IIS
Important Concepts
Service operation
Service operations are class methods that expose any business logic in a service. To define a service operation, add the SysEntryPointAttribute attribute at the top of a method. Any existing method can be converted to a service operation by adding this attribute at the beginning of the method.
&absp;
Note: The service operation name cannot include Create, Find, Update or Delete. These names are reserved to be used by AIF Document services. AX will make an exception when they are called from a client.SysEntryPointAttribute
SysEntryPointAttribute defines the authorization checks that will be performed when a method is called from the server. This attribute must be set on all the service operations. If the value is “true”, it means that authorization checks will be performed for all the tables accessed in the method and if set to “false”, no authorization checks will be performed.AifCollectionTypeAttribute
AifCollectionTypeAttribute is used when you want to use a collection as a return type or in a parameter of a service operation. This attribute defines the type of data a collection contains.
Scenario
As part of this tutorial the service will return the list of customer names in Dynamics AX.
Steps
- First we will create a new class which will contain Service operations.
- Open AOT. Go to Classes and create a new class. Let’s name it CustomerServiceDemo.
- Set the RunOn property of the class to Server. This will make sure the class always executes on the server.
- Add a new method and name it as getCustomerNameList. This method will query customers’ names and return a Type list string. Write the following code in the method:
- The SysEntryPointAttribute tells AX that this method is a service operation method.
- Now we will create a new service and add the above created service operation to it.
- Go to Services, right click and select New Service.
- Name it as CustomerServiceDemo.
- Open the properties of the newly created service and select the CustomerServiceDemo class in the Class field.
- Now expand the CustomerServiceDemo service node and add a new Operation by right clicking on Operations and selecting Add Operation.
- All service operations present in the class will be listed. Select the getCustomerNameList service operation by checking the Add field in the grid and press OK.
- The next step is to create a service group and deploy the service to the Inbound Port.
- Go to Service Groups, right click and select New Service group.
- Name it as CustomerServiceDemoGroup.
- Set the AutoDeploy to Yes (Service will start automatically when AOS is started) and set the Description asCustomer name service.
- Right click the newly created service group and select New Service Node Reference.
- In the newly created service node, set the Service property to CustomerServiceDemo. The Name property will automatically default to the Service name.
- Now right click the service group and select Deploy Service Group.
- A success message will appear if the service group is successfully deployed.
- To verify it, go to System administration à Setup à Services and Application Integration Framework à Inbound ports.
- The Service group name CustomerServiceDemoGroup will appear here as Port name with a green check mark. This shows that service group is deployed and active. If a red ‘x’ is appearing, select Activate from the action pane to activate the port.
- The WSDL URI is the URL of the service which can be used by external systems to access the service.
- To test whether the service is running properly, open the Visual Studio Command Prompt by going to All Programsà Microsoft Visual Studio 2010 à Visual Studio Tools à Visual Studio Command Prompt.
- Write wcftestclient and press enter. WCF Test Client will open.
- Now, go to File à Add Service.
- In the Add Service dialog box, paste the WSDL URI of the port and press OK.
- The WCF Test Client will open the service with the list of operations available.
- Double click the getCustomerNameList. It will open the operation details in the right hand side pane.
- Click the Invoke button. The result of the service will appear in the Response pane.
- Document services
- Custom services
- System services
- Microsoft Dynamics AX 2012
- AIF services must be installed and configured on IIS
- Document service uses an AOT query to generate related artifacts. For this tutorial, InventTable query will be used
- Open Microsoft Dynamics AX Development workspace. Go to Tools à Application Integration Frameworkà Create document service
- This will open the AIF Document Service Wizard. Click Next to proceed
- In this step, specify the Document parameters. Select the Query for which service has to be created. TheDocument name will default to Query name. Modify it as required and give a suitable Document label as shown below. Click Next
- Now specify the Code generation parameters. The wizard will use this to create the respective classes. Check the required Service operations you want to be automatically created by the wizard. Click NextNote: To allow Update/Delete/Create Service operations, the Update property must be set to Yes
- In the Generate code window, review the artifacts that will be generated. Click Generate to proceed
- The wizard will now generate all the artifacts. In the end, a Completed screen will display the list of artifacts it created. Click Finish to exit the wizard
- The next step is to create a service group and deploy the service to an Inbound Port
- Go to Service Groups, right click on it, and select New Service Group
- Name it InventServiceDemoGroup
- Set AutoDeploy to Yes (so the service will start automatically when AOS is started) and set the Description to Item Id service
- Right click the newly created service group and select New Service Node Reference
- In the newly created service node, set the Service property to InventTableDemoService. The Name property will automatically default to the Service name
- Now right click the service group and select Deploy Service Group
- A success message will appear if the service group is successfully deployed
- To verify, go to System administration à Setup à Services and Application Integration Framework à Inbound ports
- The Service group name InventServiceDemoGroup will appear here as Port name with a green tick mark. This shows that the service group is deployed and active. If a red cross mark is present, select Activate from the action pane to activate the port
- The WSDL URI is the URL of the service which can be used by external systems to access the service
http://www.dynamics101.com/2013/11/creating-custom-inbound-aif-service-microsoft-dynamics-ax-2012/
Creating a Document Inbound Services
Overview
Application Integration Framework (AIF) services are used to communicate with external systems or applications. Microsoft Dynamics AX 2012 has the following types of services:
An AIF service can be Inbound or Outbound. An Inbound service is used to send data to an external system while Outbound services are used to retrieve data.
This tutorial will guide you in creating Document Inbound AIF services for Microsoft Dynamics AX 2012.
Document services are XML documents that initiate transfer of data into or out of Dynamics AX. Any entity in AX can be represented as Documents, such as Customers or Sales Orders.
Document services are used when we have to execute complex CRUD (Create, Read, Update, Delete) operations on an entity.
Pre-requisites
Scenario
As part of this tutorial, the service will return the list of Item IDs in Dynamics AX
Steps
http://www.dynamics101.com/2014/06/creating-document-inbound-aif-service-microsoft-dynamics-ax-2012/