IBMCM_CreateFolder

Syntax

bool IBMCM_CreateFolder(string itemType, string attribute, string attributeValue, 
bool hasParent)

Parameters

String itemtype: the item type (classification) that is used to create the IBM Content Manager folder. This parameter is required.

String attribute: the attribute name.

String attributeValue: the unique attribute value or folder ID.

bool hasParent: if True the new folder has a parent folder.

Parameters

If hasParent is False, the new folder is created without a parent folder and the action ignores the attribute and attributeValue parameters.

If hasParent is True, it is expected that this folder is the child of an existing folder and that the attribute and attributeValue parameters specify the parent folder.

If hasParent is True and both attribute and attributeValue are not provided, the parent folder is set to the most recently created folder.

If the folder ID is used in the attributeValue parameter, leave the attribute parameter empty ("").

Smart parameters are supported for the string parameters.

Returns

True, if the folder is successfully created. Otherwise, False. The action fails if the a folder with the specified attribute or ID is not found.

Level

All levels.

Details

Creates a folder in the IBM Content Manager repository. The IBMCM_SetAttributeValue action can be called following this action to set the attributes of the newly created folder.

Example:

IBMCM_CreateFolder("NOINDEX","","",False)

This example creates an IBM Content Manager folder that is based on the NOINDEX item type. The new folder has no parent and is placed in the root directory.

IBMCM_CreateFolder("NOINDEX","", 
“A1001001A14B04B12546D00215”, True)

This example creates an IBM Content Manager folder that is based on the NOINDEX item type. The folder is placed inside the parent folder with the ID "A1001001A14B04B12546D00215".

IBMCM_CreateFolder(@MyItemType,@MyAttribute, 
@MyAttributeValue,True)
IBMCM_SetAttributeValue("name,@BATCHID")

This example creates an IBM Content Manager folder that is based on the information that is stored in the smart parameter @ MyItemType. This folder is a child that is identified by the values from the batch level smart parameters @ MyAttribute, and @MyAttributeValue.

IBMCM_CreateFolder(@B.MyItemType,"","",False)
IBMCM_SetAttributeValue("Name,MyFolder1")
IBMCM_CreateFolder(@B.MyItemType,"","",True)
IBMCM_SetAttributeValue("Name,MyFolder2")

This example creates the folders "MyFolder1" and "MyFolder2" based on the type that is identified by @B.MyItemType.

The "MyFolder1" folder has no parent folder. The parent folder of "MyFolder2" is the "MyFolder1" folder.