Administración de flujos de trabajo de documentos financieros en Java

El sector financiero utiliza archivos de PDF de forma exhaustiva para intercambiar datos, ya que ayuda a mantener el formato, el diseño y la estructura de los documentos. Este formato robusto permite a los analistas y asesores financieros ayudar a sus clientes a tomar decisiones bien informadas.

Sin embargo, el formato PDF puede resultar complicado de procesar y automatizar, especialmente cuando se combinan varias fuentes de datos, un caso práctico común en el sector financiero. Crear una solución personalizada para procesar documentos de PDF es una opción, pero no es necesario invertir demasiado tiempo y dinero en software e infraestructura. Adobe Acrobat Services proporciona todas las herramientas, servicios y características necesarios para procesar y extraer datos de los documentos de PDF.

Lo que puedes aprender

En este tutorial práctico, aprende a usar las API Adobe Acrobat Services para las aplicaciones Java Spring Boot. Se crea una aplicación de controlador de vista de modelo (MVC) que extrae contenido de los documentos del PDF, lo convierte a otros formatos de datos como Excel, combina varios PDF y protege los recursos mediante contraseña. Este tutorial explica cómo procesar documentos de PDF y mostrarlos en sus sitios web mediante la API de incrustación de PDF de Adobe.

API y recursos relevantes

Configuración

Adobe Acrobat Services usa un sistema de autenticación para controlar el acceso a los recursos. Para acceder a los servicios, debe solicitar una clave de API de Adobe para su organización o aplicación. Si tiene una clave de API, continúe con la sección siguiente. Para crear una nueva clave de API, visita Introducción en el sitio de Acrobat Services. Puede crear una clave con su prueba gratuita, que proporciona 1000 transacciones de documento que se pueden utilizar durante un máximo de seis meses.

Para seguir los pasos de este tutorial, necesita dos conjuntos de claves de API:

Después de crear las credenciales, copie las credenciales de la API de servicios de PDF y la clave privada en la aplicación Spring Boot dentro de la sección de recursos. Obtenga más información sobre las bibliotecas y dependencias Maven y Gradle en el sitio web Adobe Acrobat Services. Asegúrese de configurar todos los paquetes y bibliotecas necesarios antes de continuar.

Para configurar los servicios de registro, visite Documentación de Adobe y desplácese a la sección Registro.

Ahora que la aplicación Spring Boot está configurada, puede continuar procesando los PDF y generando informes para los clientes.

Envío de los datos del informe

Para usar la API de servicios de Adobe PDF, primero configure un ExecutionContext que consuma las credenciales proporcionadas. Puesto que tiene las credenciales dentro de la aplicación, puede leerlas en el archivo y crear el contexto de la siguiente manera:

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

ExecutionContext executionContext = ExecutionContext.create(credentials);

A continuación, obtenga el contexto para procesar los documentos del PDF. Estas son las acciones que puede realizar:

Todos estos ejemplos están disponibles en el repositorio GitHub samples.

A continuación, en Spring Boot, puede obtener un archivo mediante la ruta String o el objeto Stream en el que se está cargando el archivo. Todas las operaciones que realice deben inicializarse y debe establecerse una ruta de acceso al archivo de entrada. Para este tutorial, utiliza los informes de PDF disponibles públicamente de Blackrock. Puede utilizar cualquier otra fuente, incluidos sus propios informes.

Empiece capturando el objeto FileRef del archivo. Para simplificar, céntrese en los archivos por ruta de cadena. A continuación, se crea una operación para convertir un archivo de la ruta de acceso de 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);

Después de este paso, el programa está listo para ejecutar la primera operación en el PDF. A continuación, ejecute la operación y obtenga el resultado en la hoja de Excel:

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

En este escenario, solo se gestiona un archivo de PDF. También puede empezar con varios archivos de PDF y combinarlos en un solo archivo. El uso de varios archivos es común en los informes de datos financieros porque debe procesar fondos de varios orígenes para proporcionar un informe completo.

Generación del informe

Adobe Acrobat Services no admite el procesamiento de documentos de Excel de forma instantánea, pero puedes seguir utilizando marcos de trabajo y bibliotecas de la comunidad para procesar el contenido.

Por ejemplo, puedes usar Apache POI para procesar Excel (u otros documentos de Microsoft) en tu aplicación de Java Spring Boot, o puedes realizar otras tareas manuales o automatizadas en el archivo de Excel.

En este ejemplo, a partir de los documentos de PDF, se extrae el valor neto del activo de los tres fondos y se muestran en una tabla. También puede obtener otra información, como gráficos y tablas, según sus necesidades y los datos disponibles. Incluso puedes incorporar datos de otras fuentes.

Una vez generado el informe, en este ejemplo en formato Excel, puede utilizar las operaciones de los Servicios de Adobe PDF para volver a convertir el informe en un documento de PDF y protegerlo.

Para convertir el informe del formato de Excel a un documento de PDF, utilice la siguiente operación:

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

Este código genera un documento de PDF a partir del informe en formato Excel.

Antes de entregar este PDF a sus clientes, puede protegerlo con una contraseña. Cree otra operación que controle esta protección, ProtectPDFOperation, y luego utilice ProtectPDFOptions para agregar la contraseña al documento.

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

A continuación, especifique la entrada y ejecute la operación. El archivo resultante debe tener una contraseña para evitar el acceso no autorizado.

Visualización del informe

Ahora que se ha generado el informe de PDF, puede mostrarlo en el sitio web mediante la API Adobe PDF Embed. Esta API de JavaScript permite a los desarrolladores web cargar y procesar los documentos del PDF de forma nativa dentro del navegador web.

En la aplicación Spring Boot, agregue el siguiente fragmento de HTML donde desee procesar el informe de 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>

Esta secuencia de comandos carga el documento del PDF y permite a los usuarios realizar anotaciones y comentarios en los documentos. Esta es la vista de esta API incrustada como se muestra en Firefox:

La API de incrustación de PDF proporciona todas las herramientas necesarias para obtener una vista previa del PDF, así como para realizar anotaciones en el informe.

Pasos siguientes

Este tutorial práctico exploró las API Adobe Acrobat Services y analizó cómo usar estos servicios para procesar datos de PDF y generar informes para decisiones financieras. Se demostró cómo se pueden integrar las API en los sistemas, utilizando Java Spring Boot como marco de trabajo de ejemplo, para mostrar lo fácil que es procesar rápidamente los documentos de PDF.

Explora Adobe Acrobat Services y descubre lo que los servicios de Adobe PDF pueden hacer por tu empresa. Para obtener más información sobre las funciones disponibles en el SDK, consulta el repositorio GitHub para obtener los ejemplos y descubre cómo PDF Embed API puede ayudarte a mostrar rápidamente a los PDF en tus aplicaciones.

Para combinar y manipular documentos fácilmente, creando informes de PDF útiles para tus clientes financieros, empieza registrándote hoy mismo en tu cuenta de desarrollador de Adobe gratuita.