Actions7
Overview
This node integrates with the MediaCockpit PIM REST API to perform operations on "nodes" within the MediaCockpit system. Specifically, for the Search Nodes operation under the Default resource, it allows users to search for nodes using either a simple text query or an advanced JSON filter.
Common scenarios where this node is beneficial include:
- Quickly finding specific product or content nodes by keyword.
- Performing complex queries with custom filters to retrieve nodes matching detailed criteria.
- Retrieving large sets of nodes with control over pagination and result limits.
Practical examples:
- A user wants to find all nodes containing the word "camera" in their content.
- An advanced user needs to filter nodes based on multiple fields and conditions using a JSON filter.
- Fetching all nodes under a certain parent node or category (related operation).
Properties
| Name | Meaning |
|---|---|
| Search Mode | Choose between "Simple Search" (text query) or "Advanced Filter" (custom JSON filter). |
| Search Query | The text string used to search nodes when using Simple Search mode. |
| Filter JSON | Custom JSON object defining complex search criteria for Advanced Filter mode. Replace empty "param" with your search term. |
| Build JSON | Optional JSON configuration to customize the output format of the search results. Leave as {} for default output. |
| Return All Results | Boolean flag to return all matching results or limit the number returned. |
| Limit | Maximum number of results to return if "Return All Results" is false. |
Output
The node outputs an array of JSON objects representing the nodes found by the search operation. Each item in the output contains details about a node matching the search criteria.
- The
jsonfield includes the node data returned from the MediaCockpit API. - If the user configures advanced build JSON, the output structure may be customized accordingly.
- No binary data output is indicated for this operation.
Dependencies
- Requires connection to the MediaCockpit PIM REST API.
- Needs an API authentication token or credential configured in n8n to authorize requests.
- The base API endpoint used is
/mc/rs/node. - Network access to the MediaCockpit API server must be available.
Troubleshooting
- Authentication errors: Ensure the API key or credentials are correctly set up and valid.
- Invalid JSON in Filter JSON or Build JSON: When using advanced mode, malformed JSON will cause errors. Validate JSON syntax before running.
- Empty or no results: Check that the search query or filter parameters are correct and match existing nodes.
- Limit exceeded or pagination issues: If too many results are requested without enabling "Return All," some results may be truncated.
- Unknown operation error: This node supports specific operations; ensure "Search Nodes" is selected for searching.
Links and References
- MediaCockpit PIM API Documentation (example placeholder link)
- n8n HTTP Request Node Documentation
- JSON Validator – Useful for validating custom JSON filters and build configurations.