createFolderByPath

createFolderByPath(options)

Method Description

This function allows you to create a new file in SharePoint.

Returns
DirectoryItem

Supported Script Types

SuiteScript 2.1
Server-side Scripts: User Event, Suitelet, RESTlet, Map/Reduce, Scheduled, Workflow Action

Limitations

None

Module

b4cd-file-api-lib.js
See notes on how to load this module: FileSync API for SuiteScript

Since

FileSync 0.5.2

Parameters

Note: The options parameter is a JavaScript object.

PropertyTypeRequiredDescriptionSince
options.folderName
stringrequiredThe name of the new Folder which we are creating. 0.5.2
options.parentFolderPath
stringrequiredThe path of the parent-folder for which the new folder will be created under. This value is generally retrieved by making a call to the getRecordFolderContents or the getFolderContentsById method.0.5.2
options.recordTypeConfigId

integer

required

Internal ID of the FileSync Record Type Configuration record (customrecord_b4cd_record_type_config).

0.5.2

Returns Directory Item

PropertyTypeDescriptionSince
DirectoryItem.name

string

The file or folder name

0.6.0

DirectoryItem.uniqueId
stringThe unique ID of the file or folder as assigned by the file hosting service. 0.6.0
DirectoryItem.type
stringPossible Values: "file", "folder"0.6.0
DirectoryItem.fileSize
integerFile size in bytes.0.6.0
DirectoryItem.apiUri
stringThe URI used to access the file or folder via the API. 0.6.0
DirectoryItem.filePath
stringThe relative file or folder path on the file hosting service starting from the base directory. 0.6.0
DirectoryItem.uri
stringThe user-navigable URI for the folder or file on the file hosting platform. This can be used to construct hyperlinks for users to reach the file or folder externally. 0.6.0
DirectoryItem.fileContent
stringfile contents as encoded Base64 content0.6.0
DirectoryItem.parentFolderName
stringIf options.includeSubfolders is true this value will return the parent folder name of the directory item.0.6.0
DirectoryItem.parentFolderUniqueId
stringIf options.includeSubfolders is true this value will return the parent folder unique ID of the directory item.
0.6.0

Errors

Error CodeDetails
MISSING_REQD_ARGUMENT

A required argument is missing or undefined.

Example Usage

var params = {
             folderName: "attachments",
             parentFolderPath: "/sites/FilesConnectorSite/Shared Documents/Vendor Bill/20703",
             recordTypeConfigId: 35
           }
fileapi.createFolderByPath(params)

Was this article helpful?