Properties Defined
Properties are the aspects of form or element of a form that tell the form what the item is supposed to do, look like and behave. The properties box will always display these aspects for the selected item. This topic defines the available properties for the following elements:
- Forms
- Field
- Sub Report
- Group Properties
- Sub Form
Setup > User Tools > Form Designer > Form Designer
Form Properties
The items listed below are available in the Forms Properties pane.
Disclaimer: If you modify any property that is indicated with, "Do Not Edit this field," you may adversely impact or render the system unavailable.
- Form Family - The group of forms, separated by function (such as, diagnosis versus service), that contains the specific form.
- Form Name - Name used to identify the form.
- Form Code - ID code used to identify the form. You cannot enter spaces or special characters in the Form Code field.
- Form Program - The program used for myEvolv to render the form. The value is copied forward on this form. Do not edit this field.
- Form Program Cross-Browser - The program used for cross-browser interface to render the form. The value is copied forward on this form. Do not edit this field.
- Default Form - The default form used for the listing. This value is copied forward on the form. Do not edit this field.
- Driving Form Line (used only for sub-forms) - Expands the sub form list of all look up table items as a check box. Do not edit this field unless directed by Netsmart. Important: A large look up table may cause the system to become unresponsive.
- List Condition - You can enter a database script to filter the list results. Do not edit this field.
- Script File Links - JavaScript files loaded only for this form. Do not edit this field.
- Form Height (px) - Customize the form height in pixels. Note: Only enter a value either here or in the Form Size (%) field.
- Form Width (px) - Customize the form width in pixels. Note: Only enter a value either here or in the Form Size (%) field.
- Form Size (%) - Enter a percentage of the size of the window in relation to the size of the users desktop. For example, if your desktop is 1024 x 768 and you set this field to 50%, the form will be 512 x 384. Note: Enter a value either in the pixel sized fields or in the Form Size (%) field.
- Before Save Code - You can associate a script to this form in order to prompt a system action after the user clicks Save and before the system commits the changes. An example of an action is a message prompt display.
- After Save Code - You can associate a script to this form in order to prompt a system action after the the system saves the changes. An example of an action is a message prompt display.
- After Delete - You can associate a script to this form in order to prompt a system action after the user deletes the form. An example of an action is a message prompt display.
- Help File - No longer supported. Do not edit this field.
- Help Content ID - Internal use only to direct the system to a specific help file. Do not edit this field.
- Is Agency Name Printed on Forms? - If this flag is checked, the system will print the agency name in the top middle (title) of the report.
- Is Template? - When a test or plan form is created, the system copies from the template form and updates it on the fly.
- Group Event Form? - This form will become an option to select when creating group events. This is the form available to be filed on the individual record within the group event.
- Defran Supplied - Indicator that the form is provided by default with the system and the form is not customizable.
- Is User Defined - Indicator that the form is custom created by your agency and is modifiable.
- Before Load Code (used only by non-subforms) - You can associate a script to this form in order to prompt a system action before loading the form. An example of an action is a message prompt display.
- After Load Code - You can associate a script to this form in order to prompt a system action after loading the form. An example of an action is a message prompt display.
Field Properties
Items below with a * cannot be changed on existing fields on the form created by Netsmart.
Items with a ** cannot be changed on existing fields and should not be modified on new fields unless specific instructions are given to you by a Netsmart Representative.
Note that these properties are the same for event log fields, main data table fields, and extension table fields (udf's in table_x).
- *Column - Table column name. Same as field name.
- Caption - What displays on the form. For example, a column's field name in a table may be eye_color but you wish to display to the user as Eye Color.
- Order In Group - Numeric value noting its position in the group.
- *Display Type Code - Allows you how to show the data in the form. For example, date/time will display in two fields: a date field with 01/01/2006 and a time field with 10:00AM.
- *Display Size - Size in pixels of the data element. Recommend to not use.
- *Max Size Allowed - Total amount of characters that can be entering into the field. Recommend not to use.
- *Instructions - Text entry that appears when a user hovers the mouse over the caption to let the end user know what they should be entering in the field.
- *Is Add Only - Use this flag if you wish to allow a user to add data to the field now, but not change it later.
- Is Visible - Whether the field is visible to the user. Note that some fields already on the form created by Netsmart can be flagged.
- Is Visible on Subform - Whether the field is visible if the form is used as a sub form. Note that some fields already on the form created by Netsmart can be flagged.
- Is Listed - For event based forms, if this is flagged, the field and data will be listed in the formset if the entry is expanded. In addition the form used as the default form on the form set member, all of its field that are marked as listed will appear when there is more than one entry.
- Is Modifiable - Whether the field is modifiable. Differs from Is Add Only in that if field is not marked modifiable, user can never add an entry.
- **Use for Order By
- **Is Order Descending
- Required - Flag noting whether this field is required in order to save the form.
- *Look-up Table Used - For fields that will be picklists from other tables, this will allow you to choose the specific lookup table related to the column entry entered.
- **Formset to call
- **Depends On
- **Depends On (other)
- **On Change Event
- **On Click Event
- **Default Value
- **Apply Default On Save
- **Disable Rule
- **Erase on Disable
Group Properties
Items with a * cannot be changed on groups that Netsmart has defined.
- Caption - Description of the group.
- Order In Form - Numeric value noting its position in the form.
- *Instructions - Text entry that appears at the top of the group that you can add to let the end user know what they should be entering in the section.
- *Visible? - Whether the group is visible on the form.
- Show as a Tab? - Allows the section to appear as a tab at the bottom of the form.
Sub Form Properties
Items below with a * cannot be changed on existing fields on the form created by Netsmart.
Items with a ** cannot be changed on existing fields and should not be modified on new fields unless specific instructions are given to you by a Netsmart Representative.
- Caption - Name of the sub form that displays on the form.
- *Sub Form Family - Similar to Form Family. Sub Forms in myEvolv are grouped into families. You must select the sub form family first, then select the appropriate Sub Form.
- *Sub Form - The sub form you wish to use.
- **Sub Form Program
- Order In Group - Numeric value noting its position in the group.
- Is Required?(at least one record on hand) - Same as required for fields. Flag if the user is to enter at least one record in a sub form before saving the main form.
- Is Visible - Whether the sub form is visible to the user. Note that some sub forms already on the form created by Netsmart can be flagged.
- Is Listed - For event based forms, if this is flagged, the sub form caption and data will be listed in the formset record when expanded.
- Is Modifiable - Whether the field is modifiable.
- Vertical Size, Px - Vertical size it will appear as in the main form, measured in pixels. Leave empty for Netsmart's default size.
- **Disable Rule
Sub Report Properties
- Caption - Name of the sub report that displays on the form.
- Sub Report - Here you choose the sub report to be used. This can be either a System Defined Sub Report or a User Defined Sub Report.
- Order In Group - Numeric value noting its position in the group.
- Is Visible - Whether the sub report is visible to the user. Note that some sub reports already on the form created by Netsmart can be flagged.
- Is Listed - For event based forms, if this is flagged, the sub report caption and data will be listed in the formset record when expanded.
- Vertical Size, Px - Vertical size it will appear as in the main form, measured in pixels. Leave empty for Netsmart's default size.
