Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

Table of Contents

...

Servicio DocumentMetadataSignatureService

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 'createDocument'

...

Almacena un documento en el gestor Documental Documentum.

...

Expand
titleVer detalles

Signatura

ResultGetSubstituteDocument getSubstituteDocument(ParamGetSubstituteDocument paramGetSubstituteDocument)

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamGetSubstituteDocument (hereda de ParamBase)

csvAnnulled

String

Si

CSV del documento anulado.

Parámetros de respuesta

Nombre

Tipo

Descripción

ResultGetSubstituteDocument (hereda de ResultError)

csvSubstitute

String

CSV del documento sustituto.

Códigos de error

Los errores de la invocación se encapsulan en 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
Code Block
languagejava
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'

...

Expand
titleVer detalles

Signatura

ResultDeleteDocumentLink deleteDocumentLink(ParamDeleteDocumentLink paramDeleteDocumentLink).

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamDeleteDocumentLink(hereda de 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

Nombre

Tipo

Descripción

Anchor
ResultDeleteDocumentLink
ResultDeleteDocumentLink
ResultDeleteDocumentLink(hereda de ResultError)

Códigos de error

Los errores de la invocación se encapsulan en 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 conexión con documentum.

801

GENERIC_ERROR

Error genérico procesando la petición.

Ejemplo de invocación

Invocación
Code Block
languagejava
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.

...

Expand
titleVer detalles

Signatura

ResultGetDocumentSignatures getDocumentSignatures(ParamGetDocumentSignatures paramGetDocumentSignatures).

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamGetDocumentSignatures(hereda de ParamBase)

id

String

Si(1)

Código 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

Nombre

Tipo

Descripción

Anchor
ResultGetDocumentSignatures
ResultGetDocumentSignatures
ResultGetDocumentSignatures(hereda de ResultError)

signatures

ArrayList<Signature>

Listado de firmas de un documento.

Códigos de error

Los errores de la invocación se encapsulan en 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
Code Block
languagejava
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());
}

Métodos de gestión de metadatos.

Método 
Anchor
initializeDocumentMetadata
initializeDocumentMetadata
'initializeDocumentMetadata'

...

Expand
titleVer detalles

Signatura

