Antes de empezar

En este tutorial, aprenderá a instalar el complemento Oracle Visual Builder Add-in for Excel, a crear un libro de trabajo de Microsoft Excel que recupere datos de un servicio REST y a publicar el libro de trabajo para que los usuarios profesionales puedan realizar tareas de entrada de datos. Tiene una duración aproximada de 10 minutos.

Antecedentes

Oracle Visual Builder Add-in for Excel le ayuda a descargar datos de un servicio REST en una tabla de un libro de trabajo de Excel, donde los usuarios pueden modificar, crear o suprimir datos antes de volver a enviar esos cambios al servicio. Una vez instalado el complemento, introducirá el punto final del servicio para descargar los datos del servicio en el libro de trabajo de Excel. También verá un nuevo separador de cinta de Oracle Visual Builder con comandos que le ayudarán a gestionar los datos descargados.

¿Qué se necesita?

• Un sistema operativo Windows 10 o 11 con una instalación de Microsoft Excel 365 u otra versión compatible

  (Consulte Plataformas soportadas en Desarrollo de hojas de cálculo integradas mediante Oracle Visual Builder Add-in for Excel).

• Acceso a la instancia de Oracle Visual Builder

  Nota: Puede completar el tutorial mediante un servicio REST de su elección. Asegúrese de que tiene los metadatos del servicio OpenAPI para el servicio de destino (algunos servicios de Oracle proporcionan dicha descripción agregando /describe a la URL). Si va por esta ruta, algunos pasos de este tutorial pueden ser diferentes para su servicio.

  Por ejemplo, puede omitir los subpasos 1 a 6 del paso 1, pero aún tendrá que completar los subpasos 7 y 8 para instalar el complemento. Descargue el instalador desde la página Descargas antes de empezar.

Instalación de Oracle Visual Builder Add-in for Excel

1. Haga clic con el botón derecho en este archivo y descárguelo en su computadora.

   El archivo Personnel_Manager.zip contiene una aplicación visual con un objeto de negocio de empleados y datos de ejemplo.

2. En el explorador web, conéctese a Oracle Visual Builder.
3. En la página Aplicaciones visuales, haga clic en Importar y, a continuación, seleccione Aplicación del archivo y examine para seleccionar el archivo Personnel_Manager.zip . Haga clic en Importar.
4. En la página Visual Applications, haga clic en Personnel Manager en la columna Name.
5. Haga clic en Objetos de negocio y, a continuación, haga clic en Menú y seleccione Gestor de datos.

   

6. En la página Gestor de datos, haga clic en Editar datos en Excel para descargar el instalador.

   Consejo: compruebe si hay una versión más reciente en la página Descargas.

7. Salga de Excel antes de ejecutar el instalador.
8. Haga doble clic en el archivo de instalación descargado para comenzar la instalación, haga clic en Next (Siguiente) y, a continuación, en Close (Cerrar) después de instalar el complemento. Consulte Instalación de Oracle Visual Builder Add-in for Excel en Desarrollo de hojas de cálculo integradas con Oracle Visual Builder Add-in for Excel.

   Una instalación correcta activa el complemento en Excel y aparece un nuevo separador de Oracle Visual Builder al iniciar Excel.

   

Configuración de un libro de trabajo de Excel para descargar datos de un servicio REST

En este paso, creará una tabla en un libro de trabajo de Excel que descargue datos de empleados del servicio REST asociado con la aplicación visual que acaba de importar.

1. En el separador Objetos de negocio de Oracle Visual Builder, haga clic en Empleados y, a continuación, en Puntos finales.
2. Amplíe API de recursos y, a continuación, haga clic en el icono del portapapeles para copiar la URL completa de la API de recursos de metadatos:

   

3. Cree un libro de trabajo de Excel denominado employees-source.xlsx en un directorio de la computadora y ábralo.
4. Haga clic en la celda donde desea localizar la tabla de datos.
5. En el separador Oracle Visual Builder del libro de trabajo de Excel, haga clic en Diseñador para iniciar el asistente Nueva configuración de diseño.
6. En la primera pantalla del asistente, introduzca la dirección URL que ha copiado anteriormente en el campo Web Address y haga clic en Next (Siguiente).

   

   Deje la configuración de autenticación establecida en "Default".

   Nota: Si utiliza un servicio REST diferente, introduzca la URL de ese servicio y agregue /describe a la URL.

7. En el cuadro de diálogo Conectar, introduzca el nombre de usuario y la contraseña que utiliza para acceder a Oracle Visual Builder y haga clic en Conectar.

   El complemento se conecta a la instancia de Oracle Visual Builder y recupera los metadatos del servicio. Los resultados de la operación se muestran en el asistente.

8. Haga clic en Siguiente para continuar.
9. En la siguiente pantalla, seleccione Employees (Empleados) y, a continuación, haga clic en Next (Siguiente).

   

   La siguiente pantalla le solicita que seleccione el tipo de diseño que desea crear: Tabla o Pantalla sobre Tabla.

   

