Verwalten von Workflows für Finanzdokumente auf Java

In der Finanzbranche werden PDF-Dateien häufig für den Datenaustausch eingesetzt, da Format, Design und Struktur von Dokumenten dadurch beibehalten werden. Dieses robuste Format ermöglicht es Finanzanalysten und Beratern, ihren Kunden bei fundierten Entscheidungen zu helfen.

Die Verarbeitung und Automatisierung des PDF-Formats kann sich als Herausforderung erweisen, insbesondere wenn mehrere Datenquellen kombiniert werden müssen - ein gängiges Anwendungsszenario in der Finanzbranche. Die Entwicklung einer maßgeschneiderten Lösung zur Verarbeitung von PDF-Dokumenten ist eine Option, aber es besteht keine Notwendigkeit, zu viel Zeit und Geld in Software und Infrastruktur zu investieren. Adobe Acrobat Services stellt alle erforderlichen Tools, Services und Features zum Verarbeiten und Extrahieren von Daten aus PDF-Dokumenten bereit.

Lernziel.

In diesem praktischen Tutorial erfahren Sie, wie Sie Adobe Acrobat Services-APIs für Java Spring Boot-Anwendungen verwenden. Sie erstellen eine MVC-App (Model-View-Controller), die Inhalte aus PDF-Dokumenten extrahiert, in andere Datenformate wie Excel konvertiert, mehrere PDF kombiniert und die Ressourcen mit einem Kennwort schützt. In diesem Tutorial wird erläutert, wie Sie PDF-Dokumente mit der Adobe PDF Embed-API verarbeiten und auf Ihren Websites anzeigen.

Relevante APIs und Ressourcen

Einrichten

Adobe Acrobat Services verwendet ein Authentifizierungssystem, um den Ressourcenzugriff zu steuern. Um auf die Services zugreifen zu können, müssen Sie von der Adobe einen API-Schlüssel für Ihre Organisation oder Anwendung anfordern. Wenn Sie über einen API-Schlüssel verfügen, fahren Sie mit dem nächsten Abschnitt fort. Um einen neuen API-Schlüssel zu erstellen, besuchen Sie Erste Schritte auf der Website Acrobat Services. Sie können einen Schlüssel mit ihrer kostenlosen Testversion erstellen, die 1.000 Dokumenttransaktionen bietet, die bis zu sechs Monate lang genutzt werden können.

Um dieses Tutorial nachzuvollziehen, benötigen Sie zwei Sätze von API-Schlüsseln:

Kopieren Sie nach dem Erstellen der Anmeldeinformationen die API-Anmeldeinformationen für PDF Services und den privaten Schlüssel in die Anwendung Spring Boot im Ressourcenabschnitt. Erfahren Sie mehr über die Maven- und Gradle-Bibliotheken und -Abhängigkeiten auf der Adobe Acrobat Services-Website. Stellen Sie sicher, dass Sie alle erforderlichen Pakete und Bibliotheken eingerichtet haben, bevor Sie fortfahren.

Besuchen Sie zum Konfigurieren der Protokollierungsdienste die Adobe-Dokumentation, und scrollen Sie zum Abschnitt Protokollierung.

Nachdem Ihre Spring Boot-Anwendung konfiguriert ist, können Sie mit der Verarbeitung der PDF und der Generierung von Berichten für Kunden fortfahren.

Übermitteln der Berichtsdaten

Richten Sie zum Verwenden der Adobe PDF Services-API zunächst eine ExecutionContext ein, die die von Ihnen angegebenen Anmeldeinformationen verwendet. Da Sie die Anmeldeinformationen in Ihrer Anwendung haben, können Sie sie aus der Datei lesen und den Kontext wie folgt erstellen:

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

ExecutionContext executionContext = ExecutionContext.create(credentials);

Rufen Sie als Nächstes den Kontext zur Verarbeitung der PDF-Dokumente ab. Hier sind die Aktionen, die Sie ausführen können:

Alle diese Beispiele sind im Repository GitHub-Beispiele verfügbar.

Als Nächstes können Sie in Spring Boot eine Datei mithilfe des Zeichenfolgenpfads oder des Streams abrufen, in den die Datei hochgeladen wird. Jeder ausgeführte Vorgang muss initialisiert und ein Pfad für die Eingabedatei festgelegt werden. Für dieses Tutorial verwenden Sie die öffentlich verfügbaren PDF-Berichte von Blackrock. Sie können jede andere Quelle verwenden, einschließlich Ihrer eigenen Berichte.

Erfassen Sie zunächst das FileRef-Objekt aus der Datei. Der Einfachheit halber sollten Sie sich auf die Dateien konzentrieren, indem Sie den Pfad "Zeichenfolge" eingeben. Im Folgenden erstellen Sie einen Vorgang zum Konvertieren einer Datei in Ihrem Pfad von PDF in 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);

