Skip to main content
Version: Next

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.