Toad Intelligence Central 5.7 - Deployment Guide

Manage Folders

Objects published to Intelligence Central are organized into folders. The object's publisher selects an existing folder or creates a new folder during the publishing process in Toad Data Point. Intelligence Central users can also create folders through the Web Console.

Folders in Intelligence Central

Intelligence Central can contain several different types of folders. These folders can differ by purpose, origin, contents, and characteristics. Review the following descriptions for different folder types in Intelligence Central.

Special Folders

The following folders are created by Intelligence Central and have specific functionality.

No folder assigned

The No folder assigned folder is a special folder.

• The No folder assigned folder holds all objects not yet moved (or assigned) to other folders.
• The No folder assigned folder cannot be moved, renamed or deleted.
• The No folder assigned folder cannot have sub folders.

Common_Transformation_Repository

Toad Data Point users can publish Transform and Cleanse Rules to Intelligence Central to share with other users. These Transform and Cleanse Rules are stored in the Common_Transformation_Repository folder. See the Toad Data Point Help for more information about this feature.

• The Common_Transformation_Repository folder and its subfolders cannot be moved, renamed or deleted.
• You cannot move rules out of the Common_Transformation_Repository folder.

Secured and Non-Secured Folders

Aside from the special folders listed above, Toad Intelligence Central provides two types of folders for storing objects: secured folders and non-secured folders. Secured folders have visibility (sharing) and manage privileges assigned to them. Non-secured folders do not. See About Secured Folders for additional information.

An Intelligence Central server can provide one or both types of folders. A user with the Administrator role can configure which types of folders can be created and which user role/roles are allowed to create secured folders. To configure these server-level settings for secured folders, see Configure Server for Folder Security.

Icon	Description
	Non-secured folder—Visible to all users.
	Secured folder—Secured folders are visible only to users with visibility (sharing) privileges and can be managed only by users with manage privileges.

Create Folders

You can create a new folder using the Web Console (Web Server). A folder can also be created through Toad Data Point when an object is published. Only alpha, numeric, and the underscore (_) characters are allowed in folder names. A name cannot begin with the underscore character.

Restrictions

• You cannot create a secured folder in a non-secured folder.
• You cannot create a non-secured folder in a secured folder.
• To create a subfolder in a secured folder, you must have manage privileges to the parent secured folder.
• Folder creation is restricted to the folder types specified by the server-level Folder Security settings.
• To create a secured folder, the user's role must have permissions granted by the server-level Folder Security settings.

For more information, see About Secured Folders.

To create a new folder

1. On the Home page, select a folder and click in the Folder Details pane.
2. In the Create Folder dialog, select a folder to serve as the parent folder. To create a folder at the root level, select Folders.

3. Click the button corresponding to the type of folder you want to create.

   • New Non-Secured Folder—Select to create a non-secured folder.
   • New Secured Folder—Select to create a secured folder.

   Note: If a button is disable, creation of that folder type is not allowed, either at the server level or in the selected parent folder. See the Restrictions listed above.

4. Enter a folder name and click OK.
5. (Secured folder only) After a secured folder is created, you can then modify the visibility (sharing) and manage privileges, if necessary. Initially, only the folder creator and users with the Administrator role have visibility and manage privileges to the folder. The folder creator is automatically listed under folder Managers. See Specify Visibility, Manage and Publish Privileges for Folders for more information.

Move Folders

On the Home page, you can drag-and-drop a folder to move it. To move a folder, a user must have the Administrator role or manage privileges to all objects in the folder. A folder cannot be moved if an object in the folder is locked by another user.

Restrictions:

• You cannot move the Common_Transformation_Repository or its sub-folders.
• You cannot move the No folder assigned folder.
• You cannot move a folder while a snapshot in the folder is refreshing.
• You cannot move a secured folder into a non-secured folder.
• You cannot move a non-secured folder into a secured folder.

See About Secured Folders for more information about secured folders.

Delete Folders

You can delete a folder if you have the Administrator role or have manage privileges to all objects in the folder (unless an object is locked by another user).

To delete a folder

• On the Home page, select a folder and click in the Folder Details pane.

You cannot delete the No folder assigned folder.

View Folder Details

You can view information about a folder in Intelligence Central through the Folder Details pane. This is useful, especially for secured folders, which have sharing (visibility) and manage privileges assigned to them.

You can view the secured folders that have been shared with you. You can also view the parent folder of a secured folder that has been shared with you.

To view folder details

• In the Home page of the Web Console, select a folder to display the Folder Details pane. Review the following for additional information.

  Detail	Description
  Name	Folder name. For a secured folder, managers of the folder can rename the folder.
  Creator	Folder creator. This is the name of the user who initially created the folder.
  Visibility	(Secured folders) Displays the visibility (sharing) privileges for the selected folder. Managers can modify the visibility privileges. Click Visibility to open the Alter Folder Visibility dialog where you can modify visibility and manage privileges for the folder. See Specify Visibility, Manage and Publish Privileges for Folders for more information.
  Managers	(Secured folders) Displays the list of users and groups with manage privileges for the selected folder. Managers can modify the visibility and manage privileges for the object. Click Managers to open the Alter Folder Visibility dialog where you can modify the manage privileges for the folder. See Specify Visibility, Manage and Publish Privileges for Folders for more information.
  Publishers	(Secured folders) Displays the list of users and groups allowed to publish objects to the selected folder. Users with manage privileges can modify publish privileges for the folder through the Alter Folder Visibility dialog. See Specify Visibility, Manage and Publish Privileges for Folders for more information.

