• Add Fields to List Dialog Box
• Alpha Five Basics
• Automatic Backup and Revision Control of Layouts and Field Rules
• Automatically Populating Linking Field Values when Doing Data Entry
• Calculated Fields
• Calculated Values
• Changing the Caseof Words
• Coded Fields
• Controlling a Field's Width
• Copy Previous Field
• Creating a Field Rule Event
• Creating a Posting Field Rule
• Creating a Simple List
• Creating and Using a Summary Field
• Creating and Using an Email Smart Field
• Creating and Using Calculated Values
• Data Field Control Properties
• Default Values
• Defaulting a Date Field to Today's Date
• Define an Alpha Five View Query
• Dial Phone Number in Field
• Display Help Topic
• Exporting Fields from a Table
• Expression Builder
• F1 Context Sensitive Help
• Field Rule Field Events
• Field Rule Record Events
• Field Rules
• Field Rules Table Lookups
• Field Rules: Field Types
• Filtering Records to Exclude a Single Field Value
• Find Tables that Contain a Field Name
• Form Level Field Rules
• How Auto-Increment Fields Work
• Improvements V9
• List Box Table Lookup
• Mask Style
• Microsoft Word Integration
• Modifying a Form Field on the On Change Event
• Multi Field Quick Filter Dialog Box
• Override Field Definitions Dialog
• Overview of Field Rules
• Parent-Child Dialog Example
• Placing a Calculated Value on a Form
• Placing a Data Field on a Form
• Placing Bitmap and JPEG Image Fields
• Placing Image File Reference Fields
• Placing Smart Fields on a Form
• Query Builder
• Quickly Sorting and FilteringRecords
• Re-EvaluatingField Rules
• Recalculating Calculated Fields
• Required Fields
• Resize Fields to Fit Data
• Retrieving Distinct Field Values
• Returning a Different Field Than You Display
• Right-Click Menus
• Select Fields Dialog - Generic
• Select Text in a Field
• Skipping Over Fields
• Sorting and Selecting Overview
• Specify Filter Dialog
• Specify Order Dialog
• Specify Table Name Dialog
• Tracking Changes to Table Fields
• Types of Field Rules
• Update Example
• Using a Coded Lookup Field
• Using Field Rules to Generate A Table Lookup
• Using Field Statistics
• Using Object Properties for Table Lookups
• Using the Fields Panel
• Validation Rules
• When Calculated Fields are Calculated
• Xbasic View Record

Using the Fields Panel

Description

The Fields panel provides an easy way to place data fields, system fields, calculated fields, and variables on a layout. The Fields panel will list all the available data fields for your layout.

Placing Table Fields

1. If the Fields panel is not visible, select View > Drag-Drop List or click the following.

   

2. Select what to place on the form. Make a selection from the drop-down list at top. The options are:

   • "Fields with Titles"

   • "Fields"

   • "Field Titles only"

3. If you are placing titles:

   • Depress the following if you want the titles to be placed above the fields. After fields have been placed on the form, you can change the style, appearance, and other attributes of the fields.

     

   • Depress if you want the titles to be place to the left of the fields.

     

4. To place one or more data fields, select them and drag them onto the layout.

5. By default, fields initially appear as Type-In controls. You may right click on the control, select Properties..., and change the type of data control to be displayed. Refer to Setting Field Properties.

   

When adding multiple fields, you can specify their alignment as vertical or horizontal by clicking on the appropriate alignment button in the Fields panel.

Placing Summary Fields

When you are working with a form based on a set, you may want to summarize child table fields. To create a summary field:

1. If the Fields panel is not visible, select View > Drag-Drop List or click this.

   

2. Click the 'lamp' icon to enable the Summary Genie.

   

3. Drag the field onto the layout. The resulting dialog box will depend on the data in the field you selected. The following show a the Summary Genie that appears when the field contains a numeric value.

   

4. Select the summary calculation. Depending on the type of field, the options are to display:

   • "Value in the field (no summary)"

   • "Total of the field"

   • "Average of the field"

   • "Count of the records"

   • "Minimum value in the field"

   • "Maximum value in the field"

   • "Other summary function"

   • "First field value in group"

   • "Last field value in group"

5. If you select "Other summary function", you may select one of the following options:

   • "Count duplicates"

   • "First in group"

   • "Last in group"

   • "Standard deviation"

   • "Standard deviation for population"

   • "Variance"

   • "Variance for population"

