The REST SCO currently depends on the Autonomous REST Connector schema discovery mechanism to generate the schema for a REST service. The Autonomous REST Connector design accounts for this by allowing users to supply a REST schema file. This is an alternative to the schema discovery approach. Corticon needs to allow users to specify the schema file when configuring a REST Datasource. When specified, the schema file would be supplied to Autonomous REST Connector and schema discovery not performed.

The schema files are text files but they can be complex. Corticon will not provide any mechanisms to simplify the creation of schema files - this is the purview of the Autonomous REST Connector, whose roadmap includes provisions for tooling to aid in the creation of schema files. Users are referred to Autonomous REST Connector documentation and tooling for creation of schema files - Corticon will just provide for the import of the files.

Requirements

When configuring a REST Datasource, you have the option of supplying the schema file.

The schema is imported and stored as part of the vocabulary, similar to how it is done when schema discovery is performed. Because of its close relationship with the vocabulary, the schema is not stored as a separate file.