ESM Service Setup

Installation

The ESM Service is installed on the client's Online Server. This server is located outside the inner firewall, but inside an outer firewall. The ESM Service is comprised of the ESM Service, ESM Application Code and the ESM Test Console. All three sets of files are located under the IFAS7 Services directory within the eSchoolMall subdirectory.
The first step is to install the service and configure it in IIS. The following steps detail how to define and configure the ESM Service in the IIS Manager.

1. Load up the IIS Manager using either the server control panel or the server manager application.
2. Once on the IIS manager, open up the Default Web Site on the left-hand side of the page.
3. Right-click "Default Web Site" and select the "Add Application" option.

In the Add Application dialog box, fill in the information on the ESM service as follows: "<<Drive>>://Inetpub/wwwroot/ifas7/services/EschoolMall/EschoolMall.asmx". Make sure the services directory is correct. The location can differ per client site.

1. Click the "Connect as…" button and select "Application user (pass-through authentication)" if it is not already set.
2. Click OK on the "Add Application" dialog box and save the changes. Do not click on "Test Settings." We will test the connection later.
3. Verify that the eSchoolMall application now exists under the Default Web Site.
4. Select and right-click the eSchoolMall application. Click on Advanced Properties and display the "Advanced Settings."
5. Once displayed, confirm the "Behavior/Enabled Protocols" and confirm the protocol being utilized.
6. Click OK and exit the IIS Manager.
7. To test the connection, open an IE browser and enter the URL to the service.
8. Verify that the Service is found and returns the screen.
9. The last step in installation is for the IT department. The firewall will need to be configured for access to eSchoolMall. The ESM Easy Purchase Test and Production require being added to the ACL for the connection.

Application Code

The ESM Application code requires no installation. The application code for the service is part of a standard installation and exists under the services directory in the eSchoolMall/App_Code directory. No specific installation is required.

Test Console

A test console has been included with the ESM Service for troubleshooting and test purposes. The ESM Service Test Console exists in the Services/eSchoolMall subdirectory. Although it can be executed from the bin directory, a short cut should be created for it on the Desk Top of the Online Server for easy access.

BusinessPlus Purchasing ESM Controller

The actual processing of an ESM Transaction occurs in the BusinessPlus Purchasing subsystem which receives requests from the ESM Service on the Online Server. The ESM Controller is contained in the BT30PO.Managed project and is part of a standard release. No specific installation is required.