Form Admin Tool
The Form Admin Tool is used by a form administrator to manage workflow routing and CI for a single form transaction, as well as to quickly access form data.
Navigation: Manage GT eForms 3.x > Form Admin Tool
Search For eForms
To access the Form Admin Tool, form administrators can search for an eForm using the parameters below. Click on a link in the results list to access the Form Admin Tool for that eForm.
| SEARCH FIELD | SEARCH FIELD DESCRIPTION |
|---|---|
| Form ID | Number assigned to an initiated form |
| Form Type | Unique identifier provided on the Form Setup table |
| Form Family | Form Family used for the Form Type |
| Form Condition | Either the default form condition or another form condition configured on Form Setup |
| Form Status | Status of the form based on its progress through a workflow (Authorized, Denied, Executed, In Error, Saved, Pending, Withdrawn) |
| Original Operator | USERID of the Form Creator. |
| Originated Date | The date a form was submitted. If looking for forms submitted in a date range, use the “between” option in the operator dropdown list. |
| Last Date | The date a form was last updated. If looking for forms updated in a date range, use the “between” option in the operator dropdown list. |
| Form Key 1* | Form Key data in Key Number 1, from the Form Key Data located in the Form List tab. |
| Form Key 2* | Form Key data in Key Number 2, from the Form Key Data located in the Form List tab. |
| Form Key 3* | Form Key data in Key Number 3, from the Form Key Data located in the Form List tab. |
Once you select a form, you can change the form key order on the Form List tab in the Form Key Data section.
Main Page
Use the Main Page tab to view selected eForm Data, view an eForm AWE Workflow path, add AdHoc approvers to the path, add approvers to the current step, access eForm Links, access eForm Actions, view and add eForm Comments.
Standard Form Transaction Alert
The screenshot below shows an example of the type of alert users will see when they open a Standard form transaction in the Form Admin Tool and the Form Type is using Helium Performance. They will have an option to convert the individual form transaction to Helium from within the Admin Tool via a Convert Form ID button.
To convert all Standard transactions for a form type after activating Helium Performance for the Form Type, we recommend using the Standard Form Data Converter. Please refer to the documentation for more information.
eForm Data
This group box displays certain key eForm data to verify the form administrator is accessing the expected form.
| FIELD | VALUE/USE |
|---|---|
| Form ID | Form ID of the form selected in read-only view |
| Form Type | Form Type of the form selected in read-only view |
| Manage (link) | Opens the Form Setup page used to manage the setup for the Form Type. This link will only show if the user has access to the Form Setup component. |
| Form Status | The current status of the form selected |
| Form Condition | Form Condition of the form selected in read-only view |
| Reload Form | Refreshes the data on the page |
Approval Workflow
This group box displays key eForm data for the workflow of the form. Through the “Choose Action” box the form administrator can approve the form as a user set to the current approval stage, insert an approver into the current stage, or manage AdHocs.
| PAGE OBJECT | FUNCTIONALITY |
|---|---|
| View/Hide Comments | Expands the Comment History window shade (see the Comments section) |
| Approver Name / “Multiple Approvers” (Link) | Opens the list of Approvers for the step (including approvers included in rosters) and displays general/contact information for each user. |
| Choose Action - Approve | Allows admin to approve the form at its current step as an approver in the workflow for that step. Admin can select the user from the list in “As Approver.” |
| Choose Action - Insert Approvers | Insert additional approver or reviewer at the current step in the workflow |
| Choose Action - Manage AdHoc | Allows admin to add approvers to the workflow at any point, request information, and start a new path. Click “Save AdHoc Changes” to save the changes, or “Discard Changes” to delete the changes. |
| Request Information (only shows when “Manage AdHoc” is the selected action) | Puts current approver on hold and sends approver a notification |
| Start New Path (only shows when “Manage AdHoc” is selected action) | Starts a new Approval Path. Click the link and a window will open, prompting the user to enter a User Id to be assigned to the new approval path. The approval path will start in “Not Routed” status. |
| Roster icon | Marks current steps as Admin Approved |
| Add as Approvers | Saves new approvers to the workflow |
| “as Approver” dropdown | Provides a list of users that the admin can approve as. Note: When an admin approves as another user, the workflow shows approved by the user selected and the Form Log will show “GTAdmin:[OPRID]:” at the beginning of the step title, and will record the admin’s user ID |
For any workflows using G3FORMLIST_XRF (GT Basic Workflows), there is a view called G3AWE_FRM_USTEP that can be queried using a Process query type to see the approval history for eForms. The view allows you to see which users approved, didn’t approve, were skipped, and were admin approved. The view also includes the User IDs, timestamps, and any terminated workflow history when the form has been resubmitted. You must use the Process query type when querying the new view.
eForms Links
The target pages for the links below may trigger pop-up blockers. Enable pop-ups for this URL in order to use this feature.
| PAGE OBJECT | FUNCTIONALITY |
|---|---|
| View | Opens the eForm in the View Task |
| Update | Opens the eForm in the Update Task |
| Users with Worklist Items | Opens the Worklist Items tab |
| Form Action Items | Opens the Action Items tab |
eForms Actions
eForm Actions allow an administrator to update the status of an eForm, regardless of its current status or progress through the workflow.
| PAGE OBJECT | FUNCTIONALITY |
|---|---|
| Resubmit | Restarts the workflow from the beginning of the approval process, reinstating original assignees. Any ad hoc or alternate approvers are removed. Resubmit, Recycle, Deny, Withdraw, Authorize, Authorize Without IB, Execute, Workflow, View, and Update links are visible. The Integration Broker Section is not visible. |
| Recycle | Stops all AWE routing and sends the form back to the initiator. This includes any configured worklist or email notifications setup for the form type. Resubmit, Recycle, Deny, Withdraw, Authorize, Authorize Without IB, Execute, Workflow, View, and Update links are visible. The Integration Broker Section is not visible. |
| Deny | Denies the form. Resubmit, Recycle, Authorize, Authorize Without IB, Execute, and View links are visible. Deny, Withdraw, Update, and Integration Broker Section are not visible. Workflow is view only. |
| Withdraw | Withdraws the form. Resubmit, Recycle, Authorize, Execute, and View links are visible. Deny, Withdraw, Update, and Integration Broker Section are not visible. Workflow is hidden. |
| Authorize | Bypasses the workflow and triggers the integration broker by setting the form status to Authorize. Resubmit, Recycle, Withdraw, Integration Broker Section, and View links are visible. Deny, Authorize, Authorize Without IB, and Update links are not visible. Workflow is view only. |
| Execute | Bypasses the workflow and marks the form as done without triggering any integration logic. Resubmit, Recycle, Withdraw, Integration Broker Section, and View links are visible. Deny, Authorize, Authorize Without IB, Execute, and Update links are invisible. Workflow is hidden. |
| Authorize Without IB | Same as Authorize, but runs processes in the user’s session instead of going through the integration broker while setting the form status to Authorize. Resubmit, Recycle, Withdraw, Integration Broker Section, and View links are visible. Deny, Authorize, Authorize Without IB, and Update links are not visible. Workflow is view only. |
Message Status
This section shows the status of the form processing the CI (Component Interface), either run via the Integration Broker or the User Session. Errors in the CI can be viewed here, and forms can be resubmitted.
Comments
The Comments section allows an administrator to insert a comment onto an eForm.
| LABEL NUMBER | PAGE OBJECT | FUNCTIONALITY |
|---|---|---|
| 1 | Comments History | Displays all eForm comments from eForm users and administrators, in reverse chronological order |
| 2 | Your Comment text entry | Plain text entry field |
| 3 | Add Comment | Click to insert text as a comment in Comment History |
Form Log
The Form Log tab in the Form Admin Tool displays the eForm Transaction / Signature Log for review. This log captures an audit log of all actions for this form.
Worklist Items
The Worklist Items tab displays the User ID and Name of any user that currently has a worklist item associated with this form. Forms that do not generate worklist items according to the setup on the Form Setup table will not see any users in this section.
Form Data
Form data allows an administrator to see the data stored in all the fields on the form. This can help when troubleshooting form issues and errors. In addition to searching the data, those with access to this tab can change the data to directly update the form. The need to use this to update the form should be very limited. Making changes here can break the form if the XML/JSON structure is compromised. There is no audit on these changes. Contact support@gideontaylor.com if you have questions or concerns about this tab.
| Form Data tab – Standard |
|---|
 |
