Este capitulo contiene información relacionada con la nomenclatura de códificación para la metadata de los servicios SOAP expuestos, la cual ha sido definida por la organización.

• Se implementará nomenclatura en profundida, es decir, cada estructura json será descrita por una metadata.
• Las metadatas se pueden asociar segun estructura del servicios (consumo/respuesta)
• Toda respuesta (return_object) debe tener su metadata
• Toda metadata debe estar relacionada con un componente.

A continuación se describe la estructura de devolución de servicio la cual aplica para todas las respuestas de los servicios SOAP expuestos por los componentes Powerbuilder, se toma como ejemplo el servicio de login:

{
    "return_component_code": "LOGIN",
    "return_code": "0",
    "return_user_message": "sesión vigente",
    "return_technical_message": "sesión vigente",
    "return_response_date": "16/10/2019 13:38:58",
    "return_object":     {
        "login": "SICOF",
        "company": [
        {
            "codigo_empresa": "9999999999",
            "nit": 892000757,3,
            "razon_social": "UNIVERSIDAD DE LOS LLANOS (PRINCIPAL)",
            "_metadata_json_": "LOGIN_RESPONSE_COMPANY"
        }
        ],
        "dependence": [
        {
            "codigo_dependencia": 67,
            "descripcion_dependencia": "ADMINISTRATIVA",
            "_metadata_json_": "LOGIN_SECOND_PHASE_DEPENDENCE_RESPONSE"
        }
        ],
        "token_session": "c6e612d569abed936d2abc1f61de85d415509acbbc1645e67b162388a87760c8",
        "multiempresa": "S",
        "_metadata_json_": "LOGIN_RENEW_RESPONSE"
    },
    "return_execution_time": "157"
}

• return_component_code: Código del componente al cual pertenece la operación del servicio SOAP expuesto.
• return_code: Código de retorno del consumo. [0:Cancel,1:Ok,-1:Error,2:Continue]
• return_user_message: Mensaje destinado al usuario.}
• return_technical_message“: Mensaje Técnico.
• return_response_date: Fecha de respuesta del servicio (Es retornada desde el servidor).
• return_object: Objeto Json de retorno.
• return_execution_time: Tiempo de procesamiento del servicio (Es diferente al tiempo de respuesta del servicio).

El proceso de metadata requiere que se realicen varios tipos de configurción las cuales se describen a continuación.

Consiste en registrar la configuración de la estructura de la metadata la cual se debe realizar en las siguientes tablas de la base de datos de configuración:

• USER_ADM.TBL_ENTITY: Tabla principal, contiene el encabezado de la configuración de la metadata.
• USER_ADM.TBL_ENTITY_COLUMN: Contiene el detalle ó descripción del contenido de la metadata.
• USER_ADM.TBL_ENTITY_TYPE: Define el tipo de entidad.