stringReplacementMultiple

Replaces strings in files in a specific folder. See plugin inputs below for details about how to create the filters necessary to select the files you wish.

The string that is used as the needle can be a plain string or a regular expression.

This operation is suitable for files < 100MB, but not for very large files. The files are stored fully in memory during the replacement. Matching files are overwritten with the modified text. Files that seem to be binary in nature are skipped in this operation.

Inputs

Input Name

Input Code

Required

Description

Input Name

Input Code

Required

Description

Source Path

FDFILE_INP_SOURCE_PATH

No

The source directory path, files in this folder are eligible for property replacement. The FD_TEMP_DIR and FD_ARTIFACTS_DIR variables work great in this field.

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)

Supports archive files like zip, war, jar and ear

Here are the examples:

  • Salesforce.zip – Run replacement on all files in the zip file.

  • Salesforce.zip!*.xml - Run replacement on all xml files within the zip file.

  • Salesforce.zip!layouts/layout1.xml - Run replacement on only layouts/layout1.xml file within the zip file

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)

Supports archive files like zip, war, jar and ear

Here are the examples:

  • Salesforce.zip!*.xml - Exclude all xml files within the zip file.

  • Salesforce.zip!layouts/layout1.xml - Exclude layouts/layout1.xml file within the zip file

Replace List

FDFILE_INP_REPLACE_LIST

Yes

A list of strings and values to be replaced. Formatted as key=value. One pair per line.

${HRService.url}=${{SOA_BASE_URL}}/soa-infra/services/defaults/HRService/HRService?WSDL ${OrderService.url}=${{SOA_BASE_URL}}/soa-infra/services/defaults/OrderService/OrderService?WSDL

Lines that begin with "#" are ignored

Lines that begin with an "@" will try to load a file. If it is a relative path, it will first check the artifacts directory and then the temp directory. For example, @replace.conf. Any files loaded from will also be excluded from being replaced.

Expression

If you are using expression, please make sure to use \n between the key=value pairs.

"Remark=" + FDBLD_PACKAGE_VERSION_SEQUENCE + "\n" +
"Package=" + FD_PACKAGE_NAME

Whole Word Only

FDFILE_INP_REPLACE_WHOLE_WORD_ONLY

No

Should matches only be found when surrounded by word boundaries such as a space, punctuation, or the beginning or end of a line?

Case Insensitive

FDFILE_INP_CASE_INSENSITIVE

No

Should matches be performed case-insensitively?

Quote Pattern

FDFILE_INP_QUOTE_PATTERN

No

If true, the needle will be treated literally as a string. If false, the needle is a regular expression.

Artifacts

This operation delegates consumes/produces artifacts decision to the workflow developer. Check Consumes Artifacts on the workflow step editor if this operation requires artifacts to be delivered prior to execution of the script. Check Produces Artifacts on the workflow step editor if this operation creates artifacts. The artifacts folder is available via the FD_ARTIFACTS_DIR variable.

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" to will result in execution on all selected endpoints.

The following macros are not currently supported in the footer:
  • style