Oracle CRM On Demand Documentation Library: Role Associations for Report Folders

Users can store the reports that they create in report folders. Report folders can be created in a user's personal area and in the company wide shared folders, including the Company Wide Shared Folder for the V2 catalog, the Company Wide Shared Folder for the V3 catalog, and the Migrated Company Wide Shared Folder for the V3 catalog. You can limit access to the subfolders in the company wide shared folders by associating roles with the subfolders. After you associate one or more roles with a folder, only users with those roles can access the folder. If no role is associated with a folder, then all users have access to the folder by default. A subfolder automatically inherits the role associations of its parent folder, but you can change the role associations for the subfolder. For more information about setting up report folders, see Oracle CRM On Demand Online Help.

You can use the Oracle Migration Tool On Demand client to extract and update the associations between roles and existing folders in the company wide shared folders. However, you cannot use the Oracle Migration Tool On Demand client to create report folders or subfolders.

Table 73 describes the Oracle Migration Tool On Demand client commands used with role associations for report folders. These commands are case sensitive.

Table 73. Commands Used with Role Associations for Report Folders in Oracle Migration Tool On Demand
Command	Description
`Read ReportFolder` FolderPath	This command extracts the details of a specified folder and its role associations. The FolderPath parameter must specify the full path for the folder. The folder path for every folder in the company wide shared folders starts with /shared/Company Analyses, and this string must be included in the path. The extracted informaton includes the name of the folder's parent folder and the names of any subfolders.
ReadAll ReportFolder	This command extracts the details of all report folders and their role associations.
Upsert ReportFolder ReportFolderXML	This command updates the role associations for a report folder. NOTE: You cannot use the `Upsert` command to create new folders or subfolders. You can use the `Upsert` command only to add role associations and to set the access level for the roles.

Oracle Migration Tool On Demand Guide, Release 35		Copyright © 2017, Oracle and/or its affiliates. All rights reserved. Legal Notices.