When a workflow instance fails, errors are shown as “Task Errors” or “Internal Errors” in the Instances view and in the email sent reporting the failure. There will be one email for each error.
Error: The Details field is required if ShowDetailsTab on the Request Form is true.
Cause: This will happen if you turn on “Job Details” on a Create Request connector, when the Form Definition for the Request does not have “Show Details Tab” turned on.
Why? Turning on Job Details on the connector should be used if you want to copy the job fields such as duration, start and stop, from the request to a job. But if you don’t have “Show Details” turned on, then the user will never enter the details into the request, and there won’t be anything to copy.
To Fix: Either turn off “Job Details” or turn on “Show Details Tab”. The screenshots below show both turned on.
Retry: If you can change the Request form to turn Show Details Tab on then Retry this task.
Connector Details
Form Definition
Error: Asset must have the same geometry type as defined in the form.
Cause: This will happen if the geometry type on the Asset form is not the same as the geometry type selected on Create Asset.
Why? In the Asset Form, the Geometry type is defined to be either Point, Line, or Polygon and this cannot be overridden when an Asset is created.
To Fix: Correct the Location Type on the Connector. Geometry Type of Point matches Geolocation. Geometry Type of Line and Polygon require Geometry.
If no assets exist already then you can change the geometry type on the form, but if assets exist already then the geometry type is fixed and cannot be changed.
Retry: If you are able to change the Asset Form then retry this task.
Connector Details
Form Definition
Error: Can not evaluate condition: Can not evaluate left value
Cause: When an Exclusive Branch condition was evaluated the “1st Value” parameter is missing.
Why? This may be for a number of reasons. If you using a field in a form (as we are doing in the screenshot on the right) it could be:
You have set up the condition and then changed the asset/job/request node on which it was based to use a different form.
The field has not been filled in by the field worker - is it mandatory?
The condition has been tested before a field worker has had a chance to update the asset/job/request. This will occur if you are missing an Asset/Job/Request Status Changed connector.
To Fix: Have a look at the branch condition that has failed and see if you can work out what the problem is from the points above. Change the branch condition accordingly. If you can’t work it out you can select “Reset” for the “1st Value” and set it up again. Sometimes when you do it again you will notice something different and pick up the error.
Retry: If all you do is change the Workflow definition then Retrying won’t make any difference as the changes will not be applied to existing Instances. If you change something elsewhere in Gruntify it is worth retrying.