Print this page
In this topic
The user interface extensions (UI extensions) feature allows Ringtail administrators and service providers to extend the functionality of Ringtail by embedding third-party web applications directly into the Ringtail interface. A third-party web application that loads within Ringtail is called a UI extension.
The UI Extension SDK provides an API that UI extensions can use to communicate with Ringtail. The UI Extension SDK also includes steps to build and configure an extension, reference documentation, and an example extension. To get access to the UI Extension SDK, contact firstname.lastname@example.org.
The UI extensions that you integrate with Ringtail depend on the needs of your users. For example, you can add extensions that address client-specific custom workflows, or that connect functionality in Ringtail with functionality in other applications, or that generate revenue for your firm by providing value-added services for your clients.
UI extensions load as iframes, and interact with Ringtail data through the Ringtail Connect API. For more information about the Ringtail Connect API, see Ringtail Connect API.
You can add UI extensions as new pages on the Case Home page, and as workspace panes on the Documents page. Some example extensions include:
●On the Case Home page:
oAn automated job scheduling and notification tool for case administrators
oAn analysis tool to perform usage and status reporting
oA custom application that synchronizes document sets with third-party software
●As workspace panes on the Documents page:
oA machine language translation tool for reviewing documents in foreign languages
oAudio and video review tools for multimedia documents
oNative redaction tools
oReview tools for custom format documents, such as chat room messages, technical drawings, or system logs
oA custom application that sends documents to other systems for external processing
To make it easier to install a UI extension in Ringtail, you can define the settings for the extension in a manifest file. An administrator can upload the manifest file to Ringtail instead of manually installing the extension.
Optionally, you can use a manifest file to define custom fields and case statistics that are available to the extension. For example, an extension can use custom statistics to track client billing data.
For information about how to structure a manifest file, contact email@example.com.
For information about how to install a UI extension in Ringtail, see Administer UI extensions.
The UI Extension SDK includes an example application that demonstrates how to build a UI extension.
To get access to the example application, including sample data, contact firstname.lastname@example.org.
The example extension displays an interactive graph that shows the distribution of coding values for a selected field among the current search results. Clicking on part of the graph selects the documents in the search results that are coded with that value. The extension appears as a new workspace pane on the Documents page. The extension includes a toolbar with standard Ringtail controls that allow users to select the graph type and the coding field to display. The extension also includes logic to reload the graph when a user changes the selected field, opens a new results set, or clicks a Reload button.
The sample application demonstrates how to do the following tasks:
●Set up and construct an application that you want to use as a UI extension
●Initialize the UI Extension SDK
●Return data from Ringtail by querying the Ringtail Connect API
●Create standard controls in the Ringtail UI for users to interact with the extension
●Respond to user actions in Ringtail
●Manipulate the Browse selection state in Ringtail