Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node operation retrieves multiple Contract Service Unit records from the Autotask system. It allows users to fetch a list of contract service units with options to specify which fields to return, limit the number of records, and include human-readable labels for picklist and reference fields. This is useful for scenarios where you need to analyze, report, or integrate contract service unit data from Autotask into workflows or other systems.

Properties

Name Meaning
Fields Defines which fields of the Contract Service Unit resource to retrieve and map in the output. Supports custom mapping and selection of specific fields.
Get All Determines whether to return all available Contract Service Unit records or limit the results to a specified maximum number.
Max Records Specifies the maximum number of Contract Service Unit records to return when 'Get All' is false. The value must be between 1 and 500.
Add Picklist Labels If enabled, adds additional fields with '_label' suffix containing human-readable labels for picklist fields in the returned data.
Add Reference Labels If enabled, adds additional fields with '_label' suffix containing human-readable labels for reference fields in the returned data.
Select Columns Names or IDs. Allows selection of specific fields (columns) to include in the response. If no fields are selected, all fields are returned. The ID field is always included.
Flatten User-Defined Fields When enabled, user-defined fields (UDFs) are moved to the top level of each returned object instead of being nested inside a userDefinedFields array.

Output

JSON

  • id - Unique identifier of the Contract Service Unit record.
    fields - Values of the selected fields for each Contract Service Unit record._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.userDefinedFields - User-defined fields nested inside userDefinedFields array, unless 'Flatten User-Defined Fields' is enabled.

Dependencies

  • Requires an API key credential for Autotask REST API authentication.

Troubleshooting

  • If no records are returned, verify that the resource and operation parameters are correctly set to 'contractServiceUnit' and 'getMany'.
  • Ensure the API credentials are valid and have sufficient permissions to access Contract Service Unit data.
  • If the node returns an error about unsupported resource, confirm that the resource name is exactly 'contractServiceUnit'.
  • When selecting specific fields, ensure the field names or IDs are valid and exist in the Contract Service Unit resource schema.
  • If the maximum records limit is exceeded, reduce the 'Max Records' value to 500 or less.
  • If labels for picklist or reference fields are missing, check that the corresponding 'Add Picklist Labels' and 'Add Reference Labels' options are enabled.

Discussion