Oracle Web Services On Demand Guide > Web Services On Demand API Calls > Administrative Services API Calls >

ReportFolderUpsert

Updates or inserts role and access level information for a shared folder.

Usage

Use the ReportFolderUpsert method to insert or update role and access level information for a shared folder. The Manage Content privilege is required.

ReportFolderUpsert can insert or update only the role and access level data for a report folder. It is not possible to insert or update any other report folder data. For upsert requests, <Path> is required and its value always begins with /shared/Company Analyses/.

The root folder is read-only, so it not possible to do upserts for the root folder.

The apdata:ReportFolder argument contains the following elements containing report folder data:

• Path. The path of the folder (required).
• FolderName. The name of the folder.
• ParentFolder. The parent folder. If the folder is created directly in the company-wide shared folder, then the name of the parent folder is Company Analyses.
• Description. A description of the folder.
• ListOfSubFolders. The subfolders:
  • Path. The path of the folder.
  • FolderName. The name of the subfolder, which always begins with /shared/Company Analyses/.
  • Description. A description of the subfolder.
• ListOfAssociatedRoles. The role data:
  • RoleName. The name of the role.
  • AccessLevel. The access level: Read or Change/Delete.

Arguments

Table 150 describes the arguments taken by the ReportFolderUpsert method.

Return Value of the Call

The status is returned.