Gestión de documentos en una aplicación de Oracle Visual Builder
La API de REST de Oracle Content and Experience para Documentos proporciona un rango de puntos finales que puede utilizar para realizar tareas como descargar, ver y suprimir archivos en el almacenamiento de documentos de Oracle Content and Experience mediante la interfaz de una aplicación Oracle Visual Builder.
El contenido que aparece a continuación es un ejemplo ilustrativo que describe cómo utilizar los puntos finales adecuados con los componentes de la interfaz de usuario de Oracle Visual Builder, las variables y las cadenas de acciones para descargar un documento desde Oracle Content and Experience. Con este patrón, puede implantar funciones en la aplicación Oracle Visual Builder para realizar otras tareas con los documentos, como ver o suprimir.
Para descargar un documento, como una foto u otro tipo de archivo, necesita:
- Una conexión de servicio que expone los puntos finales Obtener Información de Archivo y Descargar Archivo proporcionados por la API de REST de Oracle Content and Experience para Documentos.
- Página de la aplicación Oracle Visual Builder que:
- Incluye una variable de tipo
Objectpara hacer referencia a un archivo seleccionado (selectedFile) y una variable de tipoStringpara hacer referencia al identificador del archivo seleccionado (selectedFileId). - Utiliza el componente de vista de lista que ha agregado anteriormente para recuperar la lista de documentos de Oracle Content and Experience. Configurará este componente de vista de lista para llamar a una cadena de acción que incluya una acción de llamada de punto final de REST para llamar al punto final Obtener Información de Archivo cuando un usuario seleccione un archivo en la lista de documentos.
- Componente de botón que llama a una cadena de acción que incluye una acción de llamada al punto final de REST para llamar al punto final de descarga de archivo para descargar el archivo seleccionado en la lista de documentos.
- Función del módulo de llamada para descargar el objeto que devuelve el punto final Descargar Archivo.
- Incluye una variable de tipo
Crear un punto final para descargar documentos
Puede crear puntos finales para descargar archivos de 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 a los puntos finales Obtener Información de Archivo y Descargar Archivo expuestos por la API de REST para Documentos.
Se supone que ya ha creado una conexión de servicio y un punto final que recupera documentos de Oracle Content and Experience. Complete esta última tarea, si aún no la ha hecho. En los siguientes pasos se describe cómo agregar los puntos finales Obtener Información de Archivo y Descargar Archivo a la conexión de servicio creada para recuperar documentos.
Para agregar puntos finales a archivos de descarga desde Oracle Content and Experience:
- En el separador Respuesta del cuadro de diálogo Agregar punto final, edite el tipo de medio soportado del cuerpo de la respuesta como
application/octet-streamy elimine el valor rellenado previamente deapplication/json.
Preparar para Descargar Documentos
Puede crear una serie de variables y escribir una función del módulo de llamadas en la página de la aplicación Oracle Visual Builder que descarga documentos de Oracle Content and Experience. También configurará el componente de vista de lista en la página para permitir la selección de archivos y recuperar la información de archivo del archivo seleccionado.
Una vez terminadas estas tareas, puede agregar un componente de interfaz de usuario, como un botón, para que los usuarios puedan llamar a una cadena de acción que incluya una acción de punto final de llamada de REST que invoque el punto final Descargar archivo.
En el editor de variables de la página que contendrá el componente Botón, haga clic en el botón + Variable para agregar las siguientes dos variables que utilizará para hacer referencia al archivo que descargar:
selectedFilede tipoObject.selectedFileIdde tipoString.
Descripción de la ilustración vb-cec-var-download.png
Si no se ha creado previamente, agregue también 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.
La función de módulo de llamadas que escribe descarga el archivo que el usuario seleccionó.
Para escribir una función del módulo de llamadas para descargar el archivo seleccionado:
En el editor de funciones de la página, agregue la siguiente función que aparece entre las líneas de comentario (//).
define(['vb/helpers/rest', 'vb/helpers/rest'], (Rest, RestHookHandler) => {
'use strict';
var PageModule = function PageModule() { };
// Download the file
PageModule.prototype.saveFile = function(data, mimeType, filename) {
const blob = new Blob([data], {
type: mimeType
});
// IE/Edge
if (window.navigator && window.navigator.msSaveOrOpenBlob) {
window.navigator.msSaveOrOpenBlob(blob);
return;
}
var link = document.createElement('a');
link.href = URL.createObjectURL(blob);
link.download = filename;
link.click();
// Firefox: delay revoking the ObjectURL
setTimeout(function() {
URL.revokeObjectURL(blob);
}, 100);
};
// ...
return PageModule;
});
Para configurar el componente de vista de lista para activar la selección y recuperar la información del archivo seleccionado:
- En la vista Diseñador de la página de la aplicación, seleccione el componente Vista de lista y, a continuación, seleccione Único en la lista desplegable Modo de selección del inspector de propiedades.
Descripción de la ilustración vb-cec-list-single elect.png - En el separador Eventos del Inspector de Propiedades del componente de vista de lista, haga clic en + Nuevo Evento y, a continuación, en Inicio Rápido: 'selección'.
Esto crea y abre una nueva cadena de acciones,
ListViewSelectionChangeChain, en el lienzo Cadena de acciones. - En el lienzo Cadena de acciones, introduzca
Ifen el campo de entrada Filtro en Acciones y, a continuación, arrastre y suelte la acción Si en la sección Lógica en el lienzo Cadena de acciones. - Con la acción If que acaba de agregar seleccionada, haga clic en la flecha desplegable situada a la derecha del campo de entrada Condición y seleccione el elemento[0] bajo selección en la sección Variables de la cadena de acción.
Descripción de la ilustración vb-cec-list-change-selection.png - En el lienzo Cadena de acciones, introduzca
Call RESTen el campo de entrada Filtro en Acciones y, a continuación, arrastre y suelte la acción Llamar punto final REST al lienzo Cadena de acciones como resultado si la acción Si se evalúa como verdadera. - Con la acción Llamar al Punto Final REST que acaba de agregar seleccionada, haga clic en el botón Seleccionar Punto Final.
- En el cuadro de diálogo Seleccionar Punto Final, seleccione el punto final Obtener Información de Archivo (
files/{fileID}) y, a continuación, haga clic en Seleccionar.
Descripción de la ilustración vb-cec-add-endpoint-fileinfo.png - En el lienzo Cadena de acciones, seleccione la acción de punto final Llamar a REST y, en la sección Parámetros de entrada, haga clic en fileID para llamar al cuadro de diálogo Llamar al punto final REST, donde puede asignar el archivo seleccionado al parámetro de fileID.
Descripción de la ilustración vb-cec-call-endpoint-fileinfo.png - Haga clic en Guardar.
- En el campo de entrada Filtro en Acciones, introduzca
Assigny, a continuación, arrastre y suelte la acción Asignar variables en el lienzo como resultado correcto para la acción Llamar al punto final de REST. - Seleccione la acción Asignar variables que acaba de agregar al lienzo y haga clic en Asignar en la sección Variables.
- En el cuadro de diálogo Asignar Variables que aparece, dibuje una conexión entre el elemento[0] con selección en Variables de Cadena de Acción en Orígenes y el nodo selectedFileId en Página en Destino.
- Obtenga también una conexión entre el nodo de cuerpo de callRestEndpoint1 en Resultados y el nodo selectedFile en Página en Destino.
- Haga clic en Guardar.
- Arrastre y suelte otra acción Asignar variables en el lienzo como resultado fallido para la acción Llamar al punto final REST.
- Seleccione la acción Asignar variables que acaba de agregar al lienzo y haga clic en Asignar en la sección Variables.
- En el cuadro de diálogo Asignar Variables que aparece, dibuje una conexión entre el elemento[0] con selección en Variables de Cadena de Acción en Orígenes y el nodo folderId en Página en Destino.
- Haga clic en Save.
Descripción de la ilustración vb-cec-fileinfo-final-action.png
Descargar el documento seleccionado
Agregará un componente de botón en el que los usuarios finales hacen clic para llamar a una cadena de acción que incluya la acción Llamar el punto final REST que llama al punto final Descargar Archivo y la acción Función de Módulo de Llamadas que descarga el archivo devuelto por el punto final Descargar Archivo.
- 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'.
- En el cuadro de diálogo Seleccionar Punto Final, seleccione el punto final Descargar Archivo (
files/{fileID}/data) que ha agregado anteriormente y, a continuación, haga clic en Seleccionar. - En el cuadro de diálogo Llamar al Punto Final REST, realice una conexión desde el nodo selectedFileId en Variables en Orígenes al nodo fileID en Parámetros en Destino y haga clic en Guardar.
- En el lienzo Cadena de acción, introduzca
Functionen el campo de entrada Filtro en Acciones y, a continuación, arrastre y suelte la acción Función de módulo de llamada en el lienzo Cadena de acción como resultado correcto para la acción Llamar al punto final de REST. - Para los dos parámetros restantes (
mimeTypeyfilename), escriba las siguientes expresiones y, para cada parámetro, active la casilla de control Expresión.$page.variables.selectedFile.mimeType$page.variables.selectedFile.name
Descripción de la ilustración vb-cec-call-module-function-savefile.png
Descripción de la ilustración vb-cec-list-download-rt.png