AvantGuard - HuduInstall

Overview

The AvantGuard - Hudu node's "Post Magic Dash" operation allows you to create or update a Magic Dash Item in the Hudu platform. This is useful for automating the creation of dashboard items that display key information, alerts, or summaries within Hudu. Common scenarios include posting status updates, company news, system alerts, or custom HTML content to dashboards for internal teams.

Practical examples:

• Automatically post a daily summary report to a company's Magic Dash.
• Push an alert with a custom icon and color when a critical event occurs.
• Share links, images, or videos directly on a dashboard item for quick access by team members.

Properties

Name	Type	Meaning
Message	String	The primary content to be displayed on the Magic Dash Item.
Company Name	String	The company name attribute used to match an existing company.
Title	String	The title attribute, used for matching existing Magic Dash Items with the same title and company_name.
Icon	String	A FontAwesome icon for the header of the Magic Dash Item (e.g., fas fa-circle).
Image Url	String	A URL for an image to be used in the header of the Magic Dash Item.
Content Link	String	A link to an external website associated with the Magic Dash Item's content.
Content	String	HTML content (tables, images, videos, etc.) to be displayed in the Magic Dash Item.
Shade	String	An optional color for the Magic Dash Item to represent different contextual states (e.g., success, danger).

All these properties are optional and can be added as needed to customize the Magic Dash Item.

Output

The node outputs a json object containing the response from the Hudu API after creating or updating the Magic Dash Item. The structure typically includes details about the created/updated item, such as its ID, attributes, and any metadata returned by the API.

Note: The exact output fields depend on the Hudu API's response for the Magic Dash endpoint.

Dependencies

• External Service: Requires access to a Hudu instance with API enabled.
• API Key: You must provide valid credentials (avantguardHuduApi) including the base URL and API key for authentication.
• n8n Configuration: Ensure the credentials are set up in n8n under the appropriate credential type.

Troubleshooting

Common Issues:

• Authentication Errors: If the API key or base URL is incorrect, you may receive 401 Unauthorized errors. Double-check your credentials.
• Missing Required Fields: If required fields for the Magic Dash Item are not provided, the API may return validation errors. Ensure at least the necessary fields (like Company Name and Title) are included if required by your Hudu setup.
• Invalid URLs or Icons: Providing malformed URLs or unsupported icon names may result in display issues or API errors.

Error Messages:

• "401 Unauthorized": Check your API credentials and permissions.
• "400 Bad Request": Review the input fields for missing or invalid data.
• "404 Not Found": The specified company or resource does not exist in Hudu.

Links and References

• Hudu API Documentation
• n8n Documentation: Custom Nodes
• FontAwesome Icon Reference