START & GET ANALYZE BANK STATEMENT (ASYNC) ==========================================

ACTION DESCRIPTION
--------------------------------
 START & GET ANALYZE BANK STATEMENT from files to return a list of text and values along with the detected languages, entities containing the invoice's normalised fields, and properties containing the normalised fields for each line items. List of supported normalised fields: https://cloud.google.com/document-ai/docs/processors-list#processor_invoice-processor

 Asynchronous request mode, useful for large files and time-insensitive application.

STEP-BY-STEP SETUP
--------------------------------
If you intend to store your files in Google Cloud Storage, please refer to the instructions of "GOOGLE STORAGE DROPZONE & UTILITIES" plugin (https://bubble.io/plugin/google-storage-dropzone--utilities-1616855011494x235332313714262000) first to setup your bucket. Then follow the instructions below.

The steps from 0) to 1) can be automatically performed by logging in into your Google Cloud Console, opening the Cloud Shell (top right corner of your page) and copy pasting this command and press enter:

 wget -q https://storage.googleapis.com/bubblegcpdemo/demo-assets/wiseable-gcp-documentai.py && python3 wiseable-gcp-documentai.py

Otherwise, follow these manual steps:

 0) Set-up a project from Google Cloud Console : https://cloud.google.com/document-ai/docs/setup
 - Create or select a project
 - Enable the DOCUMENT AI API for that project
 - Create a service account
 - Download a private key as JSON.

 1) Open the private key JSON file with a text editor, copy/paste the following parameters from your file to the Plugin settings:
 - CLIENT_EMAIL
 - PROJECT_ID
 - PRIVATE_KEY, including the -----BEGIN PRIVATE KEY-----\n prefix and \n-----END PRIVATE KEY-----\n suffix.

 2) In your Google Cloud Console > Document AI, create a BANK STATEMENT PARSER PROCESSOR. This PROCESSOR ID and REGION will be used in the following step: https://cloud.google.com/document-ai/docs/create-processor

 3) Set up the action "START ANALYZE BANK STATEMENT OPERATION" in the workflow.
   Inputs Fields :
     - INPUT FILES : PDF, TIFF, JPG, PNG, BMP, WEBP or GIF list of files in Google Storage URL (gs://bucket/path/file.pdf) format.
     - MIME TYPE : A standard MIME type describing the format of the contents. Format type/subtype. Example: image/png, video/mp4. For more information, see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
     - OUTPUT BUCKET : Output Bucket to store the results.
     - OUTPUT PATH : Folder to store the results in.
     - PROCESSOR ID : The ID of your processor. You will find this ID in your Google Cloud Console > Document AI > Processors > ID
     - REGION : Your processor's region, for example: us - United States eu - European Union. You will find this location in your Google Cloud Console > Document AI > Processors > Region
   Output Fields :
     - OPERATION NAME : ID of the operation, to be reused in the "GET ANALYZE BANK STATEMENT OPERATION RESULTS".

 4) Set up the action "GET ANALYZE BANK STATEMENT OPERATION RESULTS" in a recurring workflow ('Do every x seconds'), to poll the operation completion status on a regular basis.
   Configure this recurring workflow to retrieve the results once the OPERATION STATUS is 'SUCCEEDED', using Only When' Event Condition,
   Inputs Fields :
     - OUTPUT TYPE : Returned type, must always be set to "RESULT (DOCUMENTAI)".
     - OPERATION NAME : ID of the operation to poll, returned by "START ANALYZE BANK STATEMENT OPERATION" action.
     - REGION : Your processor's region, for example: us - United States eu - European Union. You will find this location in your Google Cloud Console > Document AI > Processors > Region

   Output Fields :
     - RESULT: Returns a list of text and values, entities containing the invoice's normalised fields, and properties containing the normalised fields  for each line items. List of supported normalised fields: https://cloud.google.com/document-ai/docs/processors-list#processor_bank-statement-parser

IMPLEMENTATION EXAMPLE
======================
Feel free to browse the app editor in the Service URL for an implementation example.

ADDITIONAL INFORMATION
======================
> Supported file formats: https://cloud.google.com/document-ai/docs/file-types

> Supported Normalised Fields : https://cloud.google.com/document-ai/docs/processors-list#processor_bank-statement-parser

> Supported Languages : https://cloud.google.com/document-ai/docs/processors-list#processor_bank-statement-parser

> GOOGLE DOCUMENT AI service limits : https://cloud.google.com/document-ai/quotas

TROUBLESHOOTING
================
Any plugin related error will be posted to the the Logs tab, "Server logs" section of your App Editor.
Make sure that "Plugin server side output" and "Plugin server side output" is selected in "Show Advanced".

> Server Logs Details: https://manual.bubble.io/core-resources/bubbles-interface/logs-tab#server-logs

PERFORMANCE CONSIDERATIONS
===========================

GENERAL
-------------
 N/A

QUESTIONS ?
===========
Contact us at [email protected] for any additional feature you would require or support question.