Gestione dei flussi di lavoro dei documenti finanziari in Java

Il settore finanziario utilizza ampiamente i file PDF per lo scambio di dati, in quanto consente di mantenere il formato, la progettazione e la struttura dei documenti. Questo robusto formato consente agli analisti e ai consulenti finanziari di aiutare i clienti a prendere decisioni consapevoli.

Il formato PDF, tuttavia, può risultare difficile da elaborare e automatizzare, soprattutto quando si combinano più origini dati, un caso d'uso comune nel settore finanziario. La creazione di una soluzione personalizzata per l'elaborazione dei documenti PDF è un'opzione possibile, ma non è necessario investire troppo tempo e denaro in software e infrastrutture. Adobe Acrobat Services fornisce tutti gli strumenti, i servizi e le funzionalità necessari per elaborare ed estrarre dati dai documenti PDF.

Cosa puoi imparare

In questo tutorial pratico, scopri come utilizzare le API Adobe Acrobat Services per le applicazioni Java Spring Boot. Si crea un'app MVC (Model-View-Controller) che estrae il contenuto dai documenti PDF, lo converte in altri formati di dati, ad esempio Excel, combina più PDF e protegge le risorse tramite password. Questo tutorial spiega come elaborare i documenti PDF e mostrarli sui tuoi siti Web utilizzando l'Adobe PDF Embed API.

API e risorse pertinenti

Configurazione

Adobe Acrobat Services utilizza un sistema di autenticazione per controllare l'accesso alle risorse. Per accedere ai servizi, è necessario richiedere una chiave API da Adobe per la tua organizzazione o applicazione. Se disponi di una chiave API, continua alla sezione successiva. Per creare una nuova chiave API, visita Guida introduttiva nel sito Acrobat Services. Puoi creare una chiave utilizzando la versione di prova gratuita che fornisce 1.000 transazioni di documenti che possono essere utilizzate per un massimo di sei mesi.

Per seguire questo tutorial, sono necessari due set di chiavi API:

Dopo aver creato le credenziali, copiare le credenziali API di PDF Services e la chiave privata nell'applicazione Spring Boot all'interno della sezione delle risorse. Ulteriori informazioni sulle librerie e dipendenze Maven e Gradle nel sito Web Adobe Acrobat Services. Prima di procedere, assicurati di configurare tutti i pacchetti e le librerie necessari.

Per configurare i servizi di registrazione, visitare la documentazione di Adobe e scorrere fino alla sezione Registrazione.

Ora che l'applicazione Spring Boot è configurata, è possibile procedere con l'elaborazione dei PDF e la generazione di report per i clienti.

Invio dei dati del report

Per utilizzare l'API di Adobe PDF Services, configurare prima un ExecutionContext che utilizzi le credenziali specificate. Poiché si dispone delle credenziali all'interno dell'applicazione, è possibile leggerle dal file e creare il contesto nel modo seguente:

Credentials credentials = Credentials.serviceAccountCredentialsBuilder()
    .fromFile(AUTH_FILE_PATH)
    .build();

ExecutionContext executionContext = ExecutionContext.create(credentials);

Quindi, ottieni il contesto per elaborare i documenti PDF. Ecco le azioni che puoi eseguire:

Tutti questi esempi sono disponibili nel repository GitHub samples.

Successivamente, in Spring Boot, è possibile ottenere un file utilizzando il percorso String o il flusso in cui viene caricato il file. Ogni operazione eseguita deve essere inizializzata e deve essere impostato un percorso del file di input. Per questo tutorial, utilizzi i report di PDF disponibili pubblicamente da Blackrock. Puoi utilizzare qualsiasi altra fonte, compresi i tuoi report.

Iniziate acquisendo l'oggetto FileRef dal file. Per semplicità, concentratevi sui file in base al percorso String. Di seguito, viene creata un'operazione per convertire un file nel percorso da PDF a Excel:

ExecutionContext executionContext = ExecutionContext.create(credentials);
ExportPDFOperation exportOperation = ExportPDFOperation.createNew(ExportPDFTargetFormat.XLSX);

// Create the input source
FileRef inputPdf = FileRef.createFromLocalFile(INPUT_PDF);
exportOperation.setInput(inputPdf);

Dopo questo passaggio, il programma è pronto per eseguire la prima operazione su PDF. Quindi, si esegue l'operazione e si ottiene il risultato nel foglio Excel:

try {
    FileRef output = exportOperation.execute(executionContext);
    output.saveAs(OUTPUT_EXCEL);
} catch (ServiceApiException e) {
    e.printStackTrace();
}