ResultDeleteMetadata deleteMetadata(ParamDeleteMetadata paramDeleteMetadata).

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamUpdateMetadata(hereda de 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 posición 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

Nombre

Tipo

Descripción

Anchor
ResultUpdateMetadata
ResultUpdateMetadata
ResultUpdateMetadata (hereda de ResultError)

Códigos de error

Los errores de la invocación se encapsulan en 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
Code Block
languagejava
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'

...

Expand
titleVer detalles

Signatura

ResultGetAllRelatedDocuments getAllRelatedDocuments(ParamGetAllRelatedDocuments paramGetAllRelatedDocuments).

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamGetAllRelatedDocuments(hereda de 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

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

Nombre

Tipo

Descripción

Anchor
ResultGetRelatedDocuments
ResultGetRelatedDocuments
ResultGetAllRelatedDocuments(hereda de ResultError)

documentTreeNodes

DocumentTreeNode

Array de documentos relacionados encontrados con los datos de la relación

Códigos de error

Los errores de la invocación se encapsulan en 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
Code Block
languagejava
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 trazas.

Método 'getTraces'

...

 Recupera las trazas de un documento o expediente.

Expand
titleVer detalles

Signatura

ResultGetTraces getTraces(ParamGetTraces paramGetTraces).

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamGetTraces (hereda de ParamBase)

csv

String

Si(1)

Código CSV asociado al documento del que se quieren recuperar las trazas.

id

String

Si(1)

Identificador del documento del que se quieren recuperar las trazas

NOTA : en caso de indicar el id del documento no habrá que indicar el csv y viceversa.(1)

Parámetros de respuesta

Nombre

Tipo

Descripción

ResultGetTraces(hereda de ResultError)

metadata

HashMap<String, Object>

Información en documentum relativa a la traza

Códigos de error

Los errores de la invocación se encapsulan en ResultGetTraces

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

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
Code Block
languagejava
ParamGetTraces paramGetTraces = new ParamGetTraces();
paramGetTraces.setCsv("CSV0B31WVP5O1A21CCSV");
ResultGetTraces result = ccsvClient.getTraces(paramGetTraces);
if(result.getReturnCode().equals(ReturnCode.ERROR){
	log.error(result.getErrorCode()+":"+result.getErrorMessage());
}

Métodos de gestión de relaciones de agentes.

Método '

...

addAgentRelationships'

...

 Añade una nueva relación   Añade relaciones al documento con id o csv indicado guardando el cambio en documentum.

Expand
titleVer detalles

Signatura

ResultAddAgentRelationship addAgentRelationship(ParamAddAgentRelationship paramAddAgentRelationship).ResultAddAgentRelationships addAgentRelationships(ParamAddAgentRelationships paramAddAgentRelationships)

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamAddAgentRelationship(hereda de ParamBase)

csv

String

Si(1)

Código csv asociado al documento en el que se quiere n añadir

la relación

las relaciones.

id

String

Si(1)

Identificador del documento en el que se

quiere

quieren agregar

la relación

las relaciones.

agentRelationship

agentRelationships

AgentRelationship

Si

[]

Contiene todos los datos de la relación a crear

traceData

TraceData

Si

Datos sobre la traza de la

agregación de una nueva relación

creación de nuevas relaciones para el documento.

NOTA : en caso de indicar el id del documento no habrá que indicar el csv y viceversa.(1)

Parámetros de respuesta

Nombre

Tipo

Descripción

Anchor

ResultAddAgentRelationship

ResultAddAgentRelationships

ResultAddAgentRelationship

ResultAddAgentRelationships

ResultAddAgentRelationship

ResultAddAgentRelationships(hereda de ResultError)

Códigos de error

Los errores de la invocación se encapsulan en ResultAddAgentRelationshipen 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

NIF solicitante al documento indicado.

189

ERROR_INTERNALACCESSCONTROL_NIFINVALID

Debe especificar el

nif

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
Code Block
languagejava
ParamAddAgentRelationshipParamAddAgentRelationships paramAddAgentRelationshipparamAddAgentRelationships = new ParamAddAgentRelationshipParamAddAgentRelationships();
paramAddAgentRelationshipparamAddAgentRelationships.setCsv("CSV0B31WVP5O1A21CCSV");
paramAddAgentRelationshipparamAddAgentRelationships.setAgentRelationshipsetAgentRelationships(agentRelationshipagentRelationships);
ResultAddAgentRelationshipResultAddAgentRelationships result = ccsvClient.addAgentRelationshipaddAgentRelationships(paramAddAgentRelationshipparamAddAgentRelationships);
if(result.getReturnCode().equals(ReturnCode.ERROR){
	log.error(result.getErrorCode()+":"+result.getErrorMessage());
}

Método '

...

deleteAgentRelationship'

...

  Añade relaciones al Elimina una relación del documento con id o csv indicado guardando el cambio en documentum.

NOTA : en caso de indicar el id del documento no habrá que indicar el csv y viceversa.

Parámetros de respuesta

ResultAddAgentRelationships(hereda de ResultError)

Códigos de error

Los errores de la invocación se encapsulan en ResultAddAgentRelationships

Ejemplo de invocación

Invocación
Expand
titleVer detalles

Signatura

ResultAddAgentRelationships addAgentRelationships(ParamAddAgentRelationships paramAddAgentRelationships)ResultDeleteAgentRelationship deleteAgentRelationship(ParamDeleteAgentRelationship paramDeleteAgentRelationship);

Parámetros de invocación

Expand
titleVer detalles

Signatura

ResultDeleteAgentRelationship deleteAgentRelationship(ParamDeleteAgentRelationship paramDeleteAgentRelationship);

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamAddAgentRelationship

ParamDeleteAgentRelationship(hereda de ParamBase)

csv

String

Si(1)

Código csv asociado al documento

en el que se quiere n añadir las relaciones.

id

String

Identificador del documento en el que se quieren agregar las relaciones.

agentRelationships

AgentRelationship[]

Contiene todos los datos de la relación a crear

traceData

TraceData

Datos sobre la traza de la creación de nuevas relaciones para el documento.

Nombre

Tipo

Descripción

Anchor
ResultAddAgentRelationshipsResultAddAgentRelationships

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

Code Block
languagejava
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.

Nombre

Tipo 

Obligatorio

Descripción

ParamDeleteAgentRelationship(hereda de ParamBase)

csv

String

Si(1)

Código csv asociado al documento del que se va a del que se va a eliminar la relación.

id

String

Si(1)

Identificador del documento del que se va a eliminar la relación.

agentRelationship

AgentRelationship

Si

Contiene todos los datos de la relación a borrar

traceData

TraceData

Si

Datos sobre la traza del borrado de la relación.

NOTA : en caso de indicar el id del documento no habrá que indicar el csv y viceversa.

Parámetros de respuesta

Nombre

Tipo

Descripción

Anchor
ResultDeleteAgentRelationship
ResultDeleteAgentRelationship
ResultDeleteAgentRelationship(hereda de ResultError)

Códigos de error

Los errores de la invocación se encapsulan en 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
Code Block
languagejava
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());
}

...

Expand
titleVer detalles

Signatura

ResultUpdateAgentRelationship updateAgentRelationship(ParamUpdateAgentRelationship paramUpdateAgentRelationship);

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamUpdateAgentRelationship(hereda de ParamBase)

csv

String

Si(1)

Código csv asociado al documento en el que se va a modificar la relación.

id

String

Si(1)

Identificador del documento en el que se va a modificar la relación.

agentRelationship

AgentRelationship

Si

Contiene todos los datos de la relación a borrar

traceData

TraceData

Si

Datos sobre la traza del borrado de la relación.

NOTA : en caso de indicar el id del documento no habrá que indicar el csv y viceversa.(1)

Parámetros de respuesta

Nombre

Tipo

Descripción

Anchor
ResultUpdateAgentRelationship
ResultUpdateAgentRelationship
ResultUpdateAgentRelationship(hereda de ResultError)

Códigos de error

Los errores de la invocación se encapsulan en 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
Code Block
languagejava
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());
}

