Wiki

Has cargado una revisión vieja del documento! Si la guardas crearás una versión nueva con estos datos.

====== Maestro Niveles de Estudio ======

===== Definición =====

===== Contrato de Consumo: WS_LISTAR =====

^  Contrato de Consumo  ^^^^^^
^  Operación^Objetivo  ^^^^^
^ws_listar|lista los registros actuales de la tabla **NOMINA.NIVEL_ESTUDIO**.|||||
^  Parámetros de Entrada  ^^^^^^
^Nombre^Tipo de Datos^Descripción^^^Formato Tipo^
|as_config|String|Cadena de Configuración del Consumo|||Json|
|as_data|String|Cadena que contiene los parámetros del Consumo|||Json|
^  Definición Interna  ^^^^^^
^Parámetro Entrada^Atributo^Tipo Dato^Descripción^Requerido^Valor por Defecto((Los valores por defecto son asumidos por el consumo interno))^
|as_config|token_session|String|Cadena que representa el hash de autenticación de acceso al consumo|Si|N/A|
|as_data|firstpag|Integer|Identificador de registro inicial de la paginación del consumo|Si|1|
|as_data|lastpag|Integer|Identificador de registro final de la paginación del consumo|Si|1|
|as_data|orderby|String|Cadena que contiene las columnas de ordenamiento del consumo|No|Utilizado por la DB|
|as_data|where|String|Cadena que contiene la sentencias de filtrado del consumo|No|N/A|
^  Parámetros de Retorno  ^^^^^^
^Nombre^Tipo de Datos^Descripción^^^Formato Tipo^
|ws_listarResult|String|Cadena de retorno del Consumo|||Json|
^  Definición Interna  ^^^^^^
^Parámetro Entrada^Atributo^Tipo Dato^Descripción^Requerido^Valor por Defecto((Los valores por defecto son asumidos por el consumo interno))^
|ws_listarResult|return_code|String|Cadena que representa el código de retorno del consumo 1: OK -1: Error|Si|N/A|
|ws_listarResult|return_user_message|String|Cadena que representa el mensaje de usuario de retorno del consumo|Si|N/A|
|ws_listarResult|return_technical_message|String|Cadena que representa el mensaje técnico de retorno del consumo|Si|N/A|
|ws_listarResult|return_object|String|Cadena que representa el objeto de retorno del consumo|No|N/A|
|return_object|alert|String|Cadena que representa el array de mensajes de alerta de retorno del consumo|No|N/A|
|alert|msg|String|Cadena que representan una posición del array de mensajes de alerta de retorno del consumo|No|N/A|
|return_object|columncount|Long|Valor que representa la cantidad de columnas de la data devuelve en el objeto de consumo|No|N/A|
|return_object|rowcount|Long|Valor que representa la cantidad de filas totales de la data que representa el objeto de consumo|No|N/A|
|return_object|nivel_estudio|Array Object|Array de Objetos que representan la data que devuelve el consumo|No|N/A|
|nivel_estudio|ka_nl_codigo|Long|Identificador del Registro|Si|N/A|
|nivel_estudio|sc_descripcion|String|Nombre dado al Nivel de Estudio|Si|N/A|
|nivel_estudio|usuario_empresa|String|Código del Usuario(Entorno Multiempresa)|Si|"NOMINA"|
|ws_listarResult|return_response_date|Date|Fecha y hora de ejecución del consumo|Si|fecha y hora del sistema|
|ws_listarResult|return_execution_time|Long|Tiempo de ejecución del consumo en milisegundos|Si|0|

===== Ejemplos =====

^  Entrada  ^^^^^^
|<code html>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempurl.org">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:ws_listar>
         
         <tem:as_config>{ "token_session": "76107349a4b87c31ba56a97c3651e3a540bd54cb8531d76b851242043d9b8ea6" }
         </tem:as_config>
         
         <tem:as_data>{"firstpag": 1, "lastpag": 1, "orderby":"sc_descripcion asc"}
         </tem:as_data>
      </tem:ws_listar>
   </soapenv:Body>
