HAP icon

HAP

Interact with HAP (Hyper Application Platform) API

Record → Update

AI-generated

Overview

This node interacts with the HAP (Hyper Application Platform) API to update a specific record in a worksheet. It allows users to modify one or more fields of an existing record by specifying the worksheet and record identifiers along with the new field values.

Common scenarios where this node is beneficial include:

  • Updating customer information in a CRM system.
  • Modifying inventory details in a product management application.
  • Changing status or attributes of tasks in a project management tool.

For example, you might use this node to update the "Status" field of a task record to "Completed" or change the "Price" field of a product record after a price adjustment.

Properties

Name Meaning
Worksheet ID The unique identifier of the worksheet containing the record to update.
Record ID The unique row ID of the record that needs to be updated.
Fields An array of objects specifying which fields to update and their new values. Each object must have an ID (field identifier or alias) and a value (new value for the field). Example: [{"ID": "status", "value": "Completed"}].
Trigger Workflow Boolean flag indicating whether to trigger any associated workflow after the update operation. Defaults to true.

Output

The node outputs JSON data representing the updated record as returned by the HAP API. This typically includes the record's identifiers and the latest values of its fields after the update.

If the node supports binary data output (not indicated here), it would represent file attachments or similar content related to the record.

Dependencies

  • Requires an API key credential for authenticating with the HAP API.
  • The node expects the HAP API endpoint to be accessible and properly configured.
  • No additional environment variables are explicitly required beyond the API authentication.

Troubleshooting

  • Invalid Worksheet ID or Record ID: If these IDs are incorrect or do not exist, the API will likely return an error indicating the resource was not found. Verify the IDs before running the node.
  • Malformed Fields Array: The fields property must be a valid JSON array of objects with ID and value properties. Errors may occur if the format is incorrect or missing required keys.
  • API Authentication Errors: Ensure the API key credential is valid and has sufficient permissions to update records.
  • Trigger Workflow Flag: If workflows are not triggering as expected after updates, verify that the triggerWorkflow property is set to true and that workflows are correctly configured on the platform side.

Links and References

Discussion