Perceptive Connector for Microsoft Dynamics AX

(1)

Perceptive Connector for Microsoft Dynamics

AX

Installation and Setup Guide

Version: 2.3.x

Written by: Product Knowledge, R&D Date: October 2015

(2)

(3)

Perceptive Connector for Microsoft Dynamics AX Installation and Setup Guide

3

Overview

Perceptive Connector for Microsoft Dynamics AX is a SOAP-based web service that you can integrate with your application to fetch data from Microsoft Dynamics AX and create an invoice.

For example, if you integrate Perceptive Connector for Microsoft Dynamics AX with an eform, it acts as a medium layer that fetches data from Microsoft Dynamics AX to populate fields in the eform. Based on the populated fields, you may create an invoice in Microsoft Dynamics AX.

Required components

Software prerequisites

Before you install Perceptive Connector for Microsoft Dynamics AX, you must have the following software installed on the target computer. The operating system must be Windows Server 2008R2.

• Microsoft Dynamics AX Server, version 2012 R2 CU6 or R2 CU7, R3, R3 CU8, R3 CU9

• Microsoft Dynamics AX AIF services is successfully deployed

• Microsoft Dynamics AX Client, version 2012 R2 CU6 or R2 CU7, R3, R3 CU8, R3 CU9

• Perceptive Interact for Microsoft Dynamics AX, version 2.3 model must be installed in AX

• .NET Framework 4.0 for AX 2012 R2 CU6 and R2 CU7

• .NET Framework 4.5 for AX 2012 R3, R3 CU8, and R3 CU9

• ASP.NET

• Internet Information Service (IIS), version 7 or higher You must have the following executable file ready for use.

• PerceptiveConnectorforMSDynamicsAXSetup_2.3.x.x.exe

Based on the Microsoft Dynamics AX version you use, you must have one of the following Perceptive Connector for Microsoft Dynamics AX models ready to be imported into Microsoft Dynamics AX.

PerceptiveAXConnectorR2CU62.3.x.xxx.axmodel

• PerceptiveAXConnectorR2CU72.3.x.xxx.axmodel

• PerceptiveAXConnectorR32.3.x.xxx.axmodel

Licenses

You must have the following licenses.

• Perceptive Interact for Microsoft Dynamics AX, version 2.3 or higher

(5)

5

Conditions for installing the web service

Before installing the web service, you must complete the following steps to prepare the system.

• Uninstall any previous version of Perceptive Connector for Microsoft Dynamics AX.

Note If you want to save the previous configuration file, create a backup for the DAXConnectorConfiguration.xml file.

• In Windows Features, turn IIS on and under Application Development Features, under World Wide Web Services, select the ASP.NET check box.

• Run the ASP.NET IIS Registration Tool (Aspnet_regiis.exe) for .NET Framework, versions 4 and 4.5.

At the command prompt, type the following command and press ENTER.

%windir%\Microsoft.NET\Framework\<v4.x.x>\aspnet_regiis.exe –i where <v4.x.x> is the absolute version of the .NET Framework.

Note This is mandatory, if .NET Framework is installed after installing IIS. If you know the windows directory that contains the IIS Registration Tool, you may provide the absolute path.

• The system you use must host the Microsoft Dynamics AX Server or be in the same domain as the Microsoft Dynamics AX Server. The identity of the IIS Application Pool must be executed as an AX Administrator level service account.

Installation and setup

To install and set up Perceptive Connector for Microsoft Dynamics AX, perform the following procedures.

1. Download the required files from the Customer Portal.

2. Import Perceptive Connector for Microsoft Dynamics AX model.

3. Run the Perceptive Connector for Microsoft Dynamics AX executable file.

4. Set credentials for the web service.

The following sections provide instructions on how to complete each procedure.

Download the required files from the Customer Portal

1. Go to the Perceptive Software website at www.perceptivesoftware.com and log in to the Customer Portal.

2. In the Product Downloads page, search for all downloadable items for Perceptive Connector for Microsoft Dynamics AX, version 2.3. For details, refer to Software prerequisites section.

