Skip to main content
Version: 0.3.0

Properties doh mapping file

The properties that are used in the file doh_mapping.json for automatically map your APIs to an OpenEdge back-end. And secondly make the generation of openapi possible.
You can download the api_framework.pl ABL procedure libraries

The search funtion will be executed to find the file doh_mapping.json

Root object

The root object of the config file

Fixed fields

Field NameTypeDescription
doh_mappingMapping ObjectREQUIRED. The available paths and operations for the API.
infoInfo ObjectREQUIRED. Provides metadata about the API.
serversServer ObjectAn array of Server Objects, which provide connectivity information to a target server. If the servers property is not provided, or is an empty array, the default value would be a Server Object with a url value of /.

Mapping Object

Field NameTypeDescription
pathstringA relative path to an individual endpoint.
operationsOperation ObjectDescribes a single API operation on a path.

Info Object

Field NameTypeDescription
titlestringREQUIRED. The title of the API.
descriptionstringA description of the API.
versionstringREQUIRED. The version of the OpenAPI document

Server Object

Field NameTypeDescription
urlstringREQUIRED. A URL to the target host.
descriptionstringAn optional string describing the host designated by the URL.

Operation Object

Field NameTypeDescription
pathstringA relative path to an individual endpoint.
operationstringA definition of an operation on this path.
tags[string]A list of tags for API documentation control. Tags can be used for logical grouping of operations by resources or any other qualifier.
abl_procedurestringABL procedure file
procedurestringABl internal procedure
classstringABL class path
class_methodstringMethod of class
parametersParameter ObjectA list of parameters that are applicable for all the operations described under this path.

Parameter Object

Field NameTypeDescription
namestringDepending on the location this can be the 'table name' or 'query parameter'
locationstringREQUIRED. The location of the parameter. Possible values are "query", "header", "path" or "cookie"
data_typestringallowedValues: array, boolean, integer, number, object, string
io_modestringallowedValues: input, input-output, output
requiredbooleanDetermines whether this parameter is mandatory.
envelopebooleanIs the response an array or is the array defined with a property in an object.