mfr - Field Service Management

Overview

This node integrates with a field service management system to manage service requests and related entities. Specifically, the "Delete One" operation under the "Service Request" resource allows users to delete a single service request by its identifier. This is useful in scenarios where a service request is no longer needed or was created in error and must be removed from the system.

Practical examples include:

• Automatically cleaning up canceled or duplicate service requests.
• Removing test or temporary service requests after processing.
• Managing lifecycle of service requests programmatically within workflows.

Properties

The property supports two modes for selecting the service request:

• From List: Search and select from existing service requests.
• By ID: Directly specify the service request ID as a string.

Output

The output JSON contains the response from the API call that deletes the service request. Typically, this will be an empty object or confirmation of deletion depending on the API's behavior. No binary data is returned.

Example output structure (conceptual):

{}

Dependencies

• Requires an API key credential for authenticating with the field service management system's API.
• The node makes HTTP DELETE requests to the endpoint corresponding to the selected service request.
• The base URL used is https://portal.mobilefieldreport.com/odata/ServiceRequests.

Troubleshooting

• Common issues:

  • Providing an invalid or non-existent service request ID will likely result in an error from the API.
  • Insufficient permissions or invalid API credentials can cause authentication failures.
  • Network connectivity issues may prevent successful API calls.

• Error messages and resolutions:

  • "Not Found" or similar: Verify the service request ID exists and is correct.
  • "Unauthorized" or "Authentication failed": Check that the API key credential is valid and properly configured.
  • "Request failed" or timeout errors: Ensure network access to the API endpoint and retry.

Links and References

• Field Service Management API Documentation (general reference to the OData API endpoints)
• n8n documentation on Creating Custom Nodes