START & GET BUSINESS CARD PARSING JOB (ASYNC) =======================================

ACTION DESCRIPTION
--------------------------------
START & GET BUSINESS CARD PARSING JOB (ASYNC) from a PDF, PNG, JPG, TIFF, BMP file returns the normalised extracted business card information.

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 FORM RECOGNIZER INSTANCE by following this link https://portal.azure.com/#create/Microsoft.CognitiveServicesFormRecognizer

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

 3)  Set up the "MICROSOFT AZURE - START BUSINESS CARD PARSING JOB" action in the workflow.
   Inputs Fields :
     - ENDPOINT : Endpoint in KEYS & ENDPOINT section of the created FORM RECOGNIZER 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.
     - LOCALE HINT : Locale hint for text recognition and document analysis. Value may contain only the language code (ex. "en", "fr") or BCP 47 language tag (ex. "en-US").
   Output Fields:
     - HEADERS OPERATION-LOCATION : Returns the OPERATION-LOCATION value is a URL to be used in "MICROSOFT AZURE - GET CONTRACT 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 BUSINESS CARD 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 BUSINESS CARD 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 BUSINESS CARD PARSING JOB RESULTS" step.
   Output Fields : Returns an object with STATUS which valid values are notStarted | running | failed | succeeded, returns also ANALYZE RESULT DOCUMENTS containing the normalised fields and the details as defined in https://learn.microsoft.com/en-us/azure/applied-ai-services/form-recognizer/concept-business-card?view=form-recog-3.0.0#field-extractions

 5) The next step shall be the DISPLAY LIST IN REPEATING GROUP RESULTS action with the DATA SOURCE the ANALYZE RESULT DOCUMENTS 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
======================
N/A

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.