</soapenv:Envelope>
</code>||||||
^  Retorno  ^^^^^^
|<code html>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <ws_listarResponse xmlns="http://tempurl.org">
         <ws_listarResult>{
    "return_code": "1",
    "return_user_message": "consulta de datos existosa",
    "return_technical_message": "consulta de datos existosa",
    "return_object": {
        "alert": [
            {
                "msg": "no se identifica el parametro: where"
            }
        ],
        "dataobject": "dsg_core_dual",
        "columncount": 4,
        "nivel_estudio": [
            {
                "ka_nl_codigo": 11,
                "sc_descripcion": "APRENDIZ",
                "usuario_empresa": "NOMINA",
                "rnum": 1
            }
        ],
        "rowcount": 17
    },
    "return_response_date": "28/06/2019 19:40:00",
    "return_execution_time": "765"
}</ws_listarResult>
      </ws_listarResponse>
   </soap:Body>
</soap:Envelope>
</code>||||||

===== Contrato de Consumo: WS_INSERTAR =====

^  Contrato de Consumo  ^^^^^^
^  Operación^Objetivo  ^^^^^
^ws_insertar|Agrega un nuevo registro en la tabla **NOMINA.NIVEL_ESTUDIO**.|||||
^  Parámetros de Entrada  ^^^^^^
^Nombre^Tipo de Datos^Descripción^^^Formato Tipo^
|as_config|String|Cadena de Configuración del Consumo|||Json|
|as_data|String|Cadena que contiene los parámetros del Consumo|||Json|
^  Definición Interna  ^^^^^^
^Parámetro Entrada^Atributo^Tipo Dato^Descripción^Requerido^Valor por Defecto((Los valores por defecto son asumidos por el consumo interno))^
|as_config|token_session|String|Cadena que representa el hash de autenticación de acceso al consumo|Si|N/A|
|as_data|datarecord|Objeto Json|Objeto que contiene la data a registrar|Si|1|
|datarecord|ka_nl_codigo|Long|Identificador del Registro|Si|0|
|datarecord|sc_descripcion|String|Nombre dado al Nivel de Estudio|Si|N/A|
|datarecord|usuario_empresa|String|Código del Usuario(Entorno Multiempresa)|Si|"NOMINA"|
^  Parámetros de Retorno  ^^^^^^
^Nombre^Tipo de Datos^Descripción^^^Formato Tipo^
|ws_insertarResult|String|Cadena de retorno del Consumo|||Json|
^  Definición Interna  ^^^^^^
^Parámetro Entrada^Atributo^Tipo Dato^Descripción^Requerido^Valor por Defecto((Los valores por defecto son asumidos por el consumo interno))^
|ws_insertarResult|return_code|String|Cadena que representa el código de retorno del consumo 1: OK -1: Error|Si|N/A|
|ws_insertarResult|return_user_message|String|Cadena que representa el mensaje de usuario de retorno del consumo|Si|N/A|
|ws_insertarResult|return_response_date|Date|Fecha y hora de ejecución del consumo|Si|fecha y hora del sistema|
|ws_insertarResult|return_execution_time|Long|Tiempo de ejecución del consumo en milisegundos|Si|0|

===== Ejemplos =====

^  Entrada  ^^^^^^
|<code html>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempurl.org">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:ws_insertar>
         
         <tem:as_config>{ "token_session": "76107349a4b87c31ba56a97c3651e3a540bd54cb8531d76b851242043d9b8ea6" }
         </tem:as_config>
         
         <tem:as_data>{"datarecord":{"ka_nl_codigo": 17, "sc_descripcion":"PRUEBAS", "usuario_empresa":"NOMINA"}}
         </tem:as_data>
      </tem:ws_insertar>
   </soapenv:Body>
