The return command in Twidget is a special command used to halt the current command workflow and immediately return a specified result. This command overrides any subsequent processes and outputs the return result regardless of the rest of the workflow logic. This command is particularly useful for error handling, conditional exits, or when a certain result needs to be promptly returned.
<result>: The value or object you want to return. This result can be a simple data type (e.g., text, number, boolean) or a complex object.When the return command is executed, it:
Stops the execution of the current workflow.
Discards any further processing or commands that follow it in the workflow.
Outputs the specified result as the final output of the workflow.
It is imperative to consider how the return command fits into your overall output schema since it will determine the structure and type of the final output.
Output Schema: Ensure the output schema of your workflow accounts for the type of results that might be returned by the return command.
Workflow Design: Carefully design your workflows to use the return command appropriately for intended early exits or error handling mechanisms.
Command Placement: Place the return command where specific conditions are met to avoid unintended workflow terminations.
The return command is powerful for controlling the flow and output of workflows in Twidget. By understanding its behavior and correctly implementing it in your workflows, you can create more efficient and effective automation processes.
Conversion
Overview. Twidget's conversion commands allow you to easily convert different data types to the required format. Below is a list of the available conversion commands and examples of how to use them. The `Convert to Text` command converts the provided value to a text (string) format. Examples: - `123...
XML commands
Use XML commands when a service sends or expects XML documents. They work with the same variable controls as other commands. Parse XML. Add Parse XML, supply the XML text and choose a mode. SIMPLE is convenient when you need fields from a straightforward document. ORDERED preserves the order of elem...
Page Security
Use these commands in page workflows to check reCAPTCHA before accepting a form submission. Configure your keys first; see [Page Settings](/docs/pages/page-settings) and the existing [reCAPTCHA guide](/docs/pages/recaptcha). Generate reCAPTCHA token. Generates a token for the current interaction. Th...
Loops
In Twidget, loops allow you to execute commands multiple times, either based on a condition or through a set number of iterations. Loops can also be nested, meaning you can run loops within other loops, creating complex logic for your tasks. List Loop. The `List Loop` command enables you to loop thr...
Cache
Cache values let an endpoint, server function or event reuse temporary data. For example, save a product summary for five minutes instead of requesting it from another service every time. A cache is temporary. Keep permanent records in your database and make sure the workflow can obtain the original...