Contact

Contents Show

The Contact screen is used to manage a contact record for a corporate parent and can be displayed in Add mode or Edit mode.

Add Contact screen

Edit Contact screen

Screen Access

Screen Access

To add a new contact:

  • Display the Corporate Parent screen > Click the Add button below the Corporate Contacts data grid.

To edit an existing contact:

  • Display the Corporate Parent screen > Click the Edit button in the Corporate Contacts data grid.

Interface Initialization

Upon initial display of the screen, the following occurs:

  • The OK button is visible and enabled as the default.

  • The Cancel button is visible and enabled as the default.

In Add mode:

  • The title bar text is set to "Add Contact".

  • The Lookup button is visible and enabled.

  • All data controls are enabled and blank.

In Edit mode:

  • The title bar text is set to "Edit Contact".

  • All data controls are enabled and display the previously saved values.

Screen Elements

Unless otherwise stated below, all controls on the Contact screen are visible and enabled when:

If one or more special conditions exist that affect a control on the Contact screen, the condition(s) are documented for that specific control below.

Title drop-down list box

  Select the title in the Title drop-down list box.

The list is populated with data from the Description column of the Reference Dictionary table where the category column value equals "VndTitle".

Salutation drop-down list box

  Select the salutation (For example, Mr., Mrs., Miss, Ms., Dr., and so on.) in the Salutation drop-down list box.

The list is populated with data from the Description column of the Reference Dictionary table where the category column value equals "Salutation".

First Name text box

  Enter the first name in the First Name text box.

The text box allows the entry of alphabetic and special characters. Numeric characters are not allowed. Special characters are limited to the following: period (.), hyphen (-), apostrophe ('), and comma (,). The maximum number of characters that can be entered in the text box is twenty (20) characters.

MI text box

  Enter the first letter of the middle name in the MI text box.

The text box allows the entry of alphabetic characters only. Numeric and special characters are not allowed. The maximum number of characters that can be entered in the text box is one (1) character.

Last Name text box

  Enter the last name in the Last Name text box.

The text box allows the entry of alphabetic and special characters. Numeric characters are not allowed. Special characters are limited to the following: period (.), hyphen (-), apostrophe ('), and comma (,). The maximum size of the text box is twenty-five (25) characters.

Telephone masked edit box

  Enter the complete ten-character telephone number in the Telephone masked edit box.

The masked edit box allows the entry of numeric characters only. Alphabetic and special characters are not allowed. The mask for the masked edit box is "###-###-####" to allow the entry of a three-character area code and seven-character telephone number. A partial entry is not allowed. If any part of the telephone number is entered, a complete ten-character telephone number is required. The maximum number of characters that can be entered in the masked edit box is ten (10) characters.

Cell Phone masked edit box

  Enter the complete ten-character telephone number in the Cell Phone masked edit box.

The masked edit box allows the entry of numeric characters only. Alphabetic and special characters are not allowed. The mask for the masked edit box is "###-###-####" to allow the entry of a three-character area code and seven-character telephone number. A partial entry is not allowed. If any part of the telephone number is entered, a complete ten-character telephone number is required. The maximum number of characters that can be entered in the masked edit box is ten (10) characters.

Fax masked edit box

  Enter the complete ten-character fax number in the Fax masked edit box.

The masked edit box allows the entry of numeric characters only. Alphabetic and special characters are not allowed. The mask for the masked edit box is "###-###-####" to allow the entry of a three-character area code and seven-character telephone number. A partial entry is not allowed. If any part of the Fax is entered, a complete ten-character Fax is required. The maximum number of characters that can be entered in the masked edit box is ten (10) characters.

E-mail text box

  Enter the e-mail address in the E-mail text box.

The text box allows the entry of alphabetic, numeric, and special characters. Only one at sign (@) is allowed. Any character can be entered before the at sign (@). After the at sign (@), the domain name is limited to alphabetic, numeric, and special characters. Special characters are limited to the following: hyphen (-) and period (.). The maximum number of characters that can be entered in the text box is one-hundred (100) characters. An e-mail address is considered valid when it includes at least once character before the at sign (@), and at least one character after the at sign (@) followed by a period and two (2) to four (4) alphabetic characters.

Lookup button

  Click the Lookup button to look up an existing corporate contact.

If the same contact is added twice, only one record for the contact displays in the data grid.

The Contact Lookup screen displays when the button is clicked.

The control is not visible when:

It has a mnemonic of "L".

OK button

  Click the OK button to process the screen.

It is the default button for the screen, unless otherwise noted.

It does not have a mnemonic. Its keyboard shortcut is the Enter key.

The Corporate Parent screen displays when the button is clicked.

Cancel button

Click the Cancel button to close the screen without processing or saving data.

It does not have a mnemonic. Its keyboard shortcut is the Esc (escape) key.

The Corporate Parent screen displays when the button is clicked.

Processing

If data can be validated and saved on the screen, the following processes occur when the screen is processed:

If no data can be validated and saved on the screen:

Data Map

The Data Map defines the values saved for all controls on the screen. If available, any additional notes or comments are displayed in the Notes column.

Control Label

Control Type

Table. Column

Notes

+Contact Type

value label

ReferenceDictionary.Description

Reference Dictionary category = "Contact Type".

+Title

drop-down list box

ContactCrossRef.Titlecd

·

+Salutation

drop-down list box

Contact.Salutation

·

~+First Name

text box

Contact.FirstName

·

+MI

text box

Contact.MiddleInitial

·

~+Last Name

text box

Contact.LastName

·

+Telephone

masked edit box

Contact.Telephone

·

+Cell Phone

masked edit box

Contact.CellNumber

·

+Fax

masked edit box

Contact.FaxNumber

·

+E-mail

text box

Contact.EmailAddress1

·

~ Denotes a required control (if applicable). The process that checks for required controls does not occur on screens displayed in read-only or Details mode.

+ Denotes data written to the database when screen processing occurs (if applicable). The process that writes data to the database does not occur on screens displayed in read-only or Details mode.

|

Reference Utility