Key-Value Storage icon

Key-Value Storage

Key-Value Storage Getter and Setter

Actions6

Get Value by Key in Scope

AI-generated

Overview

This node interacts with a key-value storage system, allowing users to get, set, increment, and list key-value pairs within different scopes such as Execution, Workflow, Instance, or all scopes. The 'Get Value by Key in Scope' operation retrieves the value associated with a specified key within a chosen scope. This is useful for workflows that need to store and retrieve temporary or persistent data across different executions or workflows, such as caching results, sharing state, or tracking counters.

Use Case Examples

  1. Retrieve a user session token stored in the Execution scope by its key.
  2. Fetch a configuration value stored in the Workflow scope to customize workflow behavior.
  3. Access a global setting stored in the Instance scope for use across multiple workflows.

Properties

Name Meaning
Scope Defines the scope in which the key-value pair is stored or retrieved. Options include ALL Scopes, Execution Scope, Workflow Scope, and Instance Scope.
Key The key whose value is to be retrieved within the specified scope.
ExecutionId Unique identifier of the execution, required when the scope is Execution Scope to specify which execution's data to access.

Output

JSON

  • value - The value retrieved from the key-value storage for the specified key and scope.

Dependencies

  • Key-Value Storage Service

Troubleshooting

  • If the specified key does not exist in the chosen scope, the node may return an empty result or null value. Verify the key and scope are correct.
  • Ensure the ExecutionId is correctly set when using the Execution scope; otherwise, the node cannot locate the correct execution context.
  • If the node fails to retrieve data, check that the key-value storage service is properly initialized and accessible.

Discussion