START & GET FORM PARSING JOB (ASYNC) =======================================

ACTION DESCRIPTION
--------------------------------
START & GET FORM PARSING JOB (ASYNC) from a PDF, PNG, JPG, TIF, BMP file returns the normalised extracted data and line items informations.

STEP-BY-STEP SETUP
--------------------------------
 0) Sign-up for MICROSOFT AZURE - COGNITIVES SERVICES by following this link: https://azure.microsoft.com/free/cognitive-services/

 1) Create a DOCUMENT INTELLIGENCE INSTANCE by following this link https://portal.azure.com/#create/Microsoft.CognitiveServicesFormRecognizer

 2) In KEYS & ENDPOINT section of the created DOCUMENT INTELLIGENCE INSTANCE, note the KEY, ENDPOINT and enter those in the PLUGIN SETTINGS.

 3)  Set up the "MICROSOFT AZURE - START FORM PARSING JOB" action in the workflow.
   Inputs Fields :
     - ENDPOINT : Endpoint in KEYS & ENDPOINT section of the created DOCUMENT INTELLIGENCE INSTANCE.
     - URL SOURCE : PDF, PNG, JPG, TIFF, BMP file from the Bubble.io uploader, or a Protocol-relative URLs (//server/file.ext), a HTTPS file URL (https://server/file.ext). For both Protocol-relative and HTTPS URL, the file must be accessible through HTTPS Protocol.
   Output Fields:
     - HEADERS OPERATION-LOCATION : Returns the OPERATION-LOCATION value is a URL to be used in "MICROSOFT AZURE - GET FORM PARSING JOB RESULTS" API DATA Provider.

 4) Set up a DISPLAY DATA IN GROUP that will contain the JOB RESULTS of the API PROVIDER "MICROSOFT AZURE - GET FORM PARSING JOB RESULTS" in the workflow, set as GET DATA FROM AN EXTERNAL API DATA SOURCE, in a recurring workflow ('Do every x seconds'), to poll the job completion status on a regular basis.
   Configure this recurring workflow to execute the next step once the job status is SUCCEEDED, using 'Only When' Event Condition, to retrieve the results.

   Inputs Fields :
     - HEADERS OPERATION-LOCATION : The OPERATION-LOCATION value is the URL retrieved from the "MICROSOFT AZURE - START FORM PARSING JOB" action.
     - LAST-UPDATED : Must be set as the LAST UPDATED DATE TIME fields of the JOB RESULTS of the "API PROVIDER "MICROSOFT AZURE - GET FORM PARSING JOB RESULTS" step.
   Output Fields : Returns an object with STATUS which valid values are notStarted | running | failed | succeeded, returns also ANALYZE RESULT containing the fields keys and values.

 5) The next step shall be the DISPLAY LIST IN REPEATING GROUP RESULTS action with the DATA SOURCE the ANALYZE RESULT FORM of the JOB RESULTS, that will then be populated upon successful status.

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

ADDITIONAL INFORMATION
======================

> Document Input Requirements and Service Limits : https://learn.microsoft.com/en-gb/azure/ai-services/document-intelligence/service-limits

> Supported Languages & Locales : https://learn.microsoft.com/en-gb/azure/ai-services/document-intelligence/language-support-ocr

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
===========================
 N/A

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