Servicios para la gestión de expedientes

 

Servicio AdministrativeFileService

A continuación se muestran todos los métodos referentes a la administración de expedientes. Los métodos que a continuación se definen permiten realizar  las operaciones de apertura, recuperación, borrado de expedientes así como las operaciones necesarias para la incorporación de documentos o subexpedientes al expediente. 

Métodos para la gestión de expedientes

Método 'getAdministrativeFile'


Recupera un expediente a partir del CSV u oid del mismo. Permite indicar los metadatos a devolver, si se desea recuperar todos los contenidos del expediente, si se desea recuperar el índice actual y si se desea la firma asociada al índice.

Signatura

ResultGetAdministrativeFile getAdministrativeFile(ParamGetAdministrativeFile paramGetAdministrativeFile).

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

Nombre

Tipo 

Obligatorio

Descripción

ParamGetAdministrativeFile (hereda de ParamBase)

csv

String

Si(1)

CSV del expediente a consultar.

id

String

Si(1)

OID del expediente a consultar.

metadata

String[]

No(por defecto añade todos)

Array de los metadatos que se quieren recuperar.

includeIndexContent

boolean

Si

Indica si se desea recuperar el índice actual del expediente.

includeContent

boolean

Si

Indica si se desean recuperar los contenidos de los documentos del expediente.

attachIndexSignature

boolean

Si

Indica si se desea recuperar la firma asociada al índice.

NOTA: Si se consulta por csv no se rellena el campo id y viceversa.(1)

Parámetros de respuesta

Nombre

Tipo

Descripción

Nombre

Tipo

Descripción

ResultGetAdministrativeFile (hereda de ResultError)

adminFile

AdministrativeFile

Documento con el índice y metadatos del expediente.

adminFileContents

AdministrativeFileRelation[]

Contenidos del expediente.

signatures

ArrayList<Signature>

Firmas asociadas al índice del expediente.

Códigos de error

Los errores de la invocación se encapsulan en ResultGetAdministrativeFile

Código

Nombre

Descripción

Código

Nombre

Descripción

1017

ERROR_ADMINFILE_CSV_E_ID_NULOS

No se ha especificado el id o el CSV del expediente.

1002

ERROR_DOCUMENTMETADATA

Error del DocumentMetadataManager.

801

GENERIC_ERROR

Error genérico procesando la petición.

Ejemplo de invocación

