Parametrized Function Block Schema

docs.neops.io/schema/RootWorkflow#/definitions/ParametrizedFunctionBlock

A function block with its execution parameters and configuration

Abstract	Extensible	Status	Identifiable	Custom Properties	Additional Properties	Access Restrictions	Defined In
Can be instantiated	No	Unknown status	No	Forbidden	Forbidden	none	RootWorkflow.schema.json*

ParametrizedFunctionBlock Type

object (Parametrized Function Block)

ParametrizedFunctionBlock Properties

Property	Type	Required	Nullable	Defined by
condition	`string`	Optional	cannot be null	Root Workflow
continueOnError	`boolean`	Optional	cannot be null	Root Workflow
delay	`number`	Optional	can be null	Root Workflow
functionBlockId	`string`	Required	cannot be null	Root Workflow
id	`string`	Required	cannot be null	Root Workflow
name	`string`	Required	cannot be null	Root Workflow
parameters	`object`	Required	cannot be null	Root Workflow
repeatConfig	Merged	Optional	cannot be null	Root Workflow
retryConfig	Merged	Optional	cannot be null	Root Workflow
runOn	`string`	Optional	cannot be null	Root Workflow
type	`string`	Required	cannot be null	Root Workflow

condition

A JMESPath expression that evaluates to a boolean value

condition

is optional
Type: string (Condition)
cannot be null
defined in: Root Workflow

condition Type

string (Condition)

condition Examples

"devices[?state=='active']"

continueOnError

Whether to continue workflow execution if this step fails. When true, workflow will proceed to next step even if current step fails.

continueOnError

is optional
Type: boolean (Continue On Error)
cannot be null
defined in: Root Workflow

continueOnError Type

boolean (Continue On Error)

continueOnError Examples

false

delay

Delay in seconds before executing this step. Useful for rate limiting or scheduling steps to run after a certain time.

delay

is optional
Type: number (Execution Delay)
can be null
defined in: Root Workflow

delay Type

number (Execution Delay)

delay Constraints

minimum: the value of this number must greater than or equal to: 0

delay Examples

functionBlockId

Fully qualified function block identifier in format "package/name:version". Must match the pattern.

functionBlockId

is required
Type: string (Function Block ID)
cannot be null
defined in: Root Workflow

functionBlockId Type

string (Function Block ID)

functionBlockId Constraints

pattern: the string must match the following regular expression:

^([^\/:]+)\/([^\/:]+):[0-9]+(\.[0-9]+)?(\.[0-9]+)?$

try pattern

functionBlockId Examples

"fb.neops.io/ping:1.0.0"

id

Unique identifier for this step configuration. Set explicitly to access the result object on a subsequent step.

id

is required
Type: string (Step ID)
cannot be null
defined in: Root Workflow

id Type

string (Step ID)

id Default Value

The default value is:

"random UUID"

id Examples

"ping"

"550e8400-e29b-41d4-a716-446655440000"

name

Human-readable name for this step

name

is required
Type: string (Step Name)
cannot be null
defined in: Root Workflow

name Type

string (Step Name)

name Constraints

maximum length: the maximum number of characters for this string is: 100

minimum length: the minimum number of characters for this string is: 1

name Examples

"Check Interface Status"

parameters

Key-value pairs of parameters to pass to the step during execution. Supports dynamic values through JMESPath expressions enclosed in double curly braces. Parameters are specific to each step type and implementation.

parameters

is required
Type: object (Step Parameters)
cannot be null
defined in: Root Workflow

parameters Type

object (Step Parameters)

parameters Default Value

The default value is:

{}

repeatConfig

Optional settings for repeating the step execution multiple times. Null if not repeating.

repeatConfig

is optional
Type: merged type (Repeat Configuration)
cannot be null
defined in: Root Workflow

repeatConfig Type

merged type (Repeat Configuration)

any of

retryConfig

Retry behavior configuration when step fails

retryConfig

is optional
Type: merged type (Retry Configuration)
cannot be null
defined in: Root Workflow

retryConfig Type

merged type (Retry Configuration)

any of

runOn

Types of entities that workflows can operate on

runOn

is optional
Type: string (Entity Type)
cannot be null
defined in: Root Workflow

runOn Type

string (Entity Type)

runOn Constraints

enum: the value of this property must be equal to one of the following values:

Value	Explanation
`"global"`
`"device"`
`"interface"`
`"group"`
`"client"`

type

Type discriminator for workflow steps. Must be "functionBlock" for this type.

type

is required
Type: string (Type)
cannot be null
defined in: Root Workflow

type Type

string (Type)

type Constraints

constant: the value of this property must be equal to:

"functionBlock"

type Examples

"functionBlock"