Web Forms Widget (BETA) List

<< 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.

 

ent-web_forms_widget-list_zoom50

 

Data 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 Col-Form_Status_InProgress-Icon or Complete Col-Form_Status_Complete-Icon).

Reports – Create PDF report of all data entered on the data form.

Edit – Selecting the Edit Col-Edit-Icon 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 Ent-Web_Forms_Widget-Submit_Icon 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 Col-Ent-Refresh_Button 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.

 

 

Sorting, Grouping, and Filtering Data Forms

 

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

 

ent-web_forms_widget-list_groupby_zoom50

 

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.

 

ent-web_forms_widget-list_groupby_folder_zoom49

 

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.

 

 

Uploaded Column

 

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).

 

ent-web_forms_widget-list_status_zoom50

 

Click the status bar of an individual data form to view details of the uploading process in the Status/Download window.

 

Ent-Web_Forms_Widget-List_Status_Download2

 

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.

 

 

Status Column

 

Data forms are listed with one of two statuses:

In Progress Col-Form_Status_InProgress-Icon – Active data form, which may receive future data entry.

Complete Col-Form_Status_Complete-Icon – 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.

 

 

Create New Data Form

 

New data forms can be created either by using Collect or by selecting the Create Data Form button on the Web Forms widget header.

 

ent-web_forms_widget-create_new_form_zoom50

 

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.

 

Ent-Web_Forms_Widget-Create_New_Form_Window

 

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.

 

Ent-Web_Forms_Widget-Create_New_Form_Template

 

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.

Col-Advanced_Search_Dialog

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 Ent-Web_Forms_Widget-Create_Icon icon to the right of the new data form to open the Web Forms Grid Entry screen and begin entering data.