Deckhand® Pro –

September 1st, 2023
Requires iPadOS 15 or later
Requires CatchFlow™ IDE version 2.0 or higher

This release addresses the following:


New Handler: payloadFilter for Reports: We are thrilled to introduce a powerful new feature in this release. Reports can now include a new handler called payloadFilter. This handler allows you to process the original payload and envelope immediately before submission, enabling you to apply edits or additions as needed. With the payloadFilter handler, you gain more control over the data you submit in your reports. This feature enhances the customization and flexibility of Deckhand Pro, empowering you to tailor your reports to your specific requirements.

Enhancement to dict() Function: We are pleased to announce a significant enhancement to the dict() function in this release. You can now use the dict() function to edit dictionaries more efficiently. To use this new feature, provide the original dictionary as the first argument, and the subsequent arguments represent the amendments you want to make to the dictionary. This enhancement simplifies and streamlines the process of editing dictionaries within your workflows.

New Function: split(): In this release, we are excited to introduce a new function called split(). This function allows you to split string components into an array, enhancing your ability to manipulate and process text data within your workflows. The split() function provides greater flexibility and control when working with strings, enabling you to divide them into manageable parts for further processing or analysis.

New Feature: $workflow.definedFunctions Array: We are delighted to introduce a new feature in this release: the $workflow.definedFunctions array. This feature is primarily designed to enhance your debugging capabilities, especially when dealing with dynamically loaded functions. The $workflow.definedFunctions array provides you with a comprehensive list of all defined functions within your workflow. This information is invaluable for debugging and gaining insights into your workflow’s structure. However, please note that for retrieving a specific function by name, it is recommended to use the $workflow.getFunction() call, as it offers a more efficient and direct way to access functions.

New Debug Function: $debug.asTextLines(): We are excited to introduce a new debug function, $debug.asTextLines(), in this release. This function is primarily intended for internal use and offers a valuable capability within the IDE console. With $debug.asTextLines(), you can specify a string or an array of strings, which will be returned in a format that is designed to print out on the IDE console verbatim, without quotes around it. This feature is particularly useful for functions that return results meant to provide help or assistance within the IDE.


Enhancement to $action.uiControl() Command: In this release, we have made significant enhancements to the $action.uiControl() command, which provides greater control and flexibility in your workflows.

Fixed Issues:

Bug Fix in seq() Function: In this release, we are pleased to announce the resolution of a bug in the seq() function. Previously, when using seq(1), it would not generate a single-item sequence as expected.With this bug fix, the seq() function will now correctly generate a single-item sequence when provided with the argument 1. This ensures that your sequences are generated accurately and consistently, improving the reliability of your workflows.

Improved Handling of MLE Functions: In this release, we have made significant improvements to the handling of MLE (Multi-line Expressions) functions that do not explicitly return values.
Previously, such functions would introduce unexpected behavior. However, with this update:

  • Return of “Undefined Return Value” Object: MLE functions that do not explicitly return values will now return a special “Undefined Return Value” object. This ensures that the behavior is more predictable and provides better feedback for Catchflow programmers.
  • Warnings for Catchflow Programmers: Programmers working with Catchflow will now receive warnings when encountering these MLE functions. These warnings serve as reminders to observe and fix any issues related to undefined return values, improving workflow reliability.
  • Action Expressions Behavior: In action expressions, these MLE functions will now succeed instead of failing. This change enhances the usability of Deckhand Pro and ensures that your workflows continue to operate smoothly.

UDF Function Argument Handling: In this release, we have fixed an issue related to User-Defined Functions (UDF) where functions with no arguments would incorrectly inherit the $fargs array of the caller.With this fix:

Thank you for your continued support and valuable feedback. We strive to provide you with the best experience, and your reports help us identify and resolve any issues promptly. If you encounter any further problems or have suggestions for improvement, please don’t hesitate to reach out to our support team.

-The Deckhand Pro Team