Managing Resource Templates

Resource templates are a means of grouping URIs and associating them with a particular RESTful Service Module.

Resource templates can have one or more resource handlers. Only one resource handler per HTTP method is permitted. For example, a resource template can have only one GET method, only one DELETE method and so on.

Adding a Resource Template

Learn how to add a resource template to a ORDS RESTful Service Module.

To add a resource template to a ORDS RESTful Service Module:

  1. On the Workspace home page, click SQL Workshop and then RESTful Services.

    The RESTful Services home page appears.

  2. Click ORDS Based RESTful Services.

    The ORDS RESTful services page appears.

  3. Click the ORDS RESTful Service module you want to ad the resource template to.

    The Module Definition Page appears.

  4. Under Resource Templates block on the left panel, click Create Template.

    The ORDS Template Definition page appears.

  5. Fill in the appropriate fields and select the appropriate options. Mandatory fields are marked with a red asterisk (*). To learn more about a specific option, see the field-level help.
  6. Specify the following:
    • URI Template - Enter the URI template to identify your Uniform Resource Identifiers. A URI template is simple syntax for describing URIs, for example:

      example/:id
      
    • Priority - Specify the template's evaluation order. Higher numbers are evaluated first.

    • HTTP Entity Tag - Specify the type of Entity Tag to use to uniquely identify the resource version

  7. Click Create Template.

Editing a Resource Template

Learn how to edit a resource template.

To edit a resource template:

  1. On the Workspace home page, click SQL Workshop and then RESTful Services.

    The RESTful Services home page appears.

  2. Click ORDS RESTful Service template you want to edit.

    The ORDS Template Definition page appears.

    The ORDS RESTful services page appears.

  3. Make the changes you want.
  4. Click Apply Changes.

Deleting a Resource Template

Deleting a resource template removes the template along with all resource handlers associated with this template.

To delete a resource template:

  1. On the Workspace home page, click SQL Workshop and then RESTful Services.

    The RESTful Services home page appears.

  2. Click ORDS Based RESTful Services.

    The ORDS RESTful services page appears.

  3. Click ORDS RESTful Service template you want to delete.

    The ORDS Template Definition page appears.

  4. Click Delete.
  5. Click OK to confirm.
  6. Click Apply Changes.