For additional information about manage privileges for secured folders, see Manager Privileges.

About Secured Folders

Secured folders are special folders in Toad Intelligence Central. Secured folders have visibility (sharing), manage, and publish privileges assigned to them. Non-secured folders do not.

Secured Folder Characteristics

Secured folders have the following special characteristics:

• Secured folders have visibility, manage, and publish privileges assigned to them.

• The sharing and manage privileges specified for a secured folder are also applied to all objects in the folder.

• When an object is published to a secured folder, the object automatically inherits the visibility and manage privileges applied to the secured folder.

Why Use Secured Folders

The special characteristics of secured folders provide the following advantages:

• Object publishers can automatically define visibility and manage privileges for an object by publishing it to the desired folder. In this way, the task of specifying object privileges can be transferred from the individual user to a group of folder managers.
• A folder manager can change the visibility and manage privileges for all objects in a secured folder at one time by simply changing the privileges for the secured folder itself.

These characteristics, along with the server-level Folder Security settings, allow companies to customize the way they define and manage object accessibility in Intelligence Central.

Use this feature to develop and implement a methodology for controlling and regulating the sharing and management of objects, files, and data.

Server-Level Configuration

Intelligence Central allows you to specify which type of folders users can create: secured, non-secured, or both. You can also specify which users are allowed to create and configure secured folders. These settings are specified at the server level by a user with the Administrator role.

To learn how to configure the server settings for secured folders, see Configure Server for Folder Security.

Rules and Restrictions for Secured Folders

Review the following rules and restrictions that apply to secured folders and their objects.

Visibility Privileges

• You can see secured folders that have been shared with you.
• You can see the parent folder of a secured folder that has been shared with you.

Privileges Based on User or Role

• By default, the folder creator and users with the Administrator role have visibility and manage privileges to a newly-created secured folder.
• Users with the Administrator role retain visibility and manage privileges to secured folders.

Subfolder Privileges

• A subfolder is not required to have the same visibility or manage privileges as the parent folder.
• A subfolder is not affected by changes to privileges for the parent folder.

Publishing

• In order to publish an object to a secured folder, the publisher must be an Administrator or have publish privileges to the secured folder.

Creating and Moving Folders

• A non-secured folder cannot be created in or moved into a secured folder.
• A secured folder cannot be created in or moved into a non-secured folder.
• A secured folder can be created at the root level.

Object Privileges

• All objects in a secured folder have the same manage and visibility privileges as the folder.

Moving and Deleting Secured Folders

• To move a secured folder, a user must have the Administrator role or manage privileges to the secured folder and all its subfolders.
• To delete a secured folder, a user must have either the Administrator role or visibility and manage privileges to the secured folder and all its subfolders.

Rules for Moving Objects into or out of a Secured Folder

• To move an object into a secured folder, the user must be an Administrator or have manage privileges to the object and the secured folder.
• If an object is moved into a secured folder, the object inherits the privileges of the secured folder, regardless of the object's original privileges.
• When an object is moved into a secured folder, the object publisher does not retain manage privileges unless the publisher is a folder manager.
• When an object is moved from a secured folder into a non-secured folder, the object's manage privileges are retained. For visibility privileges, only users with manage privileges to the object will retain visibility, others will not.

Notifications of Secured Folder Activity

• If a secured folder's objects or subfolders are moved, users with visibility or manage privileges to the folder receive an email notification.
• If an object is moved into a secured folder, the object publisher and users with visibility or manage privileges to the object will receive an email notification.

Specify Visibility and Manage Privileges

Secured folders have visibility (sharing), manage, and publish privileges assigned to them. Users with manage privileges to a secured folder can modify the visibility, manage, and publish privileges.

Specify Sharing Privileges

You can modify the visibility (sharing) options for a secured folder to which you have manage privileges. The sharing options you specify for a secured folder are applied to all objects in the folder.

To alter Visibility for a secured folder

1. In the Web Console, click Home.
2. Select a secured folder to display details.
3. In the Folder Details pane, click Visibility to open the Alter Visibility dialog.
4. In the Alter Visibility dialog, select the users and groups with which you want to share the folder.
   • Add users and groups to the right pane. You can include both individual users and groups.

5. For each user (or group) specify manage and publish privileges.

   Manage—Select this option for each user (or group) to which you want to grant Manage privileges.

   Publish—Select this option for each user (or group) to which you want to grant Publish privileges.

Specify Manage and Publish Privileges

You can modify the manage and publish privileges for a secured folder to which you have Manage privileges. The manage options you specify for a secured folder are applied to all objects in the folder.

For more information about manage privileges, see Manager Privileges.

You can also specify publish privileges to allow users to publish objects to the secured folder. Users with or without the manage privilege can be granted the publish privilege.

To modify Manage and Publish privileges for a secured folder

1. In the Web Console, click Home.
2. Select a secured folder to display folder details.
3. In the Folder Details pane, click Managers to open the Alter Visibility dialog.
4. In the Alter Visibility dialog, do the following:
   • Select the Manage check box for each user (or group) to which you want to grant Manage privileges.
   • Select the Publish check box for each user (or group) to which you want to grant Publish privileges.

Users with Manage privileges to a secured folder can do the following:

• Modify the folder's sharing (visibility), manage, and publish options
• Rename or delete the folder
• Create a subfolder

Users with Publish privileges to a secured folder can publish objects to the folder from Toad Data Point.