This chapter describes the Oracle WebCenter Content services available when using and customizing Folders services.
This chapter covers the following topics:
Folders is the name given to the current WebCenter Content feature that provides a hierarchical folder interface, similar to a conventional file system, for organizing and locating some or all of the content in the Content Server repository. This feature is supported by the FrameworkFolders component in WebCenter Content. For information about services used with the earlier version of Folders named Contribution Folders, supported by the Folders_g component in WebCenter Content, see Chapter 7.
Information about what is a WebCenter Content service and how services can be used is provided in Section 2, "Using Services." Information about basic services structure, attributes, actions, and a service example is provided in Section 3, "Customizing Services." You should be familiar with this information before customizing current services or creating new services
The locations for specific Folders services are listed within each individual service.
Note:
The most commonly used services have more extensive descriptions.
Individual Folders service types are noted in each service description. The following services are described in this section:
Service that is used to browse through the folder structure. It can be used to paginate through the folder structure in these browse modes:
Paging through folders and files separately (default behavior)
Paging through folders and files combined (must set doCombinedBrowse=true)
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
item: (Required if no fFolderGUID, no path, and no items are specified.) The item to browse. Specify in the form path:path to item or fFolderGUID is specified, fFolderGUID:GUID of item. Can be used in both browse modes.
items: (Required if no fFolderGUID, no path, and no item are specified.) The items to browse. Specify in the form of a comma-delinated list of identifiers in the form path:path to item or fFolderGUID:GUID of item. Can be used in both browse modes.
path: (Required if no lFolderGUID is specified.) The full path to the current folder. Can be used in both browse modes.
fFolderGUID: (Required if no path is specified.) Can be used instead of the path to reference the current folder. Can be used in both browse modes.
fldapp: Specifies the Folders Application of the location to which the user is browsing. Can be used in both browse modes.
doCombinedBrowse: (Integer) If set, performs the service in a combined pagination mode. Default is 0 (zero).
foldersFirst: (Integer) If set, lists folders before files in the combined pagination mode. Default is 1.
folderCount: (Integer) The number of folders to return. Default is 50. Can be used in separate browse modes.
folderStartRow: (Integer) The row number at which to start returning data. Used for pagination. Default is 0 (zero). Can be used in separate browse modes.
fileCount: (Integer) The number of files to return. Default is 50. Can be used in separate browse modes.
fileStartRow: (Integer) The row number at which to start returning data. Used for pagination. Default is 0 (zero). Can be used in separate browse modes.
combinedCount: (Integer) The number of items (folders plus files) to return. Default is 100. Can be used in combined browse modes.
combinedStartRow: (Integer) The row number at which to start returning data. Used for pagination. Default is 0 (zero). Can be used in combined browse modes.
doRetrieveTargetInfo: (Integer) If set, returns target folder's information for all shortcuts retrieved in the ChildTargetFolders ResultSet. Default is 0 (zero). Can be used in both browse modes.
doMarkFavorites: (Integer) If set, adds a fIsFavorite field in the ResultSet to indicate if the folder or file is favorite. It is a favorite if it has a shortcut in the Favorites folder. Default is 0 (zero). Can be used in both browse modes.
doRetrieveDocumentURL: (Integer) If set, adds a URL field in the files ResultSet that is the absolute Web location of the document. Default is 0 (zero). Can be used in both browse modes.
doRetrieveUniqueLinks: (Integer) If set, post processes the results to return only unique links. For example, if folder's shortcut and folder itself are in the ResultSet, only folder itself will be returned. Same for files. Default is 0 (zero). Can be used in both browse modes.
foldersFilterParams: The comma-delinated list of filter parameters for the browse. For example, foldersFilterParams=fIsContribution&fIsContribution=1 will return folders with fIsContribution=1. Can be used in both browse modes.
foldersFilterQuery: Standard query for filtering out the folders. This query is in DATABASE engine format in the FolderFolders table. For example, foldersFilterQuery=fFolderName<substring>`test`. Can be used in both browse modes.
filesFilterQuery: Standard query for filtering out the files. This query is in DATABASE engine format in the FolderFiles table. For example, filesFilterQuery=fFileName<substring>`test`. Can be used in both browse modes.
foldersSortField: Field name from the FolderFolders table on which to sort the records. Can be used in both browse modes.
foldersSortOrder: Specify Asc or Desc for an ascending or descending sort. Can be used in both browse modes.
$fieldName: The value for the specified field in the foldersFilterParams and filesFilterParams parameters. Can be used in both browse modes.
filesFilterParams: The comma-delinated list of filter parameters on the browse. For example, filesFilterParams=fOwner&fOwner=sysadmin will return folders with fOwner=sysadmin. Can be used in both browse modes.
filterFavorites: If set to Folders, this filters results to only include folders that are favorites. If set to Files, this filters only files that are favorites. If set to 1, this filters both folders and files that are favorites. By default, this filters none. Can be used in both browse modes.
filterFollows: If set to Folders, this filters results to only include folders that are followed. If set to Files, this filters only files that are followed. If set to 1, this filters both folders and files that are followed. By default, it filters none. Can be used in both browse modes.
ResultSets:
FolderInfo: Information about the folder the user is currently browsing.
ChildFolders: Information about all of the folders that exist within this particular folder.
ChildTargetFolders: Information about all of the target folders of shortcuts in the ChildFolders ResultSet.
ChildFiles: Information about all of the files that exist within this particular folder.
numFolders: (string) The number of folders in the ChildFolders ResultSet.
hasMoreChildFolders: (Boolean) This is true if the request did not return all of the child folders. This occurs when the folderCount value is reached and additional folders could have been returned.
numFiles: (Integer) The number of files in the ChildFiles ResultSet.
TotalChildFoldersCount: (Integer) The total number of items (folders and files) in the parent folder.
TotalChildFilesCount: (Integer) The total number of files in the parent folder.
TotalChildItemsCount: (Integer) The total number of items (folders and files) in the parent folder.
hasMoreChildFiles: (Boolean) This is true if the request did not return all of the child files. This occurs when the fileCount value is reached and additional documents could have been returned.
hasMoreChildItems: (Boolean) This is true if the request did not return all of the child items (folders and files). This occurs when count is reached and there are additional items that could have been returned.
Services that prepares a small pop-up containing a tree control which can be used to browse through the Folders structure and then select either documents or folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
target: The entity type the user is targeting with this pop-up. Can be set to file or folder depending on what the user is allowed to select.
ResultSets:
ChildFolders: The child folders of the root item.
ChildFiles: The child files of the root item. Will be null if the target is not set to file.
Service that allows a user to copy items from one location to another in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
destination: The destination to which all of the items will be copied. This identifier must be in the form path:$PATH'or fFolderGUID:$FOLDER_GUID.
item1: The item to be copied. If more than one item is being copied in this operation, you can specify item2, item3, and so forth. Specify these items either as IDs or as full paths. The items must be in the form of path:$PATH, fFolderGUID:$FOLDER_GUID, or fFileGUID:$FILE_GUID.
overwrite: Set to 1 to overwrite any destinations that already exist in the case of naming conflicts. Items that are overwritten are moved to the trash.
copyOwnerFilesToNewFiles: Set to 1 to copy all files of type owner to a new owner file. This action causes a new checkin to occur for each owner file being copied. By default, the copy of an owner file is a "soft" file that points to the source document.
copySoftFilesToNewFiles: Set to 1 to create new content items for all soft files being copied. By default, a copy of a soft file is another soft file pointing to the same content item.
constructDialog : Set this to 1 to make the server automatically construct an HTML dialog with the results of the copy action or information about why the copy action may have failed.
ResultSets:
ItemsRequiringOverwrite: If the overwrite flag is not set, and if any conflicting items exist in the destination, this ResultSet lists what conflicts exist. If there are any conflicts, none of the items are moved. This return allows for a quick server response on potential conflicts, enabling the client application to prompt the user for overwrite.
TaskList: Information about the tasks performed and which tasks were successful
didBackgroundTask: (string) Set this parameter to 1 if some or all of the task was backgrounded.
mainTasksComplete: (string) Set this parameter to 1 if the main tasks were completed, even if the service was backgrounded. It is useful to know that items have been copied, even if the post-copy checks have not yet finished.
dialogMarkup: (string) HTML for the dialog.
dialogScript: (string) JavaScript required to display the dialog.
Service that creates a link to a document in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fParentGUID: The GUID of the parent folder in which the new link will be created.
$fileMeta: Metadata to be assigned to the link.
A file name cannot start or end with a space.
A file name cannot be longer than 250 characters.
Restricted characters:
Restricted strings:
Service that displays a Folders form for creating a new link object which points to a document.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fParentGUID: The GUID of the parent folder in which the new link will be created.
fFileType: The type of link to create.
dDocName: The document name of the target of the link.
fApplication: The Folders Application creating the folder. The default is framework.
$fileMeta: Default metadata values for the link.
ResultSets:
ParentInfo: Information about the parent folder.
parentPath: (string) The full path to the parent folder.
Service that creates a folder in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fParentGUID: The GUID of the parent folder in which the new folder will be created.
$folderMeta: Metadata to be assigned to the folder.
A folder name cannot start or end with a space.
A folder name cannot be longer than 250 characters.
Restricted characters:
Restricted strings:
Service that displays a Folders form for creating new folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fParentGUID: The GUID of the parent folder in which the new folder will be created.
fApplication: The Folders Application creating the folder. The default is framework.
fFolderType: The type of folder to create. The default is owner.
$folderMeta: Default metadata values for the folder.
fTargetGUID: If the fFolderType value is soft, this must be the GUID of the target folder.
ResultSets:
ParentInfo: Information about the parent folder.
TargetInfo: Information about the target folder, if there is a target folder.
parentPath: (string) The full path to the parent folder.
targetPath: (string) The full path to the target, if there is a target.
Service that allows a user to delete one or more items from the Framerwork Folders hierarchy. This immediately deletes the items, even if the items are not already in the trash.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
item1: The item to be deleted. If more than one item is being deleted in this operation, then you can specify item2, item3, and so on. These items can be specified either as IDs or as full paths, and they must be specified in one of these forms:
path:$PATH
fFolderGUID:$FOLDER_GUID
fFileGUID:$FILE_GUID
constructDialog: (Boolean) Set this parameter to 1 if you want the server to automatically construct an HTML dialog with the results of the FLD_DELETE operation or information about why the operation may have failed.
ResultSets:
TaskList: Information about the tasks performed and which were successful.
didBackgroundTask: (Boolean) Set to 1 if some or all of the task was backgrounded.
dialogMarkup: (string) HTML for the dialog.
dialogScript: (string) JavaScript necessary to display the dialog.
mainTasksComplete: (Boolean) Set to 1 if the main tasks were completed, even if the service was backgrounded. It is useful to know that items have been deleted, even if the post-delete checks have not yet finished.
Service that edits a link to a document in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fFileGUID: The ID of the link being edited.
$fileMeta: Metadata to be assigned to the link being edited.
Service that displays a form for editing links to documents in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fFileGUID: The GUID of the link being edited.
$fileMeta: Metadata values currently assigned to the link being edited.
folderPath: (string) The full path to the link being edited.
Service that edits a folder in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fFolderGUID: The ID of the folder being edited.
$folderMeta: Metadata to be assigned to the folder being edited.
Service that displays a form for editing folders in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fFolderGUID: The GUID of the folder being edited.
ResultSets:
$folderMeta: Metadata values currently assigned to the folder being edited.
folderPath: (string) The full path to the folder being edited.
targetPath: (string) The full path to the target if the folder being edited is a shortcut.
TargetInfo: Information about the target if the folder being edited is a shortcut.
Service that edits metadata rules assigned to a folder in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fFolderGUID: The GUID of the folder being edited.
$fieldName: The value for the specified field.
$fieldName:isDefault: (Boolean) Set to 1 if the specified field is forced upon all children of the folder being edited.
$fieldName:isForced: (Boolean) Set to 1 if the specified field is forced upon all children of the folder being edited.
$fieldName:isRecursiveForced: (Boolean) Set to 1 if the specified field is forced upon all children of the folder being edited and upon its children's children.
$fieldName:inhibitPropagation: (Boolean) Set to 1 if the specified field can be propagated to children of the folder being edited.
Service that displays a form for editing content metadata defaults assigned to a folder. in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fFolderGUID: The GUID of the folder being edited.
ResultSets:
FolderInfo: Information about the folder that was edited.
$fieldName: (string) The value for the specified field.
$fieldName:isDefault: (Boolean) Set to 1 if the specified field has a default value associated with it.
$fieldName:isForced: (Boolean) Set to 1 if the specified field is forced upon all children of the folder.
$fieldName:isRecursiveForced: (Boolean) Set to 1 if the specified field is forced upon all children of the folder and upon its children's children.
$fieldName:inhibitPropagation: (Boolean) Set to 1 if the specified field can be propagated to children of the folder.
folderPath: (string) The full path to the folder.
dpTriggerField: (string) The profile trigger field, if one exists.
dpTriggerValue: (string) The current profile trigger value, if one exists.
dpDisplayLabel: (string) The current profile display label, if one exists.
Service that displays a dialog for migrating Folders_g legacy folder data into FrameworkFolders data structures. A history of migrations and status of any ongoing migration is displayed.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
Service that search for folders in Folders and returns the result.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
QueryTest: The text of the search query.
SortField: The field on which to sort the search results.
SortOrder: The order in which to sort the search results. Use one of these:
asc
desc
ResultSets:
SEARCH_RESULTS: The results of the search.
Service that displays a form for searching folders in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
Service that displays a dialog for choosing a destination during a move or copy operation in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
action: Set to move or copy depending on the action being performed.
item1: The item to be copied. If more than one item is being touched in this operation, then item5, item3, and so on can be specified. These items can be specified either as IDs or as full paths, and they must be in the form of one of these:
path:$PATH
fFolderGUID:$FOLDER_GUID
fFileGUID:$FILE_GUID
dialogMarkup: (string) HTML for the dialog.
dialogScript: (string) JavaScript required to display the dialog.
Service that displays a dialog for creating a link to an existing content item in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fParentGUID: The GUID of the folder in which to create the link. Either this or dDocName must be set.
dDocName: The target document of the new link. Either this or fParentGUID must be set.
fFileName: The type of link to create.
dialogMarkup: (string) HTML for the dialog.
dialogScript: (string) JavaScript required to display the dialog.
Service that displays a dialog for creating a shortcut to an existing folder in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fTargetGUID: The target document ID of the shortcut.
fParentGUID: The parent folder ID where the shortcut will be created.
dialogMarkup: (string) HTML for the dialog.
dialogScript: (string) JavaScript required to display the dialog.
Service that retrieves a dialog used to rename a file in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fFileGUID: The GUID of the file to rename.
dialogMarkup: (string) HTML for the dialog.
dialogScript: (string) JavaScript required to display the dialog.
Service that retrieves a dialog used to rename a folder in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fFolderGUID: The GUID of the folder to rename.
dialogMarkup: (string) HTML for the dialog.
dialogScript: (string) JavaScript required to display the dialog.
Service that returns information about a particular folder or file in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
path: The path to the folder or file whose information is being requested. This parameter must be specified if no fFolderGUID or fFileGUID parameter is specified.
fFolderGUID: The GUID of the folder whose information is being requested. This parameter must be specified if no path or fFileGUID parameter is specified.
fFileGUID: The GUID of the file whose information is being requested. This parameter must be specified if no path or fFolderGUID parameter is specified.
ResultSets:
FileInfo: Information about the link to the document (file). Also the metadata associated with the document itself.
FolderInfo: Information about the folder.
TargetInfo: Information about the target (shortcut).
filePath: (string) The full path to the item if the item is a document link.
folderPath: (string) The full path to the item if the item is a folder.
targetPath: (string) The full path to the target item if the item is a shortcut.
Service that loads all soft links which reference a particular content item in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
dDocName: The name of the content item.
dID: The identifier for the content item.
constructSoftLinkTableRows: (Boolean) Whether or not to construct HTML for the soft link table rows. The default is 1 (true).
ResultSets:
softLinks: The soft links for the content item.
softLinkTableRows: (string) HTML to display the soft link table rows.
Service that migrates Folders_g legacy folder data into FrameworkFolders data structures.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
Service that moves one or more content items from one location to another in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
destination: The destination where all of the items should be moved. If the destination is an existing folder, then all of the items being moved will be moved into that folder. If you are moving a single file, the destination may point to the location (including the new filename) where the file should be moved. This identifier should be in the form path:$PATH or fFolderGUID:$FOLDER_GUID.
item1: The item to be moved. If more than one item is being moved in this operation, the item2, item3, and so on can be specified. These items can be specified either as IDs or as full paths. They must be in one of the following forms:
path:$PATH
fFolderGUID:$FOLDER_GUID
fFileGUID:$FILE_GUID
overwrite: (Boolean) Set to 1 to overwrite any destinations that already exist in the case of naming conflicts. Items that are overwritten are moved to the trash.
constructDialog: (Boolean) Set to 1 to make the server automatically construct an HTML dialog with the results of the move operation or information about why the move may have failed.
ResultSets:
ItemsRequiringOverwrite: If the overwrite flag is not set, and if any conflicting items exist in the destination, this ResultSet is returned listing which conflicts exist. If there are any conflicts, none of the items are moved. This allows for a quick server response on potential conflicts, and allows the client application to prompt the user for overwrite.
TaskList: Information about the tasks performed and which were successful.
dialogMarkup: (string) HTML for the dialog.
dialogScript: (string) JavaScript required to display the dialog.
didBackgroundTask: (string) This is set to 1 if some or all of the task was backgrounded.
mainTasksComplete: (string) This is set to 1 if the main tasks were completed, even if the service was backgrounded. It is useful to know that items have been moved, even if the post move sanity check has not yet finished.
Service that provides information so a requesting client can determine if a metadata entry dialog should be presented to a user before checking in a content item.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fFolderGUID: The base folder ID for items in CONTENTS. This parameter must be used if fFolderPATH is not set.
fFolderPath: The base folder path for items in CONTENTS. This parameter must be used if fFolderGUID is not set.
CONTENTS: (ResultSet) Set of paths for folders and content items relative to the base folder. If the specified path ends with a "/" (slash) character, the path is assumed to be a folder, otherwise it is assumed to be a content item.
EXTRA_INFO_FIELDS: (ResultSet) A list of extra information fields to be returned for each item. Extra information field data is only populated for content items that already exist. Valid fields that can be requested are any of the columns from the REVISIONS, DOCMETA or DOCUMENTS tables as well as these fields (as in WebDAV): getcontentlength, getcontenttype, getlastmodified, creationdate.
allowPromptForExistingItem: (Boolean) If set to 1, enables client requests to allow prompting for second revisions. Normally prompts occurs only for first revisions.
ResultSet: REQUIRES_METADATA_PROMPT: For each row in CONTENTS, this returned ResultSet contains these fields:
FLAG field: Two flag characters: {flag1}{flag2}. For flag1, if set to 1 the specified path already exists, otherwise it does not. For flag2, if set to 1 the client is directed to present a prompt dialog for entering metadata for this item.
DP_TRIGGER_VALUE: The document profile that was used for this item. It shows one column for each field specified in the EXTRA_INFO_FIELDS parameter.
Service that propagates metadata down through the folder structure in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
$fieldName:isSelected: Set to 1 to propagate the specified field.
$fieldName: The value of the field to propagate
propagateThroughSoftLinks: (Boolean) Set to 1 to propagate metadata to documents pointed to by soft links.
Service that displays a form to allow people to propagate metadata to all children of a folder in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fFolderGUID: The ID of the folder.
ResultSets:
FolderInfo: Information about the folder.
folderPath: The full path to the folder.
$fieldName: The default value of the field to propagate. This value is taken from metadata rules or the metadata of the folder itself.
dpTriggerField: The profile trigger field, if one exists.
Service that reindexes all currently indexed documents within a particular folder in Folders. Only a system administrator can call this service.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
fFolderGUID: The GUID of the folder.
Service that enables easy pagination of child documents returned by the FLD_BROWSE service in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
path: The full path to the current folder. This parameter must be used if no folderGUID parameter is specified.
fFolderGUID: The GUID of the folder. This parameter an be specified instead of the path to reference the current folder.
fldapp: The Folders Application of the location to be browsed.
folderCount: The number of folders to return. The default is 50.
folderStartRow: The row number at which to start returning data. Used for paging responses. The default is 0.
constructListingMarkup: Specify whether or not the markup for the additional folders should be returned. This parameter is useful when performing this request in an AJAX environment. The default is 1 (true).
ResultSets:
FolderInfo: Information about the folder currently being browsed.
ChildFolders: Information about all of the folders that exist within this particular folder.
FileListingHTML: HTML that can be used to display the additional documents. Only returned when constructListingMarkup is set to 1 (true).
FileListingScript: JavaScript that must be run to display the additional documents. Only returned when constructListingMarkup is set to 1 (true).
numFolders: The number of folders in the ChildFolders ResultSet.
hasMoreChildFiles: This is 1 (true) if the request did not return all of the child files. This occurs when fileCount is reached and there are additional documents that could have been returned.
Service that enables easy pagination of child folders returned by the FLD_BROWSE service in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
path: The full path to the current folder. This parameter must be used if no folderGUID parameter is specified.
fFolderGUID: The GUID of the folder. This parameter an be specified instead of the path to reference the current folder.
fldapp: The Folders Application of the location to be browsed.
folderCount: The number of folders to return. The default is 50.
folderStartRow: The row number at which to start returning data. Used for paging responses. The default is 0.
constructListingMarkup: Specify whether or not the markup for the additional folders should be returned. This parameter is useful when performing this request in an AJAX environment. The default is 1 (true).
ResultSets:
FolderInfo: Information about the folder currently being browsed.
ChildFolders: Information about all of the folders that exist within this particular folder.
FolderListingHTML: HTML that can be used to display the additional folders. Only returned when constructListingMarkup is set to 1 (true).
FolderListingScript: JavaScript that must be run to display the additional folders. Only returned when constructListingMarkup is set to 1 (true).
numFolders: The number of folders in the ChildFolders ResultSet.
hasMoreChildFolders: This is 1 (true) if the request did not return all of the child folders. This occurs when fileCount is reached and there are additional folders that could have been returned.
Service that allows a user to subscribe to a folder. The subscription notification is sent to the user's e-mail as specified in the profile. If neither the profile e-mail address or the dSubscriptionEmail setting is provided, Content Server sets the flag isNoSubscriptionNotificationSent=1 in the response binder.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/resources/frameworkfolders_service.htm
fParentGUID: The ID of the folder to which the user will subscribe.
dSubscriptionEmail: The subscriber's e-mail address. If a non-empty value is provided, the service uses the value to update the user's e-mail value in the profile.
constructDialog: (boolean) Set this to 1 (true) if you want Content Server to automatically construct an HTML dialog with the results of the subscription or information about why the subscription may have failed.
dialogMarkup: HTML for the dialog.
dialogScript: JavaScript needed to display the dialog.
Service that tests the capability of a user to perform an operation on a document, folder, or library, based on:
user's authorization
item's access control policy
item's state
enabled WebCenter Content components
Service Class: intradoc.folders.FoldersServices
Location: IdcHomeDir/resources/frameworkfolders_service.htm
testedItems: A list of items to be tested. The type and ID of each item should be specified in the string testedItems with the format Type1:ID1,Type2:ID2,Type3:ID3
Type is:
fFolderGUID for Folder
fFileGUID for File
dDocName for Document
dID for Document Revision
ID is the value of those fields.
For example:
fFolderGUID:folder001,dDocName:doc001,fFolderGUID:folder002, fFileGUID:file001,dID:docRevision001
testedCapabilities: A list of capabilities separated by a comma; for example, MOVE,COPY,DELETE. The full list of all capabilities that can be tested is:
CREATE_CHILD_FOLDER
CREATE_CHILD_DOCUMENT
FILE_DOCUMENT
UNFILE_DOCUMENT
UPDATE_METADATA
UPDATE_ACCESS_CONTROL
LATEST_REVISION
MOVE
COPY
DELETE
PROPAGATE_METADATA
CHECK_OUT
CANCEL_CHECK_OUT
CHECK_IN_NEW_REVISION
DELETE_REVISION
RESTORE_REVISION
SHARE_PERSONAL_FOLDER
FOLLOW
UNFOLLOW
Capabilities Supported for Testing
| Capability | Folder owner link (fFolderGUID) | Folder soft link (fFolderGUID) | File owner link (fFileGUID) | File soft link (fFileGUID) | Document (dDocName) | Revision (dID) | Description |
|---|---|---|---|---|---|---|---|
|
CREATE_CHILD_FOLDER |
TEST |
Can the user create a new subfolder in this folder? |
|||||
|
CREATE_CHILD_DOCUMENT |
TEST |
Can the user create a new document in this folder. |
|||||
|
FILE_DOCUMENT |
TEST |
Can the user create an owner link to this document? |
|||||
|
UNFILE_DOCUMENT |
TEST |
TEST(2) |
Can the user delete this owner link (without deleting the document)? |
||||
|
UPDATE_METADATA |
TEST |
TEST |
TEST |
TEST |
TEST |
Can the user update the metadata of this item? |
|
|
UPDATE_ACCESS_CONTROL |
TEST |
TEST |
Can the user change the access control fields of this folder or file? |
||||
|
LATEST_REVISION |
TEST |
Is this the latest revision of the document? |
|||||
|
MOVE |
TEST |
TEST |
TEST |
TEST |
TEST(2) |
Can the user move this folder, document, or shortcut? |
|
|
COPY |
TEST |
TEST |
TEST |
TEST |
TEST(2) |
Can the user copy this folder, document, or shortcut? |
|
|
DELETE |
TEST |
TEST |
TEST(1) |
TEST |
TEST |
Can the user delete this folder, document, or shortcut? |
|
|
PROPAGATE_METADATA |
TEST |
Can the user propagate the metadata fields of this folder? It returns false for personal library/folders (LibraryType=4). |
|||||
|
CHECK_OUT |
TEST |
Can the user check out this document? It returns false for documents in personal library/folder. |
|||||
|
CANCEL_CHECK_OUT |
TEST |
Can the user cancel the check out of this document? |
|||||
|
CHECK_IN_NEW_REVISION |
TEST |
Can the user check in a new revision of this document? It returns TRUE for a document that is checked out by the current user, or is not checked out and the user has permissions to do an auto-checkout and checkin cycle. |
|||||
|
DELETE_REVISION |
TEST |
Can the user delete this revision of this document? |
|||||
|
RESTORE_REVISION |
TEST |
Can the user create a new revision of this document as a copy of this revision? |
|||||
|
SHARE_PERSONAL_FOLDER |
TEST(3) |
Can the user share this personal library or personal folder? |
|||||
|
FOLLOW |
TEST |
TEST |
Can the user follow this folder, document, or revision? A document or folder is considered "followed" if it is subscribed to directly. |
||||
|
UNFOLLOW |
TEST |
TEST |
Can the user "unfollow" this folder, document, or revision? |
(1) Equivalent to testing DELETE on the target Revision.
(2) Need to be able to test capabilities without knowing the fFileGUID.
(3) A personal library or personal folder can be shared only if each of the following conditions hold: (a) the ancestor personal library is not shared (for a personal folder); (b) no ancestor personal folder is shared (for a personal folder); and (c) no descendant personal folder is shared. If one or more of these conditions is not true, the user does not have the capability, and the FLD_TEST_USER_CAPABILITIES service should return the fFolderGUIDs of the library or folder that prevent the personal library or folder from being shared.
ResultSet:
TestResults: The test results in which:
"1" means "True" and the current user has the capability
"0" means "False"
"-1" means "N/A" (not applicable)
a string of shared ancestor/descendant folders will be returned for the failed test of the SHARE_PERSONAL_FOLDER capability because of existing shared ancestor/descendants
if SHARE_PERSONAL_FOLDER fails because the user doesn't have the share permission on the item, the service returns "0"
Service that allows a user to unsubscribe a folder.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/resources/frameworkfolders_service.htm
fParentGUID: The ID of the folder to be unsubscribed.
constructDialog: (boolean) Set this to 1 (true) to have Content Server automatically construct an HTML dialog with the results of the unsubscription or information about why the unsubscription may have failed.
dialogMarkup: HTML for the dialog.
dialogScript: JavaScript needed to display the dialog.
Service that allows a user to unfile one or more items from the Folders hierarchy. This immediately deletes the link object without affecting the target document in any way.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/components/frameworkfolders/resources/frameworkfolders_service.htm
item1: The item to be unfiled. If more than one item is being unfiled in this operation, then item2, item3, and so on can be specified. These items can be specified either as IDs or as full paths. They must be in the form of path:$PATH or fFileGUID:$FILE_GUID.
constructDialog: Set this to 1 if you want the server to automatically construct an HTML dialog with the results of the unfile or information about why the unfile may have failed.
ResultSets:
TaskList: Information about the tasks performed and which were successful.
didBackgroundTask: This is set to 1 if some or all of the task was backgrounded.
mainTasksComplete: This is set to 1 if the main tasks were completed, even if parts of the service were backgrounded. It is useful to know that items have been unfiled, even if the post unfile checks have not yet finished.
dialogMarkup: HTML for the dialog.
dialogScript: JavaScript required to display the dialog.