partialExecute (Shell)
- Joel Wenzel
Performs the same function as the Execute operation with the notable difference that it will perform the shell commands on each individual Partial Deploy file. All of the workflow execution properties available with execute are also available here in addition to the below properties:
- PROJECT_TYPE - Partial deploy project type, GENERIC, EBS, MDS etc
- OBJECT_TYPE_CODE - Object type for the File.
- FILE_PATH - File path of the partial deploy file. (File Name (with path)) on the partial deployment screen.
- FILE_NAME - File name of the partial deploy file
- FILE_PATH_PREFIX - File path, discluding the file name and extension
- FILE_EXTENSION - File extension on the partial deploy file.
- SOURCE_FILE - Fully qualified location of the file on the endpoint. Â
All partial file attributes are included as well.
Environment/Instance Properties
Property Name | Property Code | Required | Description |
|---|---|---|---|
Project Properties
Property Name | Property Code | Required | Description |
|---|---|---|---|
Project File Includes | FD_PARTIAL_FILE_INCLUDES | No | Controls files included in Project Files. Enter expressions separated by ##. Leave empty to select all files. Begin or end the expression with * for simple wildcards. Otherwise, regex |
| Project File Excludes | FD_PARTIAL_FILE_EXCLUDES | No | Controls files excluded from Project Files. Enter expressions separated by ##. Leave empty to select all files. Begin or end the expression with * for simple wildcards. Otherwise, regex is used. (e.g. /java/*##*.java##*person*##/java/.*[tT]est.*\.java) |
Inputs
| Input Name | Input Code | Required | Description |
|---|---|---|---|
| Code Snippet | FDSHELL_INP_CODE_SNIPPET | Yes | The commands and/or scripts that are to be executed on the Unix server. |
| Stop on Error | FDSHELL_INP_STOP_ON_ERROR | No | Flag that indicates whether the script should stop on an error or continue on processing. |
| Disable Echo | FDSHELL_INP_DISABLE_ECHO | No | Flag that indicates to disable echo of each command as it executes. Echo of commands can be very useful tool to identify where shell script has failed during execution as well it helps with debugging. If you do not want to see this echo, you can select this input. |
| Restrict Environment | FDWSHELL_INP_RESTRICT_ENVIRONMENT | No | Provide comma-separated instance codes to restrict environment variables in shell to specified instance codes. If no value is provided all properties are available to shell environment. |
| No Secure Variables | FDWSHELL_INP_NO_SECURE_VARIABLES | No | Check if you do not want to pass secure/encrypted properties in shell environment. |
Outputs
Output Name | Required | Description |
|---|---|---|
User Defined | No | See Special Considerations below. |
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 environment instance.
Selecting a specific resource will result in selection of endpoints associated to the environment instance 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.
Special Considerations
User defined outputs – an output must be defined in the workflow editor to be accessible. Within your script, use the following built-in function to set the output with the appropriate value and have it returned to the workflow process. Any number of outputs can be used.
setOutput {output name} {output value}
#Example
setOutput STATUS ${STATUS_VARIABLE}
Outputs are aggregated into a csv list for partial deployments.
The above STATUS example would contain an entry for each file in the object list. [SUCCESS, FAIL, SUCCESS, SUCCESS]
- style