| Form Data tab - Helium |
|---|
 |
| PAGE OBJECT | FUNCTIONALITY |
|---|---|
| Form Buffer | Displays the form data and allows edits to it. The Form Buffer is blank when the Form Data tab is opened. |
| Save XML to eForm (Standard) Save JSON to eForm (Helium) | Click this button to save any edits to the form data. CAUTION: Saving a blank Form Buffer will clear all data from the current form. |
Action Items
The Action Items tab allows administrators to see any action items that users were required to acknowledge.
Form List
All the record fields on the G3FORMLIST for this form will be displayed here for debugging purposes. It is also a reference for administrators to see the original user and date originated, the last user along with the date/time, etc. Forms created in 3.50 Helium will have a “Y” next to “Helium Performance.” Forms created in Standard will have an “N” next to “Helium Performance.”
In the Form Key Data section, the column for Key Number is what controls the first three fields that appear on the search page. To change the key order, renumber the rows then click the Save Form Key Data button.
Notification Log
The Notification Log shows a list of all the notifications triggered for the selected Form ID.
If IB services are used to send emails, those notifications may not display on this log.
| PAGE OBJECT | FUNCTIONALITY |
|---|---|
| DateTime | Timestamp when the notification was sent |
| User ID | The user who triggered the email |
| Notification Type | Displays either email or worklist |
| Form Action | The form action which triggered the notification |
| Notification Event | The form event which triggered the notification. Examples include routing and message from the email tool. |
| Email Template | The email template associated with the email notification |
| Subject | Displays either the email subject or worklist subject. Click the link to view the content of the message. |
Notification Message Content
When a user clicks the hyperlink in the “Subject” column on the Notification log tab, a modal window displays the content of each notification in the log, as shown below.
| PAGE OBJECT | FUNCTIONALITY |
|---|---|
| Form ID | Form ID associated with the notification |
| DateTime | Timestamp when the notification was sent |
| Notification recipient(s) | Field will show you all the recipients that we sent the email |
| Body of window | Body of the email including any dynamic content |