Skip Headers
Oracle® Enterprise Data Quality for Product Data Oracle DataLens Server Administration Guide
Release 11g R1 (11.1.1.6)

Part Number E29138-02
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

2 Administering the Server

Data lenses and DSAs are stored on an Oracle DataLens Server of your choosing for use by an Oracle DataLens Administration Server. The Administration Server contains information about the different versions of the data lenses and DSAs and instances of the versions themselves. Only users of the Knowledge Studio and users using the Administration web page for the Administration Server can directly manipulate these data lenses. There is no direct access to the repository from the Oracle DataLens Servers. These data lenses are checked into the server from the Knowledge Studio.

Oracle DataLens Server data lenses and DSAs are those that are under version control by the Administration Server for shared use by different team members. This prevents possible problems with more than one user updating a data lens at the same time and possibly losing work. This also provides a single location for backing up the valuable data lenses. These data lenses can be checked out for editing or as read-only by users of the Knowledge Studio that have the correct privileges.

Once these are in the Administration Server repository, any of the data lenses and DSAs can be edited and upgraded when needed.

This chapter describes the following functions contained in the Server panel:

Managing Data Lenses

From the Server panel, select Data Lens to begin managing the data lenses in your Administration Server.

Figure 2-1 Data Lens Administration

Surrounding text describes Figure 2-1 .

The columns contain the following information:

Data Lens Name

This is the name of the data lens and is a link to the complete history information for the data lens. Click the link to review the data lens details. See "Viewing Data Lens Details and Managing Deployment".

Action Items

The action buttons that may be active, left to right, are used as follows:

View or Manage Surrounding text describes edit.png. Click to review or edit the parameters of the given data lens and you are advanced to the Data Lens Component Details for the given data lens panel. See "Viewing Data Lens Details and Managing Deployment".
Lock and Unlock Surrounding text describes lock.png. Surrounding text describes unlock.png. Click to lock or unlock the data lens. The icon toggles from a locked lock to an unlocked lock based on the state of the data lens. You are prompted for a user name when unlocking a data lens to identify who unlocked it. When the user logged in does not have administrative permissions, this button is not displayed.

Typically, the user locks on data lenses are created by users of the Knowledge Studio. Occasionally, these locks need to be overridden by an administrator.

For example, a user might be on vacation and left a data lens locked that is needed by another user or a user inadvertently started editing a data lens in the Knowledge Studio and failed to lock it first. This user would not want to check out the data lens to lock it because that would overwrite the work the user has done on the data lens.

Administrators must be careful when resetting locks to ensure that the latest data lens version is held intact.

Delete Surrounding text describes delete.png. Click to delete the data lens. This button is active when the data lens is not deployed, is unlocked, and the user logged in has administrator privileges. Once deleted, the data lens is no longer on the Administration Server and cannot be used by any user.

Development, QA, and Production Deployed Revision

The revision number of the deployed data lens to the Development (or the Administration/development), Quality Assurance (QA), or Production Servers. The development column is always displayed because it is the default for all data lens. However, the QA and Production columns are displayed when there are one or more data lenses deployed to these types of servers.

Administration Server User Lock

The Knowledge Studio user that has locked this data lens for exclusive access or the last administrator that locked it. When the field is blank, it means that the data lens is available for checkout by any Knowledge Studio user with access privileges.

Description

The initial description of the data lens when it was first checked into the repository. This description can be updated from the Application Studio when checking the data lens into the Administration Server.

Viewing Data Lens Details and Managing Deployment

You can view the complete history of the data lens listed from the most recent to the oldest and change how it is deployed.

To review data lens history or change its deployment, click the data lens name link or the adjacent View or Manage button.

Figure 2-2 Data Lens Details

Surrounding text describes Figure 2-2 .

Data Lens Component Details for Data Lens Name Panel

This panel contains the following information about the selected data lens.

Description

The initial description of the data lens when it was first checked into the repository. This description can be updated from the Knowledge Studio when checking the data lens into the Administration Server.

Cache Parse Results

Indicates a whether the parse results of the data lens will be cached is turned on or off for the data lens as a yes or no value respectively. This option is set in data lens in the Knowledge Studio by modifying the data lens options.

Source

This is the language that the data lens uses as the basis translation language.

