A continuación se muestran todos los métodos referentes a la gestión de documentos, carpetas , relaciones etc.
Métodos de manejo de documentos.
Método 'createFolder'
Crea una carpeta en Documentum.
Ver detalles
Signatura
ResultCreateFolder createFolder(ParamCreateFolder paramCreateFolder).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamCreateFolder(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
folderType | String | No | Tipo Documental de la carpeta que se va a crear. |
metadata | HashMap<String, Object> | No | Metadatos propios de la carpeta que se va a crear. |
folderName | String | Si | Nombre de la carpeta que se quiere crear. |
aclName | String | No | Nombre de la lista de control de accesos al fichero.En caso de no especificarse se utilizara la utilizado por defecto por CCSV. |
folderId | String | No | Identificador de la carpeta donde se creará la subcarpeta.En caso de no especificarse se utilizara la utilizado por defecto por CCSV. |
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en ResultCreateFolder
Código | Nombre | Descripción |
|---|
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO |
161 | ERROR_FOLDERNAME_NULO | Debe especificar el nombre de la carpeta |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamCreateFolder paramCreateFolder = new ParamCreateFolder();
paramCreateFolder.setFolderName("Prueba");
paramCreateFolder.setFolderId("0c06fca38015e4aa");
ResultCreateFolder result = ccsvClient.createFolder(paramCreateFolder);
if(result.getReturnCode().equals(ReturnCode.OK){
String id = result.getId();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'getFolderContents'
Devuelve el contenido de una carpeta en Documentum.
Ver detalles
Signatura
ResultGetFolderContents getFolderContents(ParamGetFolderContents paramGetFolderContents).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamGetFolderContents(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
folderId | String | Si | Id de la carpeta en Documentum cuyo contenido queremos obtener. |
metadataNames | String[] | No(1) | Nombres de los metadatos que queremos recuperar de los contenidos de la carpeta. |
NOTA : Si no se especifican los metadatos que se quieren devolver se devuelven todos(1).
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetFolderContents
Código | Nombre | Descripción |
|---|
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
180 | ERROR_FOLDERNAME_NULO | Debe especificar el Id de la carpeta. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamGetFolderContents paramGetFolderContents = new ParamGetFolderContents();
paramGetFolderContents.setFolderId("0c06fca38015e4aa");
ResultGetFolderContents result = ccsvClient.getFolderContents(paramGetFolderContents);
if(result.getReturnCode().equals(ReturnCode.OK){
DocumentSearchResult[] folders = result.getFolders();
DocumentSearchResult[] documents = result.getDocuments();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'createDocument'
Almacena un documento en el gestor Documental Documentum.
NOTA: Se recomienda antes de crear un documento usando este método llamar al método de inicializacion de metadatos (CCSV_3.5.0_Manual de integración#initializeDocumentMetadata) sin enviar el contenido del documento.
Para crear expedientes o índices habría que usar los métodos referentes al servicio AdministrativeFileService
Ver detalles
Signatura
ResultCreateDocument createDocument(ParamCreateDocument paramCreateDocument).
Parámetros de invocación
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultCreateDocument
Código | Nombre | Descripción |
|---|
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
128 | ERROR_CSV_YAEXISTE | Ya existe un documento con el CSV especificado. |
130 | ERROR_BASEDATOS_CSVPAPIRO | Error al conectar con la base de datos CCSV. |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
155 | ERROR_VERIFYDOCUMENTMETADATA | Hay errores en la validación de metadatos |
168 | ERROR_CREAR_ANULADO | No se puede crear un documento con estado Anulado |
169 | ERROR_CREAR_COPIA_SIMPLE | No se puede crear un documento con Tipo de Copia = Copia Simple y Estado distinto a Copia |
181 | ERROR_CREAR_SINFIRMA | No se puede crear un documento sin firmar en estado Original o Copia. |
197 | MENSAJE_ERROR_COPIA_SIMPLE_SIGN | Error al firmar con sello de órgano el documento cuando es tipo de copia simple |
209 | ERROR_MESSAGE_DIGEST | Error al generar el SHA-1 |
2009 | ERROR_METADATA_HASH | El valor del metadato dea_verificacion_resumen está mal calculado respecto al algoritmo indicado |
2010 | ERROR_UPDATE_METADATA_HASH | No se puede modificar el metadato dea_verificacion_resumen sin modificar también el contenido |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamCreateDocument paramCreateDocument = new ParamCreateDocument();
paramCreateDocument.setDocument(document);//se entiende que el "document" es un documento con sus metadatos ya inicializados.
ResultCreateDocument result = ccsvClient.createDocument(paramCreateDocument);
if(result.getReturnCode().equals(ReturnCode.OK){
String id = result.getId();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'updateDocument'
Actualiza un documento en el gestor documental Documentum.
Ver detalles
Signatura
ResultUpdateDocument updateDocument(ParamUpdateDocument paramUpdateDocument).
Parámetros de invocación
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultUpdateDocument
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el id de Documentum o el CSV. |
126 | ERROR_CSV_NOVALIDO | Debe especificar el CSV. |
2010 | ERROR_UPDATE_METADATA_HASH | No se puede modificar el metadato dea_verificacion_resumen sin modificar también el contenido. |
2009 | ERROR_METADATA_HASH | El valor del metadato dea_verificacion_resumen está mal calculado respecto al algoritmo indicado. |
123 | ERROR_NOMBREDOCUMENTO_NOVALIDO | Debe especificar el nombre del documento. |
162 | ERROR_TIPO_DOCUMENTAL_NOVALIDO | Debe especificar el tipo documental del documento. |
124 | ERROR_FORMATO_NOVALIDO | Debe especificar el formato del documento. |
125 | ERROR_CODIGOAPLICACION_NOVALIDO | Debe especificar el código de la aplicación. |
155 | ERROR_VERIFYDOCUMENTMETADATA | Hay errores en la validación de metadatos. |
209 | ERROR_MESSAGE_DIGEST | Se ha producido un error al generar el hash del documento. |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con
PAU |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum |
130 | ERROR_BASEDATOS_CSVPAPIRO | Error al conectar con la base de datos CCSV |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamUpdateDocument paramUpdateDocument = new ParamUpdateDocument();
paramUpdateDocument.setDocument(document);//se entiende que el "document" es un documento que ya está creado.
paramUpdateDocument.setAddMetadata(true);
ResultUpdateDocument result = ccsvClient.updateDocument(paramCreateDocument);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'getDocumentByCitizen'
Recupera un documento desde portales públicos a partir de su identificador.
Ver detalles
Signatura
ResultGetDocumentByCitizen getDocumentByCitizen(ParamGetDocumentByCitizen paramGetDocumentByCitizen).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamGetDocumentByCitizen(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
csv | String | Si | Código seguro de verificación del documento que se desea recuperar. |
attachSignatures | boolean | No | Indica si se quieres adjuntar las firmas asociadas al documento. |
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetDocumentByCitizen
Código | Nombre | Descripción |
|---|
126 | ERROR_CSV_NOVALIDO | Debe especificar el CSV. |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado. |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
130 | ERROR_BASEDATOS_CSVPAPIRO | Error al conectar con la base de datos CCSV. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamGetDocumentByCitizen paramGetDocumentByCitizen = new ParamGetDocumentByCitizen();
paramGetDocumentByCitizen.setCsv("CSV5478454446454CCSV");
paramGetDocumentByCitizen.setAttachSignatures(true);
paramGetDocumentByCitizen.setNif("17588888H");
ResultGetDocumentByCitizen result = ccsvClient.getDocumentByCitizen(paramGetDocumentByCitizen);
if(result.getReturnCode().equals(ReturnCode.OK){
Document document = result.getDocument();
ArrayList<Signatures> signatures = result.getSignatures();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'getDocument'
Recupera un documento almacenado en el gestor documental a partir del identificador de Documentum o de su csv. Da la opción de indicar si se quiere devolver el contenido del documento, los metadatos o las firmas
Ver detalles
Signatura
ResultGetDocument getDocument(ParamGetDocument paramGetDocument).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamGetDocument(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
id | String | Si(1) | Identificador del documento en el gestor documental Documentum |
csv | String | Si(1) | Código Seguro de Verificación del documento que se quiere recuperar. |
addContent | boolean | Si(2) | Indica si adjunta el contenido del documento. |
addMetadata | boolean | Si(2) | Indica si adjunta los metadatos del documento. |
addSignatures | boolean | Si | Indica si adjunta las firmas asociadas al documento. |
NOTA : En caso de rellanar el id no habrá que rellenar el csv y viceversa.(1)
NOTA 2 : Si no se indican los datos que quieren devolverse se devuelven por defecto el contenido y los metadatos.(2)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetDocument
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el identificador del documento o su CSV. |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU. |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con PAU |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO |
130 | ERROR_BASEDATOS_CSVPAPIRO | Error al conectar con la base de datos CCSV |
2019 | ERROR_FILE_TOO_LARGE | El documento es demasiado grande. Puede descargarlo llamando al servicio web de descarga de documentos de VAJE. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamGetDocument paramGetDocument = new ParamGetDocument();
paramGetDocument.setId("0906fca3801922bb");
paramGetDocument.addContent(true);
paramGetDocument.setAttachSignatures(true);
paramGetDocument.setAddMetadata(false);
ResultGetDocument result = ccsvClient.getDocument(paramGetDocument);
if(result.getReturnCode().equals(ReturnCode.OK){
Document document = result.getDocument();
// en este caso document.getMetadata será nulo ya que no lo hemos recuperado
ArrayList<Signatures> signatures = result.getSignatures();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'deleteDocument'
Elimina un documento almacenado en el gestor documental a partir del identificador de Documentum o de su csv.
Signatura
Ver detalles
ResultDeleteDocument deleteDocument(ParamDeleteDocument paramDeleteDocument).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamDeleteDocument(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
id | String | Si(1) | Identificador del documento en el gestor documental Documentum |
csv | String | Si(1) | Código Seguro de Verificación del documento que se quiere recuperar. |
NOTA : En caso de rellanar el id no habrá que rellenar el csv y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultDeleteDocument
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el identificador del documento o su CSV. |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU. |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con PAU |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO |
130 | ERROR_BASEDATOS_CSVPAPIRO | Error al conectar con la base de datos CCSV |
2019 | ERROR_FILE_TOO_LARGE | El documento es demasiado grande. Puede descargarlo llamando al servicio web de descarga de documentos de VAJE. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamDeleteDocument paramDeleteDocument = new ParamDeleteDocument();
paramDeleteDocument.setCsv("CSV3G2ZOOM5NGAG1CCSV");
ResultDeleteDocument result = ccsvClient.deleteDocument(paramDeleteDocument);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'getSubstituteDocument'
Recupera el CSV del documento que sustituye al documento anulado que se indica en los parámetros.
Ver detalles
Signatura
ResultGetSubstituteDocument getSubstituteDocument(ParamGetSubstituteDocument paramGetSubstituteDocument)
Parámetros de invocación
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetSubstituteDocument
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el identificador del documento o su CSV. |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU. |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con PAU |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO |
130 | ERROR_BASEDATOS_CSVPAPIRO | Error al conectar con la base de datos CCSV |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamGetSubstituteDocument paramGetSubstituteDocument = new ParamGetSubstituteDocument();
paramGetSubstituteDocument.setCsvAnnulled(“CCVXXXXXXXXXXXXXCCSV”);
ResultGetSubstituteDocument result = ccsvClient.getSubstituteDocument(paramGetSubstituteDocument)
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Métodos de gestión de enlaces de documentos.
Método 'createDocumentLink'
Permite crear un enlace de un documento existente en otra carpeta determinada.
Ver detalles
Signatura
ResultCreateDocumentLink createDocumentLink(ParamCreateDocumentLink paramCreateDocumentLink).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamCreateDocumentLink(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
csv | String | Si(1) | Csv del documento que se quiere enlazar en otra carpeta. |
id | String | Si(1) | Identificador del documento que se quiere enlazar en otra carpeta. |
folderId | String | Si | Identificador de la carpeta donde se creará el link del documento. |
NOTA : En caso de rellanar el id no habrá que rellenar el csv y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultCreateDocumentLink
Código | Nombre | Descripción |
|---|
180 | ERROR_FOLDERID_NULO | Debe especificar el Id de la carpeta. |
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el id de Documentum o el CSV. |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexion con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamCreateDocumentLink paramCreateDocumentLink = new ParamCreateDocumentLink();
paramCreateDocumentLink.setCsv("CSV3G2ZOOM5NGAG1CCSV");
paramCreateDocumentLink.setFolderId("059874j45444fff4");
ResultCreateDocumentLink result = ccsvClient.createDocumentLink(paramCreateDocumentLink);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'deleteDocumentLink'
Elimina un enlace de un documento existente a una carpeta determinada.
Ver detalles
Signatura
ResultDeleteDocumentLink deleteDocumentLink(ParamDeleteDocumentLink paramDeleteDocumentLink).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamDeleteDocumentLink(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
csv | String | Si(1) | Csv del documento cuyo enlace se quiere borrar. |
id | String | Si(1) | Identificador del documento cuyo enlace se quiere borrar. |
folderId | String | Si | Identificador de la carpeta donde se borrará el enlace con el documento. |
NOTA : En caso de rellanar el id no habrá que rellenar el csv y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultDeleteDocumentLink
Código | Nombre | Descripción |
|---|
180 | ERROR_FOLDERID_NULO | Debe especificar el Id de la carpeta. |
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el id de Documentum o el CSV. |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexion con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamDeleteDocumentLink paramDeleteDocumentLink = new ParamDeleteDocumentLink();
paramDeleteDocumentLink.setCsv("CSV3G2ZOOM5NGAG1CCSV");
paramDeleteDocumentLink.setFolderId("09f54646511418");
ResultDeleteDocumentLink result = ccsvClient.deleteDocumentLink(paramDeleteDocumentLink);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Métodos de búsqueda.
Método 'search'
Realiza la búsqueda de documentos y expedientes en el gestor documental filtrando por los metadatos de los mismos.
Ver detalles
Signatura
ResultSearch search(ParamSearch paramSearchDocument).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamSearch (hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
searchType | CCSV_3.5.0_Manual de integración#SearchType | Si | Tipo de búsqueda que se quiere realizar. |
fileFilter | CCSV_3.5.0_Manual de integración#FileFilter[] | Si | Tipos de documentos que se desea buscar. |
metadataList | String[] | No | Lista de metadatos que se desea recuperar como
resultado. Si no se especifica, se devolverá un listado de id's |
int | pageNumber | No | Indica el número de página de los resultados que se
quiere obtener |
int | pageSize | No | Indica el tamaño de página de los resultados que se
quieren obtener |
sortMetadataName | String | No | Nombre del metadato por el que se quiere ordenar
los resultados de la búsqueda |
sortType | CCSV_3.5.0_Manual de integración#SortType | No | Tipo de ordenación de los resultados por el metadato especificado |
historical | Boolean | No | Indica si tiene que buscarse por históricos del organismo. |
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultSearch
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el id de Documentum o el CSV. |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU |
101 | ERROR_CONEXION_PAPIRO | Error de conexion con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamSearch paramSearchDocument = new ParamSearch();
paramSearchDocument.setSearchType(SearchType.DOCUMENTO);
String[] metadataList = new String [5]; //Metadatos a devolver
metadataList[0]= DocumentumConstants.NombreMetadatos.PAEGA_IDENT_CSV;
metadataList[1]= DocumentumConstants.NombreMetadatos.PAEGA_DESC_DESCRIPCION;
metadataList[2]= DocumentumConstants.NombreMetadatos.PAEGA_IDENT_FECHA_CAPTURA;
metadataList[3]= DocumentumConstants.NombreMetadatos.PAEGA_DESC_NOMBRE;
metadataList[4]= DocumentumConstants.NombreMetadatos.PAEGA_DESC_TIPO_DOCUMENTO;
paramSearchDocument.setMetadataList(metadataList);//Se crea una lista de filtros de tipos documentales
FileFilter[] fileFilterList= new FileFilter[1];//Se crea un filtro para tipos documentales DEA
FileFilter fileFilter = new FileFilter();//Se establece como tipo documental de búsqueda el DEA
fileFilter.setDocumentumType(DocumentumConstants.TipoDocumental.DEA);//Se inicializa la lista de filtros de rama de metadatos
DocumentFilter[] documentFilterList = new DocumentFilter[1];//Se inicializa un filtro de rama
DocumentFilter documentFilter = new DocumentFilter();//Se inicializa la lista de filtros de cada filtro de rama de metadatos
Filter[] filterList = new Filter[1];//Se define un filtro
Filter filter = new Filter();
filter.setName(DocumentumConstants.NombreMetadatos.PAEGA_IDENT_CSV);//CSV
filter.setFilterType(FilterType.IN);
filter.setValue(new String[]{"CSVSJ074D05PZAK1SCDE","CSV6B41D7L4OUA801SSS"});//Se asigna el filtro por lista de CSV's a la lista de filtros
filterList[0] = filter;//Se asigna la lista de filtros al filtro de rama de metadatos
documentFilter.setFilters(filterList);//Se asigna el filtro de rama a la lista de filtros
documentFilterList[0] = documentFilter;//Se asigna la lista de filtros de rama al filtro por tipo documental
fileFilter.setDocumentFilterList(documentFilterList);//Al ser una búsqueda de documentos sólo se informa un elemento de tipo FileFilter
fileFilterList[0]= fileFilter;//Se asigna la lista de filtros de tipos documentales
paramSearchDocument.setFileFilter(fileFilterList);
paramSearch.setPageNumber(1);//Valores de paginación
paramSearch.setPageSize(10);//Valores de ordenación
paramSearch.setSortMetadataName(DocumentumConstants.NombreMetadatos.PAEGA_IDENT_FECHA_CAPTURA);
paramSearch.setSortType(SortType.ASCENDING);
ResultSearch resultSearchDocument = documentMetadataSignatureBL.getDocumentMetadataSignatureWs().search(paramSearchDocument);
if (resultSearchDocument.getReturnCode().equals(ReturnCode.ERROR)){
log.error("Error al recuperar documentos: "+resultSearchDocument.getErrorMessage());
}else{
DocumentSearchResult[] results = resultSearchDocument.getDocumentSearchResult();
}
Método 'executeDQL'
Realiza una consulta DQL sobre el gestor documental. Este método solo debe utilizarse en casos en los que sea estrictamente necesario y no haya ninguna otra manera de realizar las consultas.
Ver detalles
Signatura
ResultExecuteDQL executeDQL(ParamExecuteDQL paramExecuteDQL).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamExecuteDQL(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
dql | String | Si | Sentencia DQL que se desea ejecutar. |
metadata | ArrayList<String> | No | Metadatos que queremos que se devuelvan la búsqueda. |
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultExecuteDQL.
Código | Nombre | Descripción |
|---|
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamExecuteDQL paramExecuteDQL = new ParamExecuteDQL();
String id="0906fca3801922bb";
String dql = "select * from dm_document where r_object_id='"+id+"'";
paramExecuteDQL.setDql(dql);
ResultExecuteDQL result = ccsvClient.executeDQL(paramExecuteDQL);
if(result.getReturnCode().equals(ReturnCode.OK){
ArrayList<HashMap<String, Object>> resultDQL = result.getResultDQL();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'searchDQL'
Realiza una búsqueda a partir de una dql previamente almacenada gestor documental. Este método solo debe utilizarse en casos en los que sea estrictamente necesario y no haya ninguna otra manera de realizar las consultas. Consultar el siguiente enlace para obtener información de como crear la dql:
Ver detalles
Signatura
ResultSearchDQL searchDQL(ParamSearchDQL paramSearchDQL).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamSearchDQL (hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
codDQL | String | Si | Identificador de la DQL |
attributesRecovered | String[] | Si | Metadatos que queremos que devuelva la búsqueda. |
attributesSearch | SearchAttribute[] | Si | Filtros de búsqueda |
sortAttributes | SortAttribute[] | Si | Filtros de ordenación |
maxResults | int | Si | Numero máximo de resultados |
pagination | boolean | Si | Activar/Desactivar la paginación |
resultsPerPage | int | Si | Resultados por pagina |
page | int | Si | Numero de pagina a recuperar |
Parámetros de respuesta
Nombre | Tipo | Descripción |
|---|
ResultSearchDQL(hereda de CCSV_3.5.0_Manual de integración#ResultError) |
resultDQL | ArrayList<HashMap<String, Object>> | Array con los datos que se han devuelto de realizar la consulta DQL. |
numRegistrosEncontrados | int | Número total de registros obtenidos de la consulta |
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultSearchDQL.
Código | Nombre | Descripción |
|---|
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
metodo = "searchDQL";
String codDQL = "ExpedientesPAEGA";
String[] atributosRecuperados = new String[13];
atributosRecuperados[0] = "r_object_id";
atributosRecuperados[1] = "dea_ident_csv";
atributosRecuperados[2] = "expediente_estado";
atributosRecuperados[3] = "expediente_fecha_apertura";
atributosRecuperados[4] = "expediente_num_expediente";
atributosRecuperados[5] = "dea_desc_descripcion";
atributosRecuperados[6] = "dea_cont_codprocedimiento";
atributosRecuperados[7] = "dea_cont_nom_procedimiento";
atributosRecuperados[8] = "expediente_csv_indice";
atributosRecuperados[9] = "expediente_fecha_cierre";
atributosRecuperados[10] = "dea_desc_tipo_documento";
atributosRecuperados[11] = "dea_desc_estado";
atributosRecuperados[12] = "dea_ident_fecha_captura";
AtributoBusqueda[] atributosBusqueda = new AtributoBusqueda[4];
AtributoBusqueda atributoBusqueda = new AtributoBusqueda();
atributoBusqueda.setName("expediente_fecha_apertura");
atributoBusqueda.setOperator(">=");
atributoBusqueda.setValue("2017-01-01T00:00:00");
atributosBusqueda[0] = atributoBusqueda;
atributoBusqueda = new AtributoBusqueda();
atributoBusqueda.setName("expediente_fecha_apertura");
atributoBusqueda.setOperator("<=");
atributoBusqueda.setValue("2017-01-31T23:59:59");
atributosBusqueda[1] = atributoBusqueda;
atributoBusqueda = new AtributoBusqueda();
atributoBusqueda.setName("agente_ident_identificacion");
atributoBusqueda.setOperator("IN");
atributoBusqueda.setValue("00000000T");
atributosBusqueda[2] = atributoBusqueda;
atributoBusqueda = new AtributoBusqueda();
atributoBusqueda.setName("relacion_rol");
atributoBusqueda.setOperator("=");
atributoBusqueda.setValue("APORTADOR");
atributosBusqueda[3] = atributoBusqueda;
AtributoOrdenacion[] atributosOrdenacion = new AtributoOrdenacion[1];
AtributoOrdenacion atributoOrdenacion = new AtributoOrdenacion();
atributoOrdenacion.setName("expediente_fecha_apertura");
atributoOrdenacion.setSentido(AtributoOrdenacion.ORDENACION_DESCENDENTE);
atributosOrdenacion[0] = atributoOrdenacion;
int maxResultados = 100000;
boolean paginacion = true;
int numResultadosPagina = 10;
int pagina = 1;
RetSearchDQL retsearchDQL = accesoSGCE.searchDQL(papiroSession, codDQL, atributosRecuperados, atributosBusqueda, atributosOrdenacion, paginacion, maxResultados, numResultadosPagina, pagina, idPeticion);
Métodos de gestión de firmas.
Método 'createAndVerifySignature'
Verifica y almacena una firma en el gestor documental almacenando adicionalmente el documento según los parámetros.
Ver detalles
Signatura
ResultCreateAndVerifySignature createAndVerifySignature(ParamCreateAndVerifySignature paramCreateAndVerifySignature).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamCreateAndVerifySignature(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
document | CCSV_3.5.0_Manual de integración#Document | Si(2) | Documento con la firma que se va a archivar en el repositorio documental. |
signature | DataHandler | Si | Firma del documento sin codificar en base64. |
id | String | Si(1) | Identificador del documento en Documentum si no hay que crearlo nuevo. |
csv | String | Si(1) | CSV del documento si no hay que crearlo de nuevo. |
createDocument | boolean | Si(2) | Indica si queremos crear el documento o no. |
signatureType | int | Si | Tipo de firma. |
initFormat | int | Si | Subformato de la firma. |
finalFormat | int | No | Se indica al subformato de firma si se quiere elevar. |
attachedSignature | boolean | Si | Indica si se trata de una firma adjunta. |
aclName | String | No | Nombre de la lista de control de accesos al fichero. |
folderId. | String | No | Identificador de la carpeta. |
NOTA : En caso de indicarse el CSV no se deberá indicar el id y viceversa.
NOTA 2 : En caso de marcar createDocument como true habrá que proporcionar el documento completo en caso contrario o habrá que indicar el CSV o el id.
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultSearch
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el id de Documentum o el CSV. |
136 | ERROR_FIRMA_FORMATONULO | Debe especificar el formato de la firma para su
verificación. |
177 | ERROR_SIGNATURETYPE_INVALID | El tipo de firma indicado no se corresponde con el
tipo de la firma proporcionada. |
178 | ERROR_SUBFORMAT_INVALID_FOR_FORMAT | El formato de firma no se puede elevar al subformato indicado. |
179 | ERROR_SUBFORMAT_INVALID_FOR_INITFORMAT | El subformato al que se desea elevar no puede ser
inferior al formato actual de la firma proporcionada. |
2005 | ERROR_SUBFORMAT_INVALID | El subformato de la firma es inferior al permitido. |
203 | ERROR_DATAHANDLER_ARRAYBYTE_CSV | Error al pasar dataHandler a ArrayByte |
138 | ERROR_DOCUMENTONULO | Debe especificar el parámetro documento. |
139 | ERROR_FIRMANULA | Debe especificar el parámetro firma. |
2010 | ERROR_UPDATE_METADATA_HASH | No se puede modificar el metadato dea_verificacion_resumen sin modificar también el contenido . |
2009 | ERROR_METADATA_HASH | El valor del metadato dea_verificacion_resumen está mal calculado respecto al algoritmo indicado |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al
documento indicado. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio. |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con
PAU |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con
SIU. |
1131 | ERROR_ASF_VALIDATE_SIGNATURE | Error al validar la firma. |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamCreateAndVerifySignature paramCreateAndVerifySignature = new ParamCreateAndVerifySignature();
paramCreateAndVerifySignature.setDocument(document);//se entiende que el objeto document es un objeto completo de un documento.
paramCreateAndVerifySignature.setSignature(signature);
paramCreateAndVerifySignature.setCreateDocument(true);//al indicar esta propiedad como verdadera no se pasan el csv y el id.
paramCreateAndVerifySignature.setSignatureType(com.tbsolutions.asf.util.Constants.CADES_FORMAT);
paramCreateAndVerifySignature.setInitFormat(new Long(com.tbsolutions.asf.signatureserver.util.Constants.CADES_T));
paramCreateAndVerifySignature.setFinalFormat(new Long(com.tbsolutions.asf.signatureserver.util.Constants.CADES_A));
paramCreateAndVerifySignature.setAttachedSignature(false);
ResultCreateAndVerifySignature result = ccsvClient.createAndVerifySignature(paramCreateAndVerifySignature);
if(result.getReturnCode().equals(ReturnCode.OK){
String documentId = result.getDocumentId();
String signatureId = result.getSignatureId();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'createWithoutVerifySignature'
Este método del servicio almacena y asocia la firma de un documento en Documentum. El documento puede estar ya almacenado o ser almacenado a la vez. La diferencia con con el CCSV_3.5.0_Manual de integración#createAndVerifySignature es que no se verifican las firmas que se van a insertar.
Ver detalles
Signatura
ResultCreateWithoutVerifySignature createWithoutVerifySignature(ParamCreateWithoutVerifySignature paramCreateWithoutVerifySignature).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamCreateWithoutVerifySignature (hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
document | CCSV_3.5.0_Manual de integración#Document | Si(2) | Documento que se desea almacenar junto con la firma proporcionada. |
id | String | Si(1) | Identificador del documento al que se desea asociar la
firma, en el caso de que no haya que crearlo. |
csv | String | Si(1) | CSV del documento al que se desea asociar la firma,
en el caso de que no haya que crearlo. |
createDocument | boolean | Si(2) | Indica si hay que almacenar primero el documento pasado por parámetro o la firma se debe vincular al documento cuyo id se proporciona. |
attachedSignature | boolean | Si | Indica si se trata de una firma adjunta |
aclName | String | No | Nombre de la lista de control de acceso o ACL con la que se quiere almacenar el documento. En caso de no informarse se utilizará el ACL por defecto proporcionado por CCSV. |
folderId | String | No | Identificador de la carpeta donde se quiere almacenar el documento. En caso de no rellenarse se almacenará en la carpeta proporcionada por CCSV. |
NOTA : En caso de indicarse el CSV no se deberá indicar el id y viceversa.(1)
NOTA 2 : En caso de marcar createDocument como true habrá que proporcionar el documento completo en caso contrario o habrá que indicar el CSV o el id.(2)
Parámetros de respuesta
Nombre | Tipo | Descripción |
|---|
ResultCreateWithoutVerifySignature(hereda de CCSV_3.5.0_Manual de integración#ResultError) |
documentId | String | Identificador en Documentum del documento almacenado. |
signatureId | String | Identificador en Documentum de la firma asociada al documento- |
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultCreateWithoutVerifySignature.
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el identificador del documento o su CSV. |
203 | ERROR_DATAHANDLER_ARRAYBYTE_CSV | Error al pasar dataHandler a ArrayByte. |
138 | ERROR_DOCUMENTONULO | Debe especificar el parámetro documento. |
2010 | ERROR_UPDATE_METADATA_HASH | No se puede modificar el metadato dea_verificacion_resumen sin modificar también el contenido. |
2009 | ERROR_METADATA_HASH | El valor del metadato dea_verificacion_resumen está mal calculado respecto al algoritmo indicado. |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio. |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU. |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU. |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamCreateWithoutVerifySignature paramCreateWithoutVerifySignature = new ParamCreateWithoutVerifySignature();
paramCreateWithoutVerifySignature.setDocument(document);
paramCreateWithoutVerifySignature.setCreateDocument(true);
paramCreateWithoutVerifySignature.setAttachedSignature(false);
ResultCreateWithoutVerifySignature result = ccsvClient.createWithoutVerifySignature(paramCreateWithoutVerifySignature);
if(result.getReturnCode().equals(ReturnCode.OK){
String documentId = result.getDocumentId();
String signatureId = result.getSignatureId();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'deleteSignature'
Servicio que elimina una firma vinculada a un documento.
Ver detalles
Signatura
ResultDeleteSignature deleteSignature(ParamDeleteSignature paramDeleteSignature).
Parámetros de invocación
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultDeleteSignature.
Código | Nombre | Descripción |
|---|
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamDeleteSignature paramDeleteSignature = new ParamDeleteSignature();
paramDeleteSignature.setId("0906fca3801922bb");
ResultDeleteSignature result = ccsvClient.deleteSignature(paramDeleteSignature);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'updateAndVerifySignature'
Verifica y reemplaza una firma en el gestor documental.
Ver detalles
Signatura
ResultUpdateAndVerifySignature updateAndVerifySignature(ParamUpdateAndVerifySignature paramUpdateAndVerifySignature).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamUpdateAndVerifySignature(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
aclName | String | No | Nombre de la lista de control de accesos al fichero. |
folderId | String | No | Identificador de la carpeta. |
csv | String | Si(1) | CSV del documento en Documentum. |
id | String | Si(1) | Identificador del documento en Documentum. |
signatureId | String | Si | Identificador de la firma. |
attachedSignature | boolean | Si | Indica si se trata de una firma adjunta. |
signatureType | int | Si | Indica el tipo de firma. |
initFormat | int | Si | Subformato de la firma. |
finalFormat | int | No | Se indica al subformato de firma si se quiere elevar. |
signature | DataHandler | Si | Firma en binario y sin codificar en base64 que se desea verificar y almacenar en el sistema de gestión documental asociada al documento indicado sustituyendo a la firma indicada. |
NOTA : En caso de indicarse el CSV no se deberá indicar el id y viceversa.
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultUpdateAndVerifySignature.
Código | Nombre | Descripción |
|---|
175 | ERROR_IDFIRMANULA | Debe especificar el parámetro ID de la firma. |
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el identificador del documento o su CSV. |
177 | ERROR_SIGNATURETYPE_INVALID | El tipo de firma indicado no se corresponde con el tipo de la firma proporcionada. |
178 | ERROR_SUBFORMAT_INVALID_FOR_FORMAT | El formato de firma no se puede elevar al subformato indicado. |
179 | ERROR_SUBFORMAT_INVALID_FOR_INITFORMAT | El subformato al que se desea elevar no puede ser inferior al formato actual de la firma proporcionada. |
2005 | ERROR_SUBFORMAT_INVALID | El subformato de la firma es inferior al permitido. |
203 | ERROR_DATAHANDLER_ARRAYBYTE_CSV | Error al pasar dataHandler a ArrayByte. |
176 | ERROR_SIGNATUREID_NOTFOUND | No existe la firma indicada para el documento cuyo identificador o csv se ha proporcionado. |
139 | ERROR_FIRMANULA | Debe especificar el parámetro firma |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU |
1131 | ERROR_ASF_VALIDATE_SIGNATURE | Error al validar firma |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamUpdateAndVerifySignature paramUpdateAndVerifySignature = new ParamUpdateAndVerifySignature();
paramUpdateAndVerifySignature.setCSV("CSV3G2ZOOM5NGAG1CCSV");
paramUpdateAndVerifySignature.setSignature(signature);
paramUpdateAndVerifySignature.setSignatureId("0906fca380173f47");
paramUpdateAndVerifySignature.setSignatureType(com.tbsolutions.asf.util.Constants.CADES_FORMAT);
paramUpdateAndVerifySignature.setInitFormat(new Long(com.tbsolutions.asf.signatureserver.util.Constants.CADES_T));
paramUpdateAndVerifySignature.setFinalFormat(new Long(com.tbsolutions.asf.signatureserver.util.Constants.CADES_A));
paramUpdateAndVerifySignature.setAttachedSignature(false);
ResultUpdateAndVerifySignature result = ccsvClient.updateAndVerifySignature(paramUpdateAndVerifySignature);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'updateWithoutVerifySignature'
Este método actualiza una firma existente de un documento almacenado en Documentum. La firma puede estar adjunta en el documento, entonces el contenido de éste será reemplazado por el de la firma en Documentum.
Ver detalles
Signatura
ResultUpdateWithoutVerifySignature updateWithoutVerifySignature(ParamUpdateWithoutVerifySignature paramUpdateWithoutVerifySignature).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamUpdateWithoutVerifySignature (hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
id | String | Si(1) | Identificador del documento al que se desea asociar la firma, en el caso de que no haya que crearlo. |
csv | String | Si(1) | CSV del documento al que se desea asociar la firma, en el caso de que no haya que crearlo. |
signature | DataHandler | Si | Firma en binario y sin codificar en base64 que se desea verificar y almacenar en el sistema de gestión documental asociada al documento indicado sustituyendo a la firma indicada. |
attachedSignature | boolean | Si | Indica si se trata de una firma adjunta. |
aclName | String | No | Nombre de la lista de control de acceso o ACL con la que se quiere almacenar el documento. En caso de no informarse se utilizará el ACL por defecto proporcionado por CCSV. |
folderId | String | No | Identificador de la carpeta. |
NOTA : En caso de indicarse el CSV no se deberá indicar el id y viceversa.
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultUpdateWithoutVerifySignature.
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el identificador del documento o su CSV. |
203 | ERROR_DATAHANDLER_ARRAYBYTE_CSV | Error al pasar dataHandler a ArrayByte |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU |
1131 | ERROR_ASF_VALIDATE_SIGNATURE | Error al validar firma |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamUpdateWithoutVerifySignature paramUpdateWithoutVerifySignature = new ParamUpdateWithoutVerifySignature();
paramUpdateWithoutVerifySignature.setCSV("CSV3G2ZOOM5NGAG1CCSV");
paramUpdateWithoutVerifySignature.setAttachedSignature(false);
ResultUpdateWithoutVerifySignature result = ccsvClient.updateWithoutVerifySignature(paramUpdateWithoutVerifySignature);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'updateAndSignDocument'
Servicio que recupera las firmas asociadas a un documento.
Ver detalles
Signatura
ResultUpdateAndSignDocument updateAndSignDocument(ParamUpdateAndSignDocument paramUpdateAndSignDocument).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamUpdateAndSignDocument (hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
document | CCSV_3.5.0_Manual de integración#Document | Si | Documento que se desea almacenar junto con la firma proporcionada. |
signature | DataHandler | Si | Firma en binario y sin codificar en base64 que se desea verificar y almacenar en el sistema de gestión documental asociada al documento indicado.. |
signatureType | int | Si | Tipo de firma. |
initFormat | int | Si | Subformato de la firma. |
finalFormat | int | No | Se indica al subformato de firma si se quiere elevar. |
attachedSignature | boolean | Si | Indica si la firma es adjunta. |
updateMetadata | boolean | No | Indica si se tienen que actualizar los metadatos del documento.En este caso, el objeto document debe venir relleno con los mismos. |
aclName | String | No | Nombre de la lista de control de acceso o ACL con la que se quiere almacenar el documento. En caso de no informarse se utilizará el ACL por defecto proporcionado por CCSV. |
folderId | String | No | Identificador de la carpeta donde se quiere almacenar el documento. En caso de no rellenarse se almacenará en la carpeta proporcionada por CCSV. |
traceData | TraceData | Si | Metadatos de la traza |
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultUpdateAndSignDocument.
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el id de Documentum o el CSV. |
126 | ERROR_CSV_NOVALIDO | Debe especificar el CSV. |
2010 | ERROR_UPDATE_METADATA_HASH | No se puede modificar el metadato dea_verificacion_resumen sin modificar también el contenido. |
123 | ERROR_NOMBREDOCUMENTO_NOVALIDO | Debe especificar el nombre del documento. |
162 | ERROR_TIPO_DOCUMENTAL_NOVALIDO | Debe especificar el tipo documental del documento. |
124 | ERROR_FORMATO_NOVALIDO | Debe especificar el formato del documento. |
125 | ERROR_CODIGOAPLICACION_NOVALIDO | Debe especificar el código de la aplicación. |
155 | ERROR_VERIFYDOCUMENTMETADATA | Hay errores en la validación de metadatos. |
209 | ERROR_MESSAGE_DIGEST | Se ha producido un error al generar el hash del documento. |
130 | ERROR_BASEDATOS_CSVPAPIRO | Error al conectar con la base de datos CCSV |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
136 | ERROR_FIRMA_FORMATONULO | Debe especificar el formato de la firma para su
verificación. |
177 | ERROR_SIGNATURETYPE_INVALID | El tipo de firma indicado no se corresponde con el
tipo de la firma proporcionada. |
178 | ERROR_SUBFORMAT_INVALID_FOR_FORMAT | El formato de firma no se puede elevar al subformato indicado. |
179 | ERROR_SUBFORMAT_INVALID_FOR_INITFORMAT | El subformato al que se desea elevar no puede ser
inferior al formato actual de la firma proporcionada. |
2005 | ERROR_SUBFORMAT_INVALID | El subformato de la firma es inferior al permitido. |
203 | ERROR_DATAHANDLER_ARRAYBYTE_CSV | Error al pasar dataHandler a ArrayByte |
138 | ERROR_DOCUMENTONULO | Debe especificar el parámetro documento. |
139 | ERROR_FIRMANULA | Debe especificar el parámetro firma. |
2009 | ERROR_METADATA_HASH | El valor del metadato dea_verificacion_resumen está mal calculado respecto al algoritmo indicado |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al
documento indicado. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio. |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con
PAU |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con
SIU. |
1131 | ERROR_ASF_VALIDATE_SIGNATURE | Error al validar la firma. |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamUpdateAndSignDocument paramUpdateAndSignDocument = new ParamUpdateAndSignDocument();
paramUpdateAndSignDocument.setDocument(document);
paramUpdateAndSignDocument.setSignature(signature);
paramUpdateAndSignDocument.setSignatureType(com.tbsolutions.asf.util.Constants.CADES_FORMAT);
paramUpdateAndSignDocument.setInitFormat(new Long(com.tbsolutions.asf.signatureserver.util.Constants.CADES_T));
paramUpdateAndSignDocument.setFinalFormat(new Long(com.tbsolutions.asf.signatureserver.util.Constants.CADES_A));
paramUpdateAndSignDocument.setAttachedSignature(false);
ResultUpdateAndSignDocument result = ccsvClient.updateAndSignDocument(paramUpdateAndSignDocument);
if(result.getReturnCode().equals(ReturnCode.OK){
String documentId = result.getDocumentId();
String signatureId = result.getSignatureId();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'getDocumentSignatures'
Recupera una firma del gestor documental.
Ver detalles
Signatura
ResultGetDocumentSignatures getDocumentSignatures(ParamGetDocumentSignatures paramGetDocumentSignatures).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamGetDocumentSignatures(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
id | String | Si(1) | Codigo identificador de la firma en el repositorio documental. |
csv | String | Si(1) | Código ccsv de la firma en el repositorio documental. |
NOTA : En caso de indicarse el CSV no se deberá indicar el id y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetDocumentSignatures.
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el identificador del documento o su CSV. |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado. |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con
PAU |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU |
2019 | ERROR_FILE_TOO_LARGE | El documento es demasiado grande. Puede descargarlo llamando al servicio web de descarga de documentos de VAJE. |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamGetDocumentSignatures paramGetDocumentSignatures = new ParamGetDocumentSignatures();
paramGetDocumentSignatures.setId("0906fca3801922bb");
ResultGetDocumentSignatures result = ccsvClient.getDocumentSignatures(paramGetDocumentSignatures);
if(result.getReturnCode().equals(ReturnCode.OK){
ArrayList<Signature> signatures = result.getSignatures();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Inicializa los metadatos del Documento proporcionado en función del tipo de documento o del tipo documental al que pertenezca.
Ver detalles
Signatura
ResultInitializeDocumentMetadata initializeDocumentMetadata(ParamInitializeDocumentMetadata paramInitializeDocumentMetadata).
Parámetros de invocación
NOTA: Se recomienda rellenar siempre que sea posible el tipo de dcumento(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultInitializeDocumentMetadata
Código | Nombre | Descripción |
|---|
144 | ERROR_INITIALIZE_DOCUMENTTYPE_NOEXISTE | No existe el tipo de documento indicado |
145 | ERROR_INITIALIZE_DOCUMENTUMTYPE_NOEXISTE | No existe el tipo documental indicado |
146 | ERROR_INITIALIZE_DOCUMENTTYPE_DOCUMENTUMTYPE_NULO | Debe indicar el tipo de documento (documentType) o el tipo documental (document.type) |
143 | ERROR_METADATA_MODEL | Error al recuperar la información del modelo de metadatos |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
Document document = new Document();// Establecemos el código de la aplicación
document.setApplicationCode("CCSV");// Establecemos el nombre de la aplicación
document.setApplicationName("Sistema de Comprobación de Documentos mediante CSV");
//documentContent es el DataHandler con el contenido del documento y no nos interesa pasarlo para la inicialización de metadatos
// Establecemos la extensión
document.setExtension("pdf");
/* Si no se sabe el tipo documental se puede indicar el tipo de documento documentType
dentro del ParamInitializeDocument */
document.setType("dga_doc_dea");
//Formato del documento según el catálogo de estándares
document.setFormat("PDF/A");
// Establecemos el nombre del documento
document.setName("solicitud1232243434343.pdf");
ParamInitializeDocumentMetadata paramInitializeDocumentMetada = new ParamInitializeDocumentMetadata();
paramInitializeDocumentMetadata.setDocument(document);
paramInitializeDocumentMetadata.setDocumentType("DECLARACION");
paramInitializeDocumentMetadata.setApplicationId("CCSV");
ResultInitializeDocumentMetadata result = ccsvClient.initializeDocumentMetadata(paramInitializeDocumentMetadata);
if(result.getReturnCode().equals(ReturnCode.OK){
document = result.getDocument();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Inicializa la estructura de un documento con el nombre del metadato proporcionado.
Ver detalles
Signatura
ResultInitializeStructuredMetadata initializeStructuredMetadata(ParamInitializeStructuredMetadata paramInitializeStructuredMetadata).
Parámetros de invocación
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultInitializeStructuredMetadata
Código | Nombre | Descripción |
|---|
147 | ERROR_NOT_STRUCTUREDMETADATAID | El id facilitado no pertenece a un metadato estructurado. |
143 | ERROR_METADATA_MODEL | Error al recuperar la información del modelo de metadatos. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamInitializeStructuredMetadata paramInitializeStructuredMetadata = new ParamInitializeStructuredMetadata();
paramInitializeStructuredMetadata.setMetadataName("agente");
ResultInitializeStructuredMetadata result = ccsvClient.initializeStructuredMetadata(paramInitializeStructuredMetadata);
if(result.getReturnCode().equals(ReturnCode.OK){
Document document = result.getDocument();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Verifica si un valor es correcto para un metadato simple proporcionado.
Ver detalles
Signatura
ResultVerifyMetadataValue verifyMetadataValue(ParamVerifyMetadataValue paramVerifyMetadataValue);.
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamVerifyMetadataValue(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
metadataName | String | Si | Nombre del metadato simple que se va a verificar. |
value | String | Si | Valor que se quiere validar para ese metadato. |
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultVerifyMetadataValue
Código | Nombre | Descripción |
|---|
143 | ERROR_METADATA_MODEL | Error al recuperar la información del modelo de metadatos. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
ParamVerifyMetadataValue paramVerifyMetadataValue = new ParamVerifyMetadataValue();
paramVerifyMetadataValue.setMetadataName("dea_desc_estado");
paramVerifyMetadataValue.setValue("0");
ResultVerifyMetadataValue result = ccsvClient.verifyMetadataValue(paramVerifyMetadataValue);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getMetadataValueVerification().getErrorMessage());
if (resultVerifyMetadataValue.getMetadataValueVerification() != null){
MetadataValueVerification error = resultVerifyMetadataValue.getMetadataValueVerification();
}
}
Verifica si la estructura de metadatos de un documento es correcta respecto al tipo de documento indicado.
Ver detalles
Signatura
ResultVerifyDocumentMetadata verifyDocumentMetadata(ParamVerifyDocumentMetadata paramVerifyDocumentMetadata);.
Parámetros de invocación
NOTA:El parámetro "content" debera ir obligatoriamente nulo.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultVerifyDocumentMetadata
Código | Nombre | Descripción |
|---|
143 | ERROR_METADATA_MODEL | Error al recuperar la información del modelo de metadatos. |
144 | ERROR_INITIALIZE_DOCUMENTTYPE_NOEXISTE | No existe el tipo de documento indicado |
145 | ERROR_INITIALIZE_DOCUMENTUMTYPE_NOEXISTE | No existe el tipo documental indicado |
146 | ERROR_INITIALIZE_DOCUMENTTYPE_DOCUMENTUMTYPE_NULO | Debe indicar el tipo de documento (documentType) o el tipo documental (document.type) |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamVerifyDocumentMetadata paramVerifyDocumentMetadata = new ParamVerifyMetadataValue();
paramVerifyDocumentMetadata.setDocument(document);
paramVerifyDocumentMetadata.setDocumentType("DECLARACION");
ResultVerifyDocumentMetadata result = ccsvClient.verifyDocumentMetadata(paramVerifyDocumentMetadata);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getMetadataValueVerification().getErrorMessage());
}
Devuelve la lista de valores para ese metadato.
Ver detalles
Signatura
ResultGetMetadataValueList getMetadataValueList(ParamGetMetadataValueList paramGetMetadataValueList).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamGetMetadataValueList(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
metadataName | String | Si(1) | Nombre del metadato tal y como se está dado de alta
en Documentum. |
metadataNameNTI | String | Si(1) | Nombre del metadato según la norma técnica de
interoperabilidad(NTI)). |
defaultOnly | boolean | Si | Indica si sólo se desea obtener el valor por defecto o
todos los valores. |
NOTA: En caso de rellenar el metadataName no se indicará el metadataNameNTI y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetMetadataValueList
Código | Nombre | Descripción |
|---|
154 | ERROR_METADATANAME_METADATANAMEID_NULO | Debe indicar el nombre del metadato en Documentum o el nombre del metadato según la NTI. |
707 | ERROR_METADATAID_NOEXISTE | No existe un metadato con el identificador especificado |
143 | ERROR_METADATA_MODEL | Error al recuperar la información del modelo de metadatos |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamGetMetadataValueList paramGetMetadataValueList = new ParamGetMetadataValueList();
paramGetMetadataValueList.setMetadata("dea_desc_estado");
paramGetMetadataValueList.setDefaultOnly(false);
ResultGetMetadataValueList result = ccsvClient.getMetadataValueList(paramGetMetadataValueList);
if(result.getReturnCode().equals(ReturnCode.OK){
List<MetadataValue> metadataValueList = result.getMetadataValueList();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Permite obtener la lista de metadatos de un tipo documental.
Ver detalles
Signatura
ResultGetMetadataList getMetadataList(ParamGetMetadataList paramGetMetadataList).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamGetMetadataList(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
documentumTypeName | String | Si(1) | Nombre del tipo del documento tal y como se está dado de alta en Documentum. |
documentumTypeNameNTI | String | Si(1) | Nombre del tipo del documento según la norma técnica de interoperabilidad(NTI)). |
NOTA: En caso de rellenar el documentumTypeName no se indicará el documentumTypeNameNTI y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetMetadataList
Código | Nombre | Descripción |
|---|
159 | ERROR_DOCUMENTUMTYPENAME_NULO | Faltan los parámetros para identificar al tipo
documental. |
160 | ERROR_DOCUMENTUMTYPE_NOEXISTE | No existe el tipo de documento indicado. |
722 | ERROR_GET_METADATALIST | No existe ningún metadato para ese tipo documental. |
143 | ERROR_METADATA_MODEL | Error al recuperar la información del modelo de
metadatos. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamGetMetadataList paramGetMetadataList = new ParamGetMetadataList();
paramGetMetadataList.setDocumentumTypeName("dga_paega_relacion");
ResultGetMetadataList result = ccsvClient.getMetadataList(paramGetMetadataList);
if(result.getReturnCode().equals(ReturnCode.OK){
List<Metadata> metadataList = result.getMetadataList();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Servicio que devuelve los valores de los metadatos indicados de un documento almacenado en el sistema de gestión documental.
Ver detalles
Signatura
ResultGetMetadata getMetadata(ParamGetMetadata paramGetMetadata).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamGetMetadataList(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
id | String | Si(1) | Identificador del documento en Documentum. |
csv | String | Si(1) | csv del documento en Documentum. |
metadataNames | String | Si | Nombres de los metadatos cuyos valores se quieren recuperar. |
NOTA: En caso de indicar el id no se indicara el csv o viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetMetadata
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el identificador del documento o su CSV |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO |
130 | ERROR_BASEDATOS_CSVPAPIRO | Error al conectar con la base de datos CCSV. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamGetMetadata paramGetMetadata = new ParamGetMetadata();
paramGetMetadata.setCsv("CSV3G2ZOOM5NGAG1CCSV");
String[] metadataNames = new String[3];
metadataNames[0] = "dea_desc_descripcion";
metadataNames[1] = "dea_desc_descriptores";
metadataNames[2] = "relacion";
paramGetMetadata.setMetadataNames(metadataNames);
ResultGetMetadata result = ccsvClient.getMetadata(paramGetMetadata);
if(result.getReturnCode().equals(ReturnCode.OK){
HashMap<String,Object> metadata = result.getMetadata();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'changeState'
Modifica el valor de un metadato simple concreto state.
Ver detalles
Signatura
ResultChangeState changeState(ParamChangeState paramchangeState).
Parámetros de invocación
NOTA: En caso de indicar el id no se indicara el csv o viceversa.(1)
NOTA 2 : En caso de cambiarse el documento a estado anulado habrá que rellenar el parámetro traceData.(2)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultChangeState
Código | Nombre | Descripción |
|---|
169 | ERROR_CHANGESTATE | No se puede modificar el estado |
197 | ERROR_COPIA_SIMPLE_SIGN | Error al firmar con sello de órgano el documento cuando es tipo de copia simple. |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con
PAU |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU |
158 | ERROR_VERIFY_NOT_VALUELIST | El valor indicado no está entre los valores válidos para ese metadato. |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO |
130 | ERROR_BASEDATOS_CSVPAPIRO | Error al conectar con la base de datos CCSV |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamChangeState paramChangeState = new ParamChangeState();
paramChangeState.setCsv("CSV3G2ZOOM5NGAG1CCSV");
paramChangeState.setState("P");
ResultChangeState result = ccsvClient.changeState(paramChangeState);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'changeExternalLock'
Modifica el valor de un metadato simple concreto Lock.
Ver detalles
Signatura
ResultChangeExternalLock changeExternalLock(ParamChangeExternalLock paramChangeExternalLock).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamChangeExternalLock(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
id | String | Si(1) | Identificador del documento en Documentum. |
csv | String | Si(1) | csv del documento en Documentum. |
documentLock | String | Si | Nuevo valor para el metadato bloqueo del documento. |
NOTA: En caso de indicar el id no se indicara el csv o viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultChangeExternalLock
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el identificador del documento o su CSV |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con
PAU |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU |
158 | ERROR_VERIFY_NOT_VALUELIST | El valor indicado no está entre los valores válidos para ese metadato. |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO |
130 | ERROR_BASEDATOS_CSVPAPIRO | Error al conectar con la base de datos CCSV |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamChangeExternalLock paramChangeExternalLock = new ParamChangeExternalLock();
paramChangeExternalLock.setCsv("CSV3G2ZOOM5NGAG1CCSV");
paramChangeExternalLock.setDocumentLock("S");
ResultChangeExternalLock result =ccsvClient.changeExternalLock(paramChangeExternalLock);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'changeDocumentVisibility'
Servicio que modifica el valor del metadato que indica si el documento es visible desde los portales públicos de acceso al ciudadano.
Ver detalles
Signatura
ResultChangeDocumentVisibility changeDocumentVisibility(ParamChangeDocumentVisibility paramChangeDocumentVisibility).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamChangeDocumentVisibility(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
id | String | Si(1) | Identificador del documento en Documentum. |
csv | String | Si(1) | csv del documento en Documentum. |
documentVisibility | String | Si | Nuevo valor para la visibilidad del documento. |
NOTA: En caso de indicar el id no se indicara el csv o viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultChangeDocumentVisibility
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el identificador del documento o su CSV |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con
PAU |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU |
158 | ERROR_VERIFY_NOT_VALUELIST | El valor indicado no está entre los valores válidos para ese metadato. |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO |
130 | ERROR_BASEDATOS_CSVPAPIRO | Error al conectar con la base de datos CCSV |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamChangeDocumentVisibility paramChangeDocumentVisibility = new ParamChangeDocumentVisibility();
paramChangeDocumentVisibility.setCsv("CSV3G2ZOOM5NGAG1CCSV");
paramChangeDocumentVisibility.setDocumentVisibility("N");
ResultChangeDocumentVisibility result = ccsvClient.changeDocumentVisibility(paramChangeDocumentVisibility);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":”+result.getErrorMessage());
}
Método 'getDocumentTypeList'
Recupera una lista de tipos de documentos, toda la lista para el modelo de metadatos actual o sólo los destacados.
Ver detalles
Signatura
ResultGetDocumentTypeList getDocumentTypeList(ParamGetDocumentTypeList paramDocumentTypeList).
Parámetros de invocación
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetDocumentTypeList
Código | Nombre | Descripción |
|---|
130 | ERROR_BASEDATOS_CSVPAPIRO | Error al conectar con la base de datos CCSV. |
718 | ERROR_GET_HIGHLIGHT | No existe ningún tipo de documento destacado para ese modelo de metadatos. |
130 | ERROR_BASEDATOS_CSVPAPIRO | Error al conectar con la base de datos CCSV. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
Ejemplo de invocación
Invocación
ParamGetDocumentTypeList paramGetDocumentTypeList = new ParamGetDocumentTypeList();
paramGetDocumentTypeList.setHighlight(true);
ResultGetDocumentTypeList result = ccsvClient.getDocumentTypeList(paramGetDocumentTypeList);
if(result.getReturnCode().equals(ReturnCode.OK){
List<DocumentTypeList> documentTypeList = result.getDocumentTypeList ();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'getDocumentXml'
Recupera el fichero xml del documento en base64.
Ver detalles
Signatura
ResultGetDocumentXml getDocumentXml(ParamGetDocumentXml paramGetDocumentXml).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamGetDocumentXml (hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
id | String | Si(1) | Identificador del documento en Documentum. |
csv | String | Si(1) | Código seguro de verificación del documento en Documentum. |
NOTA: En caso de indicar el id no se deberá indicar el csv y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetDocumentXml
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Se ha producido un error con PAPIRO. |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado. |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamGetDocumentXml paramGetDocumentXml = new ParamGetDocumentXml();
paramGetDocumentXml.setCsv("CSV0B31WVP5O1A21CCSV");
ResultGetADocumentXml result = ccsvClient.getDocumentXml(paramGetDocumentXml);
if(result.getReturnCode().equals(ReturnCode.OK){
String base64Xml = resultGetDocumentXml.getBase64Xml();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Modifica los valores de los metadatos informados independientemente del tipo que sean estos.
Ver detalles
Signatura
ResultUpdateMetadata updateMetadata(ParamUpdateMetadata paramUpdateMetadata).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamUpdateMetadata(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
id | String | Si(1) | Identificador del documento en Documentum. |
csv | String | Si(1) | Código seguro de verificación del documento en Documentum. |
newMetadata | HashMap<String,Object> | Si | Contiene los metadatos a actualizar. |
addValues | boolean | Si | Indica si los valores se añaden a los existentes: true o se sustituyen los existentes por los que se pasan: false. Solo para metadatos repetitivos. |
traceData | CCSV_3.5.0_Manual de integración#TraceData | Si | Contiene los datos de la traza de los cambios que se realizan. |
NOTA: En caso de indicar el id no se deberá indicar el csv y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultUpdateMetadata
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Se ha producido un error con PAPIRO. |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado. |
133 | ERROR_METADATONOEXISTE | No existe el metadato buscado para ese documento. |
158 | ERROR_VERIFY_NOT_VALUELIST | El valor indicado no está entre los valores válidos para ese metadato. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamUpdateMetadata paramUpdateMetadata = new ParamUpdateMetadata();
paramUpdateMetadata.setCsv("CSV3G2ZOOM5NGAG1CCSV");
// creamos un metadata con todos los metadatos que queremos modificar
HashMap<String, Object> metadata = new HashMap<String, Object> ();
// modificaremos el metadato de la descripción
metadata.put("dea_desc_descripcion", "Nueva descripción");
// y modificaremos un metadato repetitivo estructurado por ejemplo el de verificación
Object[] verificacion = new Object[2];
Document verifi1 = new Document();
verifi1.setType("dga_paega_verificacion");
verifi1.setName("verificacion");
HashMap<String, Object> metadataVerif1 = new HashMap<String, Object>();
metadataVerif1.put("verificacion_nombre","Nombre1");
metadataVerif1.put("verificacion_valor", "Valor1");
verifi1.setMetadata(metadataVerif1);
Document verifi2 = new Document();
verifi2.setType("dga_paega_verificacion");
verifi2.setName("verificacion");
HashMap<String, Object> metadataVerif2 = new HashMap<String, Object>();
metadataVerif2.put("verificacion_nombre","Nombre2");
metadataVerif2.put("verificacion_valor", "Valor2");
verifi2.setMetadata(metadataVerif2);
verificacion[0]=verifi1;
verificacion[1]=verifi2;
metadata.put("verificacion", verificacion);
paramUpdateMetadata.setNewMetadata(metadata);
paramUpdateMetadata.setAddValues(false);
ResultUpdateMetadata result = ccsvClient.updateMetadata (paramUpdateMetadata);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Borra o resetea los valores de un metadato (sea repetitivo o no).
Ver detalles
Signatura
ResultDeleteMetadata deleteMetadata(ParamDeleteMetadata paramDeleteMetadata).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamUpdateMetadata(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
id | String | Si(1) | Identificador del documento en Documentum. |
csv | String | Si(1) | Código seguro de verificación del documento en Documentum. |
metadataName | String | Si | Nombre del metadato que se quiere eliminar. |
deleteAll | boolean | Si | Para metadatos repetitivos indica si se desean borrar todos los valores. |
position | String | No | Indica la posicion del metadato repetitivo que queremos borrar. |
NOTA: En caso de indicar el id no se deberá indicar el csv y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultUpdateMetadata
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Se ha producido un error con PAPIRO. |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado. |
133 | ERROR_METADATONOEXISTE | No existe el metadato buscado para ese documento. |
134 | ERROR_POSICIONMETADATONOEXISTE | No existe metadato con ese orden o posición |
158 | ERROR_VERIFY_NOT_VALUELIST | El valor indicado no está entre los valores válidos para ese metadato. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamDeleteMetadata paramDeleteMetadata = new ParamDeleteMetadata();
paramDeleteMetadata.setCsv("CSV3G2ZOOM5NGAG1CCSV");
paramDeleteMetadata.setMetadataName("dea_desc_descriptores");
paramDeleteMetadata.setDeleteAll(false);
paramDeleteMetadata.setPosition("1");
ResultDeleteMetadata result = ccsvClient.deleteMetadata(paramDeleteMetadata);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Métodos de gestión de relaciones.
Método 'createRelationship'
Crea una relación entre documentos, pudiéndose especificar el rol de la relación, fecha de inicio y fecha de fin de la misma.
Ver detalles
Signatura
ResultCreateRelationship createRelationship(ParamCreateRelationship paramCreateRelationship).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamCreateRelationship (hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
idParent | String | Si(1) | Identificador del documento padre de la relación en Documentum. |
csvParent | String | Si(1) | Csv del documento padre de la relación. |
idChild | String | Si(2) | Identificador del documento hijo de la relación en
Documentum. |
csvChild | String | Si(2) | Csv del documento hijo de la relacion. |
relationship | CCSV_3.5.0_Manual de integración#DocumentRelation | si | Datos propios de la relación. |
NOTA : en caso de indicar el id del documento padre no habrá que indicar el csv y viceversa.(1)
NOTA 2: en caso de indicar el id del documento hijo no habrá que indicar el csv y viceversa.(2)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultCreateRelationship
Código | Nombre | Descripción |
|---|
149 | ERROR_RELACION_IDPADRE_NULO | Faltan los parámetros para identificar al documento Padre. |
150 | ERROR_RELACION_IDHIJO_NULO | Faltan los parámetros para identificar al documento Hijo |
151 | ERROR_RELACION_DATOS_NULO | Falta el parámetro con la información de la relación |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un erro con PAPIRO |
800 | ERROR_BASEDATOS_CSV | Error al conectar con la Base de Datos CSV |
158 | ERROR_VERIFY_NOT_VALUELIST | El valor indicado no está entre los valores válidos para ese metadato |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamCreateRelationship paramCreateRelationship = new ParamCreateRelationship();
paramCreateRelationship.setCsvParent("CSV0B31WVP5O1A21CCSV");
paramCreateRelationship.setCsvChild("CSVVV3X02P6OXAK1CCSV");
DocumentRelation relationship = new DocumentRelation();
relationship.setRole("Autoriza a")
paramCreateRelationship.setRelationship(relationship);
ResultCreateRelationship result = ccsvClient.createRelationship(paramCreateRelationship);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'createRelationships'
Crea una relación entre varios documentos y un mismo documento padre, pudiéndose especificar el rol de la relación, fecha de inicio y fecha de fin.
Ver detalles
Signatura
ResultCreateRelationships createRelationships(ParamCreateRelationships paramCreateRelationships).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamCreateRelationships (hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
idParent | String | Si(1) | Identificador del documento padre de la relación en Documentum. |
csvParent | String | Si(1) | Csv del documento padre de la relación. |
idsChild | String[] | Si(2) | Identificador de los documentos hijo de la relación en
Documentum. |
csvsChild | String[] | Si(2) | Csv de los documentos hijo de la relacion. |
relationship | CCSV_3.5.0_Manual de integración#DocumentRelation | Si | Datos propios de la relación. |
NOTA : en caso de indicar el id del documento padre no habrá que indicar el csv y viceversa.(1)
NOTA 2: en caso de indicar el id del documento hijo no habrá que indicar el csv y viceversa.(2)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultCreateRelationships
Código | Nombre | Descripción |
|---|
149 | ERROR_RELACION_IDPADRE_NULO | Faltan los parámetros para identificar al documento Padre. |
150 | ERROR_RELACION_IDHIJO_NULO | Faltan los parámetros para identificar al documento Hijo |
151 | ERROR_RELACION_DATOS_NULO | Falta el parámetro con la información de la relación |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un erro con PAPIRO |
800 | ERROR_BASEDATOS_CSV | Error al conectar con la Base de Datos CSV |
158 | ERROR_VERIFY_NOT_VALUELIST | El valor indicado no está entre los valores válidos para ese metadato |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamCreateRelationship paramCreateRelationship = new ParamCreateRelationship();
paramCreateRelationship.setCsvParent("CSV0B31WVP5O1A21CCSV");
paramCreateRelationship.setCsvChild("CSVVV3X02P6OXAK1CCSV");
DocumentRelation relationship = new DocumentRelation();
relationship.setRole("Autoriza a")
paramCreateRelationship.setRelationship(relationship);
ResultCreateRelationship result = ccsvClient.createRelationship(paramCreateRelationship);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'deleteRelationship '
Servicio que elimina una relación entre documentos.
Ver detalles
Signatura
ResultDeleteRelationship deleteRelationship (ParamDeleteRelationship paramDeleteRelationship).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamDeleteRelationship(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
idParent | String | Si(1) | Identificador del documento padre de la relación en Documentum. |
csvParent | String | Si(1) | Csv del documento padre de la relación. |
idChild | String | Si(2) | Identificador del documento hijo de la relación en Documentum. |
csvChild | String | Si(2) | Csv del documento hijo de la relación. |
NOTA : en caso de indicar el id del documento padre no habrá que indicar el csv y viceversa.(1)
NOTA 2: en caso de indicar el id del documento hijo no habrá que indicar el csv y viceversa.(2)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultCreateRelationships
Código | Nombre | Descripción |
|---|
149 | ERROR_RELACION_IDPADRE_NULO | Faltan los parámetros para identificar al documento Padre. |
150 | ERROR_RELACION_IDHIJO_NULO | Faltan los parámetros para identificar al documento Hijo |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un erro con PAPIRO |
800 | ERROR_BASEDATOS_CSV | Error al conectar con la Base de Datos CSV |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamDeleteRelationship paramDeleteRelationship = new ParamDeleteRelationship();
paramDeleteRelationship.setCsvParent("CSV0B31WVP5O1A21CCSV");
paramDeleteRelationship.setCsvChild("CSVVV3X02P6OXAK1CCSV");
ResultDeleteRelationship result =ccsvClient.deleteRelationship(paramDeleteRelationship);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Recupera relaciones de primer nivel entre documentos según los parámetros especificados.
Ver detalles
Signatura
ResultGetRelatedDocuments getRelatedDocuments(ParamGetRelatedDocuments paramGetRelatedDocuments).
Parámetros de invocación
Nombre | Tipo |
| Descriprición |
|---|
ParamGetRelatedDocuments(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
id | String | Si(1) | Id del documento en Documentum cuyas relaciones queremos obtener. |
csv | String | Si(1) | CSV del documento cuyas relaciones queremos obtener. |
role | String[] | No | Rol de las relaciones que queremos obtener. |
dateStart | String | No | Fecha de inicio de la búsqueda que nos indicará si debemos incluir esa relación dentro de los resultados. |
dateEnd | String | No | Fecha de fin de la búsqueda que nos indicará si debemos incluir esa relación dentro de los resultados. |
addContent | boolean | Si | Indica si se añaden los contenidos de los documentos. |
metadataNames | String[] | No | Nombres de los metadatos que queremos que nos muestre del el objeto Document de vuelta. |
searchType | CCSV_3.5.0_Manual de integración#DocumentRelationSearchType | Si | Tipo de búsqueda a realizar: indica si queremos recuperar los documentos hijos relacionados o los documentos padre relacionados. |
NOTA : en caso de indicar el id del documento no habrá que indicar el csv y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetRelatedDocuments
Código | Nombre | Descripción |
|---|
152 | ERROR_RELACION_ID_NULO | Faltan los parámetros para identificar el documento cuyas relaciones se desean buscar |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO |
153 | ERROR_RELACION_TIPOBUSQUEDA_NULO | Falta el parámetro que indica si se deben buscar los documentos hijos relacionados o los documentos padre relacionados |
148 | ERROR_DOCUMENTOS_RELACIONADOS | No se han encontrado documentos relacionados para el documento seleccionado. |
800 | ERROR_BASEDATOS_CSV | Error al conectar con la Base de Datos CSV |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU. |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamGetRelatedDocuments paramGetRelatedDocuments = new ParamGetRelatedDocuments();
paramGetRelatedDocuments.setCsv("CSV0B31WVP5O1A21CCSV");
paramGetRelatedDocuments.setSearchType(DocumentRelationSearchType.CHILD);
ResultGetRelatedDocuments result = ccsvClient.getRelatedDocuments(paramGetRelatedDocuments);
if(result.getReturnCode().equals(ReturnCode.OK){
DocumentTreeNodes[] = result.getDocumentTreeNodes();
}else{
log.error(result.getErrorCode()+”:”+result.getErrorMessage());
}
Recupera todas las relaciones entre documentos según los parámetros especificados.
Ver detalles
Signatura
ResultGetAllRelatedDocuments getAllRelatedDocuments(ParamGetAllRelatedDocuments paramGetAllRelatedDocuments).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamGetAllRelatedDocuments(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
id | String | Si(1) | Id del documento en Documentum cuyas relaciones queremos obtener. |
csv | String | si(1) | CSV del documento cuyas relaciones queremos obtener. |
role | String[] | No | Rol de las relaciones que queremos obtener. |
dateStart | String | No | Fecha de inicio de la búsqueda que nos indicará si debemos incluir esa relación dentro de los resultados. |
dateEnd | String | No | Fecha de fin de la búsqueda que nos indicará si debemos incluir esa relación dentro de los resultados. |
addContent | boolean | Si | Indica si se añaden los contenidos de los documentos. |
metadataNames | String[] | No | Nombres de los metadatos que queremos que nos muestre del el objeto Document de vuelta. |
searchType | CCSV_3.5.0_Manual de integración#DocumentRelationSearchType | Si | Tipo de búsqueda a realizar: indica si queremos recuperar los documentos hijos relacionados o los documentos padre relacionados. |
NOTA : en caso de indicar el id del documento no habrá que indicar el csv y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetAllRelatedDocuments
Código | Nombre | Descripción |
|---|
152 | ERROR_RELACION_ID_NULO | Faltan los parámetros para identificar el documento cuyas relaciones se desean buscar |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO |
153 | ERROR_RELACION_TIPOBUSQUEDA_NULO | Falta el parámetro que indica si se deben buscar los documentos hijos relacionados o los documentos padre relacionados |
148 | ERROR_DOCUMENTOS_RELACIONADOS | No se han encontrado documentos relacionados para el documento seleccionado. |
800 | ERROR_BASEDATOS_CSV | Error al conectar con la Base de Datos CSV |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU. |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamGetAllRelatedDocuments paramGetAllRelatedDocuments = new ParamGetAllRelatedDocuments();
paramGetAllRelatedDocuments.setCsv("CSV0B31WVP5O1A21CCSV");
paramGetAllRelatedDocuments.setSearchType(DocumentRelationSearchType.CHILD);
ResultGetAllRelatedDocuments result =ccsvClient.getAllRelatedDocuments(paramGetAllRelatedDocuments);
if(result.getReturnCode().equals(ReturnCode.OK){
DocumentTreeNode = result.getDocumentTreeNode();
}else{
log.error(result.getErrorCode()+”:”+result.getErrorMessage());
}
Métodos de gestión de relaciones de agentes.
Método 'addAgentRelationship'
Añade una nueva relación al documento con id o csv indicado guardando el cambio en documentum.
Ver detalles
Signatura
ResultAddAgentRelationship addAgentRelationship(ParamAddAgentRelationship paramAddAgentRelationship).
Parámetros de invocación
NOTA : en caso de indicar el id del documento no habrá que indicar el csv y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultAddAgentRelationship
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el id de Documentum o el CSV |
182 | ERROR_AGENTRELATIONSHIPNULO | Debe especificar algún agentRelationship con los datos de la relación de agente |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
158 | ERROR_VERIFY_NOT_VALUELIST | El valor indicado no está entre los valores válidos para ese metadato. |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio. |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU. |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU . |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamAddAgentRelationship paramAddAgentRelationship = new ParamAddAgentRelationship();
paramAddAgentRelationship.setCsv("CSV0B31WVP5O1A21CCSV");
paramAddAgentRelationship.setAgentRelationship(agentRelationship);
ResultAddAgentRelationship result = ccsvClient.addAgentRelationship(paramAddAgentRelationship);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'addAgentRelationships'
Añade relaciones al documento con id o csv indicado guardando el cambio en documentum.
Ver detalles
Signatura
ResultAddAgentRelationships addAgentRelationships(ParamAddAgentRelationships paramAddAgentRelationships)
Parámetros de invocación
NOTA : en caso de indicar el id del documento no habrá que indicar el csv y viceversa.
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultAddAgentRelationships
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el id de Documentum o el CSV |
182 | ERROR_AGENTRELATIONSHIPNULO | Debe especificar algún agentRelationship con los datos de la relación de agente |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
158 | ERROR_VERIFY_NOT_VALUELIST | El valor indicado no está entre los valores válidos para ese metadato. |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio. |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU. |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU . |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamAddAgentRelationships paramAddAgentRelationships = new ParamAddAgentRelationships();
paramAddAgentRelationships.setCsv("CSV0B31WVP5O1A21CCSV");
paramAddAgentRelationships.setAgentRelationships(agentRelationships);
ResultAddAgentRelationships result = ccsvClient.addAgentRelationships(paramAddAgentRelationships);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'deleteAgentRelationship'
Elimina una relación del documento con id o csv indicado guardando el cambio en documentum.
Ver detalles
Signatura
ResultDeleteAgentRelationship deleteAgentRelationship(ParamDeleteAgentRelationship paramDeleteAgentRelationship);
Parámetros de invocación
NOTA : en caso de indicar el id del documento no habrá que indicar el csv y viceversa.
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultDeleteAgentRelationship
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el id de Documentum o el CSV |
182 | ERROR_AGENTRELATIONSHIPNULO | Debe especificar algún agentRelationship con los datos de la relación de agente |
183 | ERROR_AGENTRELATIONSHIPIDNULO | Debe especificar el identificador dentro del parámetro agentRelationship |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
185 | ERROR_AGENTRELATIONSHIP_NOEXIST | No existe para el documento indicado esa relación
agente |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio. |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU. |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU . |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamDeleteAgentRelationship paramDeleteAgentRelationship = new
ParamDeleteAgentRelationship();
paramDeleteAgentRelationship.setCsv("CSV0B31WVP5O1A21CCSV");
paramDeleteAgentRelationship.setAgentRelationships(agentRelationship);
ResultDeleteAgentRelationship result = ccsvClient.deleteAgentRelationship(paramDeleteAgentRelationship);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'updateAgentRelationship'
Reemplaza una relación del documento con id o csv indicado guardando el cambio en documentum.
Ver detalles
Signatura
ResultUpdateAgentRelationship updateAgentRelationship(ParamUpdateAgentRelationship paramUpdateAgentRelationship);
Parámetros de invocación
NOTA : en caso de indicar el id del documento no habrá que indicar el csv y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultUpdateAgentRelationship
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el id de Documentum o el CSV |
182 | ERROR_AGENTRELATIONSHIPNULO | Debe especificar algún agentRelationship con los datos de la relación de agente |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
158 | ERROR_VERIFY_NOT_VALUELIST | Debe especificar el identificador dentro del parámetro agentRelationship. |
191 | ERROR_INTEGRATIONAPPLICATION | Error al recuperar la información de la integración de aplicaciones. |
190 | ERROR_INTERNALACCESS_NOTALLOWED | No está permitido el acceso del nif solicitante al documento indicado. |
189 | ERROR_INTERNALACCESSCONTROL_NIFINVALID | Debe especificar el nif del solicitante del servicio. |
192 | ERROR_CONEXION_PAU | Se ha producido un error al realizar la conexión con PAU. |
141 | ERROR_CONEXION_SIU | Se ha producido un error al realizar la conexión con SIU . |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamUpdateAgentRelationship paramUpdateAgentRelationship = new ParamUpdateAgentRelationship ();
paramUpdateAgentRelationship.setCsv("CSV0B31WVP5O1A21CCSV");
paramUpdateAgentRelationship.setAgentRelationship(agentRelationship);
ResultUpdateAgentRelationship result = ccsvClient.updateAgentRelationship(paramUpdateAgentRelationship);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'getAgentRelationship'
Devuelve la relación del documento con id o csv indicado que tenga ese role o identificationNumber o ambos
Ver detalles
Signatura
ResultGetAgentRelationship getAgentRelationship(ParamGetAgentRelationship paramGetAgentRelationship);;
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamGetAgentRelationship(hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
csv | String | Si(1) | Código csv asociado al documento del que se quiere recuperar una relación |
id | String | Si(1) | Identificador del documento del que se quiere recuperar una relación |
role | String | Si(2) | Contiene el rol que se quiere recuperar. |
identificationNumber | String | Si(2) | Código de identificación del agente: Número de
NIF, |
NOTA : en caso de indicar el id del documento no habrá que indicar el csv y viceversa.(1)
NOTA 2 : Se debe indicar por lo menos el role o el identificacion number para que se identifique una unica relacion de agente.(2)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultAddAgentRelationships
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el id de Documentum o el CSV |
184 | ERROR_ADD_ROLEORIDENTIFICATIONNUMBER | Debe especificar otro criterio de búsqueda, ya que existen varias relaciones que cumplen el indicado |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamGetAgentRelationship paramGetAgentRelationship = new ParamGetAgentRelationship();
paramGetAgentRelationship.setCsv("CSV0B31WVP5O1A21CCSV");
paramGetAgentRelationship.setRole(DocumentumConstants.RolRelacion.APORTADOR);
paramGetAgentRelationship.setIdentificationNumber("17258369T");
ResultGetAgentRelationship result = ccsvClient.getAgentRelationship(paramGetAgentRelationship);
if(result.getReturnCode().equals(ReturnCode.OK){
AgentRelationship agentRelationship = result.getAgentRelationship();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'getAgentRelationships'
Devuelve los datos de las relaciones del documento con id o csv indicado que sean de los roles indicados, estén activas o no o tengan el
identificador de agente identificationNumber. Si no se indican roles, devuelve todas las relaciones
Ver detalles
Signatura
ResultGetAgentRelationships getAgentRelationships(ParamGetAgentRelationships paramGetAgentRelationships)
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamGetAgentRelationships (hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
csv | String | Si(1) | Código csv asociado al documento del que se quiere recuperar una relación |
id | String | Si(1) | Identificador del documento del que se quiere recuperar una relación |
roles | String[] | No | Contiene los roles a buscar, si es null son todos |
current | booelan | No | true: devuelve sólo los que no tienen ficha fin de relación o si la tienen que aún no se haya llegado a esa fecha |
identificationNumber | String | No | Código de identificación del agente: Número de
NIF, |
NOTA : en caso de indicar el id del documento no habrá que indicar el csv y viceversa.
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetAgentRelationships
Código | Nombre | Descripción |
|---|
156 | ERROR_CSV_E_ID_NULOS | Debe especificar el id de Documentum o el CSV |
127 | ERROR_CSV_NOEXISTE | No existe documento con el CSV especificado |
131 | ERROR_GENERICO_PAPIRO | Se ha producido un error con PAPIRO. |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum. |
801 | GENERIC_ERROR | Error genérico procesando la petición. |
733 | ERROR_DOCUMENTO_SUSTITUIDO | El documento ha sido anulado y sustituido por el documento: CSVXXXXXXXXXXXXXBENT |
732 | ERROR_DOCUMENTO_ANULADO | No se puede recuperar un documento anulado |
Ejemplo de invocación
Invocación
ParamGetAgentRelationships paramGetAgentRelationships = new ParamGetAgentRelationships();
String[] roles = {DocumentumConstants.RolRelacion.APORTADOR,DocumentumConstants.RolRelacion.INTERESADO}
paramGetAgentRelationship.setCsv("CSV0B31WVP5O1A21CCSV");
paramGetAgentRelationship.setRoles(roles);
ResultGetAgentRelationships result = ccsvClient.getAgentRelationships(paramGetAgentRelationships);
if(result.getReturnCode().equals(ReturnCode.OK){
AgentRelationship[] agentRelationships = result.getAgentRelationships();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'generateIframeToken'
Genera un token firmado para los integradores del iframe del portal privado. Este token deberá ser devuelto para comprobar que el que carga el iframe es el mismo que lo ha pedido.
Ver detalles
Signatura
ResultGenerateIframeToken generateIframeToken(ParamGenerateIframeToken paramGenerateIframeToken)
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamGenerateIframeToken (hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
csv | String | Si(1) | Código csv asociado al documento del que se quiere recuperar una relación |
idDocumentum | String | Si(1) | Identificador del documento del que se quiere recuperar una relación |
NOTA : en caso de indicar el idDocumentum del documento no habrá que indicar el csv y viceversa.(1)
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGenerateIframeToken
Código | Nombre | Descripción |
|---|
1402 | MESSAGE_ERROR_GENERATE_TOKEN | Error creando el token |
Ejemplo de invocación
Invocación
ParamGenerateIframeToken paramGenerateIframeToken = new ParamGenerateIframeToken();
paramGenerateIframeToken.setCsv("CSV0B31WVP5O1A21CCSV");
ResultGenerateIframeToken result = ccsvClient.generateIframeToken(paramGenerateIframeToken);
if(result.getReturnCode().equals(ReturnCode.OK){
String token = result.getToken();
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'validateIframeToken'
Valida el token que se pasa en la llamada del iframe para que el portal privado deje acceso.
Ver detalles
Signatura
ResultValidateIframeToken validateIframeToken(ParamValidateIframeToken paramValidateIframeToken);
Parámetros de invocación
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultValidateIframeToken
Código | Nombre | Descripción |
|---|
1400 | MESSAGE_ERROR_EXPIRED_TOKEN | El tiempo de vida del token ha expirado |
1401 | MESSAGE_ERROR_INVALID_TOKEN | El token no es valido. |
1402 | MESSAGE_ERROR_GENERATE_TOKEN | Error creando el token |
Ejemplo de invocación
Invocación
ParamValidateIframeToken paramValidateIframeToken = new ParamValidateIframeToken();
paramValidateIframeToken.setToken("CSV0B31WVP5O1A21CCSV");
ResultValidateIframeToken result =ccsvClient.validateIframeToken(paramValidateIframeToken);
if(result.getReturnCode().equals(ReturnCode.OK){
log.info("OK");
}else{
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'getDocumentSubtypeList'
Recupera una lista de subtipos de documentos según un tipo de documento, toda la lista para el modelo de metadatos actual o sólo los destacados.
Ver detalles
Signatura
ResultGetDocumentSubtypeList getDocumentSubtypeList(ParamGetDocumentSubtypeList paramDocumentSubtypeList);
Parámetros de invocación
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en ResultGetDocumentSubtypeList
Código | Nombre | Descripción |
|---|
| ERROR_GET_DOCUMENTSUBTYPELIST | No existe ningún subtipo de documento para ese tipo de documento. |
130 | ERROR_BASEDATOS_CSVPAPIRO | 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
ParamGetDocumentSubtypeList paramGetDocumentSubtypeList = new ParamGetDocumentSubtypeList();
paramGetDocumentSubtypeList.setDocumentTypeName("documentTypeName");
ResultGetDocumentSubtypeList result = ccsvClient.documentSubtypeList(paramGetDocumentSubtypeList);
if(result.getReturnCode().equals(ReturnCode.OK){
List<DocumentSubtypeList> documentSubtypeList = result.getDocumentSubtypeList();
}
Métodos obsoletos
Debido a la definición actual del servicio de gestión documentos existen varios métodos que han quedado obsoletos ya que pueden realizarse esas mismas tareas desde un método general cambiando ciertos parámetros. Con el fin de mejorar la mantenibilidad y el soporte del sistema se ha decidido que en próximas versiones se eliminaran los siguientes métodos.(En cada uno de los métodos se marca aquel que se recomienda usar en lugar del que se ha marcado como obsoleto)
Método 'getDocumentByCSV'
Se recomienda usar el método CCSV_3.5.0_Manual de integración#getDocument ya que devuelve los mismos datos si rellenamos el csv y ademas podemos indicar los datos que queremos que se nos devuelvan.
Método 'getDocumentContentByCSV'
Se recomienda usar el método CCSV_3.5.0_Manual de integración#getDocument ya que devuelve los mismos datos si rellenamos el csv y ademas podemos indicar los datos que queremos que se nos devuelvan en este caso pasando el atributo addContent como true.
Método 'getDocumentById'
Se recomienda usar el método CCSV_3.5.0_Manual de integración#getDocument ya que devuelve los mismos datos si rellenamos el id y ademas podemos indicar los datos que queremos que se nos devuelvan.
Método 'getDocumentContentById'
Se recomienda usar el método CCSV_3.5.0_Manual de integración#getDocument que devuelve los mismos datos si rellenamos el id y ademas podemos indicar los datos que queremos que se nos devuelvan en este caso pasando el atributo addContent como true.
Se recomienda usar el método getDocument ya que podemos obtener los metadatos de un documento pasando el atributo addMetadata como true.
Se recomienda usar el método CCSV_3.5.0_Manual de integración#updateDocument ya que en caso de querer actualizar los metadatos marcaremos el atributo updateMetadata como true.
Método 'updateDocumentContent'
Se recomienda usar el método CCSV_3.5.0_Manual de integración#updateDocument ya que en caso de querer actualizar los metadatos marcaremos el atributo updateContent como true.
Método 'createSignature'
Se recomienda usar el método createAndVerifySignature que realiza las mismas funcionalidades pero está más actualizado.
Método 'updateSignature'
Se recomienda usar el método CCSV_3.5.0_Manual de integración#updateAndVerifySignature que realiza las mismas funcionalidades pero está más actualizado.
Se recomienda usar el método CCSV_3.5.0_Manual de integración#getMetadata.
Se recomienda usar el método CCSV_3.5.0_Manual de integración#getMetadata.
Se recomienda usar el método CCSV_3.5.0_Manual de integración#getMetadata.
Se recomienda usar el método CCSV_3.5.0_Manual de integración#updateMetadata ya que puede usarse independientemente del tipo de metadato que se intenta actualizar.
Se recomienda usar el método CCSV_3.5.0_Manual de integración#updateMetadata ya que puede usarse independientemente del tipo de metadato que se intenta actualizar.
Se recomienda usar el método CCSV_3.5.0_Manual de integración#updateMetadata ya que puede usarse independientemente del tipo de metadato que se intenta actualizar.
Servicio ISendAdminFileCloudWSPortType
El protocolo de Remisión en la Nube pretende ser un estándar para el intercambio de expedientes electrónicos en formato ENI (Esquema Nacional de Interoperabilidad) entre dos administraciones públicas cualesquiera, sean estas administrativas o judiciales.
Método 'createDocumentXml'
Crea un documento XML.
Ver detalles
Signatura
ResultCreateDocumentXml createDocumentXml(ParamCreateDocumentXml paramCreateDocumentXml).
Parámetros de invocación
Parámetros de respuesta
Nombre | Tipo | Descripción |
|---|
ResultCreateDocumentXml(hereda de CCSV_3.5.0_Manual de integración#ResultError) |
csv | String | Código csv asociado al documento que se ha creado. |
name | String | Nombre del documento que se ha creado. |
extension | String | Extension del documento que se ha creado. |
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultCreateDocumentXml
Código | Nombre | Descripción |
|---|
203 | ERROR_DATAHANDLER_ARRAYBYTE_CSV | Error al pasar dataHandler a ArrayByte |
1208 | ERROR_PARSE_XML | Hubo un error al leer los datos recibidos |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum |
1214 | ERROR_INDEX_FILE_EXIST | El documento eni ya existe. |
Ejemplo de invocación
Invocación
ParamCreateDocumentXml paramCreateDocumentXml = new ParamCreateDocumentXml();
paramCreateDocumentXml.setAgent(agent);//se entiende que agent es Agent correctamente creado
paramCreateDocumentXml.setXml(documento);//se entiende que document es el Datahandler de un documento xml
ResultCreateDocumentXml result= cssvClient.createDocumentXml(paramCreateDocumentXml);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'createIndexXml'
Crea un índice para documentos XML.
Ver detalles
Signatura
ResultCreateIndexXml createIndexXml(ParamCreateIndexXml paramCreateIndexXml).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamCreateIndexXml (hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
xml | DataHandler | Si | Xml del indice. |
agent | CCSV_3.5.0_Manual de integración#Agent | Si | Relación con metadato estructurado de tipo agente |
name | String | No | Nombre del documento indice. |
procedureCode | String | No | Código de procedimiento |
type | String | Si | Tipo del expediente donde se crea el indice. |
number | String | Si | Numero del expediente donde se crea el indice. |
description | String | Si | Descripcion del expediente donde se crea el indice. |
Parámetros de respuesta
Nombre | Tipo | Descripción |
|---|
ResultCreateIndexXml (hereda de CCSV_3.5.0_Manual de integración#ResultError) |
csv | String | Código csv asociado al documento indice que se ha creado. |
name | String | Nombre del documento indice que se ha creado. |
extension | String | Extension del documento indice que se ha creado. |
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultCreateIndexXml
Código | Nombre | Descripción |
|---|
203 | ERROR_DATAHANDLER_ARRAYBYTE_CSV | Error al pasar dataHandler a ArrayByte |
1208 | ERROR_PARSE_XML | Hubo un error al leer los datos recibidos |
101 | ERROR_CONEXION_PAPIRO | Error de conexión con documentum |
1214 | ERROR_INDEX_FILE_EXIST | El documento eni ya existe. |
Ejemplo de invocación
Invocación
ParamCreateIndexXml paramCreateIndexXml = new ParamCreateIndexXml();
paramCreateIndexXml.setName(“Nombre”);
paramCreateDocumentXml.setXml(documento);
paramCreateDocumentXml.setType("Tipo del expediente donde se crea el indice");
paramCreateDocumentXml.setNumber("Número del expediente donde se crea el indice");
paramCreateDocumentXml.setDescription("Descripción del expediente donde se crea el indice");
ResultCreateIndexXml result= cssvClient.createIndexXml(paramCreateIndexXml);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'prepareXmlToInside'
Prepara el documento xml de un expediente para su remisión a terceros.
Ver detalles
Signatura
void prepareXmlToInside(ParamPrepareXmlToInside paramPrepareXmlToInside)
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamPrepareXmlToInside (hereda de CCSV_3.5.0_Manual de integración#ParamBase) |
expedienteCSV | String | Si | CSV del Expediente |
codigoDir3 | String | Si | Código dir3. |
userNif | String | Si | Nif de la persona que realiza la petición. |
asunto | String | No | Asunto del xml que se prepara para enviar. Máximo 150 caracteres |
adjuntoCSV | String | No | Codigo csv adjunto al documento que se prepara para enviar. |
Id de la peticion | String | No | Id de la peticio. |
description | String | No | Descripcion del expediente donde se crea el indice. |
motivacion | String | No | Motivación. Maximo 256 |
plazoDisponibilidad | Date | No | Fecha limite hata la que el expediente//documento esta disponible |
flagAdminFileJustice | boolean | Si | Indica si se remite o no a justicia |
paramSendJustice | CCSV_3.5.0_Manual de integración#ParamSendJustice | Si | Parametros adicionales para remitir a justicia. |
NOTA: En caso de indicar como true el parametro flagAdminFileJustice habra que indicar el objeto paramSendJustice.
Parámetros de respuesta
Al ser un método void , no devolverá nada.
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#ResultGetAdministrativeFile
Código | Nombre | Descripción |
|---|
1200 | ERROR_INSIDE_ALTA_EXPEDIENTE | Se ha producido un error con el servicio Inside |
193 | ERROR_BASEDATOS_CCSV | Error al conectar con la Base de Datos CSVs |
801 | GENERIC_ERROR | Error genérico procesando la petición |
Ejemplo de invocación
Invocación
ParamPrepareXmlToInside prepareXmlToInside= new ParamPrepareXmlToInside();
paramPrepareXmlToInside.setExpedienteCSV("CSV5422552326");
paramPrepareXmlToInside.setCodigoDir3("asdasd");
paramPrepareXmlToInside.setUserNif("0000000T");
paramPrepareXmlToInside.setFlagAdminFileJustice("false");
ResultPrepareXmlToInside result= cssvClient.prepareXmlToInside(paramPrepareXmlToInside);
if(result.getReturnCode().equals(ReturnCode.ERROR){
log.error(result.getErrorCode()+":"+result.getErrorMessage());
}
Método 'accessIndexFile'
Sistema peticionario pide al sistema remitente (a través del nodo central), el acceso al índice del expediente indicando el token.
Ver detalles
Signatura
RespuestaAccesoIndiceExpedienteType accessIndexFile(PeticionAccesoIndiceExpedienteType peticionAccesoIndiceExpedienteType).
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
PeticionAccesoIndiceExpedienteType |
peticion | PeticionType | Si | Tipo de documento. |
token | StringTokenType | Si | Tipo de token |
Parámetros de respuesta
Nombre | Tipo | Descripción |
|---|
RespuestaAccesoIndiceExpedienteType |
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#RespuestaAccesoIndiceExpedienteType
Código | Nombre | Descripción |
|---|
601 | PETICION_ERROR | Se esperaba objeto petición. |
602 | PETICION_NULL | Falta petición. |
603 | TOKEN_NULL | Falta token. |
604 | TOKEN_NOT_EXIST | El token no existe. |
606 | DIR3_ERROR | La unidad DIR3 peticionada es errónea. |
607 | USER_ERROR | Usuario peticionario erróneo para el token. |
609 | TOKEN_INVALID | El token no es válido para el expediente solicitado. |
500 | ERROR_INTERNO | Error interno de inside |
Ejemplo de invocación
Invocación
RespuestaAccesoIndiceExpedienteType respuesta= cssvClient.accesoIndiceExpedienteType(peticionAccesoIndiceExpedienteType.getPeticion(), peticionAccesoIndiceExpedienteType.getToken().getIdexpEni(),peticionAccesoIndiceExpedienteType.getToken().getCsv(),peticionAccesoIndiceExpedienteType.getToken().getUuid());
log.info(respuesta.getRespuesta().getCodigo()+":"+respuesta.getRespuesta().getDescripcion());
Método 'accessDocumentFile'
Sistema peticionario solicita documento de expediente Sistema remitente (sin pasar por Punto Único Justicia, ya se hablan directamente).
Ver detalles
Signatura
RespuestaAccesoDocumentoExpedienteType accessDocumentFile(PeticionAccesoDocumentoExpedienteType peticionAccesoDocumentoExpediente.
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
PeticionAccesoDocumentoExpedienteType |
peticion | PeticionType | Si | Tipo de documento. |
token | StringTokenType | Si | Tipo de token |
idDocumento | String | Si | Identificador del documento. |
Parámetros de respuesta
Nombre | Tipo | Descripción |
|---|
RespuestaAccesoDocumentoExpedienteType |
Códigos de error
Los errores de la invocación se encapsulan en CCSV_3.5.0_Manual de integración#RespuestaAccesoDocumentoExpedienteType
Código | Nombre | Descripción |
|---|
601 | PETICION_ERROR | Se esperaba objeto petición. |
602 | PETICION_NULL | Falta petición. |
603 | TOKEN_NULL | Falta token. |
604 | TOKEN_NOT_EXIST | El token no existe. |
606 | DIR3_ERROR | La unidad DIR3 peticionada es errónea. |
607 | USER_ERROR | Usuario peticionario erróneo para el token. |
609 | TOKEN_INVALID | El token no es válido para el expediente solicitado. |
500 | ERROR_INTERNO | Error interno de inside |
Ejemplo de invocación
Invocación
RespuestaAccesoDocumentoExpedienteType respuesta= cssvClient.accesoDocumentoExpediente(peticionAccesoDocumentoExpediente.getPeticion(),peticionAccesoDocumentoExpediente.getIdDocumento(),
peticionAccesoDocumentoExpediente.getToken().getIndexEni(),peticionAccesoDocumentoExpediente.getToken().getCsv(),peticionAccesoDocumentoExpediente.getToken().getUuid());log.error(respuesta.getRespuesta().getCodigo()+":"+respuesta.getRespuesta().getDescripcion());
Servicio CSVConsumerService
A continuación se muestran todos los métodos referentes a la consulta de documentos a través de CSVBroker.
Método 'getDocument'
Permite descargar un documento de cualquier administración dado un csv y un dir3
Ver detalles
Signatura
ResultGetDocument getDocument(ParamGetDocument paramGetDocument)
Parámetros de invocación
Nombre | Tipo | Obligatorio | Descriprición |
|---|
ParamGetDocument |
csv | String | Si | Código CSV |
dir3 | String | No | Organismo que puede estar asociado al CSV |
Parámetros de respuesta
Códigos de error
Los errores de la invocación se encapsulan en ResultGetDocument
Código | Nombre | Descripción |
|---|
1505 | ERROR_GENERAL_CSV_BROKER | Error genérico al invocar a CSVBroker |
1506 | ERROR_CSV_BROKER_NOT_FOUND | No se ha encontrado el CSV |
1507 | ERROR_CSV_BROKER_ENDPOINT_ERROR | Endpoint de CSVBroker no encontrado |
1508 | ERROR_CSV_BROKER_WAIT | El documento no puede recuperarse, pero puede consultarse de nuevo pasado un tiempo |
Ejemplo de invocación
Invocación
ParamGetDocument getDocument = new ParamGetDocument();
getDocument.setCsv("123456abcdef987654zwyvijk");
getDocument.setDir3("E04583801");
ResultGetDocument result = cssvClient.getDocument(getDocument);
Servicios CSVQueryDocumentService, CSVQueryDocumentWSService y CSVQueryDocumentCertificateService
Los servicios productores para CSVBroker son exclusivos para esta aplicación y, por tanto, no deben ser integrados por otras aplicaciones. La finalidad que implementan, obtener documentos de CCSV, es igualmente implementada en IDocumentMetadataSignatureServicePortType, por lo que el resto de aplicaciones que deseen acceder a esta funcionalidad deberán utilizar este último servicio.
Estos servicios están descritos en detalle en la documentación para integradores de INSIDE: https://administracionelectronica.gob.es/ctt/inside/descargas
ANEXOS
Objetos comunes
A continuación se detallas aquellos objetos o tipos de datos que se utilizan en más de un método.
Objeto 'AdministrativeFile'
Este objeto se utiliza para almacenar la información de un expediente. Este objeto hereda las propiedades de CCSV_3.5.0_Manual de integración#Document.
Nombre | Tipo | Descripción |
|---|
number | String | Número del expediente. |
administrativeFileType | String | Tipo del expediente. |
state | String | Estado en el que se encuentra el expediente. |
indexCsv | String | Csv del índice asociado al expediente. |
date | Date | Fecha de apertura del expediente. |
closeDate | Date | Fecha de cierre del expediente. |
Objeto 'CsvBrokerDocument'
Clase donde se almacena la información de los documentos electrónicos rebida a través de CSVBroker.
Nombre | Tipo | Descripción |
|---|
documentName | String | Nombre del documento. |
documentMime | String | Mime-type del documento |
documentContent | byte[] | Contenido del documento |
organizationList | List<String> | Lista de organismos que pueden contener el documento asociado al CSV. |
Objeto 'DocumentBase'
Clase donde se almacena la información de los documentos electrónicos con el contenido.
Nombre | Tipo | Descripción |
|---|
id | String | Identificador del documento en Documentum. |
csv | String | Csv del documento. |
type | String | Nombre del tipo documental en Documentum. |
name | String | Nombre del documento. |
content | DataHandler | Contenido del documento. |
format | String | Formato del documento. |
applicationCode | String | Código de la aplicación. |
applicationName | String | Nombre de la aplicación. |
extension | String | Extensión del documento. |
Objeto 'Document'
Clase donde se almacena la información de los documentos electrónicos con el contenido y sus metadatos. Este objeto hereda las propiedades de CCSV_3.5.0_Manual de integración#DocumentBase.
Nombre | Tipo | Descripción |
|---|
metadata | HashMap<String,Object> | Almacena las propiedades o metadatos de un documento. |
Objeto 'DocumentRelation'
Clase donde se almacena la información de metadatos propios de una relación entre documentos.
Nombre | Tipo | Descripción |
|---|
role | String | Nombre del rol de la relación que existe. |
dateStart | String | Fecha de inicio de la relación. |
dateEnd | String | Fecha de fin de la relación. |
metadata | HashMap<String,Object> | Propiedades o metadatos adicionales de la relación. |
Objeto 'AdministrativeFileRelation'
Clase utilizada para almacenar la información de la relación entre un expediente y su contenido.
Objeto 'AdministrativeFileFolder'
Clase utilizada para almacenar la información de una carpeta de expediente.
Nombre | Tipo | Descripción |
|---|
code | String | Código de la carpeta |
name | String | Nombre de la carpeta |
id | String | Identificador de la carpeta en Documentum |
Objeto 'Signature'
Clase con la información de la firma y sus firmantes.
Nombre | Tipo | Descripción |
|---|
id | String | Identificado de la firma en documentum. |
data | String | Firma en base64. |
date | String | Sello de tiempo. |
stampExpirationDate | String | Fecha hasta la cual el sello es válido. |
signatureType | String | Indica que tipo de firma se esta almacenamdo. |
csvValue | String | Si signatureType es CSV, aquí se almacena el valor del CSV. |
csvGenerationRegulation | String | Si signatureType es CSV, aquí indica la referencia a la Orden, Resolución o documento que define la creación del CSV. |
signers | List<CCSV_3.5.0_Manual de integración#Signer> | Listado de firmantes. |
additionalMetadata | Hashmap<String,Object> | Metadatos adicionales. |
Objeto 'Signer'
Clase que contiene la información de un firmante.
Nombre | Tipo | Descripción |
|---|
subject | String | Asunto del certificado del firmante. |
issuer | String | Emisor del certificado. |
serialNumber | String | Número de serie del certificado. |
subjectKeyId | String | Subject key identifier del certificado. |
level | int | Nivel del firmante. |
stampExpirationDate | String | Fecha hasta la que es válido el sello de tiempo. |
date | String | Fecha y hora de la firma sin validez legal. |
timeStamp | String | Timestamp de la firma realizada por el firmante. |
signatureFormat | String | Formato final de la firma realizada por el firmante. |
signaturePolicyId | String | Identificador de la politica de firma de la DGA. |
signaturePolicyHash | String | Hash del fichero donde se describe la política de firma de la DGA. |
location | String | Localización geográfica del firmante. |
delegationText | String | Texto de delegación de la firma. |
role | String | Rol o acción del firmante en el acto de firma (Valida, supervisa...) |
position | String[] | Cargo o rol del firmante en el acto de firma. |
agent | CCSV_3.5.0_Manual de integración#Agent | Relación con metadato estructurado de tipo agente. |
additionalMetadata | HashMap<String, Object> | Metadatos adicionales. |
Objeto 'Agent'
Clase donde se almacenan los metadatos de un Documento tipo Agente.
Nombre | Tipo | Descripción |
|---|
entityType | String | Especifica el tipo de entidad que se describe; en este caso AGENTE |
category | String | Indica la categoría dentro de la entidad. Dentro de agente las categorías pueden ser CIUDADANO, EMPLEADO PUBLICO u ORGANISMO |
identificationType | String | Tipo de identificación utilizado |
identificationNumber | String | Código de identificación del agente : NIF,ORGCode... |
name | String | Nombre del agente. |
organismName | String | En caso de categoría=EMPLEADO PUBLICO, indicar en este elemento el organismo a que pertenece. |
organismResponsible | String | En caso de categoría=ORGANISMO, indicar en este elemento el responsable del organismo. |
position | String | En caso de categoría=EMPLEADO PUBLICO, indicar en este elemento el cargo del funcionario. |
positionDescription | String | En caso de categoría=EMPLEADO PUBLICO, indicar en este elemento la descripción del cargo del funcionario. |
organismDepartment | String | En caso de categoría=EMPLEADO PUBLICO, indicar en este elemento el departamento del funcionario. |
contactData | CCSV_3.5.0_Manual de integración#AgentContactData[] | Campo que almacenar los datos de contacto del agente. |
Clase utilizada para almacenar la información de la persona de contacto
Nombre | Tipo | Descripción |
|---|
type | String | Medio por el cual se contacta con el agente |
value | String | Dato para contactar con el agente. En función del canal, aquí se guardará un número de teléfono, una dirección e-mail, etc |
Clase donde se almacenan los metadatos de un Documento tipo relación
Nombre | Tipo | Descripción |
|---|
id | String | Identificador de la relación en documentum |
entityType | String | Especifica el tipo de entidad que se describe; en este caso RELACION |
category | String | Indica la categoría dentro de la entidad; en este caso AGENTE |
role | String | Tipo de rol de la relación |
dateStart | String | Fecha de inicio de la relación |
dateEnd | String | Fecha de fin de la relación |
agent | CCSV_3.5.0_Manual de integración#Agent | Metadato estructurado para almacenar el agente relacionado |
additionalMetadata | HashMap<String, Object> | Metadatos adicionales |
Objeto 'ParamBase'
Clase utilizada como base para la creación de objetos que encapsulen datos de parámetros de entrada a los servicios Web.
Nombre | Tipoe | Descripción |
|---|
applicationId | String | Identificador de la aplicación que llama al servicio. |
ip | String | IP de la aplicación que llama al web service. |
nif | String | Nif del usuario de PAU con el que se va a hacer la petición. |
Objeto 'ResultError'
Clase utilizada como base para la encapsulación de errores en las invocaciones a los servicios Web. Los objetos que encapsulan los resultados de las llamadas a los servicios heredan de esta clase para devolver los errores en caso de que se presenten.
Nombre | Tipo | Descripción |
|---|
errorCode | int | Código del error en CCSV |
errorMessage | String | Mensaje del error en CCSV |
exception | String | Excepción completa ocurrida durante la invocación al servicio. |
returnCode | String | Código que se devuelve de la invocación al servicio. |
Objeto 'SignedDocument'
Clase utilizada para almacenar un documento y su firma asociada
Clase utilizada para el almacenar la información de las versiones de los modelos de metadatos.
Nombre | Tipo | Descripción |
|---|
metadataModelId | Long | Identificador del modelo de metadatos. |
name | String | Nombre del modelo de metadatos. |
description | String | Descripción del modelo de metadatos. |
current | boolean | Indica si es el modelo de metadatos vigente. |
historical | boolean | Indica si la versión ha sido alguna vez
modelo de metadatos |
Objeto 'DocumentType'
Clase utilizada para almacenar un tipo de documento.
Nombre | Tipo | Descripción |
|---|
documentTypeId | Long | Identificador del tipo de documento. |
name | String | Nombre del tipo de documento. |
highlight | boolean | Indica si es un tipo de documento destacado. |
documentumTypeId | Long | Referencia al tipo documental al que está asociado el tipo de documento. |
documentumTypeName | String | Nombre del tipo documental al que está asociado el tipo de documento |
metadataModelId | Long | Identificador del modelo de metadatos al que pertenece el tipo de documento. |
description | String | Descripción del tipo de documento. |
cloned | boolean | Indica si el tipo de documento se ha clonado de una versión del modelo de metadatos ya existene. |
Objeto 'DocumentSubtypeList'
Clase con la información de un subtipo de documento.
Nombre | Tipo | Descripción |
|---|
name | String | Nombre del tipo de documento. |
documentTypeName | String | Nombre del tipo documental al que está asociado el tipo de documento |
description | String | Descripción del tipo de documento. |
Objeto 'DocumentumType'
Clase que almacena los datos sobre tipos documentales.
Nombre | Tipo | Descripción |
|---|
documentumTypeId | Long | Identificador del tipo documental. |
name | String | Nombre del tipo documental. |
nameNTI | String | Nombre del tipo documental según la NTI. |
description | String | Descripción del tipo documental. |
cloned | boolean | Indica si el tipo documental ha sido clonado de una versión del modelo de metadatos anterior. |
metadataModelId | Long | Referencia al modelo de metadatos al que pertenece. |
documentumTypeParentId | Long | Identificador del tipo documental padre. |
documentumTypeParentName | String | Nombre del tipo documental padre. |
Clase que almacena los metadatos de un tipo documental.
Nombre | Tipo | Descripción |
|---|
metadataId | Long | Identificador del metadato. |
name | String | Nombre del metadato en Documentum. |
nameNTI | String | Nombre del metadato según la NTI. |
label | String | Etiqueta corta del metadato para mostrar en formularios de edición. |
description | String | Descripción del metadato. |
type | String | Tipo de dato a almacenar en el metadato. |
typeSize | Integer | En caso de que el metadato sea de tipo cadena de texto, indica el tamaño máximo permitido. |
repetitive | boolean | Indica si el metadato es repetitivo. |
compulsary | boolean | Indica si el metadato es obligatorio. |
visibility | Integer | Visibilidad del metadato. |
editable | Integer | Editabilidad del metadato. |
traceable | boolean | Indica si el metadato es traceable, es decir si su modificación debe generar una traza. |
dateType | boolean | Indica si el metadato es de tipo fecha. |
cloned | boolean | Indica si el metadato se ha clonado de una versión del modelo de metadatos anterior. |
documentumTypeId | Long | Referencia al tipo documental al que pertenece |
metadataTypeId | Long | Identificador del tipo de metadato. |
metadataTypeName | String | Nombre del tipo de metadato. |
Clase que almacena los posibles valores un metadato.
Nombre | Tipo | Descripción |
|---|
metadataValueId | Long | Identificador del valor de metadato. |
value | String | Valor del metadato. |
description | String | Descripción del valor del metadato. |
defaultValue | boolean | Indica si el valor es el valor por defecto. |
repetitiveCompulsaryValue | boolean | Indica si el valor es de un metadato repetitivo y debe ser obligatorio. Se utiliza para roles de
relación |
metadataId | Long | Identificador del metadato al que pertenece. |
cloned | boolean | Indica si el valor del metadato se ha clonado de una versión del modelo de metadatos anterior. |
Objeto 'DocumentSearchResult'
Clase que se utiliza para guardar la información del resultado de una búsqueda documental.
Nombre | Tipo | Descripción |
|---|
documentumId | String | Identificador del documento en el gestor documental. |
metadata | HashMap<String, Object> | Metadatos solicitados del documento. |
Objeto 'TraceData'
Clase que almacena los datos a cerca de la traza de cambios que se producen en un documento.
Nombre | Tipo | Descripción |
|---|
reason | String | Razón por la cual se realiza la acción de actualización del documento. |
Objeto 'Filter'
Clase que permite almacenar los filtros de búsqueda en las búsquedas por metadatos.
Nombre | Tipo | Descripción |
|---|
FilterType | CCSV_3.5.0_Manual de integración#FilterType | Tipo de operador que se quiere aplicar al filtro. |
name | String | Nombre del metadato por el que se desea filtrar. |
Object | value | Valor del filtro que se quiere aplicar. |
Objeto 'DocumentFilter'
Clase utilizada para almacenar la información del filtro de documentos.
Objeto 'FileFilter'
Clase que se utiliza para guardar la infromacion del filtro de busqueda.
Nombre | Tipo | Descripción |
|---|
documentFilterList | CCSV_3.5.0_Manual de integración#DocumentFilter[] | Filtros que se van a aplicar de búsqueda. |
relationshipType | String | Tipo documental de la relación a buscar cuando tipo de búsqueda es expediente. |
documentumType | String | Tipo documental que se quiere buscar. |
contentFilter | String[] | Palabras clave de búsqueda en el contenido del documento. |
Clase que se utiliza para almacenar el nombre del metadato y el error que ha dado la validación con respecto al modelo de metadatos actual.
Nombre | Tipo | Descripción |
|---|
metadataName | String | Nombre del metadato. |
errorMessage | String | Posibles errores que han dado en la validación con respecto al modelo de metadatos actual. |
Objeto 'DocumentTypeList'
Clase que contiene la información de un tipo de documento.
Nombre | Tipo | Descripción |
|---|
name | String | Nombre del tipo del documento. |
description | String | Descripción del tipo del documento. |
Objeto 'DocumentTreeNode'
Clase que almacena la información de un nodo documental
Objeto 'ParamSendJustice'
Clase que contiene parámetros adicionales para remitir a justicia.
Nombre | Tipo | Descripción |
|---|
justiciaProcedimientoAnio | string | Año del procedimiento |
justiciaProcedimientoClase | string | Clase de procedimiento |
justiciaDescripcion | string | Descripción |
justiciaDir3OrganoRemite | string | Órgano remitente |
justiciaNig | string |
|
justicioaProcedimientoNumero | string | Número de procedimiento |
Enum 'SearchType'
Nombre | Valor | Descripción |
|---|
DOCUMENTO | documento | Tipo de búsqueda realizada por documentos. |
EXPEDIENTE | expediente | Tipo de búsqueda realizada por expedientes. |
Enum 'SortType'
Nombre | Valor | Descripción |
|---|
ASCENDING | A | Realiza una ordenación ascendente de los resultados obtenidos. |
DESCENDING | D | Realiza una ordenación descendente de los resultados obtenidos. |
Enum 'FilterType'
Nombre | Valor | Descripción |
|---|
LIKE | LIKE | Se usa para comparación de cadenas de texto interpretando algunos caracteres. |
EQUAL | = | Se usa para filtrar aquellos objetos que cumplan la condición de igualdad. |
NOT_EQUAL | <> | Se usa para filtrar aquellos objetos que cumplan la condición de desigualdad. |
GREATER | > | Se usa para filtrar aquellos objetos que cumplan la condición de ser mayor. |
LESS | < | Se usa para filtrar aquellos objetos que cumplan la condición de ser menor. |
GREATER_OR_EQUAL | >= | Se usa para filtrar aquellos objetos que cumplan la condición de ser mayor o igual. |
LESS_OR_EQUAL | <= | Se usa para filtrar aquellos objetos que cumplan la condición de ser menor o igual. |
IN | IN | Filtra aquellos objetos que estén en un listado. |
Enum 'DocumentRelationSearchType'
Nombre | Valor | Descripción |
|---|
PARENT | PARENT | Indica que se quieren buscar todos documentos “padre” del documento indicado. Es decir, que se quieren obtener todas las relaciones en las que el documento indicado figure como hijo en la relación. |
CHILD | CHILD | Indica que se quieren buscar todos documentos “hijo” del documento indicado. Es decir, que se quieren obtener todas las relaciones en las que el documento indicado figure como padre en la relación. |
Objeto 'AdministrativeFileLite'
Clase que se utiliza para guardar los datos básicos de un expediente.
Nombre | Tipo | Descripción |
|---|
id | String | Identificador del documento en el gestor documental. |
csv | String | CSV del expediente |
csvIndex | String | CSV del documento de indice |
description | String | Descripción del expediente |
number | String | Número de expedientenumber |
openDate | Date | Fecha de apertura del expediente |
state | String | Estado del expediente |
objectName | String | Nombre del objeto: object_name |
name | String | Nombre del objeto: dea_desc_nombre |
creationDate | Date | Fecha de creación: r_creation_date |
procedureCode | String | Codigo del procedimiento del expediente: dea_cont_codprocedimiento |
Objeto 'AdministrativeFileDocumentLite'
Clase que se utiliza para guardar los datos básicos de los documentos de un expediente.
Nombre | Tipo | Descripción |
|---|
id | String | Identificador del documento en el gestor documental. |
csv | String | CSV del documento |
description | String | Descripción del documento |
name | String | Nombre del documento |
openDate | Date | Fecha de creación del documento |
path | String | Ruta virtual de carpetas en la que se encuentra el documento (nombres de carpetas con separador pipe '|') |
objectName | String | Nombre del objeto: object_name |
creationDate | Date | Fecha de creación: r_creation_date |
objectType | String | Tipo de objeto: r_object_type |
documentType | String | Tipo de documento: dea_desc_tipo_documento |
Objeto 'AdministrativeFileFolderLite'
Clase que se utiliza para guardar la información de los datos básicos de una carpeta de un expediente.
Nombre | Tipo | Descripción |
|---|
id | String | Identificador del documento en el gestor documental. |
code | String | Código de la carpeta. |
name | String | Nombre de la carpeta |
path | String | Ruta virtual de carpetas (nombres de carpetas con separador pipe '|') Para una CARPETA que cuelga directamente de un expediente la ruta es
"|CARPETA" Para una CARPETA2 que cualga de otra CARPETA1 la ruta es "|CARPETA1|CARPETA2" |
objectName | String | Nombre del objeto: object_name |
Fecha de creación: r_creation_date | Date | creationDate |
Objeto 'AdministrativeFileAgentLite'
Clase que se utiliza para guardar la información básica de un agente de un expediente.
Nombre | Tipo | Descripción |
|---|
id | String | Identificador del documento en el gestor documental. |
rol | String | Rol del agente: relacion_rol |
category | String | Categoria del agente: agente_nti_categoria |
entityType | String | Tipo identida del agente: agente_nti_tipo_entidad |
name | String | Nombre del agente: agente_desc_nombre |
identification | String | Identificación del agente: agente_ident_identificacion |
identificationType | String | Tipo identificación: agente_ident_tipo_identif |
objectName | String | Nombre del objeto: object_name |
creationDate | Date | Fecha de creación del agente: r_creation_date |
objectType | String | Tipo de objeto: r_object_type |
