Overview
This node integrates with the Powerlink API to perform various data management actions on Powerlink records. It supports querying records, adding or updating records, deleting records, and attaching comments, files, or tasks to existing records.
Common scenarios where this node is useful include:
- Retrieving filtered and paginated data from Powerlink for reporting or further processing.
- Automating record creation or updates based on external triggers.
- Adding contextual information such as comments, files, or tasks to records to enhance collaboration or workflow tracking.
- Deleting obsolete or incorrect records programmatically.
Practical examples:
- Querying customer records with specific filters and sorting criteria.
- Automatically adding a task assigned to a user when a new support ticket is created.
- Uploading a file attachment URL to a particular record.
- Adding a comment note to a record after an automated validation step.
Properties
| Name | Meaning |
|---|---|
| Action | The operation to perform. Options: Add Comment, Add File, Add Record, Add Task, Delete Record, Query, Update Record |
| Object Type | Integer representing the type of object in Powerlink to operate on |
| Object ID | Identifier of the specific object/record (required for most actions except query and addRecord) |
| File Url | URL of the file to attach (used only with Add File action) |
| Page Size | Number of records per page to retrieve (used only with Query action) |
| Page Number | Page number to retrieve (used only with Query action) |
| Sort By | Field name to sort the query results by (used only with Query action) |
| Sort Type | Sort direction, e.g., ASC or DESC (used only with Query action) |
| Fields | Comma-separated list of fields to retrieve; use * for all fields (used only with Query action) |
| Message | Text message or comment to add (used with Add Task, Add Comment, Add File actions) |
| Owner ID | ID of the user acting as the reporter for a task (used only with Add Task action) |
| Query Parameters | Collection of field ID and value pairs used as filters or data payload depending on action |
| Options | Boolean flag indicating whether to return only data without column metadata (used only with Query action) |
Output
The node outputs JSON data structured according to the action performed:
- For Query, it returns either the full response including metadata or just the array of data records depending on the "Options" property.
- For Add Record, Update Record, Delete Record, Add Comment, Add File, and Add Task, it returns the API response data confirming the success or failure of the operation.
If files are added, the node handles uploading the file content fetched from the provided URL but does not output binary data itself.
Dependencies
- Requires an API key credential for authenticating requests to the Powerlink API.
- Uses the Axios HTTP client library for making REST API calls.
- Uses the FormData library to handle file uploads.
- The node expects network access to
https://api.powerlink.co.il/api.
Troubleshooting
- Authentication errors: Ensure the API key credential is correctly configured and has sufficient permissions.
- Invalid Object Type or Object ID: Verify that the integer object type and string object ID correspond to valid entities in Powerlink.
- File upload failures: Confirm the file URL is accessible and points to a valid file. Network issues or invalid URLs will cause upload errors.
- Query parameter issues: Fields specified in the query parameters must be defined in Powerlink; otherwise, they will be ignored or cause empty results.
- API rate limits or downtime: The node may throw errors if the Powerlink API is unavailable or rate-limited. Retry later or check service status.
Error messages typically include the HTTP error code and message returned by the Powerlink API. Inspect these messages to adjust input parameters or credentials accordingly.
Links and References
- Powerlink API Documentation (Assumed URL for reference, please verify actual docs)
- Axios HTTP Client: https://axios-http.com/
- FormData npm package: https://www.npmjs.com/package/form-data