Creating and Using Modules
Create custom modules from the Modules page, define their inputs and outputs in the Module I/O panel, and use them as nodes in other workflows.
On this page7
Overview
Modules are reusable subgraphs that appear as a single node in a workflow. You create and manage your modules from the Modules page in the platform scope. From there you can create a new module, build its internal workflow, expose inputs and outputs via the Module I/O panel, and then use the module in any workflow like any other node. For an introduction to what modules are and how they fit with workflows and the Library, see Modules in Key Concepts.
Where to Find Your Modules
All of your modules are listed on the Modules page. In the sidebar, under the PLATFORM section, click Modules. The page shows a grid of your modules with search and filters. Use + Create Module in the top right to create a new one.
Creating a Module
On the Modules page, click + Create Module in the top right. A dialog opens asking for the module name and an optional description.
Enter a Name for the module. You can add a Description (optional) to explain what the module does (up to 140 characters). The dialog also links to the Trickest documentation for more guidance.
Click Create Module. You are redirected to the module editor, where you can start building the module.
Building the Module
Build the module like any other workflow. Add and connect nodes (tools, scripts, and optionally other modules) on the canvas. The Module I/O panel appears to the left of the canvas. When the module is new, it shows No inputs exposed yet and No outputs exposed yet; the module does not expose any inputs or outputs until you define them.
Defining Module Inputs and Outputs
After the module has been executed, the Module I/O panel shows an Available section that lists:
- Inputs from the nodes in the module that can be exposed as module inputs.
- Outputs from the nodes in the module that can be exposed as module outputs.
If you do not see any inputs or outputs under Available, run the module once using Execute, then check the panel again.
To expose an input or output:
In the Module I/O panel, find the input or output you want under Available and click the + button next to it (for outputs, the tooltip may say "Expose as module output").
Give the input or output a custom name (recommended) or keep the default. A custom name makes the module easier to use when you add it to other workflows.
Click the checkmark to confirm. The input or output is then part of the module's interface and appears when you use the module in another workflow.
You can repeat this for as many inputs and outputs as you need. Only the inputs and outputs you expose in the Module I/O panel are visible when the module is used as a node elsewhere.
Using a Module in a Workflow
When you build or edit a workflow, you can add a module like any other node. Open the Node Library, search for your module by name, and add it with the + button. The module appears on the canvas as a single node. In the workflow's Inputs panel you can set values for the module's exposed inputs, and you can connect the module's exposed outputs to downstream nodes.
The module's Execution tab describes it as a reusable workflow and shows its inputs and outputs. To change the module's internal workflow or its exposed inputs and outputs, use Open Editor to open the module in its own editor. From the module editor you can also view the module's full execution history, including runs started directly from the module and runs triggered when the module is invoked as a node in other workflows.