User manual MICROSOFT DYNAMICS NAV 5.0

[. . . ] Microsoft Dynamics NAV 5. 00 TM Installation & System Management: Commerce Gateway for Microsoft DynamicsTM NAV®5. 00 INSTALLATION & SYSTEM MANAGEMENT: COMMERCE GATEWAY FOR MICROSOFT DYNAMICSTM NAV 5. 00 Information in this document, including URL and other Internet Web site references, is subject to change without notice. Unless otherwise noted, the companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted in examples herein are fictitious. No association with any real company, organization, product, domain name, e-mail address, logo, person, place, or event is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the user. [. . . ] The installation wizard will guide you through the installation process. 25 Chapter 1. Commerce Gateway 5. 00 for BizTalk Server 2006 2 In the Customer Information window, enter your user name, for example, Broker_user, and company name. You can also leave these fields blank. 3 In the Setup Type window, select Complete: 4 In the Ready to Install the Program window, click Install to start the installation of Commerce Gateway Broker. Modifying the Config. Xml files Before you start using Commerce Gateway Broker, you must make some modifications to the CGBroker_Config. Xml and the TCPCom_Config. Xml files. Modifying the CGBroker_Config. Xml File All the available NAV Application Servers must be known to the broker, and therefore you must specify some parameters in the CGBroker_Config. Xml file. 26 1. 6 Installing Microsoft Dynamics NAV Commerce Gateway Broker The file is located in the C:\Program Files\Microsoft Dynamics NAV\Commerce Gateway Broker folder. Open the file, for example with Notepad, and make the following changes: <Settings> <ApplicationServers> <ApplicationServer> <Name>NAS</Name> <IP>127. 0. 0. 1</IP> <PortNumber>7518</PortNumber> </ApplicationServer> </ApplicationServers> <RecoveryPoll>5</RecoveryPoll> </Settings> 1 Enter a name for the NAV Application Server in Settings/ApplicationServers/ApplicationServer/Name to make the first NAV Application Server known to the broker. It can be any name you choose but it must be unique. 2 Enter the IP address of the NAV Application Server in Settings/ApplicationServers/ApplicationServer/IP. 3 In Settings/ApplicationServers/ApplicationServer/PortNumber, enter the port number that the NAV Application Server is listening to. Make sure that the number is identical to the port number in the Start-Up Parameter Value field the NAV Application Server Manager. 4 The RecoveryPoll field specifies the interval in seconds you want the broker to listen for an available NAS after the NAS has returned a "Not available" message. To enter information for additional NAV Application Servers, you must copy the lines for the first NAV Application Server and paste them into the document. Change the values in the fields to match the values valid for the NAV Application Servers. 27 Chapter 1. Commerce Gateway 5. 00 for BizTalk Server 2006 Make sure to give the application servers unique names. <Settings> <ApplicationServers> <ApplicationServer> <Name>NAS1</Name> <IP>10. 251. 71. 46</IP> <PortNumber>7518</PortNumber> </ApplicationServer> <ApplicationServer> <Name>NAS2</Name> <IP>10. 251. 71. 46</IP> <PortNumber>7519</PortNumber> </ApplicationServer> <ApplicationServer> <Name>NAS3</Name> <IP>10. 251. 71. 46</IP> <PortNumber>7520</PortNumber> </ApplicationServer> </ApplicationServers> <RecoveryPoll>5</RecoveryPoll> </Settings> Modifying the TCPCom_Config. Xml File In the TCPCom_Config. Xml file you specify some security options, the port number of the broker, set a maximum size for the documents you transfer and specify a dump path for request and response documents. The file is located in the C:\Program Files\Microsoft Dynamics NAV\Commerce Gateway Broker folder. Open the file, and make the following changes: <Settings> <PortNumber>7517</PortNumber> <MaxDatasize>20000000</MaxDatasize> <Security> <AllowAll Values="Yes/No">Yes</AllowAll> <LogIntruders Values="Yes/No">No</LogIntruders> <Cryptography Values="Yes/No">Yes</Cryptography> <AllowedIPs> <IP>127. 0. 0. 1</IP> </AllowedIPs> </Security> <Debug> <RequestDocuments> <DumpDocuments Values="Yes/No">No</DumpD <DumpPath>C:\TCPDocLog\Request</DumpPat </RequestDocuments> <ResponseDocuments> <DumpDocuments Values="Yes/No">No</DumpD <DumpPath>C:\TCPDocLog\Response</DumpP </ResponseDocuments> </Debug> </Settings> 28 1. 6 Installing Microsoft Dynamics NAV Commerce Gateway Broker 1 In Settings/PortNumber, enter the number of the port that Commerce Gateway Broker should listen to. Make sure that the port number is identical to the number in the Appln. Srv. /Broker Port No. field in the BizTalk Management Setup window in the application. 2 A maximum size for the documents you are transferring is defined in Settings/MaxDatasize. The default value is 20 MB, but you can change this value to anything lower than the max. It is recommended that you keep the default value for the broker. 3 You can set Settings/Security/AllowAll Values to Yes or No. If you set it to Yes, the broker will handle the request regardless of the IP address that the request was sent from. If you set it to No, the broker will only accept requests from IP addresses listed in Settings/Security/AllowedIPs/IP. 4 Settings/Security/LogIntruders Values is only valid if the value Settings/Security/AllowAll Values is No. [. . . ] The rest of the error handling is described above. Errors Occurring in the Request Server If an error occurs in the Request Server, a message is written to the Application Log or the error code is returned to the client. If the error concerns the network or reading the CGRS_Config. xml document, a message is written in the Application Log. All other types of errors are returned to the client. 42 A. 2 Transaction of Large Documents A. 2 Transaction of Large Documents When you send an XML document from Dynamics NAV client to BizTalk Server, the transaction of the document can be handled in two different ways determined by the size of the document. [. . . ]