Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node operation retrieves multiple records of Contract Exclusion Set Excluded Roles from the Autotask REST API. It is useful for users who need to fetch lists of roles excluded from contract exclusion sets, for example, to analyze or synchronize exclusion role data in workflows or reporting systems.

Properties

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

Output

JSON

  • id - Unique identifier of the Contract Exclusion Set Excluded Role record.
  • fields - The selected fields of the Contract Exclusion Set Excluded Role as defined by the 'Fields' property.
  • _label - Optional human-readable labels for picklist and reference fields if enabled.
  • userDefinedFields - Array of user-defined fields unless 'Flatten User-Defined Fields' is enabled, in which case these fields appear at the top level.

Dependencies

  • Requires an Autotask API key credential for authentication to access the Autotask REST API.

Troubleshooting

  • If no records are returned, verify that the Contract Exclusion Set Excluded Roles exist and that the API credentials have sufficient permissions.
  • If the node returns an error about unsupported resource or operation, ensure that the resource is set to 'contractExclusionSetExcludedRole' and operation to 'getMany'.
  • If the maximum records limit is exceeded, reduce the 'Max Records' value or enable 'Get All' to retrieve all records.
  • If picklist or reference labels are missing, check that 'Add Picklist Labels' and 'Add Reference Labels' options are enabled.
  • If user-defined fields are not appearing as expected, verify the 'Flatten User-Defined Fields' setting.

Discussion