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 (Advanced)

AI-generated

Overview

This node operation retrieves multiple records of Configuration Item Category User-Defined Field (UDF) Associations from the Autotask PSA system using advanced filtering criteria. It is useful for scenarios where users need to query and extract detailed information about UDF associations linked to configuration item categories, applying complex filters to refine the results. For example, a user might want to fetch all UDF associations that meet specific conditions defined in a JSON filter to analyze or report on custom field usage across configuration item categories.

Use Case Examples

  1. Retrieve all Configuration Item Category UDF Associations with a specific custom field value using an advanced JSON filter.
  2. Fetch a limited number of Configuration Item Category UDF Associations matching multiple criteria for reporting purposes.

Properties

Name Meaning
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, ranging from 1 to 500.
Advanced Filter A JSON string containing a 'filter' array with Autotask API query criteria to specify complex filtering conditions for the data retrieval.
Add Picklist Labels Whether to automatically add '_label' fields for picklist fields with human-readable values (no labels added for empty values).
Add Reference Labels Whether to automatically add '_label' fields for reference fields with human-readable values (no labels added for empty 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, making UDFs accessible as top-level properties instead of nested in the userDefinedFields array.

Output

JSON

  • id - Unique identifier of the Configuration Item Category UDF Association record.
  • name - Name or label of the UDF Association.
  • userDefinedFields - Array of user-defined fields associated with the configuration item category, unless flattened.
  • _label - Human-readable labels for picklist or reference fields if enabled.

Dependencies

  • Autotask PSA REST API

Troubleshooting

  • Ensure the advanced filter JSON is correctly formatted and matches the Autotask API query criteria syntax to avoid query errors.
  • Verify API credentials and permissions to access Configuration Item Category UDF Association data.
  • If no records are returned, check the filter criteria and consider adjusting the 'Get All' and 'Max Records' settings.

Links

Discussion