Creates a build artifact containing file(s) and folder(s) selected on the Project Files tab of a project. This artifact is then used by the packageDeploy operation.

The project file attributes can be defaulted for the project using project properties. Then at populate or evaluate time, the defaults are used to fill the project file attributes. Those attributes are used at deploy time. The attributes are stored with the object, not the build, so it is possible to change the attributes and then deploy again without another build in between.

This operation can only be used in package deployment projects of type file.

Project Properties

Property Name	Property Code	Required	Description
Root Target Folder	`FDFILE_ROOT_TARGET_FOLDER`	No	The path in which to create and update file and folder objects. If left blank, the FD_TEMP_DIR will be used. Unlike the rest of the properties on this operation, this one is not a default. Its value is pulled at deploy time, not populate and evaluate time.
Use Source Path Default	`FDFILE_USE_SOURCE_PATH_DEFAULT`	No	When populating or evaluating project files, default the Use source path value to this. Defaults to true(checked ).
Ignore Failure Default	`FDFILE_IGNORE_FAILURE_DEFAULT`	No	When populating or evaluating project files, default the Ignore Failure value to this. Defaults to false (unchecked ).
Owner:Group File Default	`FDFILE_OWNER_GROUP_FILE_DEFAULT`	No	When populating or evaluating Files, default the Owner:Group value to this.
Owner:Group Folder Default	`FDFILE_OWNER_GROUP_FOLDER_DEFAULT`	No	When populating or evaluating Folders, default the Owner:Group value to this.
Permissions File Default	`FDFILE_PERMISSION_FILE_DEFAULT`	No	When populating or evaluating Files, default the Permissions to this.
Permissions Folder Default	`FDFILE_PERMISSION_FOLDER_DEFAULT`	No	When populating or evaluating Folders, default the Permissions to this.
Property Replacement Default	`FDFILE_PROPERTY_REPLACEMENT_DEFAULT`	No	When populating or evaluating Files, default the Property Replacement option to this. Defaults to true(checked ).
Execute Default	`FDFILE_EXECUTE_DEFAULT`	No	When populating or evaluating Files, default the execute option to this. Defaults to false (unchecked ).

Inputs

Input Name

Input Code

Required

Description

File Filter

FDFILE_INP_FILE_FILTER

No

Wildcard compatible expression to select file(s). You can enter multiple filter expressions separated by ##. Leave empty to select all files. The ## performs an OR expression. This will filter Files or Directory names but not the path. (e.g. for "/this/is/a/test/path" if you use "path" it will filter it, if you use "/this/is/a/test/path" it will not)

Here are some examples and expected behaviors:

Filter Text	Result
.properties##.xml##.conf##.temp	selects all .properties, .xml, .conf, and .temp files and folders.
*.war	selects all .war files
*.war##important.xml##readme.md	selects all .war files, important.xml, and readme.md

File Exclude Filter

FDFILE_INP_FILE_FILTER_EXCLUDED

No

Wildcard compatible expression to exclude file(s) OR folders. You can enter multiple filter expressions separated by ##. Leave empty to select all files. The ## performs an OR expression. This will filter Files or Directory names but not the path. (e.g. for "/this/is/a/test/path" if you use "path" it will filter it, if you use "/this/is/a/test/path" it will not)

Here are some examples and expected behaviors:

Filter Text	Result
svn##.git##*.temp	excludes any .temp, svn, .git files and folders
*.war	excludes all .war files
*.tmp##boring.xml##readme.md	excludes all .tmp, boring.xml, and readme.md files

Combining include and exclude filters

File Filer	File Exclude Filter	Result
.war##.jar	badProject	select all .war and .jar files, unless there is a folder named badProject in its path
.war##.ear	badProject.war	select all .ear and .war files, except badProject.war
	*.tmp##boring.xml##readme.md	select everything except all .tmp files, boring.xml, and readme.md
*.war		select all .war files
Important.*	*.class	select all files that start with Important, unless they end in .class

Source Path

FDFILE_INP_SOURCE_PATH

Yes

The source directory to copy file(s) from. The FD_TEMP_DIR and FD_ARTIFACTS_DIR variables work great in this field.

Target Path

FDFILE_INP_TARGET_PATH

Yes

The target directory where file(s) are to be transferred. The FD_TEMP_DIR and FD_ARTIFACTS_DIR variables work great in this field.

Clean Directory

FDFILE_INP_CLEAN_DIRECTORY

No

Flag to indicate if the target path should be cleaned before copy.

Artifacts

This operation produces an artifact that will be stored in the artifacts repository. The artifact contains the files that were selected on the Project Files page.

Endpoint Selection

This operation will select all available endpoints associated to the target.

Endpoint Execution

This operation will execute on any one of the selected endpoints and will be random in the determination of which one.

Package Deployment File Object Type Details

Unable to render {include} The included page could not be found.

packageBuild