The following sections describe the services available when using and customizing Folders services.
Information about what is an Oracle WebCenter Content (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 Folders structure.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/resources/frameworkfolders_service.htm
path: Required if no lFolderGUID is specified. The full path to the current folder.
fFolderGUID: Required if no path is specified. Can be used instead of the path to reference the current folder.
fldapp: Specifies the Folders Application of the location to which the user is browsing.
folderCount: The number of folders to return. The default value is 50.
folderStartRow: The row number at which to start returning data. Used for pagination. The default value is 0.
fileCount: The number of files to return. The default value is 50
fileStartRow: The row number at which to start returning data. Used for pagination. The default value is 0.
ResultSets:
FolderInfo: Information about the folder the user is currently browsing.
ChildFolders: Information about all of the folders that exist within this particular folder.
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.
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.
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/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/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/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.
Service that displays a Folders form for creating a new link object which points to a document.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/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/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.
Service that displays a Folders form for creating new folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/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.
Result Sets:
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/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/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/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/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/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/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/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 search for folders in Folders and returns the result.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/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/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/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/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/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 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/folders_g/resources/folders_service.htm
Service that retrieves a dialog used to rename a file in Folders.
Service Class: intradoc.folders.FoldersService
Location: IdcHomeDir/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/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/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/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/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/resources/frameworkfolders_service.htm
desination: 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/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/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/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/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/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/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 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/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.