Guía de servicios de entidad de negocio

10.3

Anterior Siguiente

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.

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:

. 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.

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.

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.

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.

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"
}

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

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

Uso de las API de REST para cargar archivos

Descargar guía

Enviar comentarios

Communities

Knowledge Base

Success Portal

Rename Saved Search

Índice

Guía de servicios de entidad de negocio

Guía de servicios de entidad de negocio

Adjuntar archivos a registros

Adjuntar archivos a registros