Tutorial: CORS Service Interface

Walks you through the process of defining a REST Web service using the Interface Mapping Toolkit (IMTK), deploying it to an enterprise server instance, and invoking it from a Cross Origin Resource Sharing (CORS)-supported browser via an Asynchronous Javascript and XML (AJAX) request script.
Restriction: This topic applies only when the Enterprise Server feature is enabled.

Before You Begin

Before beginning this tutorial, be sure that you have completed all tasks outlined in the Prerequisites section of the Tutorials: Interface Mapping Toolkit topic.

To complete the steps in the Send an AJAX Request and Resend an AJAX Request sections of this tutorial, you must have access to a browser that supports Cross-origin Resource Sharing (CORS).

Overview

In this tutorial, you work through the following tasks:
  • Review the code in the COBOL demonstration application to become familiar with how it works
  • Create, configure, and populate a Visual Studio solution and project
  • Using the Interface Mapping Toolkit (IMTK), define a REST Web Service to access the COBOL application
  • Create and configure an enterprise server instance on which to run the REST Web service.
  • Deploy the Web service to the enterprise server
  • Send an AJAX request to the Web service

Sequence

Complete this tutorial by following the instructions in the following topics in the order listed here. The bottom of each topic provides Previous topic and Next topic navigational links to help you proceed through the tutorial in its proper sequence:

  1. Demonstration Application
    Describes the BookDemo application used in this tutorial.
  2. Create the ProgramCORS Solution and Project
    Walks you through the process of creating the ProgramCORS solution and project for the BookDemo demonstration application.
  3. Add Demonstration Files to ProgramCORS
    Walks you through the process of adding BookDemo demonstration files to the ProgramCORS project.
  4. Create a REST Web Service
    Walks you through the process of creating a REST Web service for the BookDemo application.
  5. Define Service Interface Operations
    Walks you through the process of defining details for the AccessBooks REST Web service.
  6. Create and Configure ESCORS
    Walks you through the process of creating and configuring an enterprise server instance, ESCORS, to use in this tutorial.
  7. Deploy the REST Web service
    Walks you through the steps required to build the project, set deployment properties, associate an enterprise server instance with your project, deploy the service interface, and verify the deployment results.
  8. Send an AJAX Request
    Walks you through the process of sending an AJAX request to your deployed service using a browser that supports CORS.
  9. Reconfigure and Redeploy the Web Service
    Walks you through the process of configuring your service interface to accept AJAX requests from any origin, and redeploying the Web service to your enterprise server instance.
  10. Resend an AJAX Request
    Walks you through the process of resending an AJAX request to your deployed Web service running on the reconfigured ESCORS enterprise server instance using a browser that supports CORS.
Parent topic: Tutorials: Interface Mapping Toolkit
Related concepts
Tutorials: Interface Mapping Toolkit