Maestro Enfermedades

Definición

Definición del Componente
Nombre	n_ws05_enfermedad
Descripción	Gestiona el Maestro de Enfermedades de los empleados
Proyecto PB	ws05_cargo
Versión PB	12.5.1
URL SVN	http:http://adacsc.co:1443/svn/repository/ADA/SICOF/SICOF%20PBtoWS/Branches/branches%2012.5.2.5.0/05_Nomina/enfermedades
Librerias Propias	Tipo
ws05_enfermedad.pbl	Libreria Lanzadora
sf05controller_enfermedad.pbl	Libreria Controladora
sf05model_enfermedad.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_cargo/n_ws05_cargo.asmx?WSDL
Operaciones	Objetivo
ws_listar	lista los registros actuales de la tabla NOMINA.ENFERMEDAD.
ws_insertar	ingresa un nuevo registro en la tabla NOMINA.ENFERMEDAD.
ws_actualizar	actualiza valores en un registro de la tabla NOMINA.ENFERMEDAD.

Contrato de Consumo: WS_LISTAR

Contrato de Consumo
Operación	Objetivo
ws_listar	lista los registros actuales de la tabla NOMINA.ENFERMEDAD.
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	enfermedad	Array Object	Array de Objetos que representan la data que devuelve el consumo	No	N/A
enfermedad	id_enfermedad	Long	Identificador del Registro	Si	N/A
enfermedad	codigo	String	Código de la Enfermedad	Si	N/A
enfermedad	nombre	String	Nombre del Enfermedad	Si	N/A
enfermedad	descripcion	String	Descripción del Enfermedad	Si	N/A
enfermedad	borrado	String	Estado del Enfermedad	Si	N/A
enfermedad	codigo_usuario	String	Código del Usuario(Entorno Multiempresa)	Si	“NOMINA”
enfermedad	codigo_mempresa	String	Código de la Empresa (Entorno Multiempresa)	Si	“9999999999”
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":"nombre 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": 8,
        "enfermedad": [
            {
                "id_enfermedad": 5663,
                "codigo": "R100",
                "nombre": "ABDOMEN AGUDO",
                "descripcion": "ABDOMEN AGUDO",
                "borrado": "N",
                "usuario_empresa": "NOMINA",
                "codigo_mempresa": "9999999999",
                "rnum": 1
            }
        ],
        "rowcount": 17758
    },
    "return_response_date": "28/06/2019 15:43:14",
    "return_execution_time": "281"
}</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.ENFERMEDAD.
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	id_enfermedad	Long	Identificador del Registro	Si	0
datarecord	codigo	String	Código de la Enfermedad	Si	N/A
datarecord	nombre	String	Nombre del Enfermedad	Si	N/A
datarecord	descripcion	String	Descripción del Enfermedad	Si	N/A
datarecord	borrado	String	Estado de la Enfermedad	Si	N/A
datarecord	codigo_usuario	String	Código del Usuario(Entorno Multiempresa)	Si	“NOMINA”
datarecord	codigo_mempresa	String	Código de la Empresa (Entorno Multiempresa)	Si	“9999999999”
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":{"id_enfermedad":17773, "codigo":"Z001", "nombre":"ciro", "descripcion":"ciro", "borrado":"N", "usuario_empresa":"NOMINA", "codigo_mempresa":"9999999999"}}
         </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 15:45:05",
    "return_execution_time": "952"
}</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.ENFERMEDAD.
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	id_enfermedad	Long	Identificador del Registro	Si	0
datarecord	codigo	String	Código de la Enfermedad	Si	N/A
datarecord	nombre	String	Nombre del Enfermedad	Si	N/A
datarecord	descripcion	String	Descripción del Enfermedad	Si	N/A
datarecord	borrado	String	Estado de la Enfermedad	Si	N/A
datarecord	codigo_usuario	String	Código del Usuario(Entorno Multiempresa)	Si	“NOMINA”
datarecord	codigo_mempresa	String	Código de la Empresa (Entorno Multiempresa)	Si	“9999999999”
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":{"id_enfermedad":17773, "codigo":"Z001", "nombre":"PRUEBAs", "descripcion":"PRUEBAs", "borrado":"N", "usuario_empresa":"NOMINA", "codigo_mempresa":"9999999999"}}
         </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 15:48:07"
}</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.ENFERMEDAD
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	codigo_cargo	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	enfermedad	Array Object	Array de Objetos que representan la data que devuelve el consumo	No	N/A
enfermedad	id_enfermedad	Long	Identificador del Registro	Si	N/A
enfermedad	codigo	String	Código de la Enfermedad	Si	N/A
enfermedad	nombre	String	Nombre del Enfermedad	Si	N/A
enfermedad	descripcion	String	Descripción del Enfermedad	Si	N/A
enfermedad	borrado	String	Estado del Enfermedad	Si	N/A
enfermedad	codigo_usuario	String	Código del Usuario(Entorno Multiempresa)	Si	“NOMINA”
enfermedad	codigo_mempresa	String	Código de la Empresa (Entorno Multiempresa)	Si	“9999999999”
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>{ "id_enfermedad": "17773" }
         </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": 8,
        "enfermedad": [
            {
                "id_enfermedad": 17773,
                "codigo": "Z001",
                "nombre": "ciro",
                "descripcion": "ciro",
                "borrado": "N",
                "usuario_empresa": "NOMINA",
                "codigo_mempresa": "9999999999",
                "rnum": 1
            }
        ],
        "rowcount": 0
    },
    "return_response_date": "28/06/2019 15:46:24",
    "return_execution_time": "249"
}</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 Enfermedades

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