Actions7
Overview
This node integrates with the MediaCockpit PIM REST API to manage nodes within a product information management system. Specifically, the "List Nodes by Ancestor" operation retrieves all child nodes under a specified ancestor node (parent or collection). This is useful for scenarios where you want to explore or process hierarchical data structures, such as categories, collections, or nested product groups.
Practical examples include:
- Fetching all products or subcategories under a specific category.
- Retrieving all assets or items grouped under a particular collection.
- Building dynamic menus or navigation trees based on node hierarchies.
Properties
| Name | Meaning |
|---|---|
| Ancestor (Parent/collection) ID | The key or ID of the ancestor node whose child nodes you want to list. |
| Return All Results | Whether to return all matching results or limit the output to a specified number. |
| Limit | Maximum number of results to return if not returning all. Must be at least 1. |
Output
The node outputs an array of JSON objects representing the nodes found under the specified ancestor. Each item in the output contains details about a node retrieved from the MediaCockpit PIM system.
The exact structure of each node object depends on the MediaCockpit API response but typically includes identifiers, type information, parent references, and any associated metadata.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the MediaCockpit PIM REST API.
- The node uses the configured API endpoint URL from the credentials to make HTTP requests.
- Network access to the MediaCockpit PIM service must be available.
Troubleshooting
Common issues:
- Invalid or missing ancestor ID will result in no data or errors.
- API authentication failures due to incorrect or expired credentials.
- Network connectivity problems preventing access to the MediaCockpit API.
Error messages:
"Unknown operation": Indicates an unsupported operation was selected; ensure "listByAncestor" is chosen."Create node failed": Not relevant here but indicates failure when creating nodes.- HTTP request errors may surface if the API endpoint is unreachable or returns errors; verify credentials and network.
Resolutions:
- Double-check the ancestor ID value for correctness.
- Verify that the API key credential is valid and has necessary permissions.
- Ensure the MediaCockpit API endpoint URL is correctly configured.
- Use the "Return All Results" option carefully to avoid large data loads.
Links and References
- MediaCockpit PIM API Documentation (example placeholder link)
- n8n Documentation on Creating Custom Nodes
- General info on Product Information Management (PIM)