Create File

The Create File activity creates a new file or directory with the specified name. When creating a file, you can also provide the file contents.

The Configuration tab has the following fields.

Field	Global Var?	Description
Name	No	The name to appear as the label for the activity in the process definition.
Description	No	Short description of the activity.
Overwrite	No	Overwrite existing file with the same name, if one exists. The activity raises an exception if the specified file exists and this field is unchecked.
Is a Directory	No	When checked, the activity creates a directory instead of a file.
Create Non-Existing Directories	No	When checked, the activity creates all directories in the specified path, if they do not already exist. If this field is unchecked and there are one or more directories in the specified path that do not exist, an exception is raised.

The name to appear as the label for the activity in the process definition.

Description

Short description of the activity.

Overwrite

Overwrite existing file with the same name, if one exists.

The activity raises an exception if the specified file exists and this field is unchecked.

Is a Directory

When checked, the activity creates a directory instead of a file.

Create Non-Existing Directories

When checked, the activity creates all directories in the specified path, if they do not already exist.

If this field is unchecked and there are one or more directories in the specified path that do not exist, an exception is raised.

See TIBCO ActiveMatrix BusinessWorks Process Design for more information about mapping and transforming input data.

The input for the activity is the following.

Input Item	Datatype	Description
fileName	string	The path and name of the file to create. If the Is a Directory field is checked on the Configuration tab, this specifies the name of the directory to create.

The path and name of the file to create.

If the Is a Directory field is checked on the Configuration tab, this specifies the name of the directory to create.

The output for the activity is the following.

Output Item	Datatype	Description
fileInfo	complex	Element containing the fileName, location, type, readProtected, writeProtected, and size data.
fullName	string	The name of the file or directory, including the path information.
fileName	string	The name of the file or directory without the path information.
location	string	The path to the file or directory.
configuredFileName	string	This element is optional and it is not populated by this activity.
type	string	The file type.
readProtected	boolean	Whether the file or directory is protected from reading.
writeProtected	boolean	Whether the file or directory is protected from writing.
size	integer	Size of the file (in bytes).
lastModified	string	Time stamp indicating when the file was last modified.

Element containing the fileName, location, type, readProtected, writeProtected, and size data.

fullName

string

The name of the file or directory, including the path information.

fileName

string

The name of the file or directory without the path information.

location

string

The path to the file or directory.

configuredFileName

string

This element is optional and it is not populated by this activity.

Whether the file or directory is protected from reading.

writeProtected

boolean

Whether the file or directory is protected from writing.

size

integer

Size of the file (in bytes).

lastModified

string

Time stamp indicating when the file was last modified.

The Error Output tab lists the possible exceptions that can be thrown by this activity. See TIBCO ActiveMatrix BusinessWorks Error Codes for more information about error codes and corrective action to take.

Exception	Thrown When...
FileAlreadyExistsException	The file or directory you are attempting to create already exists and the Overwrite field is not checked on the Configuration tab.
FileIOException	There is an I/O error. For example, the file or directory already exists and is write protected.

Exception

Thrown When...

FileAlreadyExistsException

The file or directory you are attempting to create already exists and the Overwrite field is not checked on the Configuration tab.

FileIOException

There is an I/O error. For example, the file or directory already exists and is write protected.