Trimble Unity Maintain

The Trimble Unity Maintain output type allows you to create work order requests. Trimble Unity Maintain is a cloud-based asset and work management software designed for utilities and public works organizations.

Learn more about Trimble Unity Maintain

Examples

The following are example use cases for the output:

• A utility company monitors critical infrastructure—such as water pumps, sensors, and transformers—in real-time. When a sensor reports an abnormality (for example, high pressure or temperature), ArcGIS Velocity processes this data and triggers an automated workflow to generate a work order using a predefined Work Order Template ID parameter for repair or inspection.

• After a severe storm, Velocity analyzes weather and environmental data such as flood levels or stormwater runoff. When a critical threshold is exceeded at a specific monitoring site, the system automatically creates a work order by providing the Work Order Template ID, Work Order Entity Type (for example, location), and Work Order Entity UID (for example, the unique ID of the affected flood monitoring station) parameters. This ensures the work order is generated using the correct template and is accurately associated with the specific entity requiring response.

Usage notes

Keep the following in mind when working with the output:

• The Trimble Unity Maintain output type parameters listed in the Parameters section below, which include user access credentials and URL, can be obtained from Trimble.

  Learn more about getting started with Trimble

• You can create a work order in either of the following ways:

  • Provide a value only for the Work Order Template ID parameter. The system uses the template's predefined configuration to determine the associated entity.

  • Provide values for a valid combination of the Work Order Template ID, Work Order Entity Type, and Work Order Entity UID parameters. This combination ensures the work order is created for the correct entity while still applying the template's configuration. You can specify which entity a work order should be associated with.

    Keep in mind that values for the Work Order Entity Type and Work Order Entity UID parameters must always be provided together.

Parameters

The following are the parameters for the output:

Parameter	Description	Data type
URL	The URL part of the credentials provided by Trimble, for example, https://maintain.unity.trimble.com/CLIENT_NAME.	String
Username	The username part of the credentials provided by Trimble.	String
Password	The password part of the credentials provided by Trimble.	Password
Work Order Template ID	A template ID is a unique identifier assigned to a work order template. A work order tracks maintenance activities performed by individuals or crews. The work order template provides details on the ID, tasks, labor, required materials, equipment, completion deadline, incurred costs, and more. Learn more about work orders	String
Work Order Entity Type (Optional)	An entity type defines the object category the work order applies to. It indicates what kind of entity the work is being performed on and determines how the work order links to asset data, GIS features, and maintenance history. The Work Order Entity Type parameter must be paired with the Work Order Entity UID parameter.	String
Work Order Entity UID (Optional)	An entity UID is a unique identifier for a specific entity instance within Trimble Unity Maintain. It is a system-assigned identifier that ensures the work order remains linked to the correct entity record, even if the entity's names or descriptive attributes change. The Work Order Entity UID parameter must be paired with the Work Order Entity Type parameter.	String
Additional logging (Optional)	Optionally, turn on the logging for raw HTTP requests and responses issued by Velocity. Note: This parameter should only be turned on for troubleshooting purposes and turned off when troubleshooting is complete. Once turned on, start the analytic, and the debug level logs are available on the analytic logs page. If necessary, contact Esri Technical Support for assistance with troubleshooting.	Boolean

Considerations and limitations

Consider the following when using the output:

• Users are responsible for ensuring that the Work Order Template ID, Work Order Entity Type, and Work Order Entity UID parameters they provide are valid.

• Velocity automatically converts any input—whether an integer, float, or string—into a string for processing.

• Velocity only allows the submission of the Work Order Template ID parameter, which defaults to the ApplyToEntity value of the associated work order template in Trimble.

• Trimble may temporarily lock your account due to repeated login attempts with incorrect URLs, passwords, or usernames.