Case Folder
The Case Folder view displays documents and folders that are pertaining to the case
instance in the target object store. If you are authorized, then you can search, create, delete, and
rename folders. You can also upload, view, check out, and remove documents.
You can configure the Case Folder view so that users can add, view, or delete individual folders,
and add, view, check out, download, and remove documents. The Case Folder view uses services to use
these functions.
- When you open a coach that contains a Case Folder instance, the instance displays the contents of its case root folder as specified by the configuration options. This root folder is named Documents. However, the Case Folder displays this name in a breadcrumb trail when you are browsing one of its subfolders. The root folder for a Case Folder instance is specific to that instance. The root folder for the Case Folder is specified directly by binding the input variables caseId and tosName to the respective configuration options.
When Case Folder view is used in the context of the process user task page, the view configures itself based on the parent case, without specifying the Case identifier and target object store name in the view’s configuration.
Configuration properties
Set or modify configuration properties for the view in the Configuration
properties tab.
Property | Description | Data type |
---|---|---|
Case Identifier | The Case Identifier is a mandatory option that needs to be bound to the input variable caseId. | String |
Target Object Store Name | The target object store name is a mandatory option that needs to be bound to the input variable tosName. | String |
Edit title | Allows to edit the title of this view. | Any |
Hide title | Allows to hide the title as an option. | Any |
Get Repository Name Service | Service to retrieve the repository name that is associated to the case instance. | String |
- Additional resources
- For more information about how to create a coach or page, see Building coaches.
For more information about standard properties (General, Configuration, Positioning, Visibility, and HTML Attributes), see View properties. For other UI views, see UI toolkit.
Events
The Case Folder view has an event handler On Document Clicked, which is prefilled with an event action to help in previewing the documents if the document can be viewed in a browser. Otherwise, it would allow the document content to be downloaded.
Note:
- To view documents in the Document Explorer view for upgraded solution by using custom view,
update the
On custom view
event of the Document Explorer view with the following script:
var isCaseClient = ${GetIsCaseClient}.getValue();
if(isCaseClient == true) {
// This would open the document in Navigator viewer only for Case Client.
var docObject = {};
var frameURL= null;
var CaseClientTabID = null;
if(doc.id.includes("idd_")){
docObject.id = doc.id.split("_")[1];
}
frameURL=window.location.href;
if(frameURL.includes('tw.local.caseDetailsClientTabID')){
windowURL= frameURL.split('&tw.local.caseDetailsClientTabID=');
caseClientTabID= windowURL[1].split('&');
docObject.pageId = caseClientTabID[0];
}
docObject.caseAction = "documentClicked";
this.context.broadcastMessage (docObject);
}
else {
// This would open the document in native browser for browser supported mime types
window.open(doc.url, '_blank')
}
- If a process page containing Document explorer view is accessed from Case Client, then the
following script needs to be updated to the
On custom view
event:
var docObject = {};
var frameURL= null;
var zTaskId = null;
if(doc.id.includes("idd_")){
docObject.id = doc.id.split("_")[1];
}
frameURL=window.location.href;
if(frameURL.includes('zTaskId')){
windowURL= frameURL.split('&zTaskId=');
zTaskId= windowURL[1].split('&');
docObject.taskId = zTaskId[0];
}
docObject.taskAction = "documentClicked";
this.context.broadcastMessage (docObject);
- If a process page containing Document explorer view is accessed from Workplace, then the
following script needs to be updated to the
On custom view
event:
window.open(doc.url, '_blank');
Restriction:
Document management security has been enhanced so that only documents of specified MIME types are allowed to be uploaded. To know the default MIME types supported and to add more MIME types, see Configuring document management security.