Skip to main content

Form Definition - Object Definition section

  1. Last updated
  2. Save as PDF

Add and modify fields contained in the section.

Prerequisites:

  • You must have a section selected on the Section Definition section.

  1. In the Object Definition table, click Add New Item.

  2. The Object Order field displays the form object order. 
  • Changing the object order number moves the object to a different position in the form.
  • Objects are added from the left and the top of the form screen.

  1. In the Type of Object field, select the type of object. The object type affects which fields in this section are enabled.

Note: The Chart View displays the fields in the order in which they are ordered in Form Definition. 
To change the order of display in the Chart View, go into the Form Definition form, and go into the 'Object Def.' section and observe the objects are in a certain order. 
If you change the columns to a different 'Object Order', they will display in the Chart View in that order. 
The order of the fields in Form Designer only controls the display in the form itself, not in the Chart View.

Client Picture

The Client Picture object allows you to include an identifying photo of the client on your form.

  1. The Object Width field defaults to Half Screen. The Full Screen setting is not available for Client Picture.

  2. In the Force New Page field:

  • Select Yes to display the object on an additional sub-section. This setting has no effect for the first object on the section.
  • Select No to create a new sub-section as new fields are added in the section through RADplus modeling.
    It is recommended to add table columns and command buttons to a form, then file the form, before selecting Force New Page.

  1. In the Allow User to update Client Picture Object field, select Yes to enable end-users to edit the client's picture via a right-click menu.

Label

A label allows you to categorize a set of objects under a heading. These can also be used as hyperlinks.

  1. In the Label Description field, enter the label description.

  2. In the Object Width field:

    • Select Half Page to display the object across half of the screen, using a center line.

    • Select Full Page to display the object across the full form screen.

  3. In the Force New Page field:

    • Select Yes to display the object on an additional sub-section. This setting has no effect for the first object on the section.
    • Select No to create a new sub-section as new fields are added in the section through RADplus modeling.
      It is recommended to add table columns and command buttons to a form, then file the form, before selecting Force New Page.

  1. In the Is the Label Associated with a Hypertext Link field, select Yes to associate the label with a hypertext link.

  2. In the Hypertext Link field, enter the link address.

  3. Click Test Hypertext Link to test the link.

  4. In the Label Appearance field, select if the link ought to display in bold and/or italics.

Note: Regarding Labels, the Chart View only displays the text that is in Form Definition, not what is in Form Designer. There is a 180 character limit on labels in Form Definition, so the Chart View will display the first 180 characters, regardless of what is in Form Designer.

Line

A line allows you to divide the objects on the form with a visual marker.

  1. In the Object Width field:

    • Select Half Page to display the object across half of the screen, using a center line.

    • Select Full Page to display the object across the full form screen.

  2. In the Force New Page field:

    • Select Yes to display the object on an additional sub-section. This setting has no effect for the first object on the section.
    • Select No to create a new sub-section as new fields are added in the section through RADplus modeling.
      It is recommended to add table columns and command buttons to a form, then file the form, before selecting Force New Page.

Report

Report buttons allow you to launch a report from within your modeled form.

  1. In the Object Width field:

    • Select Half Page to display the object across half of the screen, using a center line.

    • Select Full Page to display the object across the full form screen.

  2. In the Force New Page field:

    • Select Yes to display the object on an additional sub-section. This setting has no effect for the first object on the section.
    • Select No to create a new sub-section as new fields are added in the section through RADplus modeling.
      It is recommended to add table columns and command buttons to a form, then file the form, before selecting Force New Page.

  3. In the Report Command Button Caption field, enter the report command button title.

  4. In the Report field, select the report to be generated by clicking the report button. Reports are added through the Import Report for Command Button Launch form.

  5. In the Send Report Directly to Default Printer field:

    • Select Yes to print reports when a report button is clicked.
    • Select No to display the report through the report viewer.

  6. In the Show Group Tree field, select Yes to show the group tree in reports.

  7. In the Report Parameter fields - select the report parameters in the order they will be passed to the Crystal Report.
    Note: A Crystal report with matching parameters must be loaded into myAvatar via the Import Report(s) form.

ScriptLink Button

