Développer une application Web qui modifie les documents PDF
Oracle Visual Builder fournit des outils et des modèles qui vous permettent de créer des applications Web pouvant utiliser des bibliothèques JavaScript externes pour créer, mettre à jour et télécharger des documents PDF.
- Ajout d'un nouveau texte.
- Dessiner un rectangle autour d'une partie du document.
- Fractionner le PDF dans différentes pages.
- Insertion d'une image.
Cette solution vous guide dans l'implémentation de la fonctionnalité de modification PDF sur vos applications Visual Builder Web et mobiles. Il décrit comment développer une application Web d'une page avec laquelle un utilisateur peut télécharger ou créer un nouveau fichier PDF, modifier ce document avec un texte personnalisé, puis afficher le document sur la page principale de l'application. Si nécessaire, l'application permet également aux utilisateurs de télécharger le fichier dans leur référentiel client local.
Le référentiel GitHub (SampleVBCSModifyingPDFApplication) contient le code source d'une application Web Oracle Visual Builder qui peut être utilisée comme exemple d'une telle implémentation. Vous pouvez accéder à ce référentiel à partir de la section "Explorer plus" de ce livre de jeux.
Avant de commencer
Les développeurs peuvent utiliser Oracle Low Code Visual Builder pour créer des applications Web ou mobiles capables de gérer des fichiers PDF afin d'effectuer des tâches telles que :
- Création d'un fichier PDF.
- Modifier un contenu PDF (par exemple, ajouter ou supprimer des pages, du texte ou des images).
- Fusionner différents documents PDF en un ou fractionner un document PDF multipage.
- Affiché dans l'interface utilisateur de l'application.
- Téléchargé par l'utilisateur de l'application.
- Stocké sur un bucket.
- Envoi à d'autres services OCI pour traitement ultérieur (par exemple, service OCI Document Understanding).
Cette solution utilise l'API PDF-LIB pour créer un nouveau document PDF et modifier les documents PDF existants.
Architecture
Ce diagramme d'architecture présente une méthode courante pour développer et intégrer une application Web implémentée et déployée par Oracle Visual Builder.
Description de l'illustration webapp-vb-arch.png
Oracle Visual Builder vous permet de développer des applications capables de communiquer avec le service de stockage back-end. Utilisez-le pour créer les pages qui affichent l'interface de votre application, créer les connexions de service qui se connectent aux services REST et définir des configurations de build afin que les services de build d'Oracle Visual Builder puissent créer des applications Web de base, Android, iOS et Progressive.
- Visual Builder Cloud Service
Oracle Visual Builder Cloud Service est une plate-forme de développement logiciel en tant que service (PaaS) basée sur le cloud et un environnement hébergé pour votre infrastructure de développement d'applications. Il fournit une solution open source et reposant sur des normes, qui vous permet de développer des applications, de collaborer sur celles-ci et de les déployer dans Oracle Cloud. Il offre également un environnement de développement visuel intégré avec développement collaboratif agile, contrôle des versions et automatisation de la livraison continue. Enrichir les applications avec une interface utilisateur personnalisée et agréable, il s'agit d'une plate-forme extensible qui s'appuie sur les normes JavaScript, HTML, CSS et REST.
- Studio Visual Builder
Oracle Visual Builder Studio (VB Studio) est une plate-forme de développement d'applications fiable qui aide votre équipe à planifier et à gérer efficacement votre travail à toutes les étapes du cycle de développement d'applications : conception, création, test et déploiement. Voici les avantages dont vous bénéficiez avec Oracle Visual Builder Studio :
- Référentiels intégrés pour l'hébergement de code dans Git et l'hébergement de fichiers binaires, tels que les dépendances Maven.
- Un service d'intégration continue qui vous permet d'automatiser vos systèmes de création et de test.
- Un service de livraison continue qui s'intègre étroitement à Oracle Cloud Applications.
- Un concepteur visuel enrichi intégré au contrôle de source (Git) pour que les développeurs puissent gérer les modifications, appliquer les meilleures pratiques de contrôle des versions et collaborer avec leurs coéquipiers pour développer des applications.
- Possibilité de créer et d'afficher différentes variantes de l'interface utilisateur pour répondre aux besoins des utilisateurs discrets de certaines applications Oracle Cloud Applications (qui ont été créées avec VB Studio et Oracle JavaScript Extension Toolkit (Oracle JET)), également dans une structure Git.
- Cartes agiles et système de suivi des problèmes pour le suivi des sprints, des tâches, des défauts et des fonctionnalités.
- Machines virtuelles (exécuteurs de build de machines virtuelles)
Les exécuteurs de build de machine virtuelle sont des instances de calcul de machine virtuelle OCI dédiées à l'exécution de builds de travaux que les membres de votre organisation définissent dans les projets VB Studio. Un exécuteur de machine virtuelle est toujours associé à un modèle d'exécuteur de build. Lorsque les membres de votre organisation créent des travaux, ils associent simplement le modèle d'exécuteur approprié au travail. Lorsque la création du travail se déclenche, VB Studio exécute le build sur un exécuteur de machine virtuelle associé au modèle d'exécuteur. Un exécuteur de machine virtuelle démarre automatiquement lorsqu'un build d'un travail qui référence son modèle d'exécuteur déclenche et modifie son état en conséquence. N'oubliez pas qu'un exécuteur de machine virtuelle ne vous coûte que lorsqu'il est actif, exécute un build ou se prépare à exécuter un build.
- Conteneurs Docker (exécuteur et images de build)
Une image Docker définit le système d'exploitation et les packages logiciels dont les membres de votre organisation ont besoin pour exécuter des builds sur un exécuteur Docker. Vous pouvez importer une image Docker à partir d'un registre Docker externe, tel que DockerHub, ou la créer à partir d'un modèle d'exécuteur de build. Contrairement à un exécuteur de machine virtuelle, un exécuteur Docker n'est associé directement à aucune machine virtuelle spécifique. Lorsque les membres de votre organisation créent des travaux, ils associent simplement une image Docker en tant que modèle de build au travail. Lorsque la création du travail se déclenche, VB Studio exécute la compilation sur n'importe quelle machine virtuelle de déploiement Docker. Quelques points clés à retenir sur les images Docker :
- Lorsque vous créez une image à partir d'un modèle d'exécuteur de build, VB Studio crée une image Docker en installant le logiciel configuré dans ce modèle. Lorsque vous créez une image à partir d'un registre, VB Studio extrait l'image du registre, ajoute un agent de build et crée une image.
- Vous pouvez indiquer le nombre maximal d'exécuteurs pouvant être créés à partir de l'image.
- Vous pouvez créer autant d'images Docker que nécessaire, à condition que la machine virtuelle de gestion dispose de suffisamment d'espace.
- Fonctions
Oracle Cloud Infrastructure Functions est une plate-forme Functions-as-a-Service entièrement gérée, colocative, hautement évolutive et à la demande. Ce service s'appuie sur Oracle Cloud Infrastructure pour les entreprises et s'appuie sur le moteur open source du projet Fn. L'architecture sans serveur et élastique d'OCI Functions signifie qu'il n'y a pas d'administration d'infrastructure ou de logiciel à effectuer. OCI Functions vous permet d'écrire du code en Java, Python, Node, Go, Ruby et C# (pour des cas d'emploi avancés, utilisez votre propre fichier Dockerfile et Graal VM). Vous pouvez ensuite déployer votre code, l'appeler directement ou le déclencher en réponse à des événements et être facturé uniquement pour les ressources consommées lors de l'exécution. Vous pouvez accéder aux fonctions OCI à l'aide de la console, d'une interface de ligne de commande et d'une API REST. Vous pouvez appeler les fonctions que vous déployez vers OCI Functions à l'aide de l'interface de ligne de commande ou en effectuant des demandes HTTP signées. OCI Functions est intégré à Oracle Cloud Infrastructure Identity and Access Management (IAM), qui permet une authentification facile avec une fonctionnalité d'identité Oracle Cloud Infrastructure native.
- Evénements
Les actions que vous effectuez sur les instances Oracle Visual Builder Studio émettent des événements. Vous pouvez utiliser la console Oracle Cloud pour définir des règles déclenchant une action spécifique lorsqu'un événement survient. Oracle Cloud Infrastructure Events vous permet de créer une automatisation basée sur les modifications d'état des ressources dans l'ensemble de votre location. Utilisez Events pour permettre à vos équipes de développement de réagir automatiquement lorsqu'une ressource change d'état. Par exemple, vous pouvez définir une règle envoyant une notification à des administrateurs lorsqu'un utilisateur crée, supprime ou met à jour une instance.
- Projet
Un projet est un ensemble de fonctionnalités de VB Studio. Vous pouvez utiliser un projet pour héberger les fichiers de code source, suivre les problèmes, collaborer sur le code, créer et déployer vos applications. Un projet peut héberger plusieurs référentiels Git. Chaque référentiel Git peut comporter plusieurs branches et des centaines de fichiers de code. Vous pouvez créer une demande de fusion pour chaque branche du référentiel Git et demander aux réviseurs de vérifier le code. Vous pouvez créer et configurer plusieurs travaux de build pour générer différents artefacts de projet que vous pouvez déployer vers Oracle Cloud ou votre serveur Web sur site.
- Référentiel Git
Un outil de gestion des codes source (SCM) et de contrôle des versions distribuées pour héberger les fichiers de code source.
- Demande de vérification et de fusion de code
Méthode permettant de fusionner un branchement de référentiel Git avec un autre branchement. Avant de fusionner les branches, les membres de l'équipe peuvent vérifier les différences entre les fichiers des deux branches et fournir leurs commentaires.
- Pipelines d'intégration continue et de déploiement continu
L'intégration continue est un ensemble de pratiques qui permettent aux équipes de développement d'implémenter de petites modifications de code et de propager le code vers des référentiels de contrôle des versions, tels que Git, fréquemment. La livraison continue est une pratique qui permet aux développeurs de produire des logiciels en cycles courts.
- Services cloud de réseau cloud virtuel (VCN)
Un VCN est un réseau personnalisable, défini par logiciel, que vous configurez dans une région Oracle Cloud Infrastructure. Comme les réseaux de centre de données traditionnels, les réseaux cloud virtuels vous donnent un contrôle total sur l'environnement réseau. Un réseau cloud virtuel peut comporter plusieurs blocs CIDR qui ne se chevauchent pas et que vous pouvez modifier après l'avoir créé. Vous pouvez segmenter un réseau cloud virtuel en plusieurs sous-réseaux ciblant une région ou un domaine de disponibilité. Chaque sous-réseau est composé d'une plage contiguë d'adresses qui ne chevauchent pas celles des autres sous-réseaux du réseau cloud virtuel. Vous pouvez modifier la taille d'un sous-réseau après sa création. Un sous-réseau peut être public ou privé.
- Référentiels de données (avec Oracle Autonomous Transaction Processing)
Oracle Autonomous Transaction Processing est un service de base de données à pilotage, sécurité et réparation automatiques, optimisé pour les charges de travail de traitement des transactions. Il n'est pas nécessaire de configurer ou de gérer un matériel, ni d'installer un logiciel. Oracle Cloud Infrastructure gère la création de la base de données, ainsi que la sauvegarde, l'application de patches, la mise à niveau et le réglage de la base de données.
- Identity Cloud Services (IdCS)
Oracle Identity Cloud Service est un service novateur entièrement intégré qui offre toutes les fonctionnalités essentielles de gestion des identités et des accès via une plate-forme cloud colocative.
- Audit
Le service OCI Audit enregistre automatiquement les appels vers toutes les adresses d'API publiques OCI prises en charge en tant qu'événements de journal.
- Stockage d'objet
Object Storage offre un accès rapide à de grandes quantités de données structurées et non structurées de tout type de contenu, y compris des sauvegardes de base de données, des données analytiques et du contenu enrichi tel que des images et des vidéos. Vous pouvez stocker les données, puis les extraire directement à partir d'Internet ou de la plate-forme cloud, et ce, en toute sécurité. Vous pouvez adapter le stockage de manière transparente sans subir de dégradation des performances ni de la fiabilité du service. Utilisez le stockage standard pour le stockage "à chaud" auquel vous devez accéder rapidement, immédiatement et fréquemment. Utilisez le stockage d'archive pour un stockage "froid" que vous conservez pendant de longues périodes et que vous accédez rarement ou rarement.
Etapes de création d'applications avec Oracle Visual Builder
Voici les étapes de base à suivre lors du développement d'applications avec Oracle Visual Builder :
- Créez une instance du service Visual Builder (s'il n'en existe pas déjà une) à partir du service Visual Builder autonome ou d'une instance d'intégration (s'il n'en existe pas déjà une) à partir d'Oracle Integration Cloud (OIC).
- Créez une application Visual Builder.
- Créez une application Web dans Oracle Visual Builder.
- Créez les pages et une interface utilisateur globale qui expose des contrôles, tels que des boutons permettant de charger des fichiers, de créer des documents PDF et de télécharger des documents mis à jour.
- Créez les variables et les constantes pour héberger les informations extraites ou incluses dans le document PDF.
- Importer les ressources et bibliothèques externes nécessaires
- Développez le code JavaScript requis pour :
- Téléchargez un fichier à partir du système local.
- Modifiez le fichier PDF chargé avec le texte saisi.
- Créez un document PDF.
- Téléchargez le fichier PDF.
- Testez l'application avec l'utilisateur et le document appropriés.
- Préparer et publier l'application Web.
A propos des services et des rôles requis
Cette solution nécessite le service Oracle Visual Builder, ainsi que les services supplémentaires suivants et les rôles respectifs :
| Nom de service : rôle | Obligatoire à |
|---|---|
| Oracle Cloud Infrastructure : administrateur | Gérer les utilisateurs mobiles, les rôles et les domaines. |
| Oracle Visual Builder : rôle prédéfini Visual Builder Developer qui correspond au rôle prédéfini de couche d'application ServiceDeveloper. | Créer, gérer, sécuriser et publier des applications Web et mobiles. |
Reportez-vous à Découvrez comment obtenir les services Oracle Cloud pour les solutions Oracle afin d'obtenir les services cloud dont vous avez besoin.