Gestion des workflows de documents financiers en Java

Le secteur financier utilise beaucoup les fichiers de PDF pour l’exchange des données, car ils permettent de conserver le format, la conception et la structure des documents. Ce format robuste permet aux analystes financiers et aux conseillers financiers d'aider leurs clients à prendre des décisions éclairées.

Le format PDF, cependant, peut être difficile à traiter et à automatiser, en particulier lorsqu’il associe plusieurs sources de données, un cas d’utilisation courant dans le secteur financier. La création d’une solution personnalisée pour traiter les documents PDF est une option, mais il n’est pas nécessaire d’investir trop de temps et d’argent dans les logiciels et les infrastructures. Adobe Acrobat Services fournit tous les outils, services et fonctionnalités nécessaires au traitement et à l'extraction de données à partir des documents du PDF.

Ce que vous pouvez apprendre

Dans ce tutoriel pratique, découvrez comment utiliser les API Adobe Acrobat Services pour les applications Java Spring Boot. Vous créez une application Model-view-controller (MVC) qui extrait le contenu des documents de mot de PDF, le convertit dans d’autres formats de données tels qu’Excel, associe plusieurs mots de PDF et protège les ressources par mot de passe. Ce tutoriel explique comment traiter les documents de PDF et les afficher sur vos sites Web à l'aide de l'API PDF Embed Adobe.

Ressources et API pertinentes

Configuration

Adobe Acrobat Services utilise un système d'authentification pour contrôler l'accès aux ressources. Pour accéder aux services, vous devez demander une clé API à Adobe pour votre organisation ou application. Si vous disposez d’une clé API, passez à la section suivante. Pour créer une nouvelle clé API, consultez la page Prise en main sur le site Acrobat Services. Vous pouvez créer une clé à l’aide de son essai gratuit, qui fournit 1 000 transactions de document pouvant être utilisées pendant six mois maximum.

Pour suivre ce tutoriel, vous avez besoin de deux ensembles de clés API :

Après avoir créé les informations d'identification, copiez les informations d'identification de l'API des services de PDF et la clé privée dans l'application Spring Boot dans la section des ressources. En savoir plus sur les bibliothèques et dépendances Maven et Gradle sur le site web Adobe Acrobat Services. Assurez-vous de configurer tous les packages et bibliothèques nécessaires avant de continuer.

Pour configurer les services de journalisation, consultez la documentation de l'Adobe et faites défiler jusqu'à la section Journalisation.

Maintenant que votre application Spring Boot est configurée, vous pouvez continuer à traiter les mots de PDF et à générer des rapports pour les clients.

Envoi des données du rapport

Pour utiliser l'API Adobe PDF Services, commencez par configurer un ExecutionContext qui utilise les informations d'identification que vous fournissez. Puisque vous disposez des informations d’identification dans votre application, vous pouvez les lire à partir du fichier et créer le contexte comme suit :

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

ExecutionContext executionContext = ExecutionContext.create(credentials);

Ensuite, obtenez le contexte pour traiter les documents du PDF. Voici les actions que vous pouvez effectuer :

Tous ces exemples sont disponibles dans le référentiel GitHub samples.

Ensuite, dans Spring Boot, vous pouvez obtenir un fichier à l'aide du chemin d'accès Chaîne ou du flux dans lequel le fichier est téléchargé. Chaque opération que vous effectuez doit être initialisée et un chemin d'accès au fichier d'entrée doit être défini. Pour ce tutoriel, vous utilisez les rapports de PDF accessibles au public de Blackrock. Vous pouvez utiliser toute autre source, y compris vos propres rapports.

Commencez par capturer l’objet FileRef à partir du fichier. Pour plus de simplicité, concentrez-vous sur les fichiers par chemin de chaîne. Vous trouverez ci-dessous une opération permettant de convertir un fichier dans votre chemin d’accès de PDF vers 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);

Après cette étape, votre programme est prêt à exécuter la première opération sur le PDF. Ensuite, vous exécutez l'opération et obtenez le résultat dans la feuille Excel :

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

Ce scénario ne gère qu’un seul fichier de PDF. Vous pouvez également commencer par plusieurs fichiers de PDF et les regrouper en un seul fichier. L'utilisation de plusieurs fichiers est courante dans les rapports de données financières, car vous devez traiter des fonds provenant de plusieurs sources pour fournir un rapport complet.

Génération du rapport

Adobe Acrobat Services ne prend pas en charge le traitement des documents Excel prêts à l'emploi, mais vous pouvez toujours utiliser les infrastructures de la communauté et les bibliothèques pour traiter le contenu.

Par exemple, vous pouvez utiliser le API Apache pour traiter Excel (ou d'autres documents Microsoft) dans votre application Java Spring Boot, ou vous pouvez effectuer d'autres tâches manuelles ou automatisées sur le fichier Excel.

Dans cet exemple, en commençant par les documents de votre PDF, vous extrayez la valeur nette de vos trois fonds et les affichez dans un tableau. Vous pouvez également extraire d’autres informations, telles que des graphiques et des tableaux, en fonction de vos besoins et des données disponibles. Vous pouvez même importer des données provenant d’autres sources.

Une fois votre rapport généré (dans cet exemple, au format Excel), vous pouvez utiliser les opérations Adobe PDF Services pour reconvertir le rapport en document de PDF et le protéger.

Pour convertir le rapport au format Excel en document PDF, procédez comme suit :

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

Ce code génère un document de PDF à partir du rapport au format Excel.

Avant de fournir ce mot de PDF à vos clients, vous pouvez le protéger avec un mot de passe. Créez une autre opération qui gère cette protection pour vous, ProtectPDFOperation, puis utilisez ProtectPDFOptions pour ajouter le mot de passe au document.

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

Ensuite, spécifiez l’entrée et exécutez l’opération. Le fichier obtenu doit comporter un mot de passe pour empêcher tout accès non autorisé.

Affichage du rapport

Une fois le rapport de votre PDF généré, vous pouvez l’afficher sur le site web à l’aide de l’API Adobe PDF Embed. Cette API JavaScript permet aux développeurs web de charger et de rendre les documents du PDF en mode natif dans le navigateur web.

Dans votre application Spring Boot, ajoutez l'extrait de HTML suivant à l'endroit où vous souhaitez afficher le rapport du 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>

Ce script charge le document du PDF et permet aux utilisateurs d’annoter et de commenter les documents. Voici la vue de cette API Embed comme indiqué dans Firefox :

L’API PDF Embed fournit tous les outils nécessaires pour prévisualiser le PDF et annoter le rapport.

Marche à suivre

Ce tutoriel pratique a exploré les API Adobe Acrobat Services et expliqué comment utiliser ces services pour traiter les données des PDF et générer des rapports pour les décisions financières. Il a montré comment vous pouvez intégrer les API dans vos systèmes, en utilisant Java Spring Boot comme exemple de framework, pour montrer à quel point il est facile de traiter rapidement les documents de PDF.

Explorez Adobe Acrobat Services et découvrez ce que les services Adobe PDF peuvent apporter à votre entreprise. Pour en savoir plus sur les fonctionnalités disponibles dans le SDK, consultez le référentiel GitHub pour obtenir des exemples et découvrez comment l'API PDF Embed peut vous aider à afficher rapidement les PDF dans vos applications.

Pour combiner et manipuler facilement des documents et créer des rapports de PDF utiles pour vos clients financiers, commencez par créer votre compte développeur Adobe gratuit dès aujourd'hui.