Maestro Tipos Identificacion

Definición

Definición del Componente
Nombre	n_ws05_nivel_estudio
Descripción	Gestiona el Maestro de Tipos Identificacion de los empleados
Proyecto PB	ws05_tipo_identificacion
Versión PB	12.5.1
URL SVN	http://adacsc.co:1443/svn/repository/ADA/SICOF/SICOF%20PBtoWS/Branches/Backend/branches%2012.5.2.5.0/05_Nomina/tipo_identificacion
Librerias Propias	Tipo
ws05_tipo_identificacion.pbl	Libreria Lanzadora
sf05controller_tipo_identificacion.pbl	Libreria Controladora
sf05model_tipo_identificacion.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 TESORE01.DET_TIPOS_IDENTIFICACION.
ws_insertar	ingresa un nuevo registro en la tabla TESORE01.DET_TIPOS_IDENTIFICACION.
ws_actualizar	actualiza valores en un registro de la tabla TESORE01.DET_TIPOS_IDENTIFICACION.

Contrato de Consumo: WS_LISTAR

Contrato de Consumo
Operación	Objetivo
ws_listar	lista los registros actuales de la tabla TESORE01.DET_TIPOS_IDENTIFICACION.
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	tipo_identificacion	Array Object	Array de Objetos que representan la data que devuelve el consumo	No	N/A
tipo_identificacion	descripcion	String	Nombre dado al Tipo Documento	Si	N/A
tipo_identificacion	digito	String	Digito para indicar si esta activo o no	Si	N/A
tipo_identificacion	usuario_empresa	String	Código del Usuario(Entorno Multiempresa)	Si	“NOMINA”
tipo_identificacion	codigo_mempresa	String	Código de la Empresa(Entorno Multiempresa)	Si	“9999999999”
tipo_identificacion	codigo_siif	String	Código de la Aplicación	Si	N/A
tipo_identificacion	tipo_identificacion	String	Código identificador del Resgistro	Si	N/A
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": "66c9bd52fd59ca17d41c12117067fcdb0f0de8566f387ddc5322ef445ea80d20" }
         </tem:as_config>
         <!--Optional:-->
         <tem:as_data>{"firstpag": 1, "lastpag": 1, "orderby":"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": 7,
        "tipo_identificacion": [
            {
                "descripcion": "Cedula de Ciudadania",
                "digito": "N",
                "usuario_empresa": "TESORE01",
                "codigo_mempresa": "9999999999",
                "codigo_siif": "03",
                "tipo_identificacion": "1",
                "rnum": 1
            }
        ],
        "rowcount": 11
    },
    "return_response_date": "02/07/2019 21:41:32",
    "return_execution_time": "2057"
}</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 TESORE01.DET_TIPOS_IDENTIFICACION.
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	descripcion	String	Nombre dado al Tipo Documento	Si	N/A
datarecord	digito	String	Digito para indicar si esta activo o no	Si	N/A
datarecord	usuario_empresa	String	Código del Usuario(Entorno Multiempresa)	Si	“NOMINA”
datarecord	codigo_mempresa	String	Código de la Empresa(Entorno Multiempresa)	Si	“9999999999”
datarecord	codigo_siif	String	Código de la Aplicación	Si	N/A
datarecord	tipo_identificacion	String	Código identificador del Resgistro	Si	N/A
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": "66c9bd52fd59ca17d41c12117067fcdb0f0de8566f387ddc5322ef445ea80d20" }
         </tem:as_config>
         <!--Optional:-->
         <tem:as_data>{"datarecord":{"tipo_identificacion":11, "descripcion":"ciro", "usuario_empresa":"NOMINA", "digito":"N", "codigo_mempresa":9999999999, "codigo_siif":05}}
         </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": "02/07/2019 21:43:18",
    "return_execution_time": "218"
}</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 TESORE01.DET_TIPOS_IDENTIFICACION.
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
as_data	datarecord	Objeto Json	Objeto que contiene la data a registrar	Si	1
datarecord	descripcion	String	Nombre dado al Tipo Documento	Si	N/A
datarecord	digito	String	Digito para indicar si esta activo o no	Si	N/A
datarecord	usuario_empresa	String	Código del Usuario(Entorno Multiempresa)	Si	“NOMINA”
datarecord	codigo_mempresa	String	Código de la Empresa(Entorno Multiempresa)	Si	“9999999999”
datarecord	codigo_siif	String	Código de la Aplicación	Si	N/A
datarecord	tipo_identificacion	String	Código identificador del Resgistro	Si	N/A
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": "66c9bd52fd59ca17d41c12117067fcdb0f0de8566f387ddc5322ef445ea80d20" }
         </tem:as_config>
         <!--Optional:-->
         <tem:as_data>{"datarecord":{"tipo_identificacion":"10", "descripcion":"PRUEBAS", "usuario_empresa":"NOMINA", "digito":"N", "codigo_mempresa":"9999999999", "codigo_siif":"05"}}</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": "02/07/2019 21:45:16"
}</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 TESORE01.DET_TIPOS_IDENTIFICACION
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	tipo_identificacion	Array Object	Array de Objetos que representan la data que devuelve el consumo	No	N/A
tipo_identificacion	descripcion	String	Nombre dado al Tipo Documento	Si	N/A
tipo_identificacion	digito	String	Digito para indicar si esta activo o no	Si	N/A
tipo_identificacion	usuario_empresa	String	Código del Usuario(Entorno Multiempresa)	Si	“NOMINA”
tipo_identificacion	codigo_mempresa	String	Código de la Empresa(Entorno Multiempresa)	Si	“9999999999”
tipo_identificacion	codigo_siif	String	Código de la Aplicación	Si	N/A
tipo_identificacion	tipo_identificacion	String	Código identificador del Resgistro	Si	N/A
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": "66c9bd52fd59ca17d41c12117067fcdb0f0de8566f387ddc5322ef445ea80d20" }
         </tem:as_config>
         <!--Optional:-->
         <tem:as_data>{ "tipo_identificacion": "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": 7,
        "tipo_identificacion": [
            {
                "descripcion": "Cedula de Ciudadania",
                "digito": "N",
                "usuario_empresa": "TESORE01",
                "codigo_mempresa": "9999999999",
                "codigo_siif": "03",
                "tipo_identificacion": "1",
                "rnum": 1
            }
        ],
        "rowcount": 0
    },
    "return_response_date": "02/07/2019 21:44:15",
    "return_execution_time": "218"
}</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 Tipos Identificacion

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