</soapenv:Envelope>
</code>||||||
^  Retorno  ^^^^^^
|<code html>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <ws_insertarResponse xmlns="http://tempurl.org">
         <ws_insertarResult>{
    "return_code": "1",
    "return_user_message": "información registrada correctamente.",
    "return_response_date": "28/06/2019 19:41:18",
    "return_execution_time": "453"
}</ws_insertarResult>
      </ws_insertarResponse>
   </soap:Body>
</soap:Envelope>
</code>||||||

===== Contrato de Consumo: WS_ACTUALIZAR =====

^  Contrato de Consumo  ^^^^^^
^  Operación^Objetivo  ^^^^^
^ws_actualizar|Agrega un nuevo registro en la tabla **NOMINA.NIVEL_ESTUDIO**.|||||
^  Parámetros de Entrada  ^^^^^^
^Nombre^Tipo de Datos^Descripción^^^Formato Tipo^
|as_config|String|Cadena de Configuración del Consumo|||Json|
|as_data|String|Cadena que contiene los parámetros del Consumo|||Json|
^  Definición Interna  ^^^^^^
^Parámetro Entrada^Atributo^Tipo Dato^Descripción^Requerido^Valor por Defecto((Los valores por defecto son asumidos por el consumo interno))^
|as_config|token_session|String|Cadena que representa el hash de autenticación de acceso al consumo|Si|N/A|
|as_data|datarecord|Objeto Json|Objeto que contiene la data a registrar|Si|1|
|datarecord|ka_nl_codigo|Long|Identificador del Registro|Si|0|
|datarecord|sc_descripcion|String|Nombre dado al Nivel de Estudio|Si|N/A|
|datarecord|usuario_empresa|String|Código del Usuario(Entorno Multiempresa)|Si|"NOMINA"|
^  Parámetros de Retorno  ^^^^^^
^Nombre^Tipo de Datos^Descripción^^^Formato Tipo^
|ws_actualizarResult|String|Cadena de retorno del Consumo|||Json|
^  Definición Interna  ^^^^^^
^Parámetro Entrada^Atributo^Tipo Dato^Descripción^Requerido^Valor por Defecto((Los valores por defecto son asumidos por el consumo interno))^
|ws_actualizarResult|return_code|String|Cadena que representa el código de retorno del consumo 1: OK -1: Error|Si|N/A|
|ws_actualizarResult|return_user_message|String|Cadena que representa el mensaje de usuario de retorno del consumo|Si|N/A|
|ws_actualizarResult|return_response_date|Date|Fecha y hora de ejecución del consumo|Si|fecha y hora del sistema|

===== Ejemplos =====

^  Entrada  ^^^^^^
|<code html>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempurl.org">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:ws_actualizar>
         
         <tem:as_config>{ "token_session": "76107349a4b87c31ba56a97c3651e3a540bd54cb8531d76b851242043d9b8ea6" }
         </tem:as_config>
         
         <tem:as_data>{"datarecord":{"ka_nl_codigo": 15, "sc_descripcion":"PRUEBA", "usuario_empresa":"NOMINA"}}
         </tem:as_data>
      </tem:ws_actualizar>
   </soapenv:Body>
</soapenv:Envelope>
</code>||||||
^  Retorno  ^^^^^^
|<code html>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <ws_actualizarResponse xmlns="http://tempurl.org">
         <ws_actualizarResult>{
    "return_code": "1",
    "return_user_message": "información actualizada correctamente",
    "return_response_date": "28/06/2019 19:45:30"
}</ws_actualizarResult>
      </ws_actualizarResponse>
   </soap:Body>
</soap:Envelope>
</code>||||||

===== Contrato de Consumo: WS_CONSULTAR =====

