Overview

This node operation retrieves a single Service Object from the mfr Field Service Management system. It allows fetching the Service Object either by its internal ID or by an External ID. Additionally, it supports expanding related hidden fields such as Company, Contacts, Product, and Tags to include more detailed information in the response. This operation is useful for scenarios where detailed information about a specific service object is needed, for example, to display or process service object details in an automation workflow.

Use Case Examples

1. Fetch a Service Object by its internal ID to get detailed information for a maintenance task.
2. Retrieve a Service Object by External ID and expand related fields like Company and Contacts for comprehensive data integration.

Properties

Output

JSON

• Id - The unique identifier of the Service Object.
• Name - The name of the Service Object.
• CompanyId - The identifier of the associated Company.
• Contacts - Related contacts linked to the Service Object, if expanded.
• Product - Product details related to the Service Object, if expanded.
• Tags - Tags associated with the Service Object, if expanded.

Dependencies

• Requires an API key credential for the mfr Field Service Management API to authenticate requests.

Troubleshooting

• Ensure the Service Object ID or External ID is correct and exists in the system to avoid 'not found' errors.
• If using the expand option, verify that the related entities exist and the API supports expanding those fields.
• Check API authentication credentials if requests fail due to authorization errors.

Links

• Expand documentation - Documentation on how to use the $expand query parameter to include related entities in the response.