Recombee SetItemValues
Overview
This node, "Recombee SetItemValues," is designed to set or update properties for a specific item in a Recombee database. It allows users to maintain an up-to-date item catalog by modifying product details, categories, prices, and any other relevant item-related information. The node supports batch processing of multiple items with retry logic to handle temporary network issues or rate limits.
Common scenarios where this node is beneficial include:
- Updating product attributes in an e-commerce catalog.
- Adding new metadata to items for personalized recommendations.
- Correcting or enriching existing item data in bulk.
Practical example: An online store wants to update the price and category of several products after a sale event. This node can be used to send those updates efficiently to the Recombee recommendation engine.
Properties
| Name | Meaning |
|---|---|
| Item ID | The unique identifier of the item to update. |
| Values | A JSON object containing the item properties to set or update (e.g., price, category, metadata). |
| Cascade Create | Whether to create the item if it does not already exist in the database (true/false). |
| Max Retries | Number of times to retry failed batch requests, useful for handling temporary network issues or rate limits. |
Output
The node outputs an array of JSON objects, each corresponding to an input item processed. Each output object contains:
success: Boolean indicating whether the update was successful.- If successful,
itemDataincludes the response data from the Recombee API for that item. - If failed, an
errorfield describing the failure reason. - The original input data fields are also included for reference.
If the node is configured to continue on failure, errors for individual items do not stop the entire execution; instead, they are reported per item.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the Recombee service.
- Needs configuration of the Recombee database ID, private token, and region.
- Uses the official Recombee API client library (
recombee-api-client) bundled within the node.
Troubleshooting
- Empty Values Error: If the "Values" JSON object is empty, the node throws an error stating "Values cannot be empty." Ensure you provide at least one property to update.
- API Errors: If the Recombee API returns an error for an item, the node either stops execution or continues based on the "Continue On Fail" setting. Check the error message for details such as invalid item IDs or permission issues.
- Network Issues / Rate Limits: The node retries failed batch requests up to the configured "Max Retries" count. If failures persist, verify network connectivity and API usage limits.
- Invalid Credentials: Authentication failures will prevent the node from executing. Confirm that the API key and database credentials are correctly configured.