5 Using the Generic Visualization Adapter

Oracle Life Sciences Data Hub includes a generic visualization adapter that allows you to integrate an external tool with Oracle LSH to view data without building a custom adapter.

To use this adapter, you do not need to follow instructions in any section of this guide other than this chapter.

To integrate your visualization tool with Oracle LSH:

• Use an Oracle LSH view to display, when a user logs in to the visualization tool, the Business Area instances to which the user has access; see Display User's Business Area Instances.
• Use Oracle LSH APIs to allow the user to select appropriate blinding and currency settings; see Getting Possible Blinding Types of a Business Area Instance and Getting Snapshot Labels Common to All Tables in a BA Instance for a Given Blinding Access Type.
• Use Oracle LSH APIs to initialize the user's selected Business Area instance with those settings and to reset as required; see Initializing the Business Area Instance and Resetting a Generic Visualization Business Area.
• Use an Oracle LSH view to Retrieve Table Instance Details for the data you want to display.

To use the adapter, Definers create Business Areas of type Generic Visualization. When a Definer installs a Generic Visualization Business Area instance for the first time, the adapter creates a database schema exclusively for the Business Area instance. As with other Business Areas, data in Table instances mapped to the Business Area's Table Descriptors can be viewed in the visualization tool. Normally users log in directly to the visualization tool through its URL.

Note:

You do not need to define any service locations or service instances for this adapter.

For more information, see the following:

• Generic Visualization Adapter APIs
  The adapter includes public APIs that you can call from the external visualization system.
• Generic Visualization Adapter Views
  You can retrieve data for a user's business area instances and for table instances.
• Generic Visualization Business Area Instance Attributes
  Business Area instances of type Generic Visualization have several attributes including Schema Name, Default Currency, and Default Blinding Access Type.
• Generic Visualization Adapter Security
  Security for the generic visualization adapter has several components including Database and User Accounts, Object Security, Data Blinding and Currency, and Auditing.
• Generic Visualization Adapter Definitional Components
  All the defined objects, from the Adapter Domain down, are shipped with Oracle Life Sciences Data Hub.