Perceptive Content - View Widget

The Perceptive Content - View widget displays details about and provides access to Documents made available through a Perceptive Content View definition, whereby the results are to be displayed upon a front end content portal interface for non-licensed users to access.

This Widget has been developed to serve two primary operational modes and organizational needs:

1. Public / Unauthenticated user access to Documents
2. Private / Authenticated user specific access to Documents

The intention with enabling Public document access would be to expose a set of public access documents (for which a user does not need to sign in to authenticate) which are being maintained directly within Perceptive Content / ImageNow, for example Corporate Policy papers.

This allows the organization to maintain a central repository of these files within Perceptive Content and remove the need to have different sets of documents maintained by both the web team, where any changed files are reflected live almost immediately.

Fields

A particular View can be configured in the widget settings, and a preview of the data retrieved from Perceptive Content will be displayed.

Standard field/column names, such as "Field 3" can be overridden inn the widget settings to provide a user friendly alternative when displayed.

Field	Notes	Required?
Title	The heading of the widget.	✅
Perceptive Content View	The View in Perceptive Content to retrieve files from.	✅
Cache time	The length of time to cache results for in seconds. This is in order to prevent overloading the Perceptive Content Integration Server instance with too many requests for high traffic sites. Files referenced are not cached, and are always access from Integration Server. There may be a small delay in adding a new View within Perceptive Content and this becoming available for selection within the Widget settings are for instance.	✅
Authenticated user access only	Restrict the records shown to Documents within the View that match the unique user account identifier of the authenticated user.	✅
Perceptive Content User ID Field	Provided when authenticated access is enabled. Specify which Field / Document key within Perceptive Content stores the associated user identifier for when the application performs matching. The current field options are limited to Field / Document keys 1 through to 5.	✅

note

The private mode requests made by the Widget use a Perceptive Content Visual Scripting Language (VSL) statement to pull out the relevant Documents within a chosen View, where the specified “Key” field value assigned to corresponding Documents within that View matches exactly the signed in Student/Staff/User identifier.

Example output

The resultant HTML output is rendered in a semantically marked up table and provides all necessary accessibility attributes (such as a table summary, table headings and so on).

tip

When wishing to determine what columns of data you wish to display, simply enable/disable the column using the checkbox within Perceptive Contents View Designer interface.

API endpoint usage

GET:/document/[id]/page/[id]/file
GET:/view.json?category=DOCUMENT
GET:/view/[id].json?category=DOCUMENT
POST:/view/[id]/result.json?category=DOCUMENT