START & GET OCR TO MARKDOWN JOB (ASYNC) =======================================

ACTION DESCRIPTION
--------------------------------
START & GET OCR TO MARKDOWN JOB (ASYNC) from a PDF, PNG, JPG, TIF, BMP file returns the markdowned content of the document.

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 OCR TO MARKDOWN 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 OCR TO MARKDOWN 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 OCR TO MARKDOWN 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 OCR TO MARKDOWN 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 OCR TO MARKDOWN JOB RESULTS" step.
   Output Fields : Returns an object with STATUS which valid values are notStarted | running | failed | succeeded, returns also ANALYZE RESULT containing the markdown content

 6) (Optional) Add the AZURE AI - MARKDOWN & LATEX PARSER element to display markdown formatting

 FIELDS:
   - MARKDOWN INPUT : Input formatted as Markdown Text.        
   - CSS STYLING : CSS styling to apply to rendered HTML output.

   EVENTS :
   - CODE COPIED : Event triggered when code is copied from the element.

   EXPOSED STATES:
   - HTML : Outputs the input formatted as HTML code.


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.