1. Enviar fotos y archivos de aplicaciones de Oracle Visual Builder a Oracle Content and Experience
  2. Carga de archivos en Oracle Content and Experience

Carga de archivos en Oracle Content and Experience

Cargue archivos en Oracle Content and Experience desde una aplicación desarrollada en Oracle Visual Builder.

Para cargar un archivo desde un dispositivo de usuario mediante una aplicación Oracle Visual Builder, necesita tres cosas:

  1. Una conexión de servicio que expone el punto final de carga de archivo para cargar el archivo.
  2. Componente de selector de archivos que permite al usuario seleccionar un archivo de su dispositivo.
  3. Cadena de acción que carga el archivo devuelto por el selector de archivos mediante el punto final Cargar Archivo.

Necesita una conexión de servicio a la API de REST para los documentos para proporcionar acceso al punto final Cargar archivo. Una vez creada la conexión de servicio y el punto final, utilice cadenas de acción en la aplicación para seleccionar un archivo del dispositivo del usuario y cargarlo en Oracle Content and Experience.

Crear un punto final para cargar archivos

Puede crear un punto final para cargar archivos en Oracle Content and Experience mediante el URI base de la instancia de Oracle Content and Experience a la que se conecta y los parámetros de consulta para acceder al punto final Cargar Archivo expuesto por la API de REST para los documentos.

Por ejemplo, si https://cec-instance-url.com es el URI base de la instancia de Oracle Content and Experience a la que se conecta, introduzca el siguiente URI con el método HTTP adecuado (POST) al crear el punto final.

https://cec-instance-url.com/documents/api/1.2/files/data

También deberá proporcionar los detalles de autenticación que utilizará para conectarse a Oracle Content and Experience para utilizar el punto final Cargar Archivo. La autenticación básica es suficiente para fines de desarrollo, pero no se recomienda su uso en producción.

Para crear un punto final para cargar archivos en Oracle Content and Experience:

  1. Abra Conexiones de servicio en el navegador y haga clic en Crear conexión de servicio ( Icono Crear Conexión de Servicio ).
  2. Haga clic en Definir por Punto Final en el panel Seleccionar Origen del asistente Crear Conexión de Servicio.
  3. En la lista desplegable Método, seleccione POST, introduzca https://cec-instance-url.com/documents/api/1.2/files/data en el campo de entrada URL, seleccione Crear en la lista desplegable Indicación de Acción y haga clic en Siguiente.
  4. En el separador Servicio, revise los valores de URL de Base de Servicio, Nombre de Servicio e ID de Servicio.
    Oracle Visual Builder rellena automáticamente estos campos según los valores introducidos anteriormente.
  5. Abra el separador Autenticación y seleccione Activar Autenticación / Proxy para introducir los detalles de autenticación.
  6. Seleccione Básico en la lista desplegable Mecanismo de Autenticación e introduzca el nombre de usuario y la contraseña que utiliza para acceder a la instancia de Oracle Content and Experience.
  7. Abra la ficha Request (Solicitud ) y, para el cuerpo de la solicitud, agregue multipart/form-data como tipo de medio y elimine application/json.
  8. Abra el separador Respuesta e introduzca un ejemplo de cuerpo de respuesta para el punto final.

    El separador Respuesta contiene un área de texto en la que puede pegar un ejemplo del cuerpo de la respuesta. El ejemplo de la respuesta es la definición de la estructura del objeto devuelto. Introduzca el siguiente ejemplo de un objeto devuelto en respuesta a una llamada a la API de carga de archivos. 

    {
    "id":"DB1C5AF480FFE61C588027A8T0000000000100000001",
    "parentID":"FF4729683CD68C1AFB1AE87DT0000000000100000001",
    "name":"example.txt",
    "type":"file",
    "size":"13",
    "version":"1",
    "createdTime":"2014-02-21T21:32:37Z",
    "modifiedTime":"2014-02-21T21:32:37Z",
    "createdBy":{
        "displayName":"User AA",
        "id":"U0EAA20910FAF3052ACB79E4T00000000001",
        "loginName":"userAALoginName",
        "type":"user"
    },
    "ownedBy":{
        "displayName":"User AA",
        "id":"U0EAA20910FAF3052ACB79E4T00000000001",
        "loginName":"userAALoginName",
        "type":"user"
    },
    "modifiedBy":{
        "displayName":"User AA",
        "id":"U0EAA20910FAF3052ACB79E4T00000000001",
        "loginName":"userAALoginName",
        "type":"user"
    },
    "errorCode":"0",
    "errorMessage":"Successfully checked in content item 'ADC412030000000000000000000002'."
}
    Descripción de vb-cec-example-response.png
    Descripción de la ilustración vb-cec-example-response.png
  9. Haga clic en Crear.

