Javaでの財務文書ワークフローの管理

金融業界では、文書のフォーマット、デザイン、構造を維持するために、PDFファイルを広範囲にわたって使用してデータを交換しています。 この堅牢な形式により、財務アナリストやアドバイザーは、顧客が十分な情報に基づいて意思決定を行えるように支援できます。

ただし、PDFフォーマットは、特に複数のデータソースを組み合わせる場合（金融業界で一般的なユースケース）には、処理と自動化が難しい場合があります。 PDF文書を処理するカスタムソリューションを構築することも選択肢の1つですが、ソフトウェアやインフラストラクチャに多くの時間とコストを費やす必要はありません。 Adobe Acrobat Servicesは、PDF文書のデータを処理および抽出するために必要なすべてのツール、サービス、および機能を提供します。

学習内容

この実践チュートリアルでは、Java Spring Boot個のアプリケーションにAdobe Acrobat Services個のAPIを使用する方法について学習します。 PDF文書からコンテンツを抽出してExcelなどの他のデータ形式に変換し、複数のリソースを結合してPDFを保護するモデルビューコントローラ(MVC)アプリを構築します。 このチュートリアルでは、Adobe PDF埋め込みAPIを使用してPDF文書を処理し、Webサイトで表示する方法について説明します。

関連APIとリソース

設定

Adobe Acrobat Servicesは認証システムを使用してリソースアクセスを制御します。 サービスにアクセスするには、組織またはアプリケーションのAPIキーをAdobeにリクエストする必要があります。 APIキーがある場合は、次のセクションに進みます。 新しいAPIキーを作成するには、Acrobat ServicesサイトでGetting Startedにアクセスしてください。 キーは無料体験版を使用して作成できます。この無料体験版では、最大6か月間で使用できる1,000件の文書トランザクションを提供します。

このチュートリアルを実行するには、次の2つのAPIキーセットが必要です。

資格情報を作成した後、Resourcesセクション内のSpring BootアプリケーションにPDFサービスAPI資格情報と秘密キーをコピーします。 Adobe Acrobat Services WebサイトのMavenとGradleのライブラリと依存関係の詳細をご覧ください。 作業を進める前に、必要なすべてのパッケージとライブラリを設定してください。

ログサービスを構成するには、Adobeドキュメントにアクセスし、[ログ]セクションまでスクロールします。

Spring Boot PDFが構成されたので、アプリケーションの処理に進み、お客様向けのレポートを作成できます。

レポートデータの送信

Adobe PDFサービスAPIを使用するには、まず、指定した資格情報を使用するExecutionContextを設定します。 アプリケーション内に資格情報があるので、ファイルから読み取り、次のようにコンテキストを作成できます。

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

ExecutionContext executionContext = ExecutionContext.create(credentials);

次に、PDF文書を処理するためのコンテキストを取得します。 実行できるアクションは次のとおりです。

これらのサンプルはすべて、GitHubサンプルリポジトリで利用できます。

次に、Spring Bootで、文字列パスまたはファイルがアップロードされているストリームを使用してファイルを取得できます。 実行するすべての操作を初期化し、入力ファイルパスを設定する必要があります。 このチュートリアルでは、Blackrockで一般に公開されているPDFレポートを使用します。 独自のレポートなど、他のソースを使用できます。

まず、ファイルからFileRefオブジェクトをキャプチャします。 わかりやすくするために、文字列パスによるファイルに焦点を当てます。 以下では、パスに含まれるファイルをPDFから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);

この手順を実行すると、プログラムはPDF上で最初のオペレーションを実行する準備が整います。 次に、操作を実行して、Excelシートに結果を取得します。

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

この場合、PDFファイルは1つしか処理されません。 複数のPDFファイルから始めて、それらを1つのファイルに結合することもできます。 財務データのレポートでは、複数のファイルを使用することが一般的です。これは、包括的なレポートを提供するために、複数のソースから資金を処理する必要があるためです。

レポートの生成

Adobe Acrobat Servicesは、すぐに使えるExcelドキュメントの処理をサポートしていませんが、コミュニティフレームワークとライブラリを使用してコンテンツを処理することはできます。

たとえば、Apache POIを使用して、Java Spring BootアプリでExcel (またはその他のMicrosoftドキュメント)を処理したり、Excelファイルに対して他の手動または自動の操作を行うことができます。

この例では、PDF文書から始めて、3つの資金の純資産額を抽出し、表に示します。 要件と使用可能なデータに基づいて、チャートや表などの他の情報を取得することもできます。 他のソースからデータを取り込むこともできます。

この例では、Excel形式でレポートが生成された後に、Adobe PDF Servicesのオペレーションを使用してレポートをPDFの文書に変換し、保護することができます。

レポートをExcel書式からPDF文書に変換するには、次の操作を実行します。

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

このコードは、レポートからExcelフォーマットのPDF文書を生成します。

このPDFをお客様に提供する前に、パスワードで保護することができます。 この保護を処理する別の操作ProtectPDFOperationを作成し、ProtectPDFOptionsを使用して文書にパスワードを追加します。

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

次に、入力を指定して操作を実行します。 結果のファイルには、不正アクセスを防止するためのパスワードが必要です。

レポートの表示

PDFレポートが生成されたので、Adobe PDF Embed APIを使用して、webサイトでレポートを表示できます。 このJavaScript APIを使用すると、Web開発者はWebブラウザー内でPDFドキュメントをネイティブに読み込んでレンダリングできます。

Spring Bootアプリケーションで、PDFレポートを表示する場所に次のHTMLスニペットを追加します。

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

このスクリプトは、PDF文書を読み込み、閲覧者が文書に注釈を付けたり、注釈を付けたりできるようにします。 Firefoxに表示されるこのEmbed APIのビューは次のとおりです。

PDF埋め込みAPIには、PDFのプレビューとレポートの注釈付けに必要なすべてのツールが用意されています。

次の手順

この実践チュートリアルでは、Adobe Acrobat ServicesのAPIについて説明し、これらのサービスを使用してPDFデータを処理し、財務上の意思決定に関するレポートを作成する方法について説明しました。 サンプルフレームワークとしてJava Spring Bootを使用してAPIをシステムに組み込む方法を示し、PDF文書の迅速な処理がどれほど簡単かを示しました。

Adobe Acrobat Servicesを検索して、Adobe PDFサービスがお客様のビジネスに何ができるかを確認してください。 SDKで利用できるその他の機能については、GitHubリポジトリーでサンプルを確認し、Application Embed APIによってPDF内のPDFをすばやく表示する方法を確認してください。

金融関係の顧客に役立つPDFレポートを作成したり、文書を簡単に組み合わせて操作するには、まず今すぐ無料のAdobe開発者アカウントにサインアップしてください。