Docs
Search K

Appearance

Task Field Input Types ​

Task configuration fields support a variety of input components to match different data requirements. Below is a reference for each input type, its purpose, and basic usage.

Variable Autocomplete ​

  • Scope: Available in Text, Textarea, Dictionary keys & values, SearchCondition values, List items, EditablePicklist, AdvancedForm inputs, and DateTime Variable Mode.

  • Usage: Type { { to open the variable picker sourced from the JSON Viewer on the left.

    • First Run: No variables available until the workflow executes at least once.
    • Filtering: As you type, the list narrows to matching variables.
    • Navigation: Use Tab to select, . to access nested properties, and Enter to confirm.
    • Highlighting: Enclosed variable expressions appear highlighted in blue.
    • Concatenation: Combine variables with static text within the same field.

1. Text ​

  • Component: Single-line input.

  • Use Case: Enter simple strings or expressions (e.g., filenames, URLs).

  • Features:

    • Placeholder supports default values.
    • Inline error highlighting when validation fails.

2. Checkbox ​

  • Component: Boolean toggle.

  • Use Case: Enable/disable flags or binary options (e.g., true/false).

  • Features:

    • Checked state bound to a boolean variable.
    • Validation errors display below the checkbox.

3. Textarea ​

  • Component: Multi-line input.

  • Use Case: Enter longer text blocks, JSON snippets, or Markdown content.

  • Features:

    • Resizable area for editing.
    • Supports line breaks and large text values.

4. Dictionary ​

  • Component: Dynamic list of key/value pairs.

  • Use Case: Capture objects or maps (e.g., HTTP headers, metadata fields).

  • Key Uniqueness: Each key must be unique; duplicate keys are not allowed.

  • Features:

    • Add, edit, and remove pairs.
    • Key input can be a picklist when options are provided.

5. Search Condition ​

  • Component: Condition builder with rows for each predicate.

  • Use Case: Define filters or query conditions in workflows.

  • Features:

    1. DataType dropdown (string, number, dateTime, boolean, object).
    2. Left value input.
    3. Operator dropdown filtered by data type.
    4. Right value input.
    5. Add and remove conditions dynamically.

6. File Upload ​

  • Component: File picker control.

  • Use Case: Upload files or select from storage locations.

  • Storage Behavior: Uploaded files are stored on the MinuteView server; original source no longer required. Files can be retrieved and used later in the workflow.

  • Features:

    • Accepts custom file type filters via accept.
    • Returns a storage reference for downstream tasks.

7. List ​

  • Component: Dynamic list of single-line inputs.

  • Use Case: Collect arrays of values (e.g., tags, recipients).

  • Features:

    • Add/remove items in the list.

8. Picklist ​

  • Component: Static dropdown select.

  • Use Case: Choose one option from a predefined set.

  • Features:

    • Renders options as <option> elements.
    • Includes a -- Select -- default placeholder.

9. Editable Picklist ​

  • Component: Custom picklist allowing free-text entries.

  • Use Case: Select from common options or enter custom values.

  • Features:

    • Combines dropdown with editable text input.

10. Code Editor ​

  • Component: Button to open an external code editor.

  • Use Case: Edit scripts or code snippets (e.g., PowerShell).

  • Features:

    • Opens a separate window pointing at the code editor page.

11. Advanced Form ​

  • Component: Button to launch a modal with custom form layout for advanced configurations.

  • Use Case: Complex structured input requiring specialized controls, available only for nodes with very detailed configuration needs.

  • Features:

    • Opens a dedicated Advanced Form dialog revealing controls, tables, and inputs defined in the node’s advancedForm metadata.

12. Schedule ​

  • CronEditor User Guide

The CronEditor component provides a visual interface for creating cron schedules (automated task timings) without needing to write complex cron expressions manually.

  • What is it?

CronEditor gives you a user-friendly way to set up recurring schedules.
Instead of typing cryptic cron syntax like 0 9 * * 1-5, you can simply select options such as:

“Every weekday at 9:00 AM.”

This makes it easy to schedule workflows, automation triggers, or maintenance tasks in a clear and intuitive way.

  • Basic Usage

When displayed, the CronEditor provides interactive controls that let you specify:

  • When the task should run – minutes, hours
  • Which days – specific weekdays or month days
  • How often – every day, weekly, monthly, or at specific intervals

The editor instantly shows a preview of the underlying cron expression and the human-readable description of your schedule.

  • Key Features
  • Human-readable labels – Uses clear, natural-language descriptions of your selected schedule
  • Real-time preview – Updates the cron expression instantly as you make changes
  • Dropdown selectors – No need to memorize or type cron syntax
  • Visual feedback – Displays exactly what your schedule means in plain English
  • Error prevention – Invalid combinations are automatically disallowed
  • Common Schedule Examples
Schedule TypeConfiguration ExampleResulting Expression
Daily at 9 AMHour: 9, Minute: 0, Every day0 9 * * *
Every Monday at 8 AMDay: Monday, Hour: 8, Minute: 00 8 * * 1
Every 15 minutesInterval mode, 15-minute frequency*/15 * * * *
First day of every monthMode: Monthly, Day: 10 0 1 * *
  • Documentation

The component uses the react-js-cron library under the hood.

For reference and advanced understanding of cron expressions:

The library handles all the complexity of cron expressions, so you can focus on selecting when your task should run, not how to write the expression.

13. DateTime ​

  • Component: Dual-mode date/time input.

  • Use Case: Capture timestamps either via picker or variable.

  • Features:

    • Picker Mode: Native datetime-local input with toggle.
    • Variable Mode: Text input using the Variable Autocomplete component.

14. Icon Picker ​

  • Component: Grid-style icon selection control.

  • Use Case: Choose an icon class for UI elements.

  • Features:

    • Displays available icons.
    • Highlights the selected icon.

Use this reference to match each input component to your task’s data requirements when configuring nodes.

Tentech 2024