Troubleshooting the Creator Workshop Configuration
Introduction
Building an application is a complex process that might result in errors if configured incorrectly. The first step to resolving errors in your application is to identify where the error occurred. Once located, you can troubleshoot and resolve these issues.
If you're having trouble identifying and resolving configuration errors in your application, use the following table to help guide you through any issues that might occur. The table provides you with a list of all elements used in a specific use case step and a summary of their configuration. Once you find the source of the error, visit the relevant use case step and review the configuration instructions.
The configuration values you enter (Property IDs, Inputs and Outputs table Mapping, JSON, and so on) are often case sensitive. Ensure your inputs match the configuration instructions and example builds.
Configuration Overview
| Use Case Step | Elements | Configuration |
|---|---|---|
|
Creator Workshop workflow:
To see a preview of these elements in a configuration, visit https://training.unqork.io/#/workflow/646533d1811f0f6e5b3c245f/edit. |
In this use case, you created a workspace, a workflow-type application, and the Employee Information |
|
|
Employee Information module:
To see a preview of these elements in a configuration, visit https://training.unqork.io/#/workflow/6465340be070300e1cbd6917/edit. |
In this use case, you added fields to your Employee Information module to intake employee information. |
|
|
Employee Information module:
To see a preview of these elements in a configuration, visit https://training.unqork.io/#/workflow/6465347d811f0f6e5b3c249f/edit. |
In this use case, you added Email component fields to your Employee Information module so you can collect employee and manager email addresses. You also added a Button component to trigger the Company Travel Policy pop-up modal. |
|
|
Employee Information module:
To see a preview of these elements in a configuration, visit https://training.unqork.io/#/workflow/646534a904acb7e9780ce2c1/edit. |
In this use case, you configured the Company Travel Policy pop-up modal in your Employee Information module using a Panel component. You also used Field Group and Columns components to organize your module's Express View appearance. |
|
|
Employee Information module:
To see a preview of these elements in a configuration, visit https://training.unqork.io/#/workflow/646534dba3cc90f4cb0d0135/edit. |
In this use case, you learned about reviewing submission data entered in the Employee Information workflow screen. For other workflow screens, use the same process for reviewing submission data with the DevTools Console to ensure the configuration works as expected. |
|
|
Creator Workshop workflow:
Email Validation module:
To see a preview of these elements in a configuration, visit https://training.unqork.io/#/workflow/646534fd4bb77e5fa1cfd951/edit. |
In this use case, you converted the Authenticated swimlane into the Employee swimlane for employee role access. You also created a new Task node and module in the Automated swimlane to validate that the employee email addresses had the correct company domain. Instead of configuring the content, you copied/pasted a module definition. |
|
|
Creator Workshop workflow:
To see a preview of these elements in a configuration, visit https://training.unqork.io/#/workflow/64653519811f0f6e5b3c24ec/edit. |
In this use case, you added an Exclusive Gateway node to divert the workflow path into two paths — one for valid email addresses and another for invalid ones. For invalid email addresses, you used the Message node to notify employee roles that their email address is invalid. For valid employee email addresses, you added another Task node and module to send the workflow to the Employee Travel Information screen. |
|
|
Step 8: Adding Snippets to a Module and Calculating Travel Cost |
Employee Travel Information module:
To see a preview of these elements in a configuration, visit https://training.unqork.io/#/workflow/6465352f04acb7e9780ce312/edit. |
In this use case, you added a snippet to your Employee Travel Information module. You reviewed the snippet configuration, which takes employee information from the Employee Information screen and displays it concisely for employees to see. The snippet also contained Address Search, Date Input, and Calculator components that retrieved end-user travel departure and arrival information. The snippet also displayed the estimated cost and remaining annual travel budget. |
|
Step 9: Using External API Calls to Retrieve Currency Exchange Rates |
Employee Travel Information module:
To see a preview of these elements in a configuration, visit https://training.unqork.io/workflow/6477ae9823c3b8819426dc0b. |
In this use case, you added a snippet to your Employee Travel Information module that uses internal and external APIs to calculate current currency exchange rates. You learned how Plug-In components can create API calls to get information from other Unqork modules or from external sources. You also learned how the Calculator and Data Workflow components can be used to take information from large country code and currency rate data sets, manipulate that data, and display the current exchange rate and the estimated converted cost. |
|
Creator Workshop workflow:
Manager Review module:
To see a preview of these elements in a configuration, visit https://training.unqork.io/workflow/6477aee53bfcc5f14a997ecf. |
In this use case, you created a new swimlane for Manager roles. Inside your Manager swimlane, you created a Task node and module for managers to view and then approve or deny submitted employee travel requests. In the Manager Review module, you copied/pasted the configuration from your Employee Information and Employee Travel Information modules. Then, you deleted unnecessary components and organized the module to display the employee travel request information to the manager role. Using a Panel component, you made all the employee information viewable only to the manager role. Then, you added a Dropdown component for the manager to select an Approved or Denied response. For the second part of this use case, you used a Signal node to notify employees that their travel request was successfully submitted for approval. Then, you used a Message node to notify and the manager and link them to the Manager Review screen to review the employee travel request submission. |
|
|
Step 11: Messaging Approved or Denied Travel Request Emails to Employees |
Creator Workshop workflow:
To see a preview of these elements in a configuration, visit https://training.unqork.io/workflow/6477af11cc31bc9fd848489e. |
In this use case, you used another Exclusive Gateway node to divert the workflow path based on the manager's Approved or Denied response in the Manager Review module. For the Denied responses, you used a Message node to send a Denied message to employees. For Approved responses, you used a Message node to send an approved message. |
|
Step 12: Creating a Dashboard to Display Submitted Travel Requests |
Creator Workshop application:
Manager Dashboard module:
To see a preview of these elements in a configuration, visit https://training.unqork.io/#/form/6480e19f6b6743aa0d61a4b1/edit. |
In this use case, you created a module outside of your workflow to hold your manager review dashboard. This dashboard displays all the completed employee travel request submissions for the manager to view. First, you added a Plug-In component to bring all end-user submission data into the module. Using a ViewGrid component, you organized and displayed this information by its review status. In the next step of the use case, you added a snippet containing an advanced dashboard configuration. You learned how Data Workflow components can filter data by their Approved or Denied status. You learned how Panels can organize and display data, allowing managers to see approved and denied travel requests separately. You also learned how Chart and KPI components can display data in dynamic widgets. Wrapping up your use case, you configured your workflow End nodes to redirect the manager to your dashboard after they approved or denied an employee travel request. |
Task
End
Date Input
Dropdown
Email
Button
Exclusive Gateway
Message
Signal
Columns
ViewGridUnqork Community Hub
If you are still having trouble finding a solution to your configuration, visit the Unqork Community Hub. Here, you can post questions and get assistance from other Creators and Unqork employees.
Troubleshooting Resources
The Unqork Documentation Hub holds more information that can help you identify and resolve your performance issues. Here are resources you can access to troubleshoot your application:
