Fieldcode Manual

Tip: You can use filters for better results

The Workflow Monitoring tool inside the Admin panel gives you troubleshooting options for various workflow errors and stuck tickets. With this tool, you can identify and solve problems yourself, which may save you additional support requests. You can, however, still always contact support if you encounter problems.

Inside the Admin panel go to Automations → Workflow Monitoring.

Please ensure that you granted permissions for Workflow Monitoring!

Admins should have permissions for Ticket Workflow Monitoring enabled by default. However, If permissions are not enabled, please those rights via
Access -> Permissions -> Security Resources ->Admin panel category -> Navigation: Access -> Page: Ticket Workflow Monitoring -> View + Edit rights.

In the best-case scenario no errors should be findable in the search, which would indicate that your workflow configurations are good to go!

For such cases, you do not need to troubleshoot your workflows.

It may happen that workflows (especially custom workflows) may get configured wrongly inside Work Place.
For such cases, you can try to self-help yourself and try to fix workflow errors manually by yourself.

If you still cannot fix certain workflow errors manually by yourself, you can always contact Fieldcode Support.

Let’s have a closer look at how to troubleshoot workflow errors:

  1. Go to the Admin Panel.
  2. Go to Automations -> Workflow Monitoring.
  3. Move over to the Errors tab.
  4. Enter the workflow name or another keyword in the search field.
  5. Click Enter on your keyboard.
  6. Troubleshoot your workflows by taking either directly an proposed action and clicking on refresh afterwards to check if the error is solved or solve it manually.
  • In the search field, you can search for the wrongly behaving workflow by entering the workflow name or another keyword.

  • The button inside the proposed actions performs a proposed action which may help you to solve your particular workflow error.

  • Please do not forget to refresh the error after trying out a proposed action to check out if the error vanishes away.

  • You can configure the displayed error columns according to your preferences by using this button.

Error MessageExplanationTroubleshooting
[fieldPath]:Invalid value: [value set enumeration]The described value set enumeration was excluded for the project and cannot be saved.Add the value set to the project again and retry or
Change the configuration of the form/workflow action to a different value set and retry.
com.fieldcode.microservice.exception.MicroserviceException: Missing parameter: relationIdA checklist field was added to a form which can be executed without having a reported intervention to relate the checklist field to.Remove the field from the form or
Add a render condition in the form to hide it for tickets not having a reported intervention.
An unexpected error occurred: org.graalvm.polyglot.PolyglotException: [specific details]The polyglott script being used throws an exception, the detailed error description shows where exactly.Fix the exception in the script and retry.
resolvedActions - not able to resolve all parameterAn incorrect parameter was used, usually due to typos or undefined parameters.Fix the parameter and retry.
Authentication failed: Authentication failed; nested exception is javax.mail.AuthenticationFailedException: 535 5.7.8 Error: authentication failed: authentication failure\nThe action sending an email failed due to an invalid SMTP configuration.Fix the SMTP settings on Account and/or Project level and once SMTP is tested successfully retry the workflow errors.
Required argument 'objectState' missing.Unknown error cause.Retry and if that does not solve it please contact Fieldcode Support.
Unexpected error! Please try again later!Unknown error cause.Retry and if that does not solve it please contact Fieldcode Support.
emptyUnknown error cause.Retry and if that does not solve it please contact Fieldcode Support.
Please ensure that you granted permissions for Workflow Monitoring!

Admins should have permissions for Ticket Workflow Monitoring enabled by default. However, If permissions are not enabled, please those rights via
Access -> Permissions -> Security Resources ->Admin panel category -> Navigation menu: Automations -> Page: Workflow Monitoring -> View + Edit rights.

Please only fix tickets manually when you do not see workflow buttons anymore!

This functionality is not intended to be used for manually advancing issues.
It is intended as a self-help feature, in case you are unable to progress a ticket in any direction due to differing reasons.

In the unlikely event that a ticket gets stuck inside Work Place you can try to self-help yourself and fix stuck tickets manually.
If moving tickets to a different step by yourself doesn’t solve your specific problem you can always contact Fieldcode Support.

A stuck ticket is a ticket that cannot be moved forward to another step by triggering the workflow buttons.

Let’s have a closer look at how to move stuck tickets:

  1. Go to the Admin Panel.
  2. Go to Process -> Workflow Monitoring.
  3. Move over to the Ticket Nudge tab.
  4. Enter the CNI of the stuck ticket in the search field.
  5. Click Enter on your keyboard.
  6. Green buttons that have a context menu can be used to move the ticket to a different step manually.
  7. Click on the context menu of the step you want the ticket to move to.
  8. Click on Send ticket to this step.
If you are not sure about what the steps mean, how they relate to a status, etc. - please check out the following topics first:
Finding a ticket and skipping steps

You can check the previous path a ticket has gone through via the Ticket Workflow Monitoring menu. Here’s how to do it:

  1. Go to the Admin Panel.
  2. Go to Process -> Ticket Workflow Monitoring.
  3. Enter the CNI of the ticket you want to check.
  4. Click Enter on your keyboard.
  5. Click on the Ticket path button in the upper-right in order to understand the path a ticket went through.
Checking the ticket path
Was this topic helpful?
0 out of 5 stars
5 Stars 0%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%
5
How can we further improve this topic?
Please provide the reason for your vote. This will help us improve this topic.
Navigation