Table of Contents | ||||
---|---|---|---|---|
|
Servicio IissueService
...
CreateIssue
El método createIssue tiene como finalidad permitir la creación de un envío dentro de bandeja de entrada, su invocación retornará un número que será el identificador del envío creado, que podrá ser utilizado posteriormente para realizar consultas sobre dicho envío. Para integrarse con este método será necesario ponerse en contacto con el equipo de desarrollo de BENT para tipificar el envío según la aplicación y dar de alta a la misma en la configuración desde el módulo administrativo (se detalla esto en el manual de administrador)
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
El resultado del alta es el identificador único del envío creado. Signatura public Long createIssue(ParamCreateIssue paramCreateIssue) throws InternalCoreException
Parámetros de entrada: ParamCreateIssue
Parámetros de salida
Códigos de error Este método lanza una excepción de tipo InternalCoreException. A continuación se muestra una tabla con los códigos de error que puede contener la excepción lanzada.
Ejemplo de invocación La petición createIssue de BENT tiene varias casuísticas diferenciadas principalmente por el origen del envío a crear. Este parámetro de origen tiene cuatro valores posibles y según el valor que corresponda se parametrizarán también los valores del emisor (senderDni, senderName y senderOrgCode). Esto no afectará a los parámetros del receptor no obstante. La parametrización del receptor tiene como parámetro obligatorio el receiverOrgCode (deberá ser un organismo de la DGA con su código formateado correctamente ORGXXXXX). El otro parámetro receiverDni, es opcional y se introducirá únicamente si el envío es dirigido a la bandeja personal de un funcionario en concreto del organismo establecido en el receiverOrgCode. Dicho DNI deberá estar registrado correctamente en SIU, si no se especifica ningún dni el envío será recibido en la bandeja del organismo y se deberá crear un registro de entrada a través de SRT para que el envío pueda ser completado y visible en BENT. En caso de realizar un envío a un organismo que no tenga gestores dados de alta en BENT, la aplicación enviará una notificación a soporte para realizar las acciones pertinentes. El parámetro issuerDni, no es obligatorio y únicamente informa del usuario que realizó la operación. La parametrización del sender dependerá del tipo de origen del envío, por lo tanto vamos a mostrar una petición de cada tipo y como se debería parametrizar en cada caso:
El envío proviene de la propia administración interna y se tipificará el campo origen como 0. En este caso la parametrización del sender será igual que la del receiver. Será obligatorio indicar un senderOrgCode con el formato ORGXXXXX y opcional indicar un senderDni correspondiente a un funcionario del organismo, dependiendo si el emisor fuera una bandeja personal o la del propio organismo. Ponemos como ejemplo una petición de la aplicación CPPC que realiza este tipo de envíos, el envío sería dirigido desde una bandeja de organismo a la bandeja de personal de un funcionario en concreto, e incluyendo dos documentos :
2. Origen Ciudadano El envío proviene de un ciudadano y se tipificará el campo origen como 1. En este caso en la parametrización del sender se deberá informar un senderDni y un senderName, con los datos del solicitante. El campo senderOrgCode quedará nulo. Ponemos como ejemplo una petición de la aplicación TTO que realiza envíos de este tipo:
3. Administracion Externa El envío proviene de una administración externa a la dga y el campo origen se puede tipificar con el valor 2 (caso de que el envío sea una comunicación) o 3 (caso de que el envío sea una notificación). En este caso se informará como en el caso anterior el senderDni y el senderName, pero en este caso con el dni del gestor y el nombre del organismo. Ponemos como ejemplo una petición de la aplicación SETA que realiza envíos de este tipo:
|
AcceptIssue
Este método permite aceptar un envío creando una traza con la fecha de aceptación. Los envios considerados como aceptables son los que tienen como ultimo evento uno de tipo 1 (envio) o 4 (reenvio), cuyo estado es finalizado OK (3) y no contienen documentos editables. Tampoco se permite realizar una aceptación sobre una importación de REGFIA directamente.
...
|
ImportRegfiaEntry
Este método permite realizar la importación de un asiento de REGFIA en BENT
Signatura
public ResultImportRegfiaEntry importRegfiaEntry(ParamImportRegfiaEntry paramImportRegfiaEntry)
Parámetros de entrada
Parámetro | Tipo | Obligatorio | Descripción |
paramImportRegfiaEntry | ParamImportRegfiaEntry | SI | Objeto donde están encapsulados los datos relativos al asiento a importar |
Parámetros de salida
Parámetro | Tipo | Descripción |
resultImportRegfiaEntry | ResultImportRegfiaEntry | Objeto que contiene el id de envio generado en BENT, o la informacion del error producido |
Ejemplo de invocación
|
ParamImportRegfiaEntry
La clase ParamImportRegfiaEntry encapsula los parametros del asiento de REGFIA que son necesario para realizar la importacion en BENT tal y como los devuelve esta aplicacion en el metodo getRegistry.
Ver detalles
Parámetro | Tipo | Obligatorio | Descripción |
asunto | String | SI | Asunto del asiento a importar |
codOrganismoDestino | String | SI | codigo del organismo receptor de la importación. Debe ser un codigo valido de SIU |
codOrganismoOrigen | String | NO* | codigo del organismo origen de la importación |
dsOrganismoOrigen | String | NO* | descripcion del organismo emisor de la importación |
numeroRegistro | String | SI | numero de registro del asiento |
tipoAsiento | String | SI | Debe ser “E” solo se permiten importar asientos de entrada |
identificadorAgente | String | NO* | identificador del primer interesado del asiento |
nombreCompletoAgente | String | NO* | nombre completo del primer interesado del asiento |
csvList | List<String> | SI | listado de csvs del asiento. BENT comprueba y elimina los documentos en estado borrador. En el caso de que todos sean borradores el envio fallará. |
( * ) deben introducirse los datos del organismo origen, o del agente interesado obligatoriamente. En cualquier caso estos parametros se deben rellenar siempre con lo que venga informado en el asiento de REGFIA: organismoOrigen e interesados (el primero del listado).
ResultImportRegfiaEntry
La clase ResultImportRegfiaEntry contiene el resultado de la importación.
Ver detalles
Parámetro | Tipo | Descripción |
errorCode | String | Codigo de error producido |
errorMsg | String | Mensaje de error producido |
error | boolean | valor booleano que indica si la importacion se ha realizado correctamente o no |
issueId | Long | devuelve el id de envio creado en la importación |
FindIssueTrayAdvanced
Método que devuelve una lista de envíos correspondientes de la bandeja de recibidos con filtros avanzados
Signatura
public ResultTrayListAdvanced findIssueTray(ParamFindTrayAdvanced paramTraySearch) throws InternalCoreException
Parámetros de entrada
Parámetro | Tipo | Obligatorio | Descripción |
paramTraySearch | ParamFindTrayAdvanced | SI | Objeto donde están encapsulados los datos para realizar la búsqueda de envíos recibidos |
Parámetros de salida
Parámetro | Tipo | Descripción |
resultTrayList | ResultTrayListAdvanced | Objeto donde se encuentran encapsulados la lista de envíos correspondientes a la bandeja y su tamaño |
Excepciones
Tipo de excepción | Descripción |
InternalCoreException | Error en una operación del núcleo |
Ejemplo de invocación
|
ParamFindTrayAdvanced
La clase ParamFindTrayAdvanced es la que contiene los parámetros para la obtención de los listados que se muestran en las bandejas que ve el usuario, se la bandeja de usuario o la de organismo, tanto para entrada como para salida, con filtros adicionales.
Ver detalles
Parámetro | Tipo | Obligatorio | Descripción |
senderDni | String | NO | DNI del remitente |
senderName | String | NO | Nombre del remitente |
receiverDni | String | NO | DNI del destinatario |
receiverName | String | NO | Nombre del destinatario |
origin | String | NO | Origen de creación del envío |
adminFileNumber | String | NO | Número del expediente |
issueId | Long | NO | Identificador del envío |
status | Long | NO | Estado en el que se encuentra el envío |
acceptanceNif | String | NO | NIF de la persona que realiza la aceptación del envío |
description | String | NO | Descripción del envío |
entryDateFrom | Date | NO | Fecha inicial para el rango de fechas de entrada del envío en el sistema |
entryDateTo | Date | NO | Fecha final para el rango de fecha de entrada del envío en el sistema |
receptionDateFrom | Date | NO | Fecha inicial para el rango de fechas de recepción del envío |
receptionDateTo | Date | NO | Fecha final para el rango de fechas de recepción del envío |
viewIfIntermediate | Boolean | NO | Incluir o no en el resultado los envíos en los que el organismo es un organismo intermedio en la ruta de remisión |
fromIndex | int | NO | Para consultas paginadas recuperar desde el registro con el número indicado en fromIndex |
toIndex | int | NO | Para consultas paginadas recuperar hasta el registro con el número indicado en toIndex |
maxResults | int | NO | Para consultas paginadas indica el número máximo de registros a retornar |
sortColumn | String | NO | Columna por la cual se van a ordenar los resultados |
ascending | Boolean | NO | Ordenación ascendente (true) o descendente (false) de los resultados |
userSentNif | String | NO | NIF del usuario que realiza el envío, aplicable sólo para envíos remitidos a otro usuario/organismo |
userOrgCode | String | NO | Código del organismo desde el que se realiza el envío, aplicable sólo para envíos remitidos a otro usuario/organismo |
acceptedIssue | String | NO | Estado de aceptación de un envío |
editableDocs | String | NO | Documentos que hay que editar el código de procedimiento |
origen | String | NO | Parámetro que indica el origen del envío |
procNum | Long | NO | Codigo de procedimiento |
eventCause | Long | NO | Causa del evento del envio |
regInNumber | String | NO | Numero de registro de entrada |
regOutNumber | String | NO | Numero de registro de salida |
regInDateFrom | Date | NO | Fecha de registro de entrada |
regOutDateFrom | Date | NO | Fecha de registro de salida |
regInCsv | String | NO | Csv del documento de registro de entrada |
regOutCsv | String | NO | Csv del documento de registro de salida |
ResultTrayListAdvanced
La clase ResultTrayListAdvanced contiene el resultado de buscar la lista de trazas de un envío.
Ver detalles
Parámetro | Tipo | Descripción |
list | List<ParamReceivedTrayAdvanced> | Lista que contiene uno o varios objetos ParamReceivedTrayAdvanced |
size | int | Número de objetos que contiene la lista |
ParamReceivedTrayAdvanced
La clase ParamReceivedTrayAdvanced contiene los datos a mostrar en el listado de la bandeja de recibidos.
Ver detalles
Parámetro | Tipo | Descripción |
issueId | Long | Identificador del envío |
issueEventId | Long | Identificador del evento de envío |
acceptanceNif | String | NIF del usuario que realiza la aceptación del envío |
adminFileNumber | String | Número de expediente |
entryDate | Date | Fecha de entrada del envío |
receptionDate | Date | Fecha de recepción del envío |
senderDni | String | DNI del usuario que remite el envío |
senderName | String | Nombre del usuario que remite el envío |
receiverDni | String | DNI del usuario que se va consultar la bandeja de elementos recibidos |
description | String | Descripción del envío |
origin | String | Origen del envío, ver códigos en “Tipos de origen de creación del envío” |
state | Integer | Estado en el que se encuentra el registro, ver “Valores del campo status” |
senderOrgName | String | Nombre del organismo del remitente |
sender | String | Nombre del remitente completo |
acceptedIssue | String | Estado de aceptación del issue |
editableDocs | String | Documentos que hay que editar el código de procedimiento |
origen | String | Parámetro que indica el origen del documento |
receiverOrgCode | String | Código del organismo del receptor |
eventCause | String | Causa del evento del envío |
procNum | Long | Codigo de procedimiento del evio |
regInNumber | String | numero de registro de entrada |
regOutNumber | String | numero de registro de salida |
regInDate | Date | fecha de registro de entrada |
regOutDate | Date | fecha de registro de salida |
regInCsv | String | csv del documento de registro de entrada |
regOutCsv | String | csv del documento de registro de salida |
FindIssueTrayExternal
Método que devuelve una lista de envíos correspondientes de la bandeja de recibidos con filtros avanzados
...
Parámetro | Tipo | Descripción |
list | List<ParamReceivedTrayAdvanced> | Lista que contiene uno o varios objetos ParamReceivedTrayAdvanced |
size | int | Número de objetos que contiene la lista |
errorCode | String | codigo de error |
errorMsg | String | mensaje de error |
Servicio OrganismManagerService
...
GetEmailListByOrgCode
Este método del servicio organismManager permite recuperar el listado de los emails de los usuarios dados de alta en BENT en una bandeja de organismo concreta. BENT únicamente almacena los dnis de los usuarios en su base de datos, recuperando el email a través de SIU. Si un usuario implicado en la búsqueda no tuviera un email registrado el servicio simplemente no lo añadirá al listado de resultados.
...
|
getOrganismManagerListByOrgCode
Este método del servicio organismManager permite recuperar el listado de gestores asociados en BENT con un código de organismo concreto.
...