Skip to content

Task execute card

The Task execute card exposes one configured task and opens its execution panel for the current dashboard scope.

When to use it

Use it for a prominent, repeatable action with one known task. Use Task selector when readers need to choose among several tasks.

Live example

The Card Lab supplies deterministic task and execution data to the production card. Opening the task panel is explicitly simulated and never starts a task.

Open the Task execute Card Lab in a new page

Requirements

Requirement Value
Dashboard types Standard and aggregation
Minimum size 2 columns by 2 rows
Data One task definition and the selected entity query
Backend capabilities Task search, execution status, and task-panel support
Permissions Permission to view and execute the configured task

Configuration

The paths below are relative to cardConfig.data.

title

Property Value
Type string with interpolation
Required No
Default no title provided
Values Text interpolated against the loaded task result

Sets the card heading.

uniqueTaskName

Property Value
Type string
Required Yes
Default No default
Values Exact task unique name

Identifies the task loaded from the backend. The action is disabled until a matching task is found.

entityType

Property Value
Type string
Required When opening a scoped task
Default No default
Values client, device, generic, global, group, or interface

Selects the entity query and local-filter state passed to the task panel. Generic and global values do not resolve to an entity context in this card.

infoAlertContent

Property Value
Type string
Required No
Default No description
Values Plain text

Adds explanatory content below the title.

Examples

Device backup action

{
  "cardId": "task-execute",
  "data": {
    "title": "Back up selected devices",
    "uniqueTaskName": "device.backup",
    "entityType": "device",
    "infoAlertContent": "Review the current device filter before continuing."
  }
}

The button opens the task panel with the configured task and current device query.

Behavior

The card searches for one exact task, shows a skeleton while loading, and disables its action when no match exists. It watches the current user’s latest matching execution and warns when one is already active. Clicking the action opens the task panel; it does not bypass task input or confirmation handled there.

Limitations and safety

The current dashboard filter determines the target set. Backend authorization must prevent unauthorized execution regardless of dashboard configuration.

See Task selector.