Hantera arbetsflöden för finansiella dokument i Java

Banderoll för användningsfall

Finansbranschen använder PDF-filer i stor utsträckning för att utbyta data eftersom det hjälper till att upprätthålla dokumentformat, design och struktur. Detta robusta format gör det möjligt för finansanalytiker och rådgivare att hjälpa sina kunder att fatta välinformerade beslut.

PDF-formatet kan dock vara svårt att bearbeta och automatisera, särskilt när man kombinerar flera datakällor - ett vanligt användningsfall inom finansbranschen. Att skapa en anpassad lösning för att behandla PDF-dokument är ett alternativ, men det finns ingen anledning att investera för mycket tid och pengar i mjukvara och infrastruktur. Adobe Acrobat Services tillhandahåller alla verktyg, tjänster och funktioner som behövs för att bearbeta och extrahera data från PDF-dokument.

Vad du kan lära dig

I den här praktiska självstudiekursen lär du dig Adobe Acrobat Services API:er för Java Spring Boot program. Du skapar en MVC-app (Model-View-Controller) där innehåll extraheras från PDF-dokument, konverteras till andra dataformat, till exempel Excel, flera PDF kombineras och resurserna lösenordsskyddas. I den här självstudiekursen beskrivs hur du bearbetar PDF-dokument och visar dem på dina webbplatser med hjälp av Adobe PDF Embed API.

Relevanta API:er och resurser

Installation

Adobe Acrobat Services använder ett autentiseringssystem för att kontrollera resursåtkomst. Du måste begära en API-nyckel från Adobe för din organisation eller ditt program för att få åtkomst till tjänsterna. Fortsätt till nästa avsnitt om du har en API-nyckel. Om du vill skapa en ny API-nyckel går du till Komma igång i Acrobat Services -plats. Du kan skapa en nyckel med den kostnadsfria testversionen som innehåller 1 000 dokumenttransaktioner som kan användas i upp till sex månader.

Om du vill följa den här självstudiekursen behöver du två uppsättningar API-nycklar:

  • Adobe PDF Services - används för att bearbeta PDF-dokumentet

  • Adobe PDF Embed API

När du har skapat inloggningsuppgifterna kopierar du API-inloggningsuppgifterna för PDF Services och den privata nyckeln till Spring Boot programmet i resursavsnittet. Läs mer om Bibliotek och beroenden för Maven och Gradle om Adobe Acrobat Services webbplats. Se till att du konfigurerar alla nödvändiga paket och bibliotek innan du fortsätter.

Skärmbild av katalogplatsen för API-uppgifter för PDF Services

Konfigurera loggningstjänsterna genom att gå till Adobe-dokumentation och bläddra till avsnittet Loggning.

NOTE
Spara inte de privata nycklarna i versionskontrollen i produktionsmiljön. Använd alltid ett hemligt valv eller en nyckelinjektionstjänst för att förhindra obehörig användning av autentiseringsuppgifter.

Nu när din Spring Boot Om programmet är konfigurerat kan du fortsätta att bearbeta PDF och generera kundrapporter.

Inlämning av rapportdata

För att använda Adobe PDF Services API måste du först konfigurera en ExecutionContext som förbrukar de autentiseringsuppgifter du anger. Eftersom du har inloggningsuppgifterna i programmet kan du läsa dem från filen och skapa sammanhanget på följande sätt:

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

ExecutionContext executionContext = ExecutionContext.create(credentials);

Hämta sedan kontexten för att bearbeta PDF-dokumenten. Här är de åtgärder du kan utföra:

  • Konvertera PDF-dokument (till Excel, Word eller bildtyp)

  • Skapa PDF-dokument (från HTML, Excel, Word med mera)

  • Kombinera flera PDF-dokument

  • Protect och ta bort skyddet från PDF-dokumenten (du måste ha lösenordet)

  • Optimera PDF-dokument för visning i nätverk

Alla dessa exempel finns i GitHub-exempel databas.

Nästa, i Spring Boot, du kan hämta en fil med hjälp av sökvägen eller strömmen där filen laddas upp. Varje åtgärd du utför måste initieras och en indatafilsökväg måste anges. I den här självstudiekursen använder du de offentligt tillgängliga PDF-rapporterna från Blackrock. Du kan använda vilken källa som helst, inklusive dina egna rapporter.

