Skip to main content
Compares two text files and writes a unified or HTML diff report to the reports folder, FD_REPORTS_DIR. Use this operation in pre-deploy workflows when you need a line-level comparison between a source file and a target file (for example, comparing CSV exports or other text artifacts) before deployment continues. When Set Review Required is enabled and differences are found, the workflow output FD_REVIEW_REQUIRED is set to true. In a pre-deploy workflow, that output signals FlexDeploy that human review is required before the deploy proceeds. This operation compares existing file paths only; it does not export packages from FlexDeploy File Package Manager.

​
Inputs

Input Name

Input Code

Required

Description

Source File Path

FDFILE_INP_SOURCE_PATH

Yes

Path to the left/source file to compare.

Target File Path

FDFILE_INP_TARGET_PATH

Yes

Path to the right/target file to compare.

Reports Subfolder

FDFILE_INP_TARGET_SUBFOLDER

No

Optional sub-folder under the reports directory for the diff report.

Report File Name

FDFILE_INP_DIFF_REPORT_NAME

No

Optional report file name. Defaults to source-vs-target with .diff or .html extension.

Report Format

FDFILE_INP_DIFF_FORMAT

No

Diff report format: unified (default) or html.

Set Review Required

FDFILE_INP_SET_REVIEW_REQUIRED

No

When true and differences are found, sets the FD_REVIEW_REQUIRED workflow output to true. Enable this when using diffFiles in a pre-deploy workflow so review can be required before deploy.

​
Outputs

Output Name

Output Code

Description

Lines Added

FDFILE_OUT_LINES_ADDED

Number of lines added in the target file relative to the source file.

Lines Removed

FDFILE_OUT_LINES_REMOVED

Number of lines removed from the source file relative to the target file.

Review Required

FD_REVIEW_REQUIRED

Set to true when Set Review Required (FDFILE_INP_SET_REVIEW_REQUIRED) is enabled and differences are found between the source and target files. Intended for use in pre-deploy workflows so FlexDeploy can require human review before deployment continues. Remains unset or not true when the files match or when Set Review Required is disabled.

​
Endpoint Selection

This operation delegates endpoint selection to the workflow developer. The workflow editor will default the selection to “All”, which selects all available endpoints associated to the Target. Selecting a specific resource will result in selection of endpoints associated to the Target which have that resource defined.

​
Endpoint Execution

This operation delegates endpoint execution to the workflow developer. The workflow editor will default to “Any”, which will execute on any one of the selected endpoints, which will be randomly picked from selected endpoints or a specific endpoint where previous step may have executed. Changing this value to “All” will result in execution on all selected endpoints.