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 and to access migrated company wide shared folders, the Access Migrated Company Wide Shared Folder 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 user keys for upsert operations are:

<Path>

<Path> + <Catalog>

If the <Catalog> element is not specified, and if multiple folders are found that match the value in the <Path> element, then an error is returned.

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

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

• Catalog. The catalog version of the folder. Possible values are: V2 and V3.

  NOTE:  Depending on how your company instance is set up, your company might not have access to the V3 catalog.

• 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:
  • Catalog. The catalog version of the folder. Possible values are: V2 and V3.
  • 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 156 describes the arguments taken by the ReportFolderUpsert method.

Return Value of the Call

The status is returned.