DM_SetFolderName

Specifies the name of the Documentum folder where Datacap places the uploaded file on the Documentum system.

Syntax

bool DM_SetFolderName (StrParam)

Parameters

Repository folder where the file will be uploaded. Smart parameters are supported.

Returns

Always True.

Level

Any level.

Details

The name of the cabinet / folder that will hold the uploaded file. The path specification to the folder can be specified using a typical folder syntax separated by forward slashes, such as /folder/anotherfolder/finalfolder. Alternatively, the target folder can be specified by the object ID of the folder as defined in the repository, without any slashes.

This action does not confirm that the folder actually exists in the repository. If the specified content type is incorrect, the upload action will report the error. This action must be called prior to DM_UploadPage or DM_UploadDocument.

Example:
DM_SetFolderName("/folder1/folder2")
DM_SetContentType("tiff")
DM_SetObjectName("@ID")
DM_UploadPage()           

This example shows the folder path as it exists in the repository.

DM_SetFolderName("0c0022538000252d")
DM_SetContentType("tiff")
DM_SetObjectName("@ID")
DM_UploadPage()

This example uses the object ID of the destination folder in the repository.