Create Folder

this method will create a new folder in box and optionally set an enterprise metadata template and metadata values input parameters parent folder id id of the parent folder to create the new folder within the newly created folder will be a child/leaf of this folder folder name name of the new folder conflict behaviour if a folder with the same name already exists in the parent folder, this setting determines how trex should handle reconciling this use existing keep the existing folder and continue normal processing (no error surfaced) use existing overwrite metadata keep the existing folder but update any metadata values (if provided) append unique id this will append a uniquely generated id string to the folder name fail the upload will fail and the box error will be returned cascade conflict policy if a cascade policy already exists on the folder, this setting determines how trex should handle reconciling see 'setting metadata values' in the following section on how to set the cascade policy overwrite existing overwrite the cascade policy with the new value keep existing keep the existing cascading policy setting metadata values note trex only supports setting a single enterprise metadata template and values during create folder to add additional metadata templates and values to the document, use the 'update folder' method after the 'create folder' method metadata values these are the values for either enterprise metadata (defined in a metadata template) or global metadata (string value pairs directly attributed to a document) click on the pencil icon in the top right to edit the definition of metadata drag an 'available parameter' from the available parameters to the middle section called 'defined parameters' there are four types of parameters description this allows the setting of the description on the document no additional configuration/naming is required the name should be left as 'description' and the datatype left as 'string' enable cascade on turns on cascading of metadata from the folder to any children contained within the string list provided should be configured with the names of the enterprise templates to turn on the cascade feature enterprise metadata value this allows setting of enterprise metadata that is defined on a pre defined metadata template name this is required to be the name of the metadata value defined in box it will include the metadata template name that it is assoicated with (e g trexmetadata trextextfield) data type the type value assigned in the box metadata definition global metadata value this allows the setting of key/value pair strings to be added to a document name this should match the metadata value of a custom attribute already defined on the document it will always be prefixed with the value 'document' followed by the name of the box value (e g document trexmycustomstring)