Agregar un componente de selector de archivos a la página

El componente Selector de Archivos es el componente más adecuado para agregar a la página de la aplicación para que los usuarios seleccionen archivos que desean cargar en un servicio de almacenamiento de backend, como Oracle Content and Experience.

Permite a los usuarios seleccionar archivos o soltar archivos en un área de zona de colocación que presenta el componente. Para utilizar el componente Selector de Archivos correctamente en la aplicación, realice las siguientes tareas.

  1. Agregue variables a la página de la aplicación para hacer referencia al objeto de archivo y al nombre de objeto de archivo devuelto por el componente Selector de archivos.
  2. Agregue un componente de selector de archivos a la página y configure el evento ojSelect del selector de archivos para disparar una cadena de acciones cuando un usuario seleccione el componente de selector de archivos.
  3. En la cadena de acción disparada por el evento ojSelect del selector de archivos, agregue una acción Asignar variables para asignar el objeto de archivo y el nombre de objeto de archivo a las variables de página a las que se hace referencia en el paso 1.

Una vez que haya completado estas tareas, la aplicación seleccionará correctamente el archivo y ahora podrá configurar la aplicación para que llame al punto final Cargar archivo que lo cargue en el almacenamiento de documentos de Oracle Content and Experience. Esta última tarea (llamada al punto final Cargar Archivo) se describe más adelante. A partir de ahora, debe terminar las tareas asociadas al uso del componente Selector de Archivos.

En el editor de variables de la página que contiene el componente Selector de archivos, haga clic en el botón + Variable para agregar dos variables nuevas:

  • uploadFile del tipo de objeto
  • uploadFileName del tipo de cadena

Estas variables almacenarán el objeto de archivo y el nombre del objeto de archivo devuelto por el componente de selector de archivos que también agregará a la página para que el usuario seleccione un archivo desde su dispositivo.

A continuación se muestra la descripción de variables-file-picker.png
Descripción de la ilustración variables-file-picker.png

La paleta de componentes en Oracle Visual Builder no expone el componente de selector de archivos para que tenga que agregarlo manualmente a la página de la aplicación donde desea utilizarlo. Agregue el componente Selector de Archivos a la vista Código de la página donde los usuarios podrán verlo y utilizarlo. Oracle Visual Builder agrega una sentencia de importación a los metadatos de la página para que el componente Selector de Archivos se importe para su uso en la aplicación.

Agregue el componente de selector de archivos mediante la vista de código en Oracle Visual Builder. 

...
<div>
  <oj-file-picker id="oj-file-picker-1084591017-1"></oj-file-picker>
</div>
...

Al agregar el componente Selector de Archivos a la página, puede utilizar el Inspector de Propiedades de Visual Builder para configurar sus propiedades para su caso de uso. Visual Builder genera el siguiente fragmento de código en el archivo al configurar el componente Selector de Archivos para seleccionar un archivo a la vez.

...
<div>
	<oj-file-picker id="oj-file-picker-1084591017-1" selection-mode="single"></oj-file-picker>
</div>
...

Para asignar el nombre de archivo y archivo seleccionados a las variables:

  1. En el Inspector de Propiedades del componente Selector de Archivos, haga clic en Nuevo Evento Personalizado, seleccione ojSelect en Eventos de Selector de Archivos en el cuadro de diálogo Seleccionar Evento que aparece y, a continuación, haga clic en Seleccionar.
  2. En el cuadro de diálogo Seleccionar Cadena de Acción que aparece, haga clic en Nueva Cadena de Acción para abrir el lienzo Cadena de Acción.
  3. En el campo de entrada Filtro en Acciones, introduzca Assign y, a continuación, arrastre y suelte la acción Asignar variables en el lienzo.
  4. Seleccione la acción Asignar variables que acaba de agregar al lienzo y haga clic en Asignar en la sección Variables.
  5. En el cuadro de diálogo Asignar Variables que aparece, realice una conexión entre el nodo de detalles de Cadena de Acción en Orígenes y el nodo uploadFile en Página en Destino.
  6. Seleccione uploadFileName en Página en Destino y escriba la siguiente expresión en el campo de entrada proporcionado.
    $chain.variables.detail.files[0].name
  7. Active la casilla de control Expresión.
  8. Haga clic en Guardar.
