Sviluppare un'applicazione Web che modifichi i documenti PDF
Oracle Visual Builder fornisce strumenti e modelli che consentono di creare applicazioni Web che possono utilizzare librerie JavaScript esterne per creare, aggiornare e scaricare documenti PDF.
- Aggiunta di un nuovo testo.
- Disegno di un rettangolo intorno a una parte del documento.
- Suddivisione del PDF in pagine diverse.
- Inserimento di un'immagine.
Questa soluzione fornisce le linee guida necessarie per implementare la funzionalità di modifica PDF nelle applicazioni Visual Builder Web e mobile. Viene descritto come sviluppare un'applicazione Web a una pagina con cui un utente può caricare o creare un nuovo file PDF, modificare questo documento con un testo personalizzato e quindi visualizzare il documento nella pagina principale dell'applicazione. Se necessario, l'applicazione consentirà inoltre agli utenti di scaricare il file nel repository client locale.
Il repository GitHub (SampleVBCSModifyingPDFApplication) contiene il codice sorgente di un'applicazione Web Oracle Visual Builder che può essere utilizzato come esempio di un'implementazione di questo tipo. È possibile accedere a questo repository dalla sezione "Esplora altro" di questo playbook.
Informazioni preliminari
Gli sviluppatori possono utilizzare Oracle Low Code Visual Builder per creare applicazioni Web o mobile in grado di gestire i file PDF per eseguire attività quali:
- Creazione di un file PDF.
- Modifica di un contenuto PDF (ad esempio, aggiunta o rimozione di pagine, testo, immagini).
- Unione di un documento PDF diverso in uno o frazionamento di un documento PDF multipage.
- Visualizzati nell'interfaccia utente dell'applicazione.
- Scaricato dall'utente dell'applicazione.
- Memorizzato in un bucket.
- Inviato ad altri servizi OCI per ulteriore elaborazione (ad esempio, il servizio OCI Document Understanding).
Questa soluzione utilizza l'API PDF-LIB per creare un nuovo documento PDF e modificare documenti PDF esistenti.
Architettura
Questo diagramma dell'architettura mostra un modo comune per sviluppare e integrare un'applicazione Web implementata e distribuita da Oracle Visual Builder.
Descrizione dell'immagine webapp-vb-arch.png
Oracle Visual Builder ti consente di sviluppare applicazioni in grado di comunicare con il servizio di storage backend. Utilizzarla per creare le pagine che presentano l'interfaccia della propria applicazione, creare le connessioni al servizio che si connettono ai servizi REST e definire le configurazioni di build in modo che i servizi di build di Oracle Visual Builder possano creare applicazioni Web Android, iOS, Progressive e di base.
- Visual Builder Cloud Service
Oracle Visual Builder Cloud Service è una soluzione Platform as a Service (PaaS) di sviluppo software basata sul cloud e un ambiente hosted per l'infrastruttura di sviluppo delle applicazioni. Fornisce una soluzione open source basata su standard che consente di sviluppare, condividere e distribuire applicazioni all'interno di Oracle Cloud. Offre anche un ambiente di sviluppo visivo integrato con sviluppo collaborativo agile, controllo delle versioni e automazione della distribuzione continua. Arricchisci le applicazioni con un'interfaccia utente personalizzata accattivante ed è una piattaforma estendibile attraverso JavaScript, HTML, CSS e REST standard.
- Visual Builder Studio
Oracle Visual Builder Studio (VB Studio) è una solida piattaforma di sviluppo delle applicazioni che consente al tuo team di pianificare e gestire in modo efficace il tuo lavoro in tutte le fasi del ciclo di vita di sviluppo delle applicazioni: progettazione, creazione, test e distribuzione. Con Oracle Visual Builder Studio puoi ottenere:
- Repository integrati per il codice di hosting in Git e per i file binari di hosting, quali le dipendenze Maven.
- Un servizio di integrazione continua che ti consente di automatizzare i sistemi di creazione e test.
- Un servizio di distribuzione continua che si integra perfettamente con Oracle Cloud Applications.
- Un avanzato Visual Designer integrato con controllo sorgente (Git), che consente agli sviluppatori di gestire le modifiche, applicare le migliori prassi per il controllo delle versioni e collaborare con i propri colleghi per sviluppare applicazioni.
- Possibilità di creare e visualizzare diverse versioni dell'interfaccia utente per soddisfare le esigenze di utenti discreti di determinate Oracle Cloud Applications (quelle create con VB Studio e Oracle JavaScript Extension Toolkit (Oracle JET)), anche all'interno di un framework Git.
- Schede agili e un sistema di registrazione dei problemi per tenere traccia di sprint, attività, difetti e funzionalità.
- VM (esecutori build Virtual Machine)
Gli esecutori build VM sono istanze di computazione VM OCI dedicate all'esecuzione di build dei job definiti dai membri dell'organizzazione nei progetti VB Studio. Un esecutore VM è sempre associato a un modello di esecutore build. Quando i membri dell'organizzazione creano job, è sufficiente associare il modello di esecutore appropriato al job. Quando la build del job viene attivata, VB Studio esegue la build su un esecutore VM associato al modello di esecutore. Un esecutore VM viene avviato automaticamente quando viene attivata una build di un job che fa riferimento al relativo modello di esecutore e ne modifica lo stato di conseguenza. Tenere presente che un esecutore VM costa l'utente solo quando è attivo, esegue una build o si prepara a eseguire una build.
- Container Docker (Crea esecutore e immagini)
Un'immagine Docker definisce il sistema operativo e i package software necessari ai membri dell'organizzazione per eseguire le build su un esecutore Docker. È possibile importare un'immagine Docker da un registro Docker esterno, ad esempio DockerHub, oppure crearla da un modello di esecutore build. A differenza di un esecutore VM, un esecutore Docker non è associato in modo diretto ad alcuna VM specifica. Quando i membri dell'organizzazione creano job, associano semplicemente un'immagine Docker come modello di build al job. Quando viene attivata la build del job, VB Studio esegue la build su qualsiasi VM di distribuzione Docker. Alcuni punti chiave da ricordare sulle immagini Docker:
- Quando si crea un'immagine da un modello di esecutore build, VB Studio crea una nuova immagine Docker installando il software configurato in tale modello. Quando si crea un'immagine da un registro, VB Studio estrae l'immagine dal registro, aggiunge un agente build e crea una nuova immagine.
- È possibile specificare il numero massimo di esecutori che possono essere creati dall'immagine.
- Puoi creare tutte le immagini Docker necessarie, purché la VM di gestione disponga di spazio sufficiente.
- Funzioni
Oracle Cloud Infrastructure Functions è una piattaforma completamente gestita, multi-tenant, altamente scalabile, on-demand e Functions-as-a-Service. Si basa su Oracle Cloud Infrastructure di livello enterprise e sfrutta il motore open source di Fn Project. L'architettura serverless ed elastica delle funzioni OCI significa che non è prevista alcuna amministrazione dell'infrastruttura o dell'amministrazione software da eseguire. Funzioni OCI, puoi scrivere codice in Java, Python, Node, Go, Ruby e C# (e per casi d'uso avanzati, trasferire il tuo Dockerfile e Graal VM). Puoi quindi distribuire il codice, richiamarlo direttamente o attivarlo in risposta agli eventi e ricevere la fatturazione solo per le risorse consumate durante l'esecuzione. Puoi accedere alle funzioni OCI utilizzando la console, un'interfaccia CLI e un'interfaccia API REST. Puoi richiamare le funzioni distribuite nelle funzioni OCI utilizzando l'interfaccia CLI o eseguendo richieste HTTP firmate. OCI Functions è integrato con Oracle Cloud Infrastructure Identity and Access Management (IAM), che fornisce una facile autenticazione con la funzionalità di identità nativa di Oracle Cloud Infrastructure.
- Eventi
Azioni eseguite sulle istanze di Oracle Visual Builder Studio che emettono eventi. È possibile utilizzare la console di Oracle Cloud per definire regole che attivano un'azione specifica quando si verifica un evento. Oracle Cloud Infrastructure Events ti consente di creare un'automazione basata sulle modifiche di stato delle risorse in tutta la tua tenancy. Utilizzare Eventi per consentire ai team di sviluppo di rispondere automaticamente quando una risorsa cambia stato. Ad esempio, puoi definire una regola che invierà una notifica agli amministratori quando qualcuno crea, elimina o aggiorna un'istanza.
- Progetto
Un progetto è una raccolta di funzionalità di VB Studio. Puoi utilizzare un progetto per ospitare file di codice sorgente, tenere traccia dei problemi, collaborare al codice, creare e distribuire le tue applicazioni. Un progetto può ospitare più repository Git. Ogni repository Git può avere più diramazioni e centinaia di file di codice. È possibile creare una richiesta di unione per ogni diramazione del repository Git e chiedere ai revisori di rivedere il codice. È possibile creare e configurare più job di build per generare artifact di progetto diversi che è possibile distribuire in Oracle Cloud o nel server Web in locale.
- Repository Git
Strumento di gestione del codice sorgente (SCM) e controllo della versione distribuita per l'hosting dei file del codice sorgente.
- Revisione del codice e richiesta di unione
Metodo per unire una diramazione del repository Git con un'altra diramazione. Prima di unire le diramazioni, i membri del team possono esaminare le differenze tra i file di entrambe le diramazioni e fornire il proprio feedback.
- Pipeline di integrazione continua (CI) e distribuzione continua (CD)
L'integrazione continua è un set di procedure che consente ai team di sviluppo di implementare piccole modifiche al codice e di eseguire il push dei repository di controllo delle versioni, ad esempio Git, di frequente. La distribuzione continua è una pratica che consente agli sviluppatori di produrre software in brevi cicli.
- Servizi cloud di rete cloud virtuale (VCN)
Una VCN è una rete personalizzabile e definita dal software configurata in un'area Oracle Cloud Infrastructure. Analogamente alle reti di data center tradizionali, i VCN offrono il controllo completo sull'ambiente di rete. Una VCN può avere più blocchi CIDR non sovrapposti che puoi modificare dopo aver creato la VCN. Puoi segmentare una VCN nelle subnet che possono essere definite nell'area o in un dominio di disponibilità. Ogni subnet è composta da un intervallo contiguo di indirizzi che non si sovrappongono alle altre subnet nella VCN. Puoi modificare le dimensioni di una subnet dopo la creazione. Una subnet può essere pubblica o privata.
- Repository di dati (con Oracle Autonomous Transaction Processing)
Oracle Autonomous Transaction Processing è un servizio di database self-driving, self-securing, self-repairing ottimizzato per i carichi di lavoro di elaborazione delle transazioni. Non è necessario configurare o gestire alcun hardware o installare alcun software. Oracle Cloud Infrastructure gestisce la creazione del database, nonché il backup, l'applicazione di patch, l'aggiornamento e l'ottimizzazione del database.
- Identity Cloud Services (IdCS)
Oracle Identity Cloud Service offre un servizio innovativo e completamente integrato che offre tutte le funzionalità di gestione delle identità e degli accessi di base attraverso una piattaforma cloud multi-tenant.
- Audit
Il servizio di audit OCI registra automaticamente le chiamate a tutti gli endpoint pubblici OCI supportati come eventi di log.
- Memoria oggetti
Lo storage degli oggetti garantisce un accesso rapido a grandi quantità di dati strutturati e non strutturati di qualsiasi tipo di contenuto, inclusi backup del database, dati analitici e contenuti avanzati, ad esempio immagini e video. Puoi memorizzare i dati in tutta sicurezza e poi recuperarli direttamente da Internet o dall'interno della piattaforma cloud. Puoi ridimensionare lo storage in modo trasparente senza alcun peggioramento a livello di prestazioni o affidabilità dei servizi. Utilizza lo storage standard per lo storage "hot" a cui devi accedere in modo rapido, immediato e frequente. Utilizzare lo storage di archivio per lo storage "freddo" che si mantiene per lunghi periodi di tempo e raramente può accedere.
Passi per creare applicazioni con Oracle Visual Builder
Di seguito sono riportati i passi di base da seguire per sviluppare le applicazioni con Oracle Visual Builder.
- Creare un'istanza del servizio Visual Builder (se non ne è già stata creata una) dal servizio Visual Builder standalone o dalla nuova istanza di integrazione (se non ne è stata già creata una) da Oracle Integration Cloud (OIC).
- Creare una nuova applicazione di Visual Builder.
- Crea una nuova applicazione Web in Oracle Visual Builder.
- Creare le pagine e un'interfaccia utente complessiva che espone i controlli, ad esempio pulsanti per caricare file, creare nuovi documenti PDF e scaricare documenti aggiornati.
- Creare le variabili e le costanti per ospitare le informazioni estratte o incluse nel e dal documento PDF.
- Importare le risorse e le librerie esterne necessarie
- Sviluppare il codice JavaScript richiesto per:
- Caricare un file dal sistema locale.
- Modificare il file PDF caricato con il testo immesso.
- Crea un nuovo documento PDF.
- Scaricare il file PDF.
- Eseguire il test dell'applicazione con l'utente e il documento appropriati.
- Posizionare nell'area intermedia e pubblicare l'applicazione Web.
Informazioni sui servizi e i ruoli richiesti
Questa soluzione richiede il servizio Oracle Visual Builder insieme a questi servizi aggiuntivi e ai rispettivi ruoli:
| Nome servizio: ruolo | Richiesto a |
|---|---|
| Oracle Cloud Infrastructure: Amministratore | Gestire utenti, ruoli e realm mobile. |
| Oracle Visual Builder: ruolo predefinito Sviluppatore di Visual Builder mappato al ruolo predefinito a livello di applicazione ServiceDeveloper. | Per creare, gestire, proteggere e pubblicare applicazioni Web e mobile. |
Consulta Scopri come ottenere i servizi Oracle Cloud per le soluzioni Oracle per ottenere i servizi cloud di cui hai bisogno.