Dataiku DSS

Overview

This node integrates with the Dataiku DSS API, allowing users to interact programmatically with various Dataiku DSS resources and operations. Specifically for the Insight resource with the List Insights operation, it retrieves a list of insights from a specified project in Dataiku DSS.

Common scenarios where this node is beneficial include:

• Automating retrieval of insights data for reporting or monitoring.
• Integrating Dataiku DSS insights into broader workflows or dashboards.
• Periodically fetching updated insights for analysis or alerting.

Practical example:

• A user wants to fetch all insights related to a particular project to analyze trends or performance metrics automatically within an n8n workflow.

Properties

Name	Meaning
Project Key	The unique key identifying the Dataiku DSS project from which to list insights.

The node supports many other properties for different resources and operations, but for the Insight - List Insights operation, only the Project Key is required.

Output

The output contains a JSON array where each item represents an insight object retrieved from the Dataiku DSS project. The structure corresponds directly to the Dataiku DSS API response for listing insights.

• json: Contains the parsed JSON response with the list of insights.
• No binary data is output for this operation.

Example output snippet (conceptual):

[
  {
    "id": "insight_123",
    "name": "Sales Performance",
    "description": "Monthly sales insights",
    "createdAt": "2023-01-01T12:00:00Z",
    ...
  },
  ...
]

Dependencies

• Requires an API key credential for authenticating with the Dataiku DSS instance.
• The node expects the Dataiku DSS server URL and user API key to be configured in the credentials.
• Network access to the Dataiku DSS API endpoint is necessary.

Troubleshooting

• Missing Credentials Error: If the API key credential is not set or invalid, the node will throw an error indicating missing credentials.
• Required Parameter Missing: If the Project Key is not provided when listing insights, the node throws an error stating that the Project Key is required.
• API Request Failures: Errors returned by the Dataiku DSS API (e.g., unauthorized, not found) will be surfaced as node errors with descriptive messages.
• Parsing Errors: If the API returns non-JSON or unexpected content, the node attempts to handle it gracefully but may throw parsing errors.

To resolve issues:

• Ensure valid API credentials are configured.
• Provide all required parameters such as Project Key.
• Verify network connectivity and API endpoint accessibility.
• Check Dataiku DSS API permissions for the user associated with the API key.

Links and References

• Dataiku DSS API Documentation
• Dataiku DSS Insights API Reference
• n8n Documentation on Creating Custom Nodes

---

This summary focuses on the Insight resource's List Insights operation as requested, based on static analysis of the provided source code and property definitions.