What is Workflow apps?
Workflow apps is the Workato platform capability that allows you to create custom pages, such as forms and dashboards, using a low-code/no-code approach. App-users use these pages in the Workflow apps portal, and recipes provide the logic and the data behind them. An app-user is a person who can sign in to the portal and does not need a Workato account.
Before you open a ticket
First, check status.workato.com for an ongoing incident. If there is one, follow its updates and check the affected functionality again once it is resolved.
The following actions often resolve the most common Workflow apps issues, or help you work around them:
1. Check that the app is live
If the app does not open, or the app is missing for users, check the status of the app.
- Go to Platform > Workflow apps portal and open the app.
- On the Workflow app tab, check the status next to the app name: Live or Offline.
- If the app is offline and it was not taken offline on purpose, click Go live.
2. Check the recipe and job state
If a submitted request is not processed, a task is not created, or a page action does nothing, the recipe behind it may be stopped or failing.
- Open the project of the Workflow app.
- Check that the recipe that processes the request or page action is started.
- If the recipe is stopped, start it and repeat the action.
- If the recipe is started, open the Jobs tab and check whether a failed job exists. Read the error in the job, fix the cause, and repeat the action.
3. Check that the app-user has access to the app
Go to Platform > Workflow apps portal > Users and groups and check the following:
- The user is listed. If not, invite the user.
- The invitation has been accepted and has not expired, if the user was invited. If it has expired, select the user, click the ... (ellipses) icon, and select Resend invite.
- The user belongs to a group. If user groups syncing is enabled, the groups are managed in the identity provider.
- If the user signs in with SSO, go to Platform > Workflow apps portal > Portal settings > Security and check the following:
- If just-in-time (JIT) provisioning is enabled, the user is added to the portal at the first sign-in. If it is disabled, add the user to the portal, for example by invitation, before the first sign-in.
- If user groups syncing is enabled, the groups of the user come from the identity provider and are applied at each sign-in. Ask your identity provider administrator to check the group assignment, and then sign out and sign in again.
Then open the app in Workato and click the number of groups and users under the app name to open Manage access. Check that the user group of the user is listed with a role, and open the app again.
4. Check the page configuration
If a component is missing, cannot be edited, or rejects a value, open the page in the editor and check the following:
- Conditional logic (IF conditions) that controls the visibility or editability of the component
- Validation rules, including custom regex validation
- Component actions, such as saving data or triggering a recipe. Confirm that the triggered recipe is started.
5. Check your browser
Refresh the browser tab and try again. If the issue persists, try another browser or a private window. This rules out extensions, cached data, or browser settings. If it works there, disable extensions in your regular browser one by one.
6. Check your network
Corporate proxies, VPNs, or firewalls can block parts of the Workflow apps portal. Try from a different network, or ask your network team to confirm that Workato is reachable. See IP allowlists and gateway domains.
Information to include
If the issue persists, open a ticket and mention what you tried. Including the following information in your ticket helps Workato Product Support resolve it faster:
- Details of the issue
- Project ID and app name
- Workspace ID
- Affected user info
- Recipe ID and job ID
- Page details
- HAR file
- Screenshots
- Published app URL
How to collect it
Details of the issue
Describe the following:
- Detailed steps to reproduce the issue
- What you were trying to achieve and the current result
- The exact error message, if any
- Timestamp of the last occurrence, with time zone
- How often the issue occurs
- Any recent changes
- Whether it worked before or is a new setup
Project ID and app name
These values identify the affected app in Workato.
- Go to Platform > Workflow apps portal and click the card of the affected app to open it in Workato
- Note the name of the app and the name of the project shown in the page header
- Copy the full URL from the browser address bar. The URL contains the project ID
URL example: https://app.workato.com/?fid=XXXXXXXX#app
Workspace ID
Each environment (Development, Test, Production) has its own workspace ID. Provide the ID of the environment where the affected Workflow app is configured. To find it:
- Open the environment where the issue can be reproduced
- Navigate to Workspace Admin > Settings > General
- Copy the Workspace ID value
Affected user info
Include the following for the affected users:
- Email address
- Role in the app: member or manager
- User group
- How the app-user signs in: password authentication or SSO
Recipe ID and job ID
If a request is not processed, a task is not created, or a page action fails:
- Open the project of the Workflow app
- Open the recipe that processes the request or is called by the affected page action
- Copy the recipe ID from the browser address bar
- Open the Jobs tab, open the failed job, and copy the job ID
If the recipe has no job for the attempt, mention it in the ticket and include the recipe ID and the state of the recipe (started or stopped).
Recipe ID example: 4000001. Job ID example: j-ABbCDdEe-F4GgHh.
Page details
If the issue is with a page or a tab, include the following:
- The name of the page or tab and of the affected component
- What the component is expected to show or do
- Whether the component uses a recipe as a data source or runs a recipe through an action
- Whether the component has conditional logic or validation rules
HAR file
A HAR file is a recording of your browser’s network traffic. It helps Product Support investigate issues with Workflow apps.
Open the page where the issue occurs
Open browser developer tools:
F12orCtrl+Shift+I(Windows/Linux),Cmd+Option+I(macOS)Open the Network tab
Optionally select Keep log (called Preserve log in some browser versions)
Reproduce the issue
Click the Export HAR (down arrow) icon and save the file
- Attach the file to your ticket
A HAR file can contain sensitive data, such as cookies and the contents of your pages. Share it only through the ticket.
Screenshots
Screenshots of the following help Product Support investigate the issue:
- In the Workflow apps portal, the page where the issue occurs, captured as the full browser window, so that the error and the address bar are both visible
- In the Workato UI, the failed job of the related recipe, if any
- In the page editor, the configuration of the affected component, if the issue is with a page
Published app URL
The published app URL helps Product Support identify the issues related to publication settings:
- Open the Workflow apps portal and navigate to the app.
- Click Go to app. The app opens in a separate window.
- Navigate to the page or tab where the issue occurs.
- Copy the full URL from the browser address bar
- Note whether the app is embedded in another website using an iframe, and whether the issue occurs for signed-in users, through a public link, or both.
If Go to app is not available, the app is offline. See check 1, and mention the status in the ticket.
URL example: https://your-domain.workato.app/your-app-name/
Comments
0 comments
Please sign in to leave a comment.