Hudu icon

Hudu

Interact with Hudu REST API

Actions100

Overview

This node integrates with the Hudu REST API to manage Asset Layouts, among other resources. Specifically, for the Asset Layout - Create operation, it allows users to create a new asset layout configuration in Hudu. Asset layouts define how asset information is structured and displayed, including custom fields, colors, icons, and included content types such as comments or files.

Common scenarios where this node is beneficial include automating the setup of asset management templates, standardizing asset data entry forms, or dynamically creating layouts based on external inputs or workflows. For example, an IT team could use this node to programmatically create asset layouts tailored for different device types or departments, ensuring consistent data capture and presentation.

Properties

Name Meaning
Name The name of the Asset Layout to be created. This is a required string field.
Additional Fields A collection of optional settings that customize the asset layout:
• Active: Whether the layout is active (boolean).
• Color: Background color hex code.
• Icon: Font Awesome icon code (e.g., fa-home).
• Icon Color: Hex code for the icon color.
• Include Comments: Whether to include comments in the layout (boolean).
• Include Files: Whether to include files (boolean).
• Include Passwords: Whether to include passwords (boolean).
• Include Photos: Whether to include photos (boolean).
• Password Types: List of password types separated by new lines (string, password input).
Fields A fixed collection allowing multiple entries, each defining a field in the asset layout:
• Field Type: Type of the field, options include Text, Rich Text, Heading, Check Box, Link, Confidential Text, Number, Date, List, Embed, Copyable Text, Phone, Asset Link, Address.
• Label: Label text for the field.
• Position: Numeric position/order of the field in the layout.
• Required: Whether the field is mandatory (boolean).
• Show in List: Whether to show this field in list views (boolean).

Output

The node outputs JSON data representing the newly created asset layout as returned by the Hudu API. Each output item corresponds to one created asset layout and includes all relevant details such as its ID, name, configuration fields, and status.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Hudu REST API.
  • Needs an API key credential configured in n8n for authentication.
  • The base URL for the Hudu instance must be set in the credentials.
  • No additional external dependencies are required beyond the API access.

Troubleshooting

  • Invalid Resource or Operation: If the resource or operation parameters are incorrect or missing, the node will throw an error indicating the resource is not known.
  • Authentication Errors: Failure to authenticate with the Hudu API (e.g., invalid API key) will result in errors. Verify the API key and base URL in the credentials.
  • Validation Errors: Missing required fields like "Name" or invalid field configurations may cause the API to reject the request. Ensure all required properties are correctly set.
  • Network Issues: Connectivity problems to the Hudu API endpoint can cause timeouts or failures. Check network access and firewall settings.
  • Continue On Fail Behavior: If enabled, the node will continue processing subsequent items even if some fail, returning error messages in the output JSON.

Links and References

Discussion