10. Seleccione Diseño de tabla y, a continuación, haga clic en Siguiente.

    La siguiente pantalla le solicita que seleccione objetos de negocio adicionales para uno o más diseños dependientes.

    

11. Deje esta pantalla en blanco y haga clic en Next (Siguiente) para continuar.
12. En la pantalla final, confirme los detalles del nuevo diseño y haga clic en Finish (Finalizar).

    Aparecerá una nueva tabla en el libro de trabajo de Excel. Se muestran las cabeceras de columna, con una fila de datos de marcador de posición debajo de las cabeceras. También verá el diseñador de diseños a la derecha.

    

    Nota: Si la celda de origen del diseño está en las primeras 10 filas, la fila de cabecera se congela para que siempre vea las cabeceras de columna al desplazarse hacia arriba y hacia abajo en la hoja de trabajo.

13. Haga clic en Descargar datos para descargar los datos a los que hace referencia el objeto de negocio Employee.

    

Personalizar la tabla en el libro de trabajo de Excel antes de publicar

Puede que desee personalizar la tabla que crea el complemento en el libro de trabajo de Excel antes de publicarla y distribuirla a los usuarios para la entrada de datos. Por ejemplo, puede que desee cambiar el orden de las columnas para que la columna Correo electrónico aparezca antes del nombre del empleado. También puede agregar una consulta de búsqueda para filtrar los datos que se descargan del servicio. Por ejemplo, puede agregar el campo Salario desde el objeto de negocio Empleados como un campo de búsqueda para permitir a los usuarios introducir criterios de búsqueda que les permitan descargar solo los registros de empleados que coincidan con esos criterios.

1. En el separador Oracle Visual Builder, haga clic en Diseñador si es necesario. A continuación, haga clic en el separador Columnas del diseñador de diseños.
2. Vuelva a ordenar las columnas arrastrando y soltando el icono que aparece a la izquierda de la entrada Email, como se muestra aquí:

   Consejo: haga clic con el botón derecho en una columna para ver más opciones de reordenación.

   

   Nota: Las columnas Change (Cambiar), Status (Estado) y Key (Clave) se generan automáticamente. No puede personalizar ni eliminar estas columnas.

3. Haga clic en el separador Descargar para agregar una consulta de búsqueda.
4. Haga clic en el icono Editar junto a Buscar.

   

5. Seleccione Salario en el editor de campos de objetos de negocio disponibles y haga clic en Aceptar.
6. En el Editor de búsqueda, seleccione mayor que en la lista de comparadores y deje el valor vacío.
7. Borre Editor activado en la descarga para asegurarse de que los controles del editor de búsqueda en la petición de datos de búsqueda están desactivados en la descarga.
8. Haga clic en Aceptar para guardar la configuración de búsqueda y cerrar el editor de búsqueda.
9. Haga clic en Descargar datos.
10. En el cuadro de diálogo Search (Buscar), introduzca 10000 y haga clic en OK (Aceptar).

    El complemento descarga solo los registros de los empleados cuyo salario supera los 10 000.

    

Publicación y distribución del libro de trabajo de Excel a los usuarios

Ahora que ha creado el libro de trabajo de Excel y lo ha configurado para descargar datos del servicio REST, puede que desee publicarlo. Este paso opcional es útil si desea crear una copia del libro de trabajo que puede distribuir a otros usuarios para la introducción de datos. También le permite eliminar las herramientas de diseño (Diseñador, Suprimir diseño y Publicar) y activar la protección de la hoja de trabajo. Dicho esto, puede distribuir el libro de trabajo de Excel de origen sin publicarlo.

1. En el separador Oracle Visual Builder, haga clic en Publicar.

   

2. En la ventana Publicar libro de trabajo, acepte la ubicación y el nombre de archivo del libro de trabajo. Cuando el nombre del libro de trabajo original termina con -source (como en nuestro ejemplo, employees-source.xlsx), el complemento ofrece el mismo nombre sin -source.

   

3. Desactive la casilla de control Eliminar el host de servicio de cada catálogo, pero deje las demás opciones de publicación sin cambios.
4. Haga clic en Publicar. Consulte Publicación de un libro de trabajo de Excel integrado en Developing Integrated Spreadsheets Using Oracle Visual Builder Add-in for Excel.

   Se muestra una confirmación en el panel Estado.

   

5. Guarde y cierre el libro de trabajo de Excel de origen que utilizó para publicar el libro de trabajo de Excel.

   Ahora, puede distribuir el libro de trabajo publicado a otros usuarios para la introducción de datos. Cada usuario debe tener un nombre de usuario y una contraseña que permitan el acceso al servicio REST que introdujo al crear el libro de trabajo de Excel.

   En el siguiente paso de este tutorial se muestra cómo los usuarios completan las tareas de entrada de datos mediante el libro de trabajo de Excel que acaba de publicar.

