HAP icon

HAP

Interact with HAP (Hyper Application Platform) API

Actions31

Record → Get Logs

AI-generated

Overview

This node interacts with the HAP (Hyper Application Platform) API to retrieve operation logs related to a specific record in a worksheet. The "Get Logs" operation under the "Record" resource fetches detailed logs of actions performed on a particular record, such as creation, updates, deletions, restorations, and workflow operations.

This node is beneficial for auditing changes, tracking user activities, debugging workflows, or monitoring data modifications within an application built on the HAP platform. For example, a user can retrieve all update logs for a record to understand how its data evolved over time or filter logs by specific operators or date ranges to investigate suspicious activity.

Properties

Name Meaning
Worksheet ID The unique identifier of the worksheet containing the record.
Record ID The unique row ID of the record whose logs are being retrieved.
Page Size Number of log entries to return per page; maximum allowed is 500.
Page Index The page number to retrieve, starting from 1.
Log Type Filter logs by type. Options: All Types, Create Record, Delete Record, Restore Record, Update Record, Workflow Operation.
Start Date Filter logs starting from this date (format YYYY-MM-DD).
End Date Filter logs up to this date (format YYYY-MM-DD).
Operator IDs JSON array of operator user IDs to filter logs by specific users who performed the actions.
Field Filter logs by a specific field ID or alias within the record.

Output

The node outputs a JSON array of log entries corresponding to the requested filters. Each log entry typically contains details such as:

  • The type of operation performed (create, update, delete, etc.).
  • Timestamp of the operation.
  • Operator/user who performed the action.
  • Changes made to the record or specific fields.
  • Additional metadata relevant to the log type.

If binary data were involved (e.g., attachments), it would be included in a separate binary output field, but this operation focuses on textual log data only.

Dependencies

  • Requires an API key credential for authenticating with the HAP API.
  • The node expects network access to the HAP service endpoint.
  • No additional external dependencies beyond the configured API authentication.

Troubleshooting

  • Missing or invalid Worksheet ID / Record ID: Ensure these required properties are correctly set; otherwise, the API will reject the request.
  • Page Size too large: The maximum allowed page size is 500; setting a higher value may cause errors.
  • Date format errors: Start Date and End Date must be in YYYY-MM-DD format; incorrect formats may lead to failed requests.
  • Operator IDs JSON parsing issues: The Operator IDs property expects a valid JSON array string; malformed JSON will cause errors.
  • API authentication failures: Verify that the API key credential is valid and has sufficient permissions to access record logs.
  • Network or API errors: Check connectivity and API status if requests fail unexpectedly.

Links and References

Discussion