ScriptLink buttons allow you to run a script for populating fields on your form that are based off of data found elsewhere in the system or need some type of calculation. Except for the triggering event, there is no difference between ScriptLink buttons and ScriptLink calls which deliver the full form contents to the script and may update the form fields based on the script return. 
ScriptLink buttons are prohibited from placement on multiple iteration form sections.

  1. In the Object Width field:

    • Select Half Page to display the object across half of the screen, using a center line.

    • Select Full Page to display the object across the full form screen.

  2. In the Force New Page field:

    • Select Yes to display the object on an additional sub-section. This setting has no effect for the first object on the section.
    • Select No to create a new sub-section as new fields are added in the section through RADplus modeling.
      It is recommended to add table columns and command buttons to a form, then file the form, before selecting Force New Page.

  3. In the ScriptLink Command Button Form field, enter the ScriptLink button name.

Table Column

A Table Column object allows you to include anything that you have populated in the table related to this form (from the Table Definition form).

  1. In the Initially Required field, select Yes if the object is required when the form is opened.
    As a best practice, it is recommended to make only critical fields initially required. If you intend to use a field with event logic, you can require it upon conditional logic.

  2. In the Initially Enabled field, select Yes if the object is enabled when the form is opened.

  3. In the Object Width field:

    • Select Half Page to display the object across half of the screen, using a center line.
    • Select Full Page to display the object across the full form screen.

  4. In the Force New Page field:

  • Select Yes to display the object on an additional sub-section. This setting has no effect for the first object on the section.
  • Select No to create a new sub-section as new fields are added in the section through RADplus modeling.
    It is recommended to add table columns and command buttons to a form, then file the form, before selecting Force New Page.

  1. In the Table Column field, select the table column. Tables with Primary/Secondary selected in the Type of Table field (Table Definition form) are available.

 

The following fields are enabled depending on the functionality of the selected Table Column type.

  • In the Number of Scrolling Text Box Rows field, enter the number of rows you want to display in a scrolling text box before the scroll bar displays.

  • In the Expand Combo/List Box to Full Object Width field, select Yes to display the object across the full screen. Select No to use a horizontal scroll bar to see the full text.

Other File Lookup objects

  1. In the Specify specific alternate lookups for “Other File Lookup” field:

    • Select Yes to include alternate lookups in an Other Entity Lookup field.
    • Select No to use the default selection.

  2. In the Alternate Lookups field, select alternate lookups for an Other Entity Lookup field.

Defaulting Objects 

Define how information populates when a new table row is created:

  1. In the Default to Specific Value on Addition of a New Table Row field, select Yes to populate a default value in a table row when that table row is accessed.

  2. In the Default (Date) and Default (Time) fields, select the default date and time value.
    “Today” can be selected for non-episode based applications.

  3. In the Default (Time) field, select the default time value.
    In the following 'Default' fields, select the default values that will populate the field.

    • Location entries

  4. In the Default (State) field, select the default state value.

  5. In the Default (ZIP Code) field, select the default value.

    • Number entries

  6. In the Default (Decimal) field, enter the decimal value.

  7. In the Default (Integer) field, enter the default value.

    • Default staff
      In the Default (Staff Lookup) field, select if the staff member associated with the user will populate staff lookup fields.

Multiple Iteration Grid objects

  • In the Include table column in multiple iterations grid field, select Yes to enable the table column in a multiple iteration grid.
    If the grid is sorted, the sort table column must be included in the grid.

List Boxes and Locked Dictionaries

Multiple Response Dictionaries:

  • In the Number of Multiple Response List Box Rows field, enter the number of list box rows to display.

Single Response Dictionaries:

  1. In the Allow clearing of form buttons if dictionary is locked field, select Yes to allow the selection in a single response dictionary to be cleared using the F5 key.

  2. In the Exclude from Data Collection Instrument field, select Yes to prevent the field from displaying in the form screen.

Selection Leaf objects

A selection leaf allows you to link a modeled form to a treatment plan.

  • In the Include a Clear Button in Selection Leaf field, select Yes to display a clear button.

SQL Query objects

  1. In the SQL Query field, enter SQL information:
    The query must contain a SELECT and a WHERE expression. WHERE expressions must contain '?PATID'.
    WHERE expressions can contain up to 25 parameters, or 26 if it is an SQL Query-Search type (?PATID and ?EPID and [etc.]).

  2. Click Validate SQL Query to perform an SQL query validation check.

 

  1. Back to top
  • Was this article helpful?

Recommended articles

  1. Page type
    Reference
  2. Tags
    1. av:rad
    2. myAvatar Modeling
    3. myAvatar RADplus
    4. role:systemadmin
    5. search:ready