Desarrollo de una Aplicación Web que Modifique Documentos PDF
Oracle Visual Builder proporciona herramientas y plantillas que le permiten crear aplicaciones web que pueden utilizar bibliotecas JavaScript externas para crear, actualizar y descargar documentos PDF.
- Agregar un nuevo texto.
- Dibujar un rectángulo alrededor de una parte del documento.
- División del PDF en diferentes páginas.
- Inserción de una imagen.
Esta solución le proporciona la orientación necesaria para implantar la funcionalidad de modificación de PDF en sus aplicaciones web y móviles de Visual Builder. Se describe cómo desarrollar una aplicación web de una página con la que un usuario puede cargar o crear un nuevo archivo PDF, modificar este documento con un texto personalizado y, a continuación, mostrar el documento en la página principal de la aplicación. Si es necesario, la aplicación también permitirá a los usuarios descargar el archivo en su repositorio de cliente local.
El repositorio GitHub (SampleVBCSModifyingPDFApplication) contiene el código fuente de una aplicación web de Oracle Visual Builder que se puede utilizar como ejemplo de dicha implantación. Puede acceder a este repositorio desde la sección "Explorar más" de este manual.
Antes de empezar
Los desarrolladores pueden utilizar Low Code Visual Builder de Oracle para crear aplicaciones web o móviles que puedan manejar archivos PDF para realizar tareas como:
- Creando un archivo PDF.
- Modificar un contenido PDF (por ejemplo, agregar o eliminar páginas, texto, imágenes).
- Combinar diferentes documentos PDF en uno o dividir un documento PDF de varias páginas.
- Se muestra en la interfaz de usuario de la aplicación.
- Descargado por el usuario de la aplicación.
- Se almacenan en un cubo.
- Se envían a otros servicios de OCI para su procesamiento posterior (por ejemplo, servicio de descripción de documentos de OCI).
Esta solución utiliza la API de PDF-LIB para crear un nuevo documento PDF y modificar los documentos PDF existentes.
Arquitectura
En este diagrama de arquitectura se muestra una forma común de desarrollar e integrar una aplicación web implantada y desplegada por Oracle Visual Builder.
Descripción de la ilustración webapp-vb-arch.png
Oracle Visual Builder permite desarrollar aplicaciones que se pueden comunicar con el servicio de almacenamiento backend. Utilícelo para crear las páginas que representan la interfaz de la aplicación, crear las conexiones de servicio que se conectan a los servicios REST y definir configuraciones de creación para que los servicios de creación de Oracle Visual Builder puedan crear aplicaciones web básicas, iOS, progresivas y Android.
- Visual Builder Cloud Service
Oracle Visual Builder Cloud Service es una plataforma como servicio (PaaS) de desarrollo de software basada en la nube y un entorno alojado para la infraestructura de desarrollo de su aplicación. Ofrece una solución basada en estándares de código abierto para desarrollar, colaborar y desplegar aplicaciones en Oracle Cloud. También ofrece un entorno de desarrollo visual integrado con desarrollo colaborativo ágil, control de versiones y automatización continua de la entrega. Enriquezca las aplicaciones con una interfaz de usuario personalizada atractiva y es una plataforma ampliable mediante JavaScript, HTML, CSS y REST estándar.
- Estudio de Visual Builder
Oracle Visual Builder Studio (VB Studio) es una plataforma de desarrollo de aplicaciones sólida que ayuda a su equipo a planificar y gestionar de forma eficaz su trabajo en todas las etapas del ciclo de vida de desarrollo de aplicaciones: diseño, creación, prueba y despliegue. Con Oracle Visual Builder Studio obtiene:
- Repositorios incorporados para alojar código en Git y para alojar binarios, como dependencias de Maven.
- Servicio de integración continua que permite automatizar los sistemas de creación y prueba.
- Un servicio de entrega continua que se integra perfectamente con Oracle Cloud Applications.
- Diseñador visual enriquecido integrado con control de origen (Git), que permite a los desarrolladores gestionar cambios, aplicar mejores prácticas de control de versiones y colaborar con sus compañeros de equipo para desarrollar aplicaciones.
- La capacidad de crear y mostrar diferentes tipos de interfaz de usuario para satisfacer las necesidades de usuarios discretos de determinadas aplicaciones de Oracle Cloud Applications (las creadas con VB Studio y Oracle JavaScript Extension Toolkit (Oracle JET)), también dentro de un marco de Git.
- Tableros ágiles y un sistema de seguimiento de problemas para rastrear sprints, tareas, defectos y características.
- Máquinas virtuales (ejecutores de compilación de máquinas virtuales)
Los ejecutores de compilación de máquina virtual son instancias informáticas de máquina virtual de OCI dedicadas a ejecutar compilaciones de trabajos que los miembros de su organización definen en proyectos de VB Studio. Un ejecutor de VM siempre está asociado a una plantilla de ejecutor de compilación. Cuando los miembros de su organización crean trabajos, simplemente asocian la plantilla de ejecutor adecuada al trabajo. Cuando se dispara la compilación del trabajo, VB Studio ejecuta la compilación en un ejecutor de VM asociado a la plantilla de ejecutor. Un ejecutor de VM se inicia automáticamente cuando se crea un trabajo que hace referencia a sus disparadores de plantilla de ejecutor y cambia su estado en consecuencia. Recuerde que un ejecutor de VM solo le cuesta cuando está activo, ejecuta una compilación o se prepara para ejecutar una compilación.
- Contenedores de Docker (ejecutor de compilación e imágenes)
Una imagen de Docker define el sistema operativo y los paquetes de software que los miembros de la organización necesitan para ejecutar compilaciones en un ejecutor de Docker. Puede importar una imagen de Docker desde un registro de Docker externo, como DockerHub, o crearla desde una plantilla de ejecutor de compilación. A diferencia de un ejecutor de VM, un ejecutor de Docker no está asociado directamente a ninguna máquina virtual específica. Cuando los miembros de su organización crean trabajos, simplemente asocian una imagen de Docker como una plantilla de creación con el trabajo. Cuando se dispara la creación del trabajo, VB Studio ejecuta la creación en cualquier máquina virtual de despliegue de Docker. Algunos puntos clave para recordar sobre las imágenes de Docker:
- Al crear una imagen a partir de una plantilla de ejecutor de compilación, VB Studio crea una nueva imagen de Docker instalando el software configurado en esa plantilla. Al crear una imagen a partir de un registro, VB Studio extrae la imagen del registro, agrega un agente de creación y crea una nueva imagen.
- Puede especificar el número máximo de ejecutores que se pueden crear a partir de la imagen.
- Puede crear tantas imágenes de Docker como necesite, siempre que la máquina virtual de gestión tenga suficiente espacio.
- Funciones
Oracle Cloud Infrastructure Functions es una plataforma de funciones como servicio totalmente gestionada, multiinquilino, altamente escalable y a demanda. Se basa en Oracle Cloud Infrastructure para empresas y cuenta con la tecnología del motor de código abierto Fn Project. La arquitectura sin servidor y flexible de OCI Functions significa que no hay administración de infraestructura ni administración de software que realizar. OCI Functions puede escribir código en Java, Python, Node, Go, Ruby y C# (y para casos de uso avanzados, traiga su propio Dockerfile y Graal VM). A continuación, puede desplegar el código, llamarlo directamente o dispararlo en respuesta a eventos y facturar solo por los recursos consumidos durante la ejecución. Puede acceder a las funciones de OCI mediante la consola, una CLI y una API de REST. Puede llamar a las funciones que despliega en OCI Functions mediante la CLI o realizando solicitudes HTTP firmadas. OCI Functions está integrado con Oracle Cloud Infrastructure Identity and Access Management (IAM), que proporciona una autenticación sencilla con la funcionalidad de identidad nativa de Oracle Cloud Infrastructure.
- Eventos
Las acciones que se realizan en las instancias de Oracle Visual Builder Studio emiten eventos. Puede usar la consola de Oracle Cloud para definir las reglas que dispararán una acción específica si se produce un evento. Oracle Cloud Infrastructure Events permite crear una automatización basada en los cambios de estado de los recursos de todo el arrendamiento. Utilice Events para permitir que los equipos de desarrollo respondan automáticamente cuando un recurso cambie su estado. Por ejemplo, puede definir una regla que envíe una notificación a los administradores cuando un usuario crea, suprime o actualiza una instancia.
- Proyecto
Un proyecto es una colección de funciones de VB Studio. Puede utilizar un proyecto para alojar archivos de código fuente, realizar un seguimiento de los problemas, colaborar en el código, crear y desplegar sus aplicaciones. Un proyecto puede alojar varios repositorios de Git. Cada repositorio de Git puede tener varias bifurcaciones y cientos de archivos de código. Puede crear una solicitud de fusión para cada rama del repositorio de Git y pedir a los revisores que revisen el código. Puede crear y configurar varios trabajos de creación para generar diferentes artefactos de proyecto que puede desplegar en Oracle Cloud o en su servidor web local.
- Repositorio de Git
Una herramienta de control de versiones distribuida y de gestión de código fuente (SCM) para alojar archivos de código fuente.
- Solicitud de fusión y revisión de código
Método para fusionar una rama del repositorio de Git con otra rama. Antes de fusionar las bifurcaciones, los miembros del equipo pueden revisar las diferencias entre los archivos de ambas bifurcaciones y proporcionar sus comentarios.
- Pipelines de integración y entrega continuas (CD)
La integración continua es un juego de prácticas que permite a los equipos de desarrollo implantar pequeños cambios de código y transferir el código a repositorios de control de versiones, como Git, con frecuencia. La entrega continua es una práctica que permite a los desarrolladores producir software en ciclos breves.
- Servicios en la nube de red virtual en la nube (VCN)
Una VCN es una red personalizable y definida por software que se configura en una región de Oracle Cloud Infrastructure. Al igual que las redes de los centros de datos tradicionales, las redes virtuales le proporcionan un control completo de su entorno de red. Una VCN puede tener varios bloques de CIDR no superpuestos que puede cambiar después de crear la VCN. Puede segmentar una VCN en subredes, las cuales se pueden acotar a una región o a un dominio de disponibilidad. Cada subred está formada por un rango contiguo de direcciones que no se solapan con las demás subredes de la VCN. Puede cambiar el tamaño de una subred después de la creación. Una subred puede ser pública o privada.
- Repositorios de datos (con Oracle Autonomous Transaction Processing)
Oracle Autonomous Transaction Processing es un servicio de base de datos autogestionado, autoprotegido y autoservicio optimizado para las cargas de trabajo de procesamiento de transacciones. No necesita configurar ni gestionar ningún hardware, ni instalar ningún software. Oracle Cloud Infrastructure se encarga de crear la base de datos, así como de realizar copias de seguridad, aplicar parches, actualizar y ajustar la base de datos.
- Identity Cloud Services (IdCS)
Oracle Identity Cloud Service proporciona un servicio innovador y totalmente integrado que ofrece todas las capacidades básicas de gestión de identidad y acceso mediante una plataforma en la nube multi-inquilino.
- Auditoría
El servicio OCI Audit registra automáticamente las llamadas a todos los puntos finales de API públicos de OCI soportados como eventos de log.
- Object Storage
El almacenamiento de objetos proporciona acceso rápido a grandes cantidades de datos estructurados y no estructurados de cualquier tipo de contenido, incluidas copias de seguridad de bases de datos, datos analíticos y contenido enriquecido, como imágenes y vídeos. Puede almacenar datos de forma segura y, a continuación, recuperarlos directamente desde Internet o desde la plataforma en la nube. Puede ampliar el almacenamiento sin problemas sin que se produzca ninguna degradación del rendimiento o la fiabilidad del servicio. Utilice el almacenamiento estándar para el almacenamiento "activo" al que tenga que acceder de forma rápida, inmediata y frecuente. Utilice el almacenamiento de archivos para el almacenamiento "en frío" que retiene durante largos períodos de tiempo y a los que rara vez o rara vez accede.
Pasos para crear aplicaciones con Oracle Visual Builder
Estos son los pasos básicos que se deben seguir al desarrollar aplicaciones con Oracle Visual Builder:
- Cree una instancia del servicio de Visual Builder (si aún no hay una creada) a partir del servicio de Visual Builder independiente o una nueva instancia de integración (si aún no hay una creada) a partir de Oracle Integration Cloud (OIC).
- Cree una nueva aplicación de Visual Builder.
- Cree una nueva aplicación web en Oracle Visual Builder.
- Cree las páginas y una interfaz de usuario general que muestre los controles, como botones para cargar archivos, crear nuevos docuenmts PDF y descargar documentos actualizados.
- Cree las variables y constantes para alojar la información extraída o incluida en el documento PDF.
- Importar las bibliotecas y los recursos externos necesarios
- Desarrolle el código JavaScript necesario para:
- Cargar un archivo del sistema local.
- Modifique el archivo PDF cargado con el texto introducido.
- Crear un nuevo documento PDF.
- Descargue el archivo PDF.
- Pruebe la aplicación con el usuario y el documento adecuados.
- Almacene y publique la aplicación web.
Acerca de los roles y servicios necesarios
Esta solución requiere el servicio Oracle Visual Builder junto con estos servicios adicionales y los roles correspondientes:
| Nombre de servicio: rol | Necesario para |
|---|---|
| Oracle Cloud Infrastructure: administrador | Gestionar usuarios móviles, roles y dominios. |
| Oracle Visual Builder: rol predefinido de Visual Builder Developer que se asigna al rol predefinido de capa de aplicación ServiceDeveloper. | Crear, gestionar, proteger y publicar aplicaciones web y móviles. |
Consulte Descubra cómo obtener los servicios de Oracle Cloud para las soluciones de Oracle para obtener los servicios en la nube que necesita.