Copyright © 2019 EarthSoft, Inc • Modified: 12 Nov 2019
The Activity form in EDGE provides a user-configured custom form for data that would otherwise be collected in the Activity tab. Like the Activity tab, the Activity form is used to populate the LocationParameter_v1 section of the EDGE EDD.
The Activity Form may be made visible using the “Show/Hide Tabs” item on the EDGE Menu as explained in the Data Tab Chooser article. There are several Activity forms that have identical functionality, but may be configured separately to provide different, unique forms.
The Activity form is comprised of sections. Each section of the Activity Form represents an Activity Group. These can be easily added to the database via an EDD using the Configuration Format, which is available in the Configuration Format article. Alternatively, they may be added to the database using SPM Activity Tables as described in this Setup Activity Tables.
Populate groups as follows:
•group_code = the name of the section
•member_code = the name of a line item in the section
•member_desc = the user-friendly description of the member
•default_units = the units for this parameter (optional)
•display_order = numeric value to determine the order the parameters appear on the form
•remark = either "yes_no_values" to denote a yes/no line item, the name of a valid enumeration in the EDGE-enum.xml file containing the possible entries for the line item, or an EDGE data type such as EDGE_TEXT or EDGE_DateTime
Following are examples of valid entries for remark:
•Blank or "EDGE_TEXT" = EDGE will expect text entries (up to 255 characters)
•"EDGE_Integer" = EDGE will expect integer values (1,2,3,4,5)
•"EDGE_Date" = EDGE will expect Date values (v6.4 and up)
•"EDGE_Time" = EDGE will expect time values in 24 hrs format
•"EDGE_DateTime"= EDGE will expect DateTime values
•"EDGE_Label"= EDGE_Label can be used for a header, no values are expected. To make it a white space (blank line) you need to enter a "space" in the description.
•The List Name from the format enumeration (…-enum.xml) file (e.g., enter “Colors” if that is the name of an enumeration list for colors).
The parameters may be edited in EQuIS Professional in RT_GROUP_MEMBER.
1.Once the necessary Activity Groups are loaded into the EQuIS database, follow these steps to set up an Activity Form:
2.Create a new Reference Value File (RVF) to use in EDGE. Go to Create a Reference Value File for more information on this process.
3.Launch EDGE and load the new RVF.
4.Configure the Activity Form caption as in Form Logos (optional).
5.Add sections to the Activity Form.
a.With the Activity Form tab selected, go to the Form tab located at the top ribbon.
b.Choose the desired Activity Group from the drop-down menu, i.e. Activity Sections (Activity Group), and subsequently the Activity Group Member (Surrounding Area)
c.Choose whether to display only the Activity Group Member description or both the code and description.
d.Click Save. Sections will be displayed on the form in the order in which they are added to the form or as specified in RT_GROUP_MEMBER.DISPLAY_ORDER.
e.Additional sections may be added to the form in the same way. Each Section is collapsible.
6. The Activity Form may be customized with a logo (for further information click on Form Logos).
Once setup is complete, the Activity Form is ready for use as follows:
1.Select the desired Task in the Task Chooser.
2.Select the desired Location in the Location Chooser.
3.Click New to create a new instance of the Activity Form for the selected Location.
4.Populate the values in each section as appropriate.
5.To create another instance of the form for the same Location, click New again. Note that two instances of the form cannot exist at the same date and time, as these values help differentiate record uniqueness in the LocationParameter_v1 section of the EDGE EDD.
6.To navigate between instances of the form at a particular Location, use the Record Chooser located on the form tab. Note that you can only access to the record chooser if more than one instance of the form exists at the selected Location.
7.To delete an instance of the form, click Delete, then click Yes to confirm.
8.To print an instance of the form, click Print.