Índice

Search

  1. Prólogo
  2. Introducción a los servicios de entidad de negocio
  3. Llamadas de servicio de entidad de negocio Enterprise Java Bean
  4. Llamadas del servicio de entidad de negocio de transferencia de estado representacional
  5. Llamadas de servicios de entidad de negocio de Protocolo simple de acceso a objetos
  6. Servicios para registros de referencias cruzadas y cálculos de BVT
  7. Compatibilidad del servicio de vinculación empresarial
  8. Llamadas externas para limpiar, analizar y transformar datos
  9. Uso de las API de REST para añadir registros
  10. Uso de las API de REST para cargar archivos

Guía de servicios de entidad de negocio

Guía de servicios de entidad de negocio

Adjuntar archivos a registros

Adjuntar archivos a registros

Antes de adjuntar un archivo a un registro, cree los metadatos del archivo y, a continuación, cargue el archivo en el almacenamiento temporal.
  1. Para crear los metadatos de un archivo, utilice la API de REST de creación de metadatos de archivos con TEMP como tipo de almacenamiento.
    Por ejemplo, con la siguiente solicitud se crean los metadatos del archivo
    Document_3.pdf
    :
    POST http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/TEMP Content-Type: application/json { "fileName": "Document_3.pdf", "fileType": "pdf", "fileContentType": "application/pdf" }
    Cree siempre los metadatos de archivos en el almacenamiento TEMP.
    La API de REST de creación de metadatos de archivos devuelve un ID para el archivo. El ID de archivo se presenta en el siguiente formato:
    <Tipo de almacenamiento>_<RowID>
    . Donde RowID hace referencia al ID de fila del archivo que se va a cargar en el almacenamiento.
    En el ejemplo, la llamada de API devuelve el siguiente ID para el archivo
    Document_3.pdf
    :
    TEMP_SVR1.OJU3
    El ID de archivo se puede usar para cargar el archivo, adjuntarlo, actualizarlo, descargarlo y eliminarlo.
  2. Para cargar el archivo, utilice la API de REST de carga de contenido de archivo con TEMP como tipo de almacenamiento.
    Por ejemplo, con la siguiente solicitud se carga el archivo en el almacenamiento TEMP:
    PUT http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/TEMP/TEMP_SVR1.OJU3/content Content-Type: application/octet-stream <file object (upload using REST client)>
    Después de cargar un archivo, el almacenamiento TEMP almacena el archivo durante un período de tiempo preconfigurado de 60 minutos. El archivo se debe adjuntar a un registro antes de que caduque el período preconfigurado.
  3. Para crear un registro y adjuntar el archivo a un registro nuevo, utilice la API de REST de creación de registros.
    Por ejemplo, con la siguiente solicitud se crea un registro y se adjunta el archivo con el ID de archivo
    TEMP_SVR1.OJU3
    :
    POST http://localhost:8080/cmx/cs/localhost-orcl-MDM_SAMPLE/Person?systemName=Admin Content-Type: application/json { "frstNm":"John", "lstNm":"Smith", "addrLn1":"2100 Breverly Road", "addrTyp":{ "addrTyp":"Billing", "addrTypDesc":"Billing" }, "cntryCd":{ "cntryCd":"AX", "cntryDesc":"Aland" }, "attachments":{ "item":[ { "fileId":"TEMP_SVR1.OJU3" } ] } }
    Cuando adjunte un archivo a un registro, el proceso almacenará el archivo en la base de datos. El ID del archivo cambiará a
    DB_<RowID>
    , donde DB indica que el archivo se encuentra almacenado en la base de datos.
  4. Para reemplazar un archivo que está adjunto a un registro, utilice la API de REST de carga de contenido de archivo con DB como tipo de almacenamiento.
    Por ejemplo, con la siguiente solicitud se reemplaza el archivo adjunto con el ID de archivo
    DB_SVR1.OJU3
    de la base de datos:
    PUT http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/DB/DB_SVR1.OJU3/content Content-Type: application/octet-stream <file object (upload using REST client)>
    El tipo de almacenamiento de la URL de la solicitud es DB.
  5. Para editar los metadatos de un archivo después de adjuntarlo a un registro, utilice la API de REST de actualización de metadatos de archivo con DB como tipo de almacenamiento.
    Por ejemplo, con la siguiente solicitud se actualizan los metadatos de un archivo asociado al ID de archivo
    DB_SVR1.OJU3
    de la base de datos:
    PUT http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/DB/DB_SVR1.OJU3 Content-Type: application/json { "fileName": "Document_4.pdf", "fileType": "pdf", "fileContentType": "application/pdf" }
  6. Para descargar un archivo que está adjunto a un registro, utilice la API de REST para obtener el contenido de archivo con DB como tipo de almacenamiento.
    Por ejemplo, con la siguiente solicitud se descarga un archivo que está asociado al ID de archivo
    DB_SVR1.OJU3
    desde la base de datos:
    GET http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/DB/DB_SVR1.OJU3/content
  7. Para eliminar un archivo que está adjunto a un registro, utilice la API de REST de eliminación de archivos con DB como tipo de almacenamiento.
    Por ejemplo, con la siguiente solicitud se elimina un archivo que está asociado al ID de archivo
    DB_SVR1.OJU3
    de la base de datos:
    DELETE http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/DB/DB_SVR1.OJU3