6. Alpha Anywhere makes assumptions about how to perform these summaries. You may click Advanced to display the Summarization Advanced Settings dialog.

   • 1. Optionally, change the way records were grouped to calculate the summary. The options are:

     • "Grand"

     • Parent table (and higher level parents, if they exist)

   • 2. Optionally, change the name of the calculated field that will be created.

   • 3. Optionally, change the total display length of the field.

   • 4. Optionally, change the number of decimal places that will be displayed.

   • 5. Click OK to continue or Cancel to discard your inputs.

7. Click Finish to place the field or Cancel to discard your inputs.

Creating and Placing Calculated Values

The Fields panel also contains an entry labeled "". If you drag this entry onto a layout, a dialog box appears for entering an expression, the result of which is displayed on the layout. Using a calculated value you can display the result of a calculation using data from the current table or set. In addition, calculated values can also display a date and time. For example, you have an invoice form on which you want to display the total of line-items. The easiest way to create a calculated value is by dragging "" from the Fields panel to a layout.

To place a calculated field:

1. If the Fields panel is not visible, select View > Drag-Drop List or click this.

   

2. Select and drag "" onto the form.

3. When the New Calculated Field dialog appears, enter the Name of the new field.

4. Enter the Expression that defines the field or combination of fields that provide the data for the calculation. Optionally, click to display the Expression Builder to help you define this calculation expression.

5. Select the Function you would like to perform. The options are:

   • Value (of the calculation expression)

   • Count

   • Minimum

   • Maximum

   • First

   • Last

   • Count of Duplicate

   • Blank Duplicates

   • Running Count

   • Running Minimum

   • Running Maximum

   • Below are some examples of typical calculations:

     • TAX

       Calculates 5% sales tax using the Subtotal field. Value Function

       INVOICE->SUBTOTAL*.05

     • TOTAL

       Calculates the total of line-items, given that the total of each item is stored in the field Total of the Item table. Total Function.

       ITEM->TOTAL

     • TODAY

       Evaluates to today's date. Value Function.

       DATE()

   Calculated fields can be created for a specific form, or for a table or set. If you create them for a form, they are available to only that form. For more information on creating calculated fields for a table or set, refer to Functions and Expressions?.

6. Optionally, click Advanced >>> to display the Group and Sub group fields.

   • 1. Optionally, change the way records were grouped to calculate the summary. The options for the Group field are:

     • "Grand"

     • Parent table (and higher level parents, if they exist)

   • 2. Optionally, change the way records were sub-grouped to calculate the summary. The options for the Group field are:

     • "Grand"

     • Parent table (and higher level parents, if they exist)

Placing System Fields

Alpha Anywhere provides predefined system fields that you can add to your layout. These system fields can display information such as Page numbers, current date, and sort order. System fields are global fields that are available throughout the Alpha Anywhere program. You use the Drag-and-Drop List to insert system fields in a layout. The following table describes Alpha Anywhere system fields:

• PageNumber

  Prints the current page number of the layout. This predefined calculated field uses the PAGENO() function as its expression. See also Inserting Page Numbers.

• PageXofY

  Prints the page number and the total number of pages in the layout. For example, a field value of Page 1 of 8 indicates the first page in a eight page Report layout.

• Date

  Prints the computer's system date on the layout. This predefined calculated field uses the DATE() function as its expression. See also Inserting Today's Date.

• Current_Order

  Prints the sort order expression for the layout. This predefined calculated field uses the CURRENT_ORDER_EXPN() function as its expression.

• Current_Filter

  Prints the record selection expression on the layout. This predefined calculated field uses the CURRENT_FILTER_EXPN() function as its expression.

• Layout Name

  Shows the name of the current layout.

• Data Source

  Shows the name of the table or set on which the layout is based.

To place a system field:

1. If the Fields panel is not visible, select View > Drag-Drop List or click the following.

   

2. Select and drag the selected system field onto the layout.

Creating and Placing Layout Variables

You may create a variable when you are editing a layout. To create and place a layout variable:

1. If the Fields panel is not visible, select View > Drag-Drop List or click this.

   

2. Optionally, select and drag the selected form variable onto the layout.

3. Optionally, select "" and drag it onto the layout.

   • 1. In the resulting New Variable dialog enter the Name of the new variable.

   • 2. Select the Type of the variable. The options are:

     • "Character"

     • "Date"

     • "Logical"

     • "Numeric"

   • 3. Click OK to create and place the variable or Cancel to discard your inputs.