Danach ist das Programm bereit, den ersten Vorgang auf der PDF auszuführen. Als Nächstes führen Sie den Vorgang aus und erhalten das Ergebnis in der Excel-Tabelle:

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

In diesem Szenario wird nur eine PDF-Datei verarbeitet. Sie können auch mit mehreren PDF-Dateien beginnen und sie zu einer einzigen Datei zusammenführen. Die Verwendung mehrerer Dateien ist in der Finanzdatenberichterstattung üblich, da Sie Mittel aus mehreren Quellen verarbeiten müssen, um einen umfassenden Bericht zu erstellen.

Bericht generieren

Adobe Acrobat Services unterstützt die vorkonfigurierte Verarbeitung von Excel-Dokumenten nicht, Sie können jedoch weiterhin Community-Frameworks und Bibliotheken verwenden, um den Inhalt zu verarbeiten.

Sie können beispielsweise den Apache-POI verwenden, um Excel (oder andere Microsoft-Dokumente) in Ihrer Java Spring Boot-App zu verarbeiten, oder Sie können andere manuelle oder automatisierte Aufgaben für die Excel-Datei ausführen.

In diesem Beispiel beginnend mit Ihren PDF-Dokumenten extrahieren Sie den Nettoinventarwert Ihrer drei Fonds und zeigen ihn in einer Tabelle an. Sie können auch andere Informationen abrufen, wie Diagramme und Tabellen, basierend auf Ihren Anforderungen und den verfügbaren Daten. Ihr könnt sogar Daten aus anderen Quellen importieren.

Nachdem der Bericht generiert wurde (in diesem Beispiel im Excel-Format), können Sie den Bericht mithilfe von Adobe PDF Services-Vorgängen wieder in ein PDF-Dokument konvertieren und schützen.

Gehen Sie wie folgt vor, um den Bericht vom Excel-Format in ein PDF-Dokument zu konvertieren:

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();
}

Dieser Code generiert aus dem Bericht ein PDF-Dokument im Excel-Format.

Bevor Sie diese PDF an Ihre Kunden senden, können Sie sie mit einem Kennwort schützen. Erstellen Sie einen weiteren Vorgang, der diesen Schutz für Sie behandelt, ProtectPDFOperation, und verwenden Sie dann ProtectPDFOptions, um dem Dokument das Kennwort hinzuzufügen.

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

Geben Sie als Nächstes die Eingabe an und führen Sie den Vorgang aus. Die resultierende Datei sollte mit einem Kennwort versehen sein, um unbefugten Zugriff zu verhindern.

Anzeigen des Berichts

Nachdem der PDF-Bericht erstellt wurde, können Sie ihn über die Adobe PDF Embed-API auf der Website anzeigen. Mit dieser JavaScript-API können Webentwickler die PDF-Dokumente nativ im Webbrowser laden und rendern.

Fügen Sie in der Spring Boot-Anwendung das folgende HTML-Snippet hinzu, in dem Sie den PDF-Bericht rendern möchten:

<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>

Dieses Skript lädt das PDF-Dokument und ermöglicht es den Betrachtern, die Dokumente mit Anmerkungen zu versehen und zu kommentieren. Hier ist die Ansicht dieser Einbettungs-API, wie in Firefox gezeigt:

Die PDF Embed-API bietet alle erforderlichen Tools, um die PDF in der Vorschau anzuzeigen und Anmerkungen zum Bericht hinzuzufügen.

Nächste Schritte

In diesem praktischen Tutorial wurden die Adobe Acrobat Services-APIs untersucht und die Verwendung dieser Services zum Verarbeiten von PDF-Daten und zum Generieren von Berichten für Finanzentscheidungen erläutert. Es wurde gezeigt, wie Sie die APIs mithilfe von Java Spring Boot als Beispiel-Framework in Ihre Systeme integrieren können, um zu zeigen, wie einfach die schnelle Verarbeitung von PDF-Dokumenten ist.

Erkundet Adobe Acrobat Services und erfahrt, was Adobe PDF Services für euer Unternehmen tun kann. Weitere Informationen zu den im SDK verfügbaren Funktionen finden Sie im GitHub-Repository für die Beispiele. Erfahren Sie, wie Sie mit PDF Embed API schnell PDF in Ihren Anwendungen anzeigen können.

Um Dokumente problemlos zusammenzuführen und zu bearbeiten und hilfreiche PDF-Berichte für Ihre Finanzkunden zu erstellen, melden Sie sich noch heute für Ihr kostenloses Adobe-Entwicklerkonto an.