Skip to content

open-resource ​

Ask the platform to open a file, folder, URL, or selected application.

When to use it ​

Use this node to present a local artifact or open a destination after a workflow completes. Use HTTP request for reading a web response inside the workflow.

Example ​

rattish
Rattish: 1

Workflow:
  name: Open a resource

Node step:
  type: open-resource
  target: https://github.com/zacharyivie/Raticode
  resource-type: url
  finish: pass

resource-type can be auto, file, folder, url, or app. Set it explicitly when the interpretation matters. args supplies arguments for supported application opening.

Opening a URL launches the configured application; it does not return the page content. A successful launch is not proof that a person read it. Headless machines may lack a usable desktop opener.

Configuration ​

Configuration fields use hyphens. These are the node-specific fields; shared execution fields apply separately.

FieldTypeRequired / defaultMeaning
targetstringRequiredFile, folder, URL, or application to open.
resource-typeauto, file, folder, url, app"auto"Interpretation of the resource target.
argslist of string[]Ordered argument strings.

Inputs and output ​

This node has no declared input ports. Configure its authored fields directly.

Successful output fields use these exact selector names:

FieldValue type
targetstring
resource_typefile, folder, url, app

For example, refer to node.step.output.target from a compatible downstream binding.

Preflight and limits ​

The target must match its resource type, and the platform opener or application must be available.

Use Raticode rattish check and Raticode rattish preflight before choosing to run the example. The installed contract is available through Raticode rattish docs --format json.

Continue with Node reference, Routes and joins, or Runs and approvals.