Advanced Options for Pasting Objects

17-24 System Administrators Guide for Oracle Business Intelligence Enterprise Edition ■ Additional Users and Application Roles — Shows the users, groups, and application roles that have access granted through group inheritance, and users, groups, and application roles that have no access to the request. For details on how permissions and privileges are assigned in Presentation Services, see Managing Security for Dashboards and Analyses in Oracle Fusion Middleware Security Guide for Oracle Business Intelligence Enterprise Edition. 4. If the user, group, or application role whose permissions you want to set is in the Additional Users and Application Roles list, then move it into the Users, Catalog Groups and Application Roles Explicit Permissions list by selecting it and clicking the left-arrow button . 5. Optional To filter the users, groups, and application roles displayed in the Additional Users and Application Roles list, use the List button and the adjacent field, as follows: ■ Enter filter criteria in the field next to the List button case insensitive to search by name. To enter partial filter criteria, use the asterisk symbol. For example, enter bi to display users or groups beginning with bi, BI, bI, and Bi. ■ Select a value from the list, to restrict what accounts to search for. Available values are: All, User, Catalog Group, or Application Role.

6. Select the user or group in the Users, Catalog Groups and Application Roles

Explicit Permissions list.

7. Select a new permission from the list in the Permissions column, or click Custom

from the list to display the Custom Permissions dialog, where you can select a combination of permissions. For details on what each permission means, see Permission Definitions in Oracle Fusion Middleware Users Guide for Oracle Business Intelligence Enterprise Edition.

8. Select the Apply Recursively option to apply the changes to all the objects that the

object contains.

9. Select a value from the Replace Option list as follows:

■ Replace All — Replaces the existing ACL with what is currently in the dialog. ■ Replace Listed — Changes only the accounts currently displayed in the dialog and leaves others unchanged. ■ Remove Listed — Removes only the accounts currently displayed and leaves others unchanged.

10. Click OK.

See Oracle Fusion Middleware Security Guide for Oracle Business Intelligence Enterprise Edition for more information about permissions and groups and users. Note: If you move a user or group from the Users and groups Explicit Permissions list to the Additional Users and Application Roles list, then the user or group privileges are reset to No Access. To move a user or group from one list to another, highlight it and click the right or left-arrow button, as appropriate. Configuring and Managing the Oracle BI Presentation Catalog 17-25

17.6.6 Previewing Objects from Catalog Manager

You can preview objects, such as analyses or prompts, from Catalog Manager in online mode. If you are going to preview objects from Catalog Manager, then you must identify the default browser in which to display these objects. To set the browser preference: 1. In Catalog Manager, from the Tools menu, select Preferences. 2. In the Select Web Browser to use for report previews field, select the browser that is the same one that you have set to be the default browser for your operating system. You can click the Browse button in which you can select the executable file for the appropriate browser.

3. Click OK.

To preview an object: 1. In Catalog Manager, open the catalog in online mode.

2. Navigate to the object.

3. Right-click the object in the Name list and select Preview.

17.6.7 Working with Tenants

Catalog Manager provides options for provisioning and unprovisioning tenants. This section includes the following topics: ■ Section 17.6.7.1, What Happens When Tenants are Provisioned? ■ Section 17.6.7.2, What Options are Available for Provisioning? ■ Section 17.6.7.3, How is Multi-Tenancy Enabled? 17.6.7.1 What Happens When Tenants are Provisioned? For example, you can provision certain companies if they sign a contract with your organization. Suppose that TenantA is provisioned. A copy of the shared directory is included in the tenantsTenantAshared directory, and the home directories for TenantAs users are included in the tenantsTenantAusers directory. These inclusions are completely transparent to the TenantA users. They continue to see their objects stored as if they are in the shared and users directories. 17.6.7.2 What Options are Available for Provisioning? You can use either menu options or the command line to provision tenants. From the Tools menu in Catalog Manager, select Multi-Tenancy, then either Provision Tenant or Unprovision Tenant. You can also use the provisionTenant command. The syntax is as follows: runcat.cmdruncat.sh -cmd provisionTenant -offline catalog-path-name -tenants tenant-ID The following is a sample command on Windows: runcat.cmd -cmd provisionTenant -offline C:\Oracle\Middleware\instances\instance1\bifoundation\OracleBIPr esentationServicesComponent\coreapplication_ obips1\catalog\SampleAppLite -tenants 49431843829925000:49431843829924000 17-26 System Administrators Guide for Oracle Business Intelligence Enterprise Edition 17.6.7.3 How is Multi-Tenancy Enabled? To enable the options for multi-tenancy, you must include the appropriate element in the instanceconfig.xml file, as described in the following procedure. To enable the use of multi-tenancy: 1. Open the instanceconfig.xml file for editing, as described in Section 3.6, Where Are Configuration Files Located?

2. Locate the section in which you must add the EnableMultiTenancy element.

The EnableMultiTenancy element is set to false by default. If you do not set it to true, then the options for multi-tenancy are not available.

3. Include the element and its ancestor elements as appropriate, as shown in the

following example: ps:Catalog ps:EnableMultiTenancytrueps:EnableMultiTenancy ps:Catalog 4. Save your changes and close the file. 5. Restart Oracle Business Intelligence.

17.7 Viewing and Editing Catalog Objects in XML

Catalog Manager provides the ability to view and to edit the XML description of catalog objects such as analyses, dashboards, filters, and so on. While viewing the XML code is acceptable, editing the code is not recommended. To view the XML description of an object: 1. In Catalog Manager, open the catalog.

2. Navigate to the object.

3. Right-click the object in the Name column and select Properties.

4. Click Edit XML.

5. When you have finished viewing the XML definition, click Cancel.

6. Click OK in the Properties dialog.

Figure 17–3 shows sample XML code in Catalog Manager for an object. Caution: If you edit the XML code, then you change the representation of the object in the catalog. Editing the XML code for catalog objects in any directory is not recommended and can produce unexpected results. Configuring and Managing the Oracle BI Presentation Catalog 17-27 Figure 17–3 Sample XML Code for an Object To edit the XML description of an object, which is not recommended: 1. In Catalog Manager, open the catalog.

2. Navigate to the object.

3. Right-click the object in the Name column and select Properties.

4. Click Edit XML, then Edit.

5. Make the changes in the Object XML area.

6. Click OK in the Edit XML dialog.

7. Click OK in the Properties dialog.

Note: When you edit the XML description of an object, the catalog checks only that the XML is well-formed; it does not check for any other errors.