Börja med att hämta FileRef -objekt från filen. För enkelhetens skull bör du fokusera på filerna via strängsökvägen. Nedan visas en åtgärd för att konvertera en fil i sökvägen från PDF till 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);

Efter detta steg, ditt program är redo att köra den första operationen på PDF. Därefter utför du åtgärden och får resultatet i Excel-bladet:

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

I det här scenariot hanteras endast en PDF-fil. Du kan också börja med flera PDF-filer och kombinera dem till en enda fil. Det är vanligt att använda flera filer vid rapportering av finansiella data eftersom du måste bearbeta medel från flera källor för att kunna tillhandahålla en omfattande rapport.

Genererar rapporten

Adobe Acrobat Services stöder inte bearbetning av Excel-dokument direkt, men du kan fortfarande använda communityramverk och bibliotek för att bearbeta innehållet.

Du kan till exempel använda kommandot Apache POI för att bearbeta Excel (eller andra Microsoft-dokument) i Java Spring Boot eller utföra andra manuella eller automatiska uppgifter i Excel-filen.

I det här exemplet börjar du med dina PDF-dokument och extraherar nettotillgångsvärdet för dina tre fonder och visar dem i en tabell. Du kan även hämta annan information, t.ex. diagram och tabeller, utifrån dina behov och tillgängliga data. Du kan till och med hämta data från andra källor.

När rapporten har skapats - i det här exemplet i ett Excel-format - kan du använda Adobe PDF Services-åtgärder för att konvertera tillbaka rapporten till ett PDF-dokument och skydda det.

Om du vill konvertera rapporten från Excel-format till ett PDF-dokument använder du följande åtgärd:

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();
}
TIP
För att förhindra att du måste återskapa objektet varje gång en förfrågan kommer ska du använda vårens beroendeinjektion för att injicera ExecutionContext objekt.

Med den här koden genereras ett PDF-dokument av rapporten i Excel-format.

Innan du levererar PDF till dina kunder kan du skydda den med ett lösenord. Skapa en annan åtgärd som hanterar detta skydd åt dig, ProtectPDFOperationoch använd sedan ProtectPDFOoptions för att lägga till lösenordet i dokumentet.

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

Ange sedan indata och kör åtgärden. Den resulterande filen bör ha ett lösenord för att förhindra obehörig åtkomst.

Visa rapporten

Nu när din PDF-rapport har skapats kan du visa den på webbplatsen med Adobe PDF Embed API. Med detta JavaScript API kan webbutvecklare läsa in och återge PDF-dokument direkt i webbläsaren.

NOTE
Nu behöver du en andra autentiseringstoken, klient-ID.

I ditt Spring Boot -programmet lägger du till följande HTML -utdrag där du vill återge PDF-rapporten:

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

Det här skriptet läser in PDF-dokumentet och gör det möjligt för användare att kommentera och anteckna i dokumenten. Här är vyn av detta Embed API som visas i Firefox:

Skärmbild av ett PDF-dokument i Firefox

PDF Embed API innehåller alla verktyg som behövs för att förhandsgranska PDF samt för att kommentera rapporten.

Nästa steg

I den här praktiska självstudiekursen utforskade Adobe Acrobat Services API:er och diskuterade hur du kan använda dessa tjänster för att bearbeta PDF-data och generera rapporter för ekonomiska beslut. Det visade hur du kan integrera API:erna i dina system med Java Spring Boot som en exempelram för att visa hur enkelt det är att snabbt behandla PDF-dokument.

Utforska Adobe Acrobat Services och se vad Adobe PDF-tjänster kan göra för ditt företag. Mer information om andra funktioner i SDK finns i GitHub-databas och utforska hur du kan PDF Embed API kan hjälpa dig att snabbt visa PDF i dina program.

För att enkelt kombinera och hantera dokument, skapa användbara PDF-rapporter för dina finanskunder, börja med att registrera dig gratis Utvecklarkonto för Adobe idag.

recommendation-more-help
61c3404d-2baf-407c-beb9-87b95f86ccab