Maestro Niveles de Estudio

Definición

Definición del Componente
Nombre	n_ws05_nivel_estudio
Descripción	Gestiona el Maestro de Niveles de Estudio de los Empleados
Proyecto PB	ws05_nivel_estudio
Versión PB	12.5.1
URL SVN	http:http://adacsc.co:1443/svn/repository/ADA/SICOF/SICOF%20PBtoWS/Branches/Backend/branches%2012.5.2.5.0/05_Nomina/nivel_estudio
Librerias Propias	Tipo
ws05_nivel_estudio.pbl	Libreria Lanzadora
sf05controller_nivel_estudio.pbl	Libreria Controladora
sf05model_nivel_estudio.pbl	Libreria Modelo DB
Librerias Core	Tipo
sf00core_object.pbl	Libreria Core de Objetos Base
sf00core_transaction.pbl	Libreria Core de control de Transacción DB
sf00core_proxy.pbl	Libreria de Soporte de Consumos WS - Internos
Requisitos Técnicos
Framework	.Net 4.02 o Superior
Servidor	Internet Information Server 7.5 o Superior
Sistema Operativo	Windows Server 2012 R2
Memoria Ram	8GB
Exposición de Servicio
Tipo Servicio	SOAP 1.1 y SOAP 1.2 (.Net Easy SOAP - Generado por Powerbuilder)
URL Recurso	http://10.1.40.170:88/ws05_nivel_estudio/n_ws05_nivel_estudio.asmx?WSDL
Operaciones	Objetivo
ws_listar	lista los registros actuales de la tabla NOMINA.NIVEL_ESTUDIO.
ws_insertar	ingresa un nuevo registro en la tabla NOMINA.NIVEL_ESTUDIO.
ws_actualizar	actualiza valores en un registro de la tabla NOMINA.NIVEL_ESTUDIO.

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¹⁾
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²⁾
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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempurl.org">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:ws_listar>
         <!--Optional:-->
         <tem:as_config>{ "token_session": "76107349a4b87c31ba56a97c3651e3a540bd54cb8531d76b851242043d9b8ea6" }
         </tem:as_config>
         <!--Optional:-->
         <tem:as_data>{"firstpag": 1, "lastpag": 1, "orderby":"sc_descripcion asc"}
         </tem:as_data>
      </tem:ws_listar>
   </soapenv:Body>
</soapenv:Envelope>

Retorno

<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>

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³⁾
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⁴⁾
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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempurl.org">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:ws_insertar>
         <!--Optional:-->
         <tem:as_config>{ "token_session": "76107349a4b87c31ba56a97c3651e3a540bd54cb8531d76b851242043d9b8ea6" }
         </tem:as_config>
         <!--Optional:-->
         <tem:as_data>{"datarecord":{"ka_nl_codigo": 17, "sc_descripcion":"PRUEBAS", "usuario_empresa":"NOMINA"}}
         </tem:as_data>
      </tem:ws_insertar>
   </soapenv:Body>
</soapenv:Envelope>

Retorno

<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>

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⁵⁾
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⁶⁾
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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempurl.org">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:ws_actualizar>
         <!--Optional:-->
         <tem:as_config>{ "token_session": "76107349a4b87c31ba56a97c3651e3a540bd54cb8531d76b851242043d9b8ea6" }
         </tem:as_config>
         <!--Optional:-->
         <tem:as_data>{"datarecord":{"ka_nl_codigo": 15, "sc_descripcion":"PRUEBA", "usuario_empresa":"NOMINA"}}
         </tem:as_data>
      </tem:ws_actualizar>
   </soapenv:Body>
</soapenv:Envelope>

Retorno

<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>

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⁷⁾
as_config	token_session	String	Cadena que representa el hash de autenticación de acceso al consumo	Si	N/A
as_data	id_enfermedad	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⁸⁾
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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempurl.org">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:ws_consultar>
         <!--Optional:-->
         <tem:as_config>{ "token_session": "76107349a4b87c31ba56a97c3651e3a540bd54cb8531d76b851242043d9b8ea6" }
         </tem:as_config>
         <!--Optional:-->
         <tem:as_data>{ "ka_nl_codigo": "1" }
         </tem:as_data>
      </tem:ws_consultar>
   </soapenv:Body>
</soapenv:Envelope>

Retorno

<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>

Validaciones

id	codigo	Descripción
162	CRUD_THE_QUERY_PARAMETER_IS_NOT_IDENTIFIED	no se identifica el parámetro
163	CRUD_LIMIT_CONTROL_OF_RECORD_PER_PAGE	control de límite de registros por paginación
283	CRUD_THERE_PREVIOUSLY_ENTERED_RECORD_IDENTIFIER	existe un registro previamente ingresado con el identificador
381	CRUD_INDEFINITE_QUERY_CONFIGURATION	configuración de consulta indefinida
402	CRUD_INDEFINITE_QUERY_VALIDATION	validación de consulta indefinida
403	CRUD_INDEFINITE_UPDATE_CONFIGURATION	configuración de actualización indefinida
404	CRUD_INDEFINITE_UPDATE_VALIDATION	validación de actualización indefinida
405	CRUD_INDEFINITE_INSERT_VALIDATION	validación de inserción indefinida
406	CRUD_INDEFINITE_INSERT_CONFIGURATION	configuración de inserción indefinida
407	CRUD_INDEFINITE_DELETE_VALIDATION	validación de eliminación indefinida
408	CRUD_INDEFINITE_DELETE_CONFIGURATION	configuración de eliminación indefinida
421	CRUD_ROW_NUMBER_IN_UPDATE_IS_NOT_IDENTIFIED	no se identifica el número de fila en la actualización
441	CRUD_EMPTY_OR_NULL_FIELD	campo nulo o vacío
461	CRUD_THERE_IS_NO_INFORMATION_TO_ELIMINATE	no existe información para eliminar
462	CRUD_ERROR_WHEN_IDENTIFYING_RECORD_ELIMINATION	error al identificar registros de la eliminación
501	CRUD_CONSUMPTION_OPERATION_IS_NOT_IDENTIFIED	no se identifica la operación crud del consumo
502	CRUD_NAME_CAN_NOT_BE_IDENTIFIED	no se puede identifcar el nombre del crud

¹⁾ , ²⁾ , ³⁾ , ⁴⁾ , ⁵⁾ , ⁶⁾ , ⁷⁾ , ⁸⁾

Los valores por defecto son asumidos por el consumo interno

Wiki

Herramientas de usuario

Herramientas del sitio

Tabla de Contenidos

Maestro Niveles de Estudio

Definición

Contrato de Consumo: WS_LISTAR

Ejemplos

Contrato de Consumo: WS_INSERTAR

Ejemplos

Contrato de Consumo: WS_ACTUALIZAR

Ejemplos

Contrato de Consumo: WS_CONSULTAR

Ejemplos

Validaciones

Herramientas de la página