Hudu icon

Hudu

Interact with Hudu REST API

Actions100

Overview

This node operation allows you to create a new field within an Asset Layout in the Hudu system. Asset Layout Fields define the structure and metadata fields that assets can have, such as text fields, dates, numbers, checkboxes, links, and more. Creating custom fields enables tailoring asset records to specific organizational needs, improving data organization and retrieval.

Common scenarios:

  • Adding a new custom text or number field to track additional asset information.
  • Creating a checkbox field to mark assets with a particular status.
  • Defining a date field for expiration tracking.
  • Adding a dropdown list field with predefined options for consistent data entry.

Practical example:
You want to add a "Warranty Expiration Date" field of type Date to your asset layout to keep track of warranty periods. Using this node, you specify the asset layout, set the label to "Warranty Expiration Date," choose the field type as Date, and optionally mark it for expiration tracking.

Properties

Name Meaning
Asset Layout Name or ID Select the target asset layout by name or ID where the new field will be created. You can pick from a list or provide an expression to specify the ID dynamically.
Label The display label of the new field as it will appear in the asset layout.
Field Type The type of the field to create. Options include:
- Text
- Rich Text
- Heading
- Check Box
- Link (Website)
- Confidential Text (Password)
- Number
- Date
- List (Select)
- Embed
- Copyable Text (Email)
- Phone
- Asset Link (AssetTag)
- Address
Additional Fields Optional extra settings for the field:
- Expiration: Boolean to indicate if the field is used for expiration tracking.
- Hint: Help text shown to users.
- Is Destroyed: Marks the field as destroyed (advanced).
- Linkable ID: Numeric ID linking to another resource.
- Maximum Value: Max numeric value allowed.
- Minimum Value: Min numeric value allowed.
- Options: Comma-separated string for select-type field options.
- Position: Numeric position/order of the field in the layout.
- Required: Boolean indicating if the field must be filled.
- Show in List: Boolean to show this field in list views.

Output

The node outputs JSON data representing the newly created asset layout field object returned by the Hudu API. This typically includes details such as the field's unique ID, label, type, configuration options, and metadata.

If the node supports binary data output, it would represent associated files or attachments related to the asset layout field, but this operation primarily deals with JSON metadata.

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.
  • The node relies on internal option loaders to fetch available asset layouts for selection.

Troubleshooting

  • Invalid Asset Layout ID: If the specified asset layout does not exist or is inaccessible, the node will error. Verify the asset layout ID or name is correct and accessible with your API key.
  • Missing Required Fields: Omitting required properties like "Label" or "Field Type" will cause validation errors. Ensure all mandatory inputs are provided.
  • Unsupported Field Type: Selecting a field type not supported by the API or misspelling the type may result in errors. Use only the provided options.
  • API Authentication Errors: If the API key is invalid or missing, the node will fail to authenticate. Confirm your API credentials are correctly configured.
  • Permission Issues: The API user must have permissions to modify asset layouts and create fields; otherwise, the request will be denied.

Links and References

Discussion