中文
Node Documentation

Follow Saved Path

AutomationConfigured target requirednavigation.follow-saved-path

Select a saved route and visit its points after one content read, without carrying the entire route on data wires. Keep its position-source string variable updated.

Example use

Select a saved route and visit its points using a continuously updated position variable.

Node preview

Right-drag to pan and scroll to zoom. Expand inputs and edit parameters to see how ports change. This preview does not run the node; reopening the page restores the example.

Loading node preview…

This node has dynamic parameters or ports. The reference below describes the initial example; after editing, inspect the preview for the current ports.

Data inputs 8

Saved pathassetSaved path

Select a saved route and visit its points after one content read, without carrying the entire route on data wires. Keep its position-source string variable updated.

RequiredDefault: None
Start index (zero-based)startInteger

Start index (zero-based)

Default availableDefault: 0
  • Minimum: -9007199254740991
  • Maximum: 9007199254740991
Value format examples
0
42
End index (-1 for last)endInteger

End index (-1 for last)

Default availableDefault: -1
  • Minimum: -9007199254740991
  • Maximum: 9007199254740991
Value format examples
0
42
Planar arrival tolerancetoleranceNumber

Planar arrival tolerance

Default availableDefault: 20
Altitude toleranceheight-toleranceNumber

Altitude tolerance

Default availableDefault: 20
Timeout per pointtimeoutDuration (milliseconds) · ms

Timeout per point

Default availableDefault: 30000
  • Minimum: 0
  • Maximum: 86400000
Value format examples
1000
Observation intervalintervalDuration (milliseconds) · ms

Observation interval

Default availableDefault: 100
  • Minimum: 0
  • Maximum: 86400000
Value format examples
1000
Slowdown distanceslow-distanceNumber

Slowdown distance

Default availableDefault: 100

Configuration 7

Action interval (ms)action-intervalInteger

The interval between actions while following the path.

OptionalDefault: 500
  • Minimum: 100
  • Maximum: 60000
Forward keyforwardKeyText

The forward-movement key used by navigation.

OptionalDefault: "W"
Marker action modemarker-modeChoice

How to handle marked path points; select an available mode.

OptionalDefault: "continue"
  • Options: "continue", "pause"
Position source sample variableposition-variablestate-variable

The state-variable name containing position text, continuously updated by a sampling branch.

RequiredDefault: None
  • Minimum characters: 1
  • Maximum characters: 128
Recovery attemptsrecovery-attemptsInteger

The number of recovery attempts allowed when movement encounters a problem.

OptionalDefault: 2
  • Minimum: 0
  • Maximum: 20
Window target slotslotText

The configured workflow target name, providing the application, device, HTTP or AI settings for this node.

RequiredDefault: None
  • Minimum characters: 1
  • Maximum characters: 128
  • Pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$
Camera turn direction (1 or -1)turnSignChoice

The sign relating mouse movement to turning, based on target calibration.

OptionalDefault: 1
  • Options: -1, 1

Data outputs 10

Last reached indexlast-indexInteger

Last reached index

  • Minimum: -9007199254740991
  • Maximum: 9007199254740991
Value format examples
0
42
Current point indexcurrent-indexInteger

Current point index

  • Minimum: -9007199254740991
  • Maximum: 9007199254740991
Value format examples
0
42
Current point IDpoint-idString

Current point ID

Current XxNumber

Current X

Current YyNumber

Current Y

Remaining distancedistanceNumber

Remaining distance

Point namepoint-nameString

Use this string to select actions for a named path marker.

ProgressprogressNumber

Path progress as a number from 0 to 1, not a percentage.

Recovery attemptrecovery-attemptInteger

Integer identifying the current recovery attempt.

  • Minimum: -9007199254740991
  • Maximum: 9007199254740991
Value format examples
0
42
ReasonreasonString

Reason for recovery or the movement outcome.

Control and error ports

InputinInput · Control
An incoming control signal enters this operation.
ArrivedarrivedOutput · Control
Continue from this result or stage; see the node description for branch conditions.
TimeouttimeoutOutput · Control
Continue from this result or stage; see the node description for branch conditions.
Unable to advancestuckOutput · Control
Continue from this result or stage; see the node description for branch conditions.
Position unavailableunavailableOutput · Control
Continue from this result or stage; see the node description for branch conditions.
Reference mismatchreference-mismatchOutput · Control
Continue from this result or stage; see the node description for branch conditions.
Altitude mismatchheight-mismatchOutput · Control
Continue from this result or stage; see the node description for branch conditions.
While movingmovingOutput · Control
Continue from this result or stage; see the node description for branch conditions.
Marker reachedmarkerOutput · Control
Continue from this result or stage; see the node description for branch conditions.
RecoverrecoverOutput · Control
Continue from this result or stage; see the node description for branch conditions.
FailedfailedOutput · Error
Emitted when the operation fails; connect error handling here.
Version and node identity

Version 1.1.0

sha256:56ea04fe2f8388d26a53e248d010ff5c8b14a371e61e2a9e65d885194f99ba4d