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 funzioni necessari per elaborare ed estrarre i dati dai documenti PDF.

Cosa puoi imparare

In questo tutorial pratico, scoprite come utilizzare Adobe Acrobat Services API per Java Spring Boot applicazioni. 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 API PDF Embed.

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 Introduzione nella Acrobat Services sito. 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, copia le credenziali API di PDF Services e la chiave privata nel Spring Boot nella sezione delle risorse. Ulteriori informazioni sul Librerie e dipendenze Maven e Gradle sul Adobe Acrobat Services sito web. Prima di procedere, assicurati di configurare tutti i pacchetti e le librerie necessari.

Per configurare i servizi di registrazione, visitare Documentazione dell’Adobe e scorri fino alla sezione Archiviazione.

Ora che Spring Boot l'applicazione è 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, devi prima configurare un ExecutionContext che utilizza le credenziali fornite. 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 Esempi di GitHub archivio.

Avanti, in Spring Boot, puoi 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, utilizzerai 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 dei documenti di Excel, 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 Microsoft) nel Java Spring Boot oppure eseguire altre operazioni manuali o automatiche sul file 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.

Nella Spring Boot aggiungi il seguente frammento di HTML nel punto in cui desideri 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

Questo tutorial pratico ha esplorato Adobe Acrobat Services API e ha discusso come utilizzare questi servizi per elaborare i dati PDF e generare report per le decisioni finanziarie. È stato dimostrato come integrare le API nei sistemi, utilizzando Java Spring Boot come framework di esempio, per mostrare 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 funzioni disponibili nell'SDK, consultare Repository GitHub per i campioni e scoprire come API PDF Embed consente di visualizzare rapidamente i PDF all'interno delle applicazioni.

Per combinare e manipolare facilmente i documenti, creando utili report PDF per i clienti finanziari, inizia registrandoti gratuitamente account sviluppatore Adobe oggi.