3. Download the PerceptiveConnectorforMSDynamicsAXSetup_2.3.x.x.exe file to a temporary directory on your computer.

4. Download the Perceptive Connector for Microsoft Dynamics AX model for your environment to a temporary directory on your computer.

(6)

Import Perceptive Connector for Microsoft Dynamics AX model

Prerequisite Before importing the model, close the client connections to the Application Object Server (AOS) instance with which you are working. If more than one server is using the same database, stop all other AOS instances.

To import the model, complete the following steps.

1. Open the command prompt.

2. Navigate to the directory for the management utilities. Typically, the location of this directory is

%ProgramFiles%\Microsoft Dynamics AX\60\ManagementUtilities.

3. At the command prompt, type the import command and then press ENTER. The import command syntax is axutil import /file:<File name> where <File name> is the absolute path of the model file.

4. After completion, start the AOS.

5. Open Microsoft Dynamics AX Client. A dialog box appears with the message that the new model has been modified and provides options to run the model as required.

6. To upgrade the model, in the Microsoft Dynamics AX dialog box, perform one of the following actions.

• If you are uploading the model for the first time, select Start the model upgrade checklist, click OK, and then proceed with the instructions that follow.

• If you uploaded the same model before, select Compile and synchronize and click OK.

7. Optional. If you selected the Compile and synchronize option, generate Incremental CIL build from X++ after the compilation and database synchronization is complete. To generate Incremental CIL build from X++, complete the following substeps.

1. In Microsoft Dynamics AX Client, open New Development Workspace and right-click AOT.

2. Click Add-Ins and then click Incremental CIL generation from X++. When the process is complete, proceed with the usual operations.

After importing the model, to deploy the INAPEFormServiceGroup service group, complete the following steps.

8. In Microsoft Dynamics AX Client, open New Development workspace.

9. Under AOT, under Service Groups, right-click INAPEFormServiceGroup and click Deploy Service Group.

Run the Perceptive Connector for Microsoft Dynamics AX executable

file

1. Run the PerceptiveConnectoforMSDynamicsAXSetup_2.3.x.x.exe file on the target machine.

2. In the Perceptive Connector for Microsoft Dynamics AX Installation Wizard window, complete the following substeps.

1. In the Welcome to the Perceptive Connector for Microsoft Dynamics AX Installation Wizard

(7)

7 3. Optional. In the Port Configuration page, in the Port number box, type the port number used to

publish this service and click Next.

Important Ensure that no other web application in IIS uses the identical port number.

4. In the WSDL Configuration page, enter the WSDL URI for each of the following fields.

• Invoice Services. Use the WSDL URL of the service that is used to create the invoice.

Typically the WSDL URI syntax is http://DAX<version>:<port number of AIF services>/DynamicsAx/Services/AccountsPayableServices?wsdl.

• MetadataService. Perceptive Connector for Microsoft Dynamics AX does not support any modification of this web service. Typically the WSDL URI syntax is http://DAX<version>:<port number of AIF services>/DynamicsAx/Services/ MetaDataService?wsdl.

• QueryService. Perceptive Connector for Microsoft Dynamics AX does not support any modification of this web service. Typically the WSDL URI syntax is http://DAX<version>:<port number of AIF services>/DynamicsAx/Services/ QueryService?wsdl.

• MethodService. This service is available only if you deploy the INAPEFormServiceGroup service group after importing the model. Typically, the WSDL URI syntax is

http://DAX<version>:<port number of AIF services>/DynamicsAx/Services/

INAPEFormServiceGroup?wsdl.

To get the WSDL URI for Account PayableServices and MethodService, in Microsoft Dynamics AX, complete the following substeps.

1. In the Navigation pane, click System administration.

2. In the System administration area page, under Setup, under Services and Application Integration Framework, click Inbound ports.

3. In the left pane, in the Port name column, click Account PayableServices and copy the respective WSDL URI.

4. Click INAPEFormServiceGroup and copy the respective WSDL URI.

3. Click Next.

4. In the Ready to Install the Program page, click Install.

5. After the installation is complete, in the Installation Wizard Completed page, click Finish to exit the Installation Wizard.

