Autotask icon

Autotask

Consume Autotask REST API
Join our community

Actions389

Overview

This node interacts with the Autotask REST API to retrieve detailed information about a specific Contract Block Hour Factor by its ID. It is useful for workflows that need to fetch and utilize contract-related billing factors, such as calculating billable hours or integrating contract data into other systems. For example, a user can automate the retrieval of contract block hour factors to update billing systems or generate reports.

Properties

Name Meaning
Block Hour Factor ID The unique identifier of the contract block hour factor to retrieve.
Add Picklist Labels Determines whether to automatically add human-readable '_label' fields for picklist fields in the response, enhancing readability.
Add Reference Labels Determines whether to automatically add human-readable '_label' fields for reference fields in the response.
Select Columns Names or IDs. Specifies which fields to include in the response. If none are selected, all fields are returned. The ID field is always included.
Flatten User-Defined Fields Determines whether user-defined fields (UDFs) are brought to the top level of the response object instead of being nested.

Output

JSON

  • id - The unique identifier of the contract block hour factor.
  • name - The name of the contract block hour factor.
  • description - Description or details about the block hour factor.
  • userDefinedFields - Array of user-defined fields related to the block hour factor, 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 to access the Autotask REST API.

Troubleshooting

  • If the node returns an error indicating the Block Hour Factor ID is invalid or not found, verify that the provided ID exists in Autotask.
  • If no data is returned, check that the API credentials are correct and have sufficient permissions to access contract block hour factors.
  • Errors related to missing fields may occur if 'Select Columns' specifies invalid or unavailable fields; ensure field names or IDs are correct.
  • If labels are not appearing as expected, verify that 'Add Picklist Labels' and 'Add Reference Labels' options are enabled and that the fields have non-empty values.

Discussion