Invocación
ParamGetAdministrativeFile paramGetAdministrativeFile = new ParamGetAdministrativeFile(); paramGetAdministrativeFile.setId("0906fca3801922bb"); paramGetAdministrativeFile.setIncludeContent(false); paramGetAdministrativeFile.setAttachIndexSignature(false); ResultGetAdministrativeFile result =ccsvClient.getAdministrativeFile(paramGetAdministrativeFile); if(result.getReturnCode().equals(ReturnCode.OK){ AdministrativeFile adminFile =result.getAdminFile(); AdministrativeFileRelation[] adminFileContents=result.getAdminFileContents(); ArrayList<Signature> signatures=result.getSignatures(); }else{ log.error(result.getErrorCode()+":"+result.getErrorMessage()); }

Método 'getAdminFileLiteAdv'


Recupera el conjunto de datos mínimo pero suficiente para la consulta de expedientes. Permite filtrar los datos a devolver; si se desean recuperar todos los agentes del expediente, si se desean recuperar los documentos del expediente, si se desean recuperar las carpetas del expediente y si se desean recuperar los subexpedientes del expediente.

Signatura

ResultGetAdministrativeFileLiteAdv getAdminFileLiteAdv(ParamGetAdministrativeFileLite paramGetAdministrativeFileLite);

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

Nombre

Tipo 

Obligatorio

Descripción

ParamGetAdministrativeFileLite (hereda de ParamBase)

csv

String

Si(1)

CSV del expediente a consultar.

id

String

Si(1)

OID del expediente a consultar.

addAgents

boolean

Si

Indica si se desean recuperar los agentes del expediente.

addDocuments

boolean

Si

Indica si se desean recuperar los documentos del expediente.

addFolders

boolean

Si

Indica si se desean recuperar las carpetas del expediente.

addSubAdminFiles

boolean

Si

Indica si se desean recuperar los subexpedientes del expediente.

NOTA: Si se consulta por csv no se rellena el campo id y viceversa.(1)

Parámetros de respuesta

Nombre

Tipo

Descripción

Nombre

Tipo

Descripción

ResultGetAdministrativeFileLiteAdv (hereda de ResultError)

administrativeFileLite

AdministrativeFileLite

Metadatos básicos del expediente.

administrativeFileDocumentAdvLiteList

Vector<AdministrativeFileDocumentLiteAdv>

Listado de documentos del expediente incluye el nombre y procedimiento del documento.

administrativeFileFolderLiteList

Vector<AdministrativeFileFolderLite>

Listado de carpetas del expediente.

administrativeFileAgentLiteList

Vector<AdministrativeFileAgentLite>

Listado de agentes del expediente.

administrativeFileLiteList

Vector<AdministrativeFileLite>

Listado de subexpedientes del expediente.

Códigos de error

Los errores de la invocación se encapsulan en ResultGetAdministrativeFileLiteAdv

Código

Nombre

Descripción

Código

Nombre

Descripción

1017

ERROR_ADMINFILE_CSV_E_ID_NULOS

No se ha especificado el id o el CSV del expediente.

1002

ERROR_DOCUMENTMETADATA

Error del DocumentMetadataManager.

801

GENERIC_ERROR

Error genérico procesando la petición.

Ejemplo de invocación

Invocación
ParamGetAdministrativeFileLite paramGetAdministrativeFileLite = new ParamGetAdministrativeFileLite(); paramGetAdministrativeFileLite.setApplicationId("appCode"); paramGetAdministrativeFileLite.setNif("userNif"); paramGetAdministrativeFileLite.setCsv("CCSVXXXXXXXXXXCSV"); paramGetAdministrativeFileLite.setAddAgents(true); paramGetAdministrativeFileLite.setAddDocuments(true); paramGetAdministrativeFileLite.setAddFolders(true); paramGetAdministrativeFileLite.setAddSubAdminFiles(true); ResultGetAdministrativeFileLiteAdv resultGetAdministrativeFileLiteAdv = ccsvClient.getAdminFileLiteAdv(paramGetAdministrativeFileLite);

Método 'getDocumentXml'


Recupera el documento xml del expediente codificado en Base64

Signatura

ResultGetDocumentXml getDocumentXml(ParamGetDocumentXml paramGetDocumentXml).

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

Nombre

Tipo 

Obligatorio

Descripción

ParamGetDocumentXml(hereda de ParamBase)

csv

String

Si(1)

CSV del expediente a consultar.

id

String

Si(1)

OID del expediente a consultar.

NOTA: Si se consulta por csv no se rellena el campo id y viceversa.(1)

Parámetros de respuesta

Nombre

Tipo

Descripción

Nombre

Tipo

Descripción

ResultGetDocumentXml(hereda de ResultError)


base64Xml

String

Documento en xml de la respuesta codificado en base64.

id

String

Id del documento de la respuesta.

Códigos de error

Los errores de la invocación se encapsulan en ResultGetDocumentXml 

Código

Nombre

Descripción

Código

Nombre

Descripción

148

ERROR_DOCUMENTOS_RELACIONADOS

No se han encontrado documentos
relacionados para el documento seleccionado

1042

ERROR_XML_ADMINFILE_EMPTY

El expediente debe tener contenido

1206

THREAD_ERROR

Hubo un error al generar uno o más de los
documentos Eni

193

ERROR_BASEDATOS_CCSV

Error al conectar con la Base de Datos CSV

801

GENERIC_ERROR

Error genérico procesando la petición.

Ejemplo de invocación

Invocación
ParamGetDocumentXml paramGetDocumentXml = new ParamGetDocumentXml(); ParamGetDocumentXml.setCsv("CCSV54641878471CCSV"); ResultGetDocumentXml result =ccsvClient.getDocumentXml (paramGetDocumentXml); if(result.getReturnCode().equals(ReturnCode.ERROR){ log.error(result.getErrorCode()+":"+result.getErrorMessage()); }



Método 'initializeAdministrativeFileMetadata'


Inicializa los metadatos del expediente electrónico en función de los parámetros aportados y, opcionalmente, de un documento ya existente en el gestor documental

Signatura

ResultInitializeAdministrativeFileMetadata initializeAdministrativeFileMetadata(ParamInitializeAdministrativeFileMetadata paramInitializeAdministrativeFileMetadata).

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

Nombre

Tipo 

Obligatorio

Descripción

ParamInitializeAdministrativeFileMetadata(hereda de ParamBase)

applicationCode

String

Si

Código de aplicación que da de alta el expediente

applicationName

String

Si

Nombre de aplicación que da de alta el expediente

type

String

Si

Tipo del expediente

number

String

Si

Número del expediente

name

String

Si

Nombre del expediente

description

String

Si

Descripción del expediente

date

Date

Si

Fecha de apertura del expediente

procedureCode

String

No

Código de procedimiento asociado al expediente

adminFileContentCsv

String

No(1)

CSV del documento contenido en el expediente si ya existe

adminFileContentId

String

No(1)

Id del documento contenido en el expediente si ya existe

NOTA: En caso de indicar el adminFileContentCsv no habrá que indicar el adminFileContentId y viceversa.(1)



Parámetros de respuesta

Nombre

Tipo

Descripción

Nombre

Tipo

Descripción

ResultInitializeAdministrativeFileMetadata(hereda de ResultError)


adminFile

AdministrativeFile

Documento con el índice y metadatos del expediente

adminFileContents

AdministrativeFileRelation[]

Contenidos del expediente

signatures

ArrayList<Signature>

Firmas asociadas al índice del expediente

Códigos de error

Los errores de la invocación se encapsulan en ResultInitializeAdministrativeFileMetadata 

Código

Nombre

Descripción

Código

Nombre

Descripción

1005

ERROR_ADMINFILE_NAMENULO

Debe especificar el parámetro name con el nombre del expediente

1006

ERROR_ADMINFILE_DESCRIPTIONNULO

Debe especificar el parámetro description con la descripción del expediente

1009

ERROR_ADMINFILE_APPLICODENULO

Debe especificar el código de aplicación

1010

ERROR_ADMINFILE_APPLINAMENULO

Debe especificar el nombre de aplicación

1011

ERROR_ADMINFILE_NUMBERNULO

Debe especificar el número del expediente

1012

ERROR_ADMINFILE_TYPERNULO

Debe especificar el tipo del expediente

1022

ERROR_ADMINFILE_DATENULO

Debe especificar la fecha de apertura del expediente

1002

ERROR_DOCUMENTMETADATA

Error del DocumentMetadataManager

801

GENERIC_ERROR

Error genérico procesando la petición.

Ejemplo de invocación

Invocación



Método 'openAdministrativeFile'


Crea un nuevo expediente en estado "Abierto" proporcionándole un documento asociado al mismo

Signatura

ResultOpenAdministrativeFile openAdministrativeFile(ParamOpenAdministrativeFile paramOpenAdministrativeFile)

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

Nombre

Tipo 

Obligatorio

Descripción

ParamOpenAdministrativeFile(hereda de ParamBase)

adminFile

AdministrativeFile

Si

Documento con el índice y metadatos del expediente

folderId

String

No

Identificador de la carpeta de Documentum

aclName

String

No

Nombre de la lista de control de accesos al fichero

signedDocument

SignedDocument

(1)

Documento contenido en el expediente

adminFileContentCsv

String

(2)

CSV del documento contenido en el expediente si ya existe

adminFileContentId

String

(2)

Id del documento contenido en el expediente si ya existe

createAdminFileContent

boolean

Si

Indica si el documento contenido en el expediente existe o hay que crearlo

NOTA : si createAdminFileContent es true signedDocument será obligatorio (1) ,en caso de ser falso habrá que indicar o el Csv o el id en documentum(2)

Parámetros de respuesta

Nombre

Tipo

Descripción

Nombre

Tipo

Descripción

ResultOpenAdministrativeFile(hereda de ResultError)


id

String

Identificador en Documentum del expediente creado.

adminFileContentId

String

Identificador en Documentum del documento contenido creado.

Códigos de error

Los errores de la invocación se encapsulan en ResultOpenAdministrativeFile  

Código

Nombre

Descripción

Código

Nombre

Descripción

1021

ERROR_ADMINFILENULO

Debe especificar el adminFile con todos los datos del expediente.

1003

ERROR_ADMINFILE_CSVNULO

Debe especificar el valor del CSV del expediente

1005

ERROR_ADMINFILE_NAMENULO

Debe especificar el parámetro name con el nombre
del expediente

1007

ERROR_ADMINFILE_CSV_E_ID_DOC_CONTENIDO_NULOS

Debe especificar el id o el CSV del documento
contenido del expediente

1008

ERROR_ADMINFILE_DOC_CONTENIDO_NULO

Debe especificar un documento contenido y su
firma

1009

ERROR_ADMINFILE_APPLICODENULO

Debe especificar el código de aplicación

1010

ERROR_ADMINFILE_APPLINAMENULO

Debe especificar el nombre de aplicación

1011

ERROR_ADMINFILE_NUMBERNULO

Debe especificar el número del expediente

1012

ERROR_ADMINFILE_TYPERNULO

Debe especificar el tipo del expediente

1019

ERROR_ADMINFILE_OPENORIGINALCOPIA

No se puede abrir un expediente con un
documento que no esté en estado Original o Copia

1002

ERROR_DOCUMENTMETADATA

Error del DocumentMetadataManager

801

GENERIC_ERROR

Error genérico procesando la petición.

Ejemplo de invocación

Invocación



Método 'closeAdministrativeFile'


Pasa el expediente a estado "Cerrado". En caso de contener subexpedientes también realiza el cerrado de los mismos.

Método 'reopenAdministrativeFile'


Cambia el estado de un expediente a estado abierto (si esta cerrado). En caso de contener subexpedientes, también los vuelve a abrir.

Método 'changeAdministrativeFileState'


Permite cambiar el estado del expediente actuando sobre el metadato expediente_estado. Los cambios posibles serán:

  • De Abierto a Cerrado

  • De Abierto a Índice para Remisión Cerrado.

 

NOTA: Se puede cambiar el estado de un expediente de abierto a cerrado. También se puede pasar al estado Índice para Remisión Cerrado. ¿Qué implica este cambio de pasar a Índice para Remisión Cerrado en el expediente?
Este estado fue definido en la resolución del BOE https://www.boe.es/buscar/doc.php?id=BOE-A-2011-13170 como una de los posibles opciones en el esquema de valores para el estado de un expediente en el momento del intercambio y su definición seria “Estado cuando se intercambia un expediente y en ese momento se cierra el índice para garantizar que los documentos que se mandan asociados a dicho expediente son los de ese índice en concreto”. Actualmente no se esta haciendo uso de este estado.

 

 

Método 'annulateAdminFile'


Permite anular un expediente. Este método está deprecado. En su lugar hay que usar el annulateAdminFileWithReason.

 

Método 'annulateAdminFileWithReason'


Permite anular un expediente añadiendo un motivo.

Métodos para la gestión de índices de expedientes.

Método 'getAdministrativeFileIndex'


Recupera el índice del expediente

Método 'regenerateAdministrativeFileIndex'


 Regenera el índice del expediente dejando el índice antiguo en un documento aparte con relación con rol: "ES VERSIÓN DE". Recuperando si se indica en los parámetros, el objeto expediente con el índice regenerado o su firma.

Métodos para la gestión de los contenidos de los expedientes.

Método 'addDocumentsToAdminFile'


Incluye la lista de documentos existentes en el gestor documental a un expediente en estado "Abierto". Si este expediente tiene carpetas puede identificarse esta para incluirlos dentro y no en la raíz del expediente. Nota: Si se quiere incluir un documento de registro, se deberá subir a la vez, todos los documentos que tenga la relación REGISTRA y/o ADJUNTA. El resultado de incluir uno o varios documentos a un expediente, crea una relación CONTIENE entre el expediente y dichos documentos. Será necesario una vez incluidos, regenerar el índice del expediente para su actualización.

 

Método 'addAdministrativeFileToAdminFile'


Añade el expediente existente en el gestor documental a un expediente en estado "Abierto". Para ello se deberá crear una relación entre el expediente y el subexpediente con rol "CONTIENE". Deberá añadir el expediente a la tabla de regeneración de índices para que el proceso nocturno se encargue de regenerarlo.

Método 'deleteDocumentFromAdminFile'


Quita un documento de un expediente en estado "Abierto". Para ello elimina la relación entre el expediente y el documento con rol "CONTIENE". No borra el documento de CCSV.

Método 'moveDocumentToRecycleFolder'


Servicio que elimina la relación entre un documento en cualquier estado y un expediente abierto, moviendo físicamente el documento a la carpeta dmFolder de “Papelera de reciclaje”. Si el documento se encuentra dentro de una carpeta en el expediente también eliminará la relación. El documento puede estar en cualquier estado. Se añadirá el expediente a la lista de expedientes pendientes de regeneración de su índice por el proceso nocturno.

Métodos para la gestión de carpetas.

Método 'createAdministrativeFileFolder'


Crea una carpeta dentro del expediente, para ello habrá que relacionar el expediente con la carpeta con una relación con rol CONTIENE". Deberá añadir el expediente a la tabla de regeneración de índices para que el proceso nocturno se encargue de regenerarlo.

Método 'deleteAdministrativeFileFolder'


Elimina una carpeta dentro del expediente. Deberá mover las relaciones con los documentos contenidos en la carpeta directamente sobre el expediente. Deberá añadir el expediente a la tabla de regeneración de índices para que el proceso nocturno se encargue de regenerarlo.

Método 'getAdministrativeFileFolder'


Obtiene una carpeta del expediente y los documentos contenidos en ella.

Método 'moveDocumentToFolder'


NOTA: Se recomienda el uso del método moveDocumentsToFolder por motivos de eficiencia.

Mueve un documento a una carpeta especificada. Si ya está dentro de una carpeta, se deberá cambiar la relación "CONTIENE" a la nueva carpeta conservando la fecha que es la de incorporación del documento al expediente. Deberá añadir el expediente a la tabla de regeneración de índices  para que el proceso nocturno se encargue de regenerarlo.

Método 'moveDocumentsToFolder'


Mueve un grupo de documentos a una carpeta especificada. Si ya está dentro de una carpeta, se deberá cambiar la relación "CONTIENE" a la nueva carpeta conservando la fecha que es la de incorporación del documento al expediente. Deberá añadir el expediente a la tabla de regeneración de índices para que el proceso nocturno se encargue de regenerarlo.

Método 'removeDocumentFromFolder'


Mueve un documento de una carpeta a la raíz del expediente, cambiando la relación "CONTIENE" al expediente. Deberá añadir el expediente a la tabla de regeneración de índices para que el proceso nocturno se encargue de regenerarlo.

Método 'lastAddedContents'


Recupera los últimos documentos, expedientes, carpetas, añadidos desde la fecha indicada.