^  Contrato de Consumo  ^^^^^^
^  Operación^Objetivo  ^^^^^
^ws_consultar|consulta un único registro dado de la tabla **NOMINA.NIVEL_ESTUDIO**|||||
^  Parámetros de Entrada  ^^^^^^
^Nombre^Tipo de Datos^Descripción^^^Formato Tipo^
|as_config|String|Cadena de Configuración del Consumo|||Json|
|as_data|String|Cadena que contiene los parámetros del Consumo|||Json|
^  Definición Interna  ^^^^^^
^Parámetro Entrada^Atributo^Tipo Dato^Descripción^Requerido^Valor por Defecto((Los valores por defecto son asumidos por el consumo interno))^
|as_config|token_session|String|Cadena que representa el hash de autenticación de acceso al consumo|Si|N/A|
|as_data|ka_nl_codigo|Long|Identificador del registro a consultar|Si|1|
^  Parámetros de Retorno  ^^^^^^
^Nombre^Tipo de Datos^Descripción^^^Formato Tipo^
|ws_consultarResult|String|Cadena de retorno del Consumo|||Json|
^  Definición Interna  ^^^^^^
^Parámetro Entrada^Atributo^Tipo Dato^Descripción^Requerido^Valor por Defecto((Los valores por defecto son asumidos por el consumo interno))^
|ws_consultarResult|return_code|String|Cadena que representa el código de retorno del consumo 1: OK -1: Error|Si|N/A|
|ws_consultarResult|return_user_message|String|Cadena que representa el mensaje de usuario de retorno del consumo|Si|N/A|
|ws_consultarResult|return_technical_message|String|Cadena que representa el mensaje técnico de retorno del consumo|Si|N/A|
|ws_consultarResult|return_object|String|Cadena que representa el objeto de retorno del consumo|No|N/A|
|return_object|alert|String|Cadena que representa el array de mensajes de alerta de retorno del consumo|No|N/A|
|alert|msg|String|Cadena que representan una posición del array de mensajes de alerta de retorno del consumo|No|N/A|
|return_object|columncount|Long|Valor que representa la cantidad de columnas de la data devuelve en el objeto de consumo|No|N/A|
|return_object|rowcount|Long|Valor que representa la cantidad de filas totales de la data que representa el objeto de consumo|No|N/A|
|return_object|nivel_estudio|Array Object|Array de Objetos que representan la data que devuelve el consumo|No|N/A|
|nivel_estudio|ka_nl_codigo|Long|Identificador del Registro|Si|N/A|
|nivel_estudio|sc_descripcion|String|Nombre dado al Nivel de Estudio|Si|N/A|
|nivel_estudio|usuario_empresa|String|Código del Usuario(Entorno Multiempresa)|Si|"NOMINA"|
|ws_listarResult|return_response_date|Date|Fecha y hora de ejecución del consumo|Si|fecha y hora del sistema|
|ws_listarResult|return_execution_time|Long|Tiempo de ejecución del consumo en milisegundos|Si|0|

===== Ejemplos =====

^  Entrada  ^^^^^^
|<code html>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempurl.org">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:ws_consultar>
         
         <tem:as_config>{ "token_session": "76107349a4b87c31ba56a97c3651e3a540bd54cb8531d76b851242043d9b8ea6" }
         </tem:as_config>
         
         <tem:as_data>{ "ka_nl_codigo": "1" }
         </tem:as_data>
      </tem:ws_consultar>
   </soapenv:Body>
</soapenv:Envelope>
</code>||||||
^  Retorno  ^^^^^^
|<code html>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <ws_consultarResponse xmlns="http://tempurl.org">
         <ws_consultarResult>{
    "return_code": "1",
    "return_user_message": "consulta de datos existosa",
    "return_technical_message": "consulta de datos existosa",
    "return_object": {
        "dataobject": "dsg_core_dual",
        "columncount": 4,
        "nivel_estudio": [
            {
                "ka_nl_codigo": 1,
                "sc_descripcion": "PRIMARIA INCOMPLETA",
                "usuario_empresa": "NOMINA",
                "rnum": 1
            }
        ],
        "rowcount": 0
    },
    "return_response_date": "28/06/2019 19:46:42",
    "return_execution_time": "390"
}</ws_consultarResult>
      </ws_consultarResponse>
   </soap:Body>
</soap:Envelope>
</code>||||||

===== Validaciones =====

Resumen de la edición

Wiki

Herramientas de usuario

Herramientas del sitio

Herramientas de la página