Standardizations

This is a list of the alternate standardizations that the data lens uses. In this case there is only the default standardization being used, so this column is blank.

Classifications

This is a list of the classifications that the data lens uses. In this case there are two separate classifications that are being used by the data lens.

Target Locales

This is a list of the languages that the data lens can be translated to.

Unit Conversions

This is a list of the numeric conversions that have been defined for this data lens.

History Chronology Panel

This panel enables you to view the deployment status of a data lens, as well as deploy and undeploy it. It contains the following information and tasks.

Revision

The particular revision, starting from one, listed in reverse order so the latest revision is always at the top of the list. In this example there are two revisions.

Deploy Status

Select an icon (P, Q, or D, which indicate Production, QA, and Development respectively) to deploy a particular version of this data lens to the Administration Server or Oracle DataLens Server. This means that the data lens will be listed as a data lens available for loading on the Administrator or Oracle DataLens Server. The icons displayed are based on the configured server groups.

Information

This shows the revisions of the data lens including:

  • Comments about what the Knowledge Studio user changed in the data lens in each revision.

  • The name of the Knowledge Studio user that made the revision.

  • The date/time that the revision was checked into the Administration Server.

Deployed

These icons show how the data lens is currently deployed to the Administration and Oracle DataLens Servers.

Undeploy from Development

This will undeploy a data lens from the Development Server, which means it will not be listed as a data lens to be loaded as well. This button is only available for the version that is deployed to the Administration Server.

Undeploy from Production

This will undeploy a data lens from the Oracle DataLens Server, which means it will not be listed as a data lens to be loaded as well. This button is not available if the data lens is not currently deployed to the Oracle DataLens Server.

Undeploy from QA

If there is a QA server group defined, then there will be a button to undeploy or deploy to the QA area.

It is recommended that data lens only be deployed to the development area. Data lens deployment to the QA and Production areas can be done more easily by using the package deployment of DSAs, and the packages give a level of version tracking that cannot be done by manual data lens deployment.

Viewing and Deleting Data Lens Groups

Data lenses groups are created and managed in Application Studio for use with Item Definition transformations in a DSA instead of selecting them individually in each transform. A data lens group can be used in one or multiple DSA steps and in multiple DSAs. When a data lens group is changed in Application Studio, the change is effective immediately in both Application Studio and on your Oracle DataLens Server.

To view the data lens groups associated with all of the DSAs checked into the Administration Server, click Data Lens Group.

Figure 2-3 Data Lens Group Administration

Surrounding text describes Figure 2-3 .

All of the DSAs on the Administration Server that contain data lens groups are listed by data lens group name, description, and what type of data lens it is, Development, QA, or Production. Additionally, data lenses that are not deployed to QA or Production include '[Not Deployed]' after the data lens name. Data Lens Groups cannot exist with no data lenses.

The default view is that only the first data lens group is expanded though you can expand or collapse each one by clicking the arrow adjacent to the name. You can view all of the data lens group information by clicking Expand All.

To alphabetize the list, hover to the right of the name and use the up and down arrows to sort the list alphabetically either ascending or descending respectively.

A data lens group can only be deleted if it is not being used by any DSAs so attempting to do so results in an error that details which DSAs are still using it. To delete an unused data lens group, click the delete button in the Actions column, which will delete it and refresh the panel list.

Managing Data Service Applications

You can manage all DSAs on the Administration Server by clicking DSAs.

Figure 2-4 DSA Administration

Surrounding text describes Figure 2-4 .

This DSA - Administration panel operates in a similar manner to the Data Lens Administration panel, see "Viewing Data Lens Details and Managing Deployment". The following sections describe the DSA specific functions.

Promoting DSA Packages

The one exception is the additional Promote column, which allows you to create and promote DSA packages, with the data lenses contained within, from development status to Production or QA for users to check out. DSA packages include the data lenses and data lens groups associated with the DSA.

