Reconcile Document PDF Viewer

Overview

For cases requiring bounding boxes in a PDF and auto-scrolling from interface actions.

Key Features & Functionality

Example using “boundingBoxesDocumentUrl”:

reconcileDocumentViewer(
documentUrl: document(cons!MY_DOCUMENT, "url"),
boundingBoxesDocumentUrl: document(cons!MY_BOUNDING_BOXES_JSON, "url")
)

Example usage using “boundingBoxes”:

reconcileDocumentViewer(
documentUrl: document(cons!MY_DOCUMENT, "url"),
boundingBoxes: {
a!map(
id: "1",
text: "hello",
pageNumber: 1,
geometry: a!map(
top: 0.05,
left: 0.05,
width: 0.05,
height: 0.05
),
defaultHidden: false, /* optional, defaults true */
type: "type1", /* optional, used along with "selectableTypes", this bounding box will be selectable if "selectableTypes" is empty or if its value is contained within "selectableTypes" */
)
}
)

Usage considerations:

  • Provide the component with bounding boxes using either ‘boundingBoxesDocumentUrl’ or ‘boundingBoxes’. For better performance and UI responsiveness, use ‘boundingBoxesDocumentUrl’ when possible
  • Detailed information about all the parameters is available in Appian Designer when using the component and also in the image below
  • Max PDF size: 25Mb
  • Max pages: 500
  • Max bounding boxes when using ‘boundingBoxesDocumentUrl’: 200,000
  • Max bounding boxes when using ‘boundingBoxes’: 10,000
  • Chrome (incognito): Enable “Settings > Privacy and security > Third-party cookies > Allow third-party cookies”
  • Firefox: Disable "Enhanced Tracking Protection"
  • Safari: When rendering the component after a SAIL interaction, increment “interactionIdValue” in that interaction
Anonymous
  • How do you get geometry co-ordinates as shown below? Gen AI Document Extraction AI Skill doesn't provide accurate co-ordinates to draw the bounding box. Does it require Advanced IDP Tool AI Skill? 

    geometry: a!map(
    top: 0.05,
    left: 0.05,
    width: 0.05,
    height: 0.05
    )

  • Hi,

    Im trying to use this component and I have the following problem:

    Component never displays the document when entering a task for the first time.

    The display shows the following error: "Failed to load PDF file".

    I checked that the document is uploaded correctly in Appian and its a PDF under 25Mb and under 500 pages. I tried to use both parameters (documentUrl and boundingBoxesDocumentUrl) and it didnt work

  • v1.4.0 Release Notes
    • Performance enhancements
    • Added new parameter ‘zoomLevel’ to enable developers to set the default zoom of the component on page load
    • Allow highlighting of multiple bounding boxes at once
    • Validations of max PDF size (25Mb), max pages (500), max bounding boxes when using ‘boundingBoxesDocumentUrl’ (200,000) and max bounding boxes when using ‘boundingBoxes’ (10,000)
    • Fix CVE-2025-24010
    • Fix CVE GHSA-67mh-4wv8-2f99
    • Several bug fixes and UX enhancements
  • Hi, I was wondering how you use this plug-in after extracting information from documents using Appian AI. It would be helpful if there were more detailed instructions available.

  • v1.3.0 Release Notes
    • Support highlighting multiple bounding box ids
  • v1.2.0 Release Notes
    • Supporting selecting of text blocks from within pdf.
  • v1.1.0 Release Notes
    • Adding in ability to use a document with all of the bounding box json instead of querying on the interface.