Autotask icon

Autotask

Interact with Kaseya's Autotask PSA REST API to manage companies, tickets, contracts, and more.

Actions524

Configuration Item Category UDF Association → Get Many

AI-generated

Overview

This node operation retrieves multiple Configuration Item Category UDF (User-Defined Field) Associations from the Autotask PSA system. It is useful for scenarios where you need to fetch and analyze user-defined field associations related to configuration item categories, such as for reporting, data synchronization, or integration purposes.

Use Case Examples

  1. Fetch all UDF associations for a specific configuration item category to analyze custom field usage.
  2. Retrieve a limited number of UDF associations for a configuration item category to display in a dashboard or report.

Properties

Name Meaning
Configuration Item Category ID The ID of the configuration item category for which to retrieve UDF associations. This is a required field.
Get All Whether to return all results or only up to a given limit.
Max Records Maximum number of records to return when 'Get All' is false. Range is 1 to 500.
Add Picklist Labels Whether to automatically add '_label' fields for picklist fields with human-readable values.
Add Reference Labels Whether to automatically add '_label' fields for reference fields with human-readable values.
Select Columns Names or IDs. Choose which fields to include in the response. If no fields are selected, all fields will be returned. The ID field is always included regardless of selection.
Flatten User-Defined Fields Whether to bring user-defined fields up to the top level of each object instead of being nested in the userDefinedFields array.

Output

JSON

  • id - The unique identifier of the UDF association record.
  • configurationItemCategoryID - The ID of the configuration item category associated with the UDF.
  • userDefinedFieldID - The ID of the user-defined field associated with the configuration item category.
  • userDefinedFieldLabel - The human-readable label of the user-defined field, if labels are added.
  • additionalFields - Any additional fields or metadata related to the UDF association.

Dependencies

  • An API key credential for Autotask PSA REST API

Troubleshooting

  • Ensure the Configuration Item Category ID is valid and exists in the Autotask system.
  • If no records are returned, verify that there are UDF associations for the specified category.
  • Check API credentials and permissions to ensure access to configuration item category UDF associations.
  • If the node throws errors related to rate limits, consider enabling rate limiting or retry mechanisms.

Links

Discussion