To create a production or QA DSA package:

  1. Click the green arrow in the Promote column for your DSA.

    Figure 2-5 Promote a DSA Package

    Surrounding text describes Figure 2-5 .
  2. (Optional) Change the Tag Name that will identify the package.

  3. Enter a description for the package to aid in identification.

  4. Select whether or not the package configuration has been tested in Application Studio with either true or false.

  5. Click the appropriate link to view the promoted package, QA or Production.

    Figure 2-6 Data Lens Server Package Administration

    Surrounding text describes Figure 2-6 .

    Example 2-0 shows both a true (blue check mark) and false (red R icon) data lens package. If there is more than one package for the DSA, then all of the package versions are listed as in this example. This is to ensure that users are able to identify the testing state of the data lenses that are available for production use.

    You can view all of the promoted data lens packages for each DSA as described in "Viewing DSA History Chronology".

  6. Click the name of the data lens package to view its details.

    Figure 2-7 Data Lens Package Details

    Surrounding text describes Figure 2-7 .

Viewing DSA History Chronology

The history details for a DSA including deployment status, area of deployment, and the check in information is obtained by clicking the on name of a DSA.

Figure 2-8 DSA History Chronology

Surrounding text describes Figure 2-8 .

The Deploy Status and Deployed columns contain deployment icons that enable you to toggle the deployment of the DSA. Oracle recommends that only the Deploy to Development icon be used. For deployment to QA or Production, the best practice is to promote the DSA package rather than using the Production and QA deployment icons so that you can track versions in the QA or Production server groups. See "Promoting DSA Packages".

You can view any data lens packages that have been promoted for the DSA by clicking View Production Package and results in viewing the data lens package details as in Figure 2-7.

To view all of the input and output steps, transformation maps, data lenses, web services, and database connections in the DSA, click the History Chronology for DSA Name link.

Figure 2-9 DSA Detail Information

Surrounding text describes Figure 2-9 .

Managing StatSim Indexes

StatSim is a matching application created in a DSA in the Application Studio that allows you to quickly identify similar records in your data. The process of identifying matches consists of two steps:

The StatSim indexes created by DSAs are stored on the Administration Server. You must create a StatSim database connection prior to use by DSAs in the creation of StatSim indexes, see "Creating a StatSim Database Connection".

To view and manage StatSim indexes, from the Server panel, select StatSim Index.

Figure 2-10 StatSim Indexes

Surrounding text describes Figure 2-10 .

This panel contains the following information about the StatSim indexes.

Name

The name of the StatSim index that is creating or has been created.

Actions

You can remove a StatSim index by clicking the delete button.

If the index does not previously exist, and an index creation job is cancelled, then the index is deleted. By contrast, if the index exists and you run a job to update the index, the original index is automatically deleted. In other words, the original index is not left intact.

Status

You can view the status of the StatSim index as it is being created and after successful completion. Click the refresh button to ensure that you are viewing the current progress. The progress icon is dimmed until the StatSim index creation has completed. The green arrow icon means the database connection is responsive, but no StatSim indexes are present. The red arrow means that the database connection is unresponsive and the StatSim index status is unknown.

You can also view the job process status by selecting Job Status in the Jobs panel.

Db Conn Name

The database connection used to retrieve the dataset.

Number of Rows

The number of data rows processed to create the StatSim index.

Index Memory Usage (MB)

Reports how much memory was required to build the index.

Ngram Size

The number of Ngram characters set in the DSA.

Build Time (HH:MM:SS)

Reports the amount of time required to build the StatSim index.

Last Build Date

Reports the last time that the StatSim index was built.

Accessing Reports

From the Server panel, select Reports to access the data lens and DSA reports.

Figure 2-11 Administrative Reports

Surrounding text describes Figure 2-11 .

Generating Data Lens Reports

Use the options in the Data Lens Reports panel as follows:

Data Lens Repository History

Click to view the data lens version history and the transformation types and revisions in this comprehensive repository history report. All deployment types are included in this report.

Data Lens Usage

Select a Datalens and a deployment Area from these list options, then click Datalens Usage to view how a the selected data lens is being used in the selected deployment area.

Production Data Lenses

Click to view only the Production deployed data lens version history and the transformation types and revisions in this production specific repository history.

Generating DSA Reports

Use the options in the DSA Reports panel as follows:

DSA Repository History

Click to view a comprehensive repository history of all the DSAs on the Administration Server.

DSA BOM Bill of Materials

Select a DSA, the type of report you want (deployed DSA or repository), and a deployment Area from these list options, then click DSA BOM to view the data lenses and database connections that are used by the selected DSA.