Set credentials for the web service

1. Open IIS Manager.

2. In the Connections pane, click Application Pools and select PerceptiveConnectorforMSDynamicsAXApplicationPool.

3. In the Actions pane, under Edit Application Pool, click Advanced Settings.

(8)

4. In the Advanced Settings dialog box, under Process Model, to set the Identity field, click Identity and then click .

1. In the Application Pool Identity dialog box, select the Custom account check box and click Set.

2. In the Set Credentials dialog box, in the User name box, type the user name in the format

<Domain\User name>.

Notes

• The user must have administrator privilege in Microsoft Dynamics AX Server.

• If Microsoft Dynamics AX Server and Perceptive Connector for Microsoft Dynamics AX are on separate computers, ensure that both the computers are in the same domain.

3. In the Password box, type your password.

4. Click OK.

5. In the Application Pool Identity dialog box, click OK.

5. In the Actions pane, under Application Pool Tasks, click Recycle.

6. In the Connections pane, under Sites, click PerceptiveConnectorforMSDynamicsAXWebsite.

7. In the Actions pane, under Manage Web Site, click Restart.

Configure the AX Connector to call additional AIF Service Groups

There are instances, where you need to configure the AX Connector to call more than one AIF Service Group. The default installation configures the Connector to call the AccountsPayableService group for invoice processing. To call the Accounts Payable AX AIF service, the AX Connector is installed as a single IIS hosted web site. This is commonly used to create Pending Vendor Invoices in AX that are usually PO related. You can create a Pending Vendor Invoice that is Non-PO related with this service, but may be required to use a different service group, such as Ledger Journal services.

To configure the AX Connector to call a different AX AIF Service, complete the following steps.

1. Complete the Perceptive AX Connector installation process.

2. Copy all the files in the current root directory of the installed site to back up the installation.

3. Copy and paste the installed web site folder using the File Explorer.

4. To create the new web site in Internet Information Services (IIS) Manager, complete the following substeps.

1. Open Internet Information Services (IIS) Manager, version 7.0, in Administrative tools.

2. Expand the Server node to the Sites level.

3. In the Site node, right-click and select Add Web site.

4. Enter the web site name.

5. Select the Physical Path.

(9)

9 5. To generate new proxy files and an updated web.config file using the

PerceptiveConnectorLibraryGeneratorApp.exe, complete the following substeps.

1. Copy the two files that are included in the install package to the new web site directory PerceptiveConnectorLibraryGeneratorAPP.exe and

PerceptiveConnectorLibraryGenerator.dll.

2. In the Administrator mode, at the command prompt, execute the following command, replacing the <text> with values from the current AX installation. This command creates or modifies the existing serviceproxy.dll and web.config files.

PerceptiveConnectorLibraryGeneratorApp.exe <Appropriate AIF Service WSDL URI>

Note All the above parameters are mandatory except the <Location of external dll file>

parameter. This parameter is mandatory, only if the compilation of the service depends on any external DLL file. The system generates the serviceproxy.dll and web.config files.

3. In the IIS Manager, complete the following tasks.

• Select the application pool of the website that is created and click Recycle.

• Select the website name that is created and click Restart.

6. Modify the file DAXConnectorConfiguration.xml located in the Config folder of the newly installed site. This file contains the methods and queries used in the new site AIF service.

7. Set up Envoy services to consume this new web site for creating Ledger Journal based invoice vouchers.

Validate proxy dll in custom service group

Within AX, you can create a new AIF inbound port from an existing port to isolate it from other

applications. AccountsPayableServices is the standard AX inbound port (Service Group) used in common AP solutions.

Note In order to ensure that the new service is a copy of the AccountsPayableServices you must verify within AX developer workspace and the service proxy dll file that is generated.

Check in AX developer workspace

The new service includes the following services.

• LedgerVendorPaymentService

• VendPaymentService

• VendVendInvoiceService

Within the AX developer workspace, you can check this and expand the AOT Service Groups section and compare with the AccountsPayableService.

Perceptive Connector for Microsoft Dynamics AX