In questo scenario viene gestito un solo file PDF. Potete anche iniziare con più file di PDF e combinarli in un unico file. L'utilizzo di più file è comune nel reporting dei dati finanziari, in quanto è necessario elaborare i fondi provenienti da più origini per fornire un report completo.

Generazione del report

Adobe Acrobat Services non supporta l'elaborazione di documenti di Excel preconfigurati, ma è comunque possibile utilizzare framework e librerie della community per elaborare il contenuto.

Ad esempio, è possibile utilizzare Apache POI per elaborare Excel (o altri documenti di Microsoft) nell'app Java Spring Boot oppure eseguire altre attività manuali o automatizzate nel file di Excel.

In questo esempio, iniziando dai documenti PDF, si estrae il valore patrimoniale netto per i tre fondi e li si mostra in una tabella. È possibile richiamare anche altre informazioni, ad esempio grafici e tabelle, in base alle proprie esigenze e ai dati disponibili. È anche possibile importare dati da altre origini.

Dopo aver generato il report, in questo esempio in formato Excel, è possibile utilizzare le operazioni di Adobe PDF Services per convertire nuovamente il report in un documento PDF e proteggerlo.

Per convertire il report dal formato Excel a un documento PDF, eseguire la seguente operazione:

ExecutionContext executionContext = ExecutionContext.create(credentials);
CreatePDFOperation exportOperation = CreatePDFOperation.createNew();

// Create the input source
FileRef inputPdf = FileRef.createFromLocalFile(INPUT_EXCEL);
exportOperation.setInput(inputPdf);

try {
    FileRef output = exportOperation.execute(executionContext);
    output.saveAs(OUTPUT_PDF);
} catch (ServiceApiException e) {
    e.printStackTrace();
}

Questo codice genera un documento PDF dal report in formato Excel.

Prima di consegnare questo PDF ai tuoi clienti, puoi proteggerlo con una password. Creare un'altra operazione che gestisca automaticamente questa protezione, ProtectPDFOperation, quindi utilizzare ProtectPDFOptions per aggiungere la password al documento.

ProtectPDFOptions options = ProtectPDFOptions.passwordProtectOptionsBuilder()
                    .setUserPassword("p@55w0rd")
                    .setEncryptionAlgorithm(EncryptionAlgorithm.AES_256)
                    .build();
ProtectPDFOperation operation = ProtectPDFOperation.createNew(options);

Specificare quindi l'input ed eseguire l'operazione. Il file risultante deve avere una password per impedirne l'accesso non autorizzato.

Visualizzazione del report

Ora che il report PDF è stato generato, puoi visualizzarlo sul sito Web utilizzando l’API Adobe PDF Embed. Questa API JavaScript consente agli sviluppatori Web di caricare ed eseguire il rendering dei documenti PDF in modo nativo all'interno del browser Web.

Nell'applicazione Spring Boot, aggiungere il seguente frammento di HTML in cui si desidera eseguire il rendering del report PDF:

<div id="pdf-viewer"></div>
<script src="https://documentcloud.adobe.com/view-sdk/main.js"></script>
<script type="text/javascript">
    document.addEventListener("adobe_dc_view_sdk.ready", function()
    {
        var adobeDCView = new AdobeDC.View({ clientId: "<your-client-id-here>", divId: "pdf-viewer" });
        adobeDCView.previewFile(
        {
            content: {
                location: {
                    url: "<your-document.pdf>"
                }
            },
            metaData: {
                fileName: "<document-name.pdf>"
            }
        });
    });
</script>

Questo script carica il documento PDF e consente agli utenti di annotare e aggiungere commenti ai documenti. Ecco la vista di questa API di incorporamento come mostrato in Firefox:

L’API PDF Embed fornisce tutti gli strumenti necessari per visualizzare in anteprima il PDF e per annotare il report.

Fasi seguenti

In questa esercitazione pratica sono state esplorate le API Adobe Acrobat Services e si è discusso su come utilizzare questi servizi per elaborare i dati PDF e generare report per le decisioni finanziarie. È stato illustrato come integrare le API nei sistemi utilizzando Java Spring Boot come framework di esempio, per dimostrare quanto sia facile elaborare rapidamente i documenti PDF.

Esplora Adobe Acrobat Services e scopri cosa possono fare i servizi Adobe PDF per la tua azienda. Per ulteriori informazioni sulle altre funzionalità disponibili nell'SDK, consulta il repository GitHub per gli esempi e scopri come l'API PDF Embed può aiutarti a visualizzare rapidamente i PDF nelle tue applicazioni.

Per combinare e manipolare facilmente i documenti, creando utili report PDF per i clienti finanziari, iniziate subito registrandovi per il vostro account sviluppatore Adobe gratuito.