Maestro Cargos

Definición

Definición del Componente
Nombre	n_ws05_cargo
Descripción	Gestiona el maestro de Cargo 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/Backend/branches%2012.5.2.5.0/05_Nomina/cargos
Librerias Propias	Tipo
ws05_cargo.pbl	Libreria Lanzadora
sf05controller_cargo.pbl	Libreria Controladora
sf05model_cargo.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.CARGOS.
ws_insertar	ingresa un nuevo registro en la tabla NOMINA.CARGOS.
ws_actualizar	actualiza valores en un registro de la tabla NOMINA.CARGOS.

Contrato de Consumo: WS_LISTAR

Contrato de Consumo
Operación	Objetivo
ws_listar	lista los registros actuales de la tabla NOMINA.CARGOS.
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	cargo	Array Object	Array de Objetos que representan la data que devuelve el consumo	No	N/A
cargo	codigo_cargo	Long	Identificador del Registro	Si	N/A
cargo	descripcion	String	Descripción del Cargo	Si	N/A
cargo	codigo_aplicacion	Long	Código de la Aplicación	Si	N/A
cargo	borrado	String	Estado del Cargo	Si	N/A
cargo	codigo_usuario	String	Código del Usuario(Entorno Multiempresa)	Si	“NOMINA”
cargo	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": "779f14a867cc5de46949e24590ab5510ea460d3cb7e8c2802e79e79e6bab09f5"}
         </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,
        "cargo": [
            {
                "codigo_cargo": 1,
                "descripcion": "ADMIN",
                "codigo_aplicacion": 1,
                "borrado": "N",
                "usuario_empresa": "PRESUP01",
                "codigo_mempresa": "9999999999",
                "rnum": 1
            }
        ],
        "rowcount": 263
    },
    "return_response_date": "26/06/2019 20:56:44",
    "return_execution_time": "844"
}</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.CARGOS.
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	codigo_cargo	Long	Identificador del Registro	Si	0
datarecord	descripcion	String	Descripción del Cargo	Si	N/A
datarecord	codigo_aplicacion	Long	Código de la Aplicación	Si	N/A
datarecord	borrado	String	Estado del Cargo	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": "779f14a867cc5de46949e24590ab5510ea460d3cb7e8c2802e79e79e6bab09f5"}
         </tem:as_config>
         <!--Optional:-->
         <tem:as_data>{"datarecord":{"codigo_cargo":77018,"descripcion":"PRUEBAS","codigo_aplicacion":5, "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": "26/06/2019 20:59:19",
    "return_execution_time": "172"
}</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.CARGOS.
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 actualizar	Si	1
datarecord	codigo_cargo	Long	Identificador del Registro	Si	0
datarecord	descripcion	String	Descripción del Cargo	Si	N/A
datarecord	codigo_aplicacion	Long	Código de la Aplicación	Si	N/A
datarecord	borrado	String	Estado del Cargo	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": "779f14a867cc5de46949e24590ab5510ea460d3cb7e8c2802e79e79e6bab09f5"}
         </tem:as_config>
         <!--Optional:-->
         <tem:as_data>{"datarecord":{"codigo_cargo":77017,"descripcion":"PRUEBA","codigo_aplicacion":5, "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": "26/06/2019 21:04:21"
}</ws_actualizarResult>
      </ws_actualizarResponse>
   </soap:Body>
</soap:Envelope>
</soap:Envelope>

Contrato de Consumo: WS_CONSULTAR

Contrato de Consumo
Operación	Objetivo
ws_consultar	consulta un único registro dado de la tabla NOMINA.CARGOS
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	cargo	Array Object	Array de Objetos que representan la data que devuelve el consumo	No	N/A
cargo	codigo_cargo	Long	Identificador del Registro	Si	N/A
cargo	descripcion	String	Descripción del Cargo	Si	N/A
cargo	codigo_aplicacion	Long	Código de la Aplicación	Si	N/A
cargo	borrado	String	Estado del Cargo	Si	N/A
cargo	codigo_usuario	String	Código del Usuario(Entorno Multiempresa)	Si	“NOMINA”
cargo	codigo_mempresa	String	Código de la Empresa (Entorno Multiempresa)	Si	“9999999999”
ws_consultarResult	return_response_date	Date	Fecha y hora de ejecución del consumo	Si	fecha y hora del sistema
ws_consultarResult	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": "779f14a867cc5de46949e24590ab5510ea460d3cb7e8c2802e79e79e6bab09f5"}
         </tem:as_config>
         <!--Optional:-->
         <tem:as_data>{"codigo_cargo":77017}
         </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": "dsf_cargo_only_one",
        "columncount": 6,
        "cargo": [
            {
                "codigo_cargo": 77017,
                "descripcion": "PRUEBA",
                "codigo_aplicacion": 5,
                "borrado": "N",
                "usuario_empresa": "NOMINA",
                "codigo_mempresa": "9999999999"
            }
        ],
        "rowcount": 0
    },
    "return_response_date": "26/06/2019 21:09:14",
    "return_execution_time": "171"
}</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 Cargos

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