Reconcile Document Viewer

Overview

For use cases when needing to display bounding boxes within a document and provide auto-scrolling to those locations from interface actions.

Key Features & Functionality

Parameters:

  • documentUrl - URL of document using document (<id>, "url"): PDF, JPG, PNG, TIFF (single and multi-page)
  • boundingBoxesDocumentUrl - URL of document using document (<id>, "url"), use either this or boundingBoxes
  • boundingBoxes - List of bounding boxes dictionaries containing an id and geometry (top, left, width, height), use either this or boundingBoxDocumentUrl
  • interactionId - value that should be incremented with each action outside of the component plugin that should force the component plugin to update, for example updating a highlightedBoxId to force scrolling.
  • highlightedBoxId - The ID of the bounding box that should be highlighted in the component plugin. If interactionId is updated alongside this value, the UI will scroll.
  • clickedBoundingBox - The ID of the bounding box that the user clicked within the component plugin

Example Usage:

reconcileDocumentViewer(
documentUrl: document(
<docId>,
"url"
),
boundingBoxes: {
a!map(
id: "<bounding box ID>",
text: "<text in box (used for search)>",
pageNumber: <page number of box>,
geometry: {left: <left coord>, top: <top coord>, width: <width>, height: <height>}
),
...more bounding boxes
},
interactionIdValue: local!interactionId,
interactionIdSaveInto: local!interaction,
highlightedBoxId: ri!highlightedBox,
clickedBoundingBox: ri!selectedBox
)

Usage considerations:

  • Provide bounding boxes using either ‘boundingBoxesDocumentUrl’ or ‘boundingBoxes’. For better performance and UI responsiveness, use ‘boundingBoxesDocumentUrl’ when possible
  • Max PDF size: 25Mb
  • Max pages: 500
  • Max bounding boxes using ‘boundingBoxesDocumentUrl’: 200,000
  • Max bounding boxes using ‘boundingBoxes’: 10,000
  • Chrome (incognito): Enable “Allow third-party cookies”
  • Firefox: Disable "Enhanced Tracking Protection"
  • Safari: When rendering the component after a SAIL interaction, increment “interactionIdValue” in that interaction
Anonymous
Parents
  • Hello,

    Found some issues while loading the document.

    1) PDF document with single page, one user can see, other user cannot. both are system administrator, same browser.

    2) same user, same document, this viewer component is in a interface which is the related action start form. If the related action is opened in NEW_TAB or SAME_TAB, it works; if it is opened in a dialog box, it does not work. 

    same tab

  • Hi Carlos,

    Would you be able to create a support case on MyAppian so one of our support engineers can assist you? Please provide information about the browser you're using. Additionally, if you can share the interface(s) and dummy doc you're using, that would be great so we can reproduce the issue and analyze quickly. 

    Thanks,

    Preet Jain

Comment
  • Hi Carlos,

    Would you be able to create a support case on MyAppian so one of our support engineers can assist you? Please provide information about the browser you're using. Additionally, if you can share the interface(s) and dummy doc you're using, that would be great so we can reproduce the issue and analyze quickly. 

    Thanks,

    Preet Jain

Children
No Data