Creación, lectura, actualización y supresión de datos en un libro de trabajo de Excel publicado

Los usuarios profesionales que reciben una copia del libro de trabajo de Excel que publicó deben instalar el complemento para descargar datos del servicio REST. (Pueden descargar el instalador directamente desde la página Descargas). Una vez instalado el complemento, puede crear, leer, actualizar y suprimir datos descargados en el libro de trabajo antes de cargar los cambios en el servicio.

1. Abra el libro de trabajo de Excel publicado desde el directorio en el que lo guardó.

   

   La sección Diseño no aparece en el separador Oracle Visual Builder porque ha desactivado las herramientas de diseño para evitar que los usuarios de un libro de trabajo publicado accedan a los comandos Diseñador, Suprimir diseño y Publicar a los que puede acceder como desarrollador de libros de trabajo. En la tabla se muestran las cabeceras de columna, pero no los datos, porque decidió borrar todos los diseños al publicar el libro de trabajo de Excel.

2. Haga clic en Descargar datos para descargar los datos para los que está configurado el libro de trabajo.
3. Introduzca un nombre de usuario y una contraseña en el cuadro de diálogo de conexión y haga clic en Aceptar.
4. Puesto que configura una consulta de búsqueda para limitar las descargas de datos en función del salario del empleado, se le pedirá que introduzca un valor para la consulta. Deje el valor vacío y haga clic en Aceptar.

   El complemento descarga todos los datos del empleado.

   

5. Realice los siguientes cambios:
   • En la fila 1, cambie Sophia a Sophie.
   • Haga clic en la celda G2 y seleccione Mánager en la lista de valores para cambiar el cargo de Dave Brown.
   • Seleccione la fila para John Sieve (fila 4) haciendo clic, por ejemplo, en su dirección de correo electrónico. En el separador Oracle Visual Builder, haga clic en Cambios de fila de tabla y, a continuación, haga clic en Marcar para suprimir.
   • Seleccione toda la fila 5, haga clic con el botón derecho y seleccione Insertar en el menú contextual. Introduzca estos datos para la fila recién insertada: Correo electrónico = jmcgahern@example.com, Nombre = John, Apellido = McGahern, Fecha de contratación = 2018-01-30, Cargo = Accountant, Salario = 19,000 y Departamento = Accounting.

     Nota: Otra forma de agregar nuevas filas en la tabla es seleccionar la fila inmediatamente debajo de la última fila descargada de la tabla, haga clic en Cambios de Fila de Tabla e Insertar Filas. El complemento crea una nueva fila en la tabla, que luego puede editar.

   • Seleccione la fila de Ken Ster al final de la tabla (fila 102) seleccionando, por ejemplo, su dirección de correo electrónico. En el separador Oracle Visual Builder, haga clic en Cambios de fila de tabla y, a continuación, haga clic en Marcar para suprimir.

     Una vez realizados estos cambios, la tabla es similar a la que se muestra en la siguiente imagen. Es decir, aparece un mensaje Update, Delete o Create en la columna Cambiado para cada fila en la que realizó un cambio.

     

6. En el separador Oracle Visual Builder, haga clic en Cargar cambios.

   Cuando se le solicite un mensaje que indique que la tabla tiene supresiones pendientes, haga clic en Sí para confirmar. Una vez finalizada la carga, la tabla refresca la columna Estado para describir el cambio de cada fila modificada que se ha cargado.

   La nueva fila que ha creado da como resultado la creación de un nuevo registro para John McGahern en la recopilación.

   Las filas marcadas para supresión, los registros de John Sieve y Ken Ster, ya no aparecen porque el servicio REST las ha suprimido de su recopilación.

   

   Nota: Todos los datos se validan antes de cargarlos en el servicio REST. Si se producen errores, siempre puede corregirlos y volver a cargar los cambios. Si tiene errores parciales, por ejemplo, si la actualización y supresión de filas se han realizado correctamente, pero la creación de filas ha fallado, solo tendrá que corregir los datos de la fila de creación con fallos.

   Para verificar que los cambios realizados en el libro de trabajo de Excel se hayan cargado correctamente, vaya al separador Datos de la página Objetos de negocio de la aplicación visual.

   

¿Desea más información?

• Introducción a Oracle Visual Builder Add-in for Excel en Desarrollo de hojas de cálculo integradas mediante Oracle Visual Builder Add-in for Excel
• Configuración de opciones de búsqueda para descarga en Desarrollo de hojas de cálculo integradas con Oracle Visual Builder Add-in for Excel
• Gestión de datos mediante Oracle Visual Builder Add-in for Excel. Esta guía ayuda a los usuarios profesionales a tener éxito con los libros de trabajo integrados.