La página de la aplicación contiene ahora un componente de selector de archivos que permite a los usuarios seleccionar archivos en tiempo de ejecución, además de variables que almacenan el nombre de archivo y archivo seleccionados antes de llamar al punto final de carga de archivo.

Llamar al punto final de carga de archivo

Utilizará el punto final Cargar Archivo proporcionado por Oracle Content and Experience para cargar el archivo que el usuario selecciona utilizando el componente Selector de Archivos.

Para utilizar el punto final Cargar Archivo correctamente en la aplicación, realice las siguientes tareas:

  1. Agregue una variable folderID en la página de la aplicación para identificar la carpeta en el almacenamiento de documentos de Oracle Content and Experience en el que el punto final de carga de archivos cargará el archivo.
  2. Agregue un componente de botón a la página de aplicación que pulse a los usuarios o haga clic en para llamar a una cadena de acción.
  3. Agregue una acción de llamada de punto final de REST a la cadena de acción llamada por el componente de botón. Esta acción de llamada de punto final de REST llama al punto final de carga de archivo.

Una vez finalizadas estas tareas, la aplicación cargará el archivo devuelto por el componente de selector de archivos en el almacenamiento de documentos de Oracle Content and Experience.

En el editor de variables de la página que contendrá el componente de botón, haga clic en el botón + Variable para agregar una variable denominada folderId. Especifique su tipo como String, su valor por defecto como self y active la casilla de control Parámetro de Entrada.

Esta variable identifica la ubicación de la carpeta en la que el punto final Cargar Archivo carga el archivo. El valor por defecto de self especifica el directorio raíz de Documentos.

Descripción de vb-cec-variable-folderid.png
Descripción de la ilustración vb-cec-variable-folderid.png
Para agregar un componente de botón para que los usuarios puedan llamar al punto final Cargar Archivo:
  1. En la página en la que ha agregado el componente Selector de archivos, agregue un componente Botón.
  2. En la sección Eventos del Inspector de Propiedades del componente de botón, haga clic en la lista desplegable Nuevo Evento y seleccione Inicio Rápido: 'ojAction'.
  3. En el lienzo Cadena de acciones, introduzca Call REST en el campo de entrada Filtro en Acciones y, a continuación, arrastre y suelte la acción Llamar al punto final REST en el lienzo Cadena de acciones.
  4. Con la acción Llamar al Punto Final REST que acaba de agregar seleccionada, haga clic en el botón Seleccionar Punto Final.
  5. En el cuadro de diálogo Seleccionar Punto Final, seleccione el punto final Cargar Archivo que ha agregado al crear la conexión de servicio a Oracle Content and Experience y, a continuación, haga clic en Seleccionar.
  6. En el lienzo Cadena de acciones, seleccione la acción de punto final Llamar a REST y, en el campo de entrada Tipo de contenido, introduzca multipart/form-data.
  7. En Parámetros, haga clic en Cuerpo para llamar al cuadro de diálogo Llamar al Punto Final REST, en el que puede escribir la siguiente expresión de contenido estático para el parámetro del cuerpo para cargar el archivo al que hace referencia la variable de página uploadFile. Una parte de la expresión es un objeto JSON (jsonInputParameters) con la parentID emparejada con una variable de página folderID y la otra parte es el contenido del propio archivo (primaryFile).
    {
 "jsonInputParameters": "{{ '{ \"parentID\":\"' + $page.variables.folderId + '\"}' }}",
 "primaryFile": "{{ $page.variables.uploadFile ? $page.variables.uploadFile.files[0] : {} }}"
}
    A continuación se muestra la descripción de vb-cec-upload-file-expression.png
    Descripción de la ilustración vb-cec-upload-file-expression.png
  8. Haga clic en Guardar.
La aplicación ahora contiene una página con un selector de archivos y un componente de botón para permitir a los usuarios finales seleccionar y cargar archivos en el almacenamiento de documentos en Oracle Content and Experience.