<< Click to Display Table of Contents >> Navigation: Enterprise > Widgets > Web Forms > Web Forms Widget (BETA) List |
The Web Forms widget will display the existing data forms for the selected facility or facility group on the Web Forms List, which is similar in structure to the Collect Enterprise Data Forms page. Users can also create a new data form from the Web Forms List.
The Web Forms widget provides a summary list of data forms available for data entry. Data forms must meet three criteria before displaying in the list:
•Data form must have a user group that includes the current user.
•Data form must be associated with the current facility or facility group (session facility on dashboard).
•Template upon which the data form is based must match a selected template in the widget’s settings (if specific templates are selected in the widget settings). See the Web Forms Settings Manager article for more information.
By default, the following information is provided for each data form. The columns displayed on the Data Forms page can be configured in the widget’s settings (see the Web Forms Settings Manager article).
•Data Form – Data Form name.
•Template – Template name and version number.
•Facility Code – Facility where the form is deployed.
•Format – Template format upon which the data form is based; frequently a specified EQuIS EDD format.
•Date – Date the data form was created.
•Uploaded – Number of times the completed data form was uploaded from the Web Forms widget; icons shown for success or failure of data forms to be processed by Enterprise EDP. EDDs and error logs may be accessed from the Uploaded column.
•Status – Data form status (In Progress or Complete ).
•Reports – Create PDF report of all data entered on the data form.
•Edit – Selecting the Edit icon allows further editing of the data form. See the Web Forms Grid Entry article for more information about editing data forms.
•Submit – Selecting the Submit icon sends the data form to be checked by Enterprise EDP using the EQuIS format defined in the Collect template upon which the data form is based. Users will be asked to confirm data submittal prior to uploading to EQuIS.
•Clear – Selecting the Clear X icon will remove content of the data form.
The Refresh button in the header of the Web Forms List allows the user to refresh the list without having to refresh the site or leave the widget.
The Search box can be used to filter the data forms. Type a search into the search box to filter the list of data forms. The display of data forms in the widget will be limited to the search string.
Each of the columns in the Web Forms List can be sorted alphabetically or chronologically. The mouse cursor changes from the default arrow to a pointer when hovering over selectable items on the Web Forms List. Clicking a column will sort the list by that column.
The data forms can also be grouped into folders based on the following columns. To organize the data forms, click the Group By selector button at the widget header to open a drop-down menu and choose the desired column.
•Template Name
•Facility
•Format
•Date
•Status
The view will change when organizing the data forms to a file folder like setup. Clicking on each of the tabs will open that folder view to see the data forms available in that folder.
Note: Once a column is chosen for folder sorting, it is removed from the columns that are viewed in the folders view, as the folder tabs now display the selected column values. |
---|
The Uploaded status provides the number of times the data form was uploaded from the Web Forms widget and displays the status of the data form upload to EQuIS through EDP as indicated by color.
Orange – The data form is still processing.
Grey – The data form was received but not yet sent to EDP.
Green – The data form passed EDP checks and was sent to the database.
Red – The data form did not upload successfully to the database (i.e., it was rejected by EDP). If this happens frequently due to data issues, consider adding other checks to the form template (e.g., using the Error attribute on form fields to ensure users can only enter valid data).
Click the status bar of an individual data form to view details of the uploading process in the Status/Download window.
The upload details are described below.
•Users – User who uploaded the data form.
•Status – Status of EDP submission, which matches the colors displayed on the Web Forms List. The Fail icon is displayed in red, the word Processing is orange, the word Pass is Green, and the word Received is Black.
•DateTime – Date/time stamp of submission.
•Actions – Select the drop-down menu to choose from the following actions:
•Download EDD – Download the EDD (*.zip) file. This is generated by processing the submitted data form into the EQuIS format defined in the template upon which the data form is based.
•Send to EDP – Shows if the data form has been received but not yet pushed to EDP. Click here to submit to EDP.
•Download Error Log – If EDP reports errors when processing the EDD, the error log is useful to understand why the EDD failed. Select this action to download the error log.
Data forms are listed with one of two statuses:
•In Progress – Active data form, which may receive future data entry.
•Complete – Data form is archived. This status is set by an Enterprise user by clicking the Testing or In Progress status icon and confirming to mark the form as complete. The data form is not visible on the Web Forms List unless the “Show Complete” check box on the widget header is enabled.
Any data form with a "Complete" status can be changed back to an "In Progress" status. Select the Show Complete check box to display all completed data forms. Find the desired data form and click on the Complete status icon. Move the selected data form back into the list by confirming to mark the dataform as In Progress.
Note: Marking a data form as "Complete" sets ST_COLLECT_FILES.EDD_STATUS for the data form to TRUE. |
---|
New data forms can be created either by using Collect or by selecting the Create Data Form button on the Web Forms widget header.
The Create Data Form dialog opens. Enter a Name for the data form and edit the form details in the available fields. Note that Red Bold* denotes required fields.
Note: Data form names are limited to 60 characters. The name of the data form cannot contain: •periods (.) •forward slashes (/) •backward slashes (\) •ampersands (&) •colons (:) •apostrophes (')
If these characters are included in the name, an error message will be displayed and the data form will not be created.
Special characters for languages supported in EQuIS Collect can be used in data forms and form names. |
---|
Click on Select Form Template to open a searchable dialog window of existing templates listed in alphabetical order.
Advanced Search – Click the down arrow to expand the advanced search dialog window. Items that can be searched (e.g., Name, Version, Description) will appear in the first drop-down. By default, the first drop-down will be selected as Any. The Any option will search all the items to match the expression with any of the properties. The second drop-down allows the user to select an operator (e.g., Starts With, Ends With, Equals, Contains). By default, the operator is set to StartsWith. The operator defines how the expression is matched to the items being searched. Enter the expression to be searched in the text field. Multiple expressions can be set by clicking the + button below the first expression. Expressions can also be removed/cleared by clicking the – button to the left of each expression. To collapse the advanced search dialog, click the up arrow at the bottom of the advanced search dialog. Note that collapsing the advanced search will not clear search expressions that have been setup.
Note: If the selected template contains prepopulation, then the 'Use Pre Population Report' check box is displayed along with the associated report. Prepopulation can be previewed. If the user unchecks the 'Use Pre Population Report' check box, then the resulting data form will be blank. |
---|
The Facility auto-populates with the active Facility session for the Collect Enterprise dashboard and cannot be changed. If creating the data form while in a Facility Group or a specific facility has not been chosen on the dashboard, a drop-down will appear requiring the user to select a specific facility to assign to the data form.
The User Groups will auto-populate to the User Groups currently assigned to the selected template. To change the User Group settings, select Users Groups to open the Groups window. Check the boxes for all desired user groups and select the OK button.
Files can be attached to the data form. See the Create New Data Form article in the Collect documentation for more details on attaching files.
Click the Save button to create the new data form. The new data form will display on the Web Forms List. Click the Create icon to the right of the new data form to open the Web Forms Grid Entry screen and begin entering data.
Copyright © 2023 EarthSoft, Inc • Modified: 14 Mar 2023