...

Expand
titleVer detalles

Signatura

ResultGetAgentRelationship getAgentRelationship(ParamGetAgentRelationship paramGetAgentRelationship);;

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamGetAgentRelationship(hereda de 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 identificación number para que se identifique una única relación de agente.(2)

Parámetros de respuesta

Nombre

Tipo

Descripción

Anchor
ResultGetAgentRelationship
ResultGetAgentRelationship
ResultGetAgentRelationship(hereda de ResultError)

agentRelationship

AgentRelationship

Objeto AgentRelationship con el contenido de la relación agente recuperado

Códigos de error

Los errores de la invocación se encapsulan en 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
Code Block
languagejava
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());
}

...

Expand
titleVer detalles

Signatura

ResultGetAgentRelationships getAgentRelationships(ParamGetAgentRelationships paramGetAgentRelationships)

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamGetAgentRelationships (hereda de 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

Nombre

Tipo

Descripción

Anchor
ResultGetAgentRelationships
ResultGetAgentRelationships
ResultGetAgentRelationships (hereda de ResultError)

agentRelationships

AgentRelationship[]

Array de objetos AgentRelationship con el contenido de las relaciones agente recuperadas

Códigos de error

Los errores de la invocación se encapsulan en 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
Code Block
languagejava
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());
}

...

Expand
titleVer detalles

Signatura

ResultGenerateIframeToken generateIframeToken(ParamGenerateIframeToken paramGenerateIframeToken)

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamGenerateIframeToken (hereda de 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

Nombre

Tipo

Descripción

Anchor
ResultGenerateIframeToken
ResultGenerateIframeToken
ResultGenerateIframeToken (hereda de ResultError)

token

String

Token que se genera a partir de los datos que se facilitan

Códigos de error

Los errores de la invocación se encapsulan en ResultGenerateIframeToken

Código

Nombre

Descripción

1402

MESSAGE_ERROR_GENERATE_TOKEN

Error creando el token

Ejemplo de invocación

Invocación
Code Block
languagejava
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());
}

...

Expand
titleVer detalles

Signatura

ResultValidateIframeToken validateIframeToken(ParamValidateIframeToken paramValidateIframeToken);

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamValidateIframeToken (hereda de ParamBase)

token

String

Si

Token generado por el iframe que se va a validar que se correcto.

Parámetros de respuesta

Nombre

Tipo

Descripción

Anchor
ResultValidateIframeToken
ResultValidateIframeToken
ResultValidateIframeToken(hereda de ResultError)

Códigos de error

Los errores de la invocación se encapsulan en 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
Code Block
languagejava
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());
}

...

Expand
titleVer detalles

Signatura

ResultGetDocumentSubtypeList getDocumentSubtypeList(ParamGetDocumentSubtypeList paramDocumentSubtypeList);

Parámetros de invocación

Nombre

Tipo 

Obligatorio

Descripción

ParamGetDocumentSubtypeList (hereda de ParamBase)

documentTypeName

String

Si

Nombre del tipo de documento.

Parámetros de respuesta

Nombre

Tipo

Descripción

ResultGetDocumentSubtypeList (hereda de ResultError)

documentSubtypeList

List<DocumentSubtypeList>

Listado de los subtipos de documentos que se han recuperado a partir de los parámetros de búsqueda.

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
Code Block
languagejava
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)

...

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 DocumentMetadataSignatureService, por lo que el resto de aplicaciones que deseen acceder a esta funcionalidad deberán utilizar este último servicio.

...