Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node operation retrieves multiple Skill records from the Autotask system using an advanced filtering mechanism. It allows users to specify complex query criteria in JSON format to filter the skills returned. Users can choose to return all matching records or limit the number of results. Additionally, it supports options to include human-readable labels for picklist and reference fields, select specific columns to return, and flatten user-defined fields for easier access. This operation is useful for scenarios where detailed and customized retrieval of skill data is needed, such as reporting, data synchronization, or integration workflows that require filtered skill information.

Properties

Name Meaning
Get All Determines whether to return all matching Skill records or limit the results to a specified maximum number.
Max Records Specifies the maximum number of Skill records to return when 'Get All' is set to false. The value must be between 1 and 500.
Advanced Filter A JSON string containing a 'filter' array that defines the query criteria for retrieving Skill records. This allows for complex and precise filtering based on Autotask API query syntax.
Add Picklist Labels Indicates whether to automatically add additional fields with '_label' suffix for picklist fields, providing human-readable values instead of raw codes.
Add Reference Labels Indicates whether to automatically add additional fields with '_label' suffix for reference fields, providing human-readable values.
Select Columns Names or IDs. Allows selection of specific fields to include in the response. If no fields are selected, all fields are returned by default. The ID field is always included regardless of selection.
Flatten User-Defined Fields Determines whether user-defined fields (UDFs) should be moved to the top level of each returned object instead of being nested inside a 'userDefinedFields' array.

Output

JSON

  • id - Unique identifier of the Skill record.
  • name - Name of the Skill.
  • description - Description of the Skill.
  • userDefinedFields - Array of user-defined fields associated with the Skill, unless flattened.
    _label - Human-readable label for picklist fields if 'Add Picklist Labels' is enabled._label - Human-readable label for reference fields if 'Add Reference Labels' is enabled.

Dependencies

  • Requires an Autotask API key credential for authentication.
  • Relies on the Autotask REST API to perform advanced filtered queries on Skill resources.

Troubleshooting

  • Ensure the 'Advanced Filter' JSON string is correctly formatted and follows Autotask API query syntax; invalid JSON or incorrect filter structure will cause errors.
  • If no results are returned, verify that the filter criteria match existing Skill records.
  • When 'Get All' is false, the 'Max Records' value must be between 1 and 500; values outside this range will cause validation errors.
  • If picklist or reference labels are not appearing, confirm that the corresponding options are enabled and that the fields contain values.
  • Large result sets may cause performance issues; consider using filters to limit data returned.

Links

Discussion