Skip to content
D
Documentation

Contact record

reference
8 min readUpdated

A contact record stores the information your organisation uses to identify and communicate with a person. Use it to review the person's main information, add communication details, maintain the contact image, and review related record areas when they are available.

Contact records at a glance

The record belongs to the Contacts area, which is the starting point for finding an existing contact and opening its saved record. Its main information includes Title, Name, Position, Department, and Account.

You can add communication fields through Contact Details, maintain the image, and use the saved-record tabs Attachment and Last Modifications when the record has an identifier and the form is not a popup.

If you need to…Go to
Find an existing contactContacts
Open and interpret a saved contact recordUnderstand the record information
Change contact information and remain on the recordEdit and save contact information
Add communication details or maintain the imageManage contact details and the image
Review files linked to the recordLibraries
Create a contact instead of changing a saved recordCreate a contact

Before you open or change a record

The contact identifier determines whether the form loads a saved record and whether the saved-record tabs are available. The subscription and editability state determine which parts of the surface you can use.

ConditionWhat you see or can do
The Contacts subscription is includedThe contact form is available.
The subscription does not include ContactsA subscription-upgrade surface replaces the form.
The saved contact identifier is absent or zeroThe form initializes a new contact and loads the account lookup.
The saved contact identifier is presentThe saved contact loads and Name uses the saved-contact text field.
The form is read-onlyEditing controls are disabled or hidden. Save, Save and Close, and Contact Details are unavailable.
The contact has no identifier, or the form is opened in a popupAttachment and Last Modifications are unavailable.

Before changing a record, confirm that it is saved and editable, and that the contact name and account information are ready. Select an account from the choices shown by Account.

Find and open a contact record

The Contacts list is where you locate an existing contact before opening its saved record. After you open the record, review its fields before choosing the part of the record you need.

Prerequisites

  • You are in the Contacts area.
  • The contact already exists as a saved record.

Steps

  1. In the Contacts work list, locate the saved contact you need to review.
  2. Open the contact from the list.
  3. Confirm that the contact-record surface shows Title, Name, Position, Department, and Account.

Result: The saved contact record shows its contact fields and save controls. Continue with Understand the record information to interpret the fields.

Understand the record information

The main form identifies the contact and relates the person to an account. On a saved record, Name is shown as a text field. On a new contact, Name uses an autocomplete or text entry.

FieldRequired marker on the main surfaceUse
TitleNoEnter the person's title.
NameYesIdentify the contact.
PositionNoEnter the person's position.
DepartmentNoEnter the person's department.
AccountYesSelect the account related to the contact.

Name and Account show required markers on the main surface. Title, Position, and Department do not show required markers there. After reviewing these fields, continue with Edit and save contact information when you need to change them.

Required markers beside Name and Account on the main form

Edit and save contact information

After reviewing the fields, change the saved contact when needed. The next section covers communication details and the image.

Prerequisites

  • The saved contact is open.
  • The form is editable.
  • Name and Account contain valid values.

Steps

  1. In the main form, change one or more of Title, Name, Position, Department, or Account.

  2. If you changed Name, use a name that is not already assigned to another contact.

  3. Select the save destination that matches your next task.

    If you need to…Select
    Continue working on the recordSave
    Leave the recordSave and Close
  4. Check the result message before continuing.

When the save succeeds, the page reports Contact saved successfully. The common completion message is Your request was completed successfully. If the save returns a server failure, the page reports Error: Server Error. If the name conflicts during save, it reports Error: This Contact Name Already Exists.

Save and Save and Close actions on the contact record

Result: Save leaves the saved contact open after the change. Save and Close saves the change and leaves the record. Continue with Manage contact details and the image for communication fields or the image.

Manage contact details and the image

Contact Details adds communication fields to the contact form. The image actions belong to the record image area and depend on the image state.

Contact-detail choiceResult
PhoneAdds the corresponding communication field.
FaxAdds the corresponding communication field.
MobileAdds the corresponding communication field.
EmailAdds the corresponding communication field.
WebsiteAdds the corresponding communication field.
Online SupportAdds the corresponding communication field.
CommentsAdds the corresponding communication field.

Prerequisites

  • The contact record is open.
  • The form is editable before adding a contact-detail field.

Steps

  1. Open Contact Details.

  2. Select the communication field you need from the choices shown.

  3. Enter the value in the field that appears.

  4. If you enter Phone, Fax, or Mobile, use numeric keys; non-numeric keys are prevented.

  5. If you enter Email, use an email value that passes the field's validation.

  6. Choose the image action that matches the current image state.

    If you need to…Select
    Add or replace the contact imageUpload
    Remove an existing contact imageDelete contact image
Contact Details choices and the added communication fields

Note: Delete contact image is available only when the record has a non-placeholder image.

Result: The selected communication field appears on the contact record, and the image action is available for the current image state. Continue with Maintain the contact image to add or remove an image, or with Review attachments and change history to open a related record area.

Maintain the contact image

The contact image area provides Upload for an image file and Delete contact image when an image URL exists and the displayed image is not the placeholder image.

Prerequisites

  • The contact record is open.
  • The form is editable.
  • For deletion, a non-placeholder contact image exists.

Steps

  1. To add or replace the contact image, select Upload.
  2. Choose the image file in the file picker.
  3. To remove an existing image, select Delete contact image.
  4. Confirm the delete-image action in the confirmation modal.
  5. Check for Photo Deleted Successfully after the deletion completes.

The Delete contact image control is hidden when the image URL is empty or the displayed image is the placeholder image.

Result: Upload uploads the selected contact image. After a completed deletion, the page reports Photo Deleted Successfully.

Review attachments and change history

After maintaining the contact information, use the saved-record tabs for related areas. Attachment is for attached files, and Last Modifications is for change history.

Prerequisites

  • The contact is saved and has a contact identifier.
  • The record is open outside a popup.

Steps

  1. Select Attachment to open the attached-files area.
  2. Select Last Modifications to open the change-history area.

Use Libraries for attached-file management.

Result: The saved-record tabs are Attachment and Last Modifications. Continue with When a contact record cannot be saved if a save problem needs correction.

When a contact record cannot be saved

Use the message on screen to match the problem to the correction.

What you seeCauseCorrective action
This field is requiredName has no value.Enter a contact name in Name.
Just '_'‘-''.' And '&' Characters AcceptedThe contact name contains a character outside the accepted name pattern.Correct Name to use the accepted characters.
Account field is mandatoryNo account is selected.Select an account in Account.
Email is invalidThe value in Email fails email validation.Correct the value in Email.
You already have a contact with this nameThe contact name matches an existing contact during name checking or save.Enter a name that does not duplicate an existing contact.
Error: This Contact Name Already ExistsThe save returned a duplicate-contact error.Change Name, then save again.
Error: Server ErrorThe save returned a server error.Do not treat the change as saved; resolve the server problem before saving again.
The exit confirmation popup opensThe form has unsaved changes and you selected Close.Follow the exit confirmation flow.

After correcting the value, return to Edit and save contact information.

Out of scope

These messages and surfaces belong to other pages or popups rather than the contact record's own contact-name and save flow.

MessageOwning page or surface
You already have account with this nameNew-account popup
Error.. client not saved yetNew-account popup
Error.. vendor not saved yetNew-vendor popup
Just '_'‘-''.' And '&' Characters Accepted; Your request was completed successfullyLibrary and file popup

Continue from the contact record

After reviewing or changing a contact, choose the page that owns the next task.

Next needContinue to
Find another existing contactContacts
Create a new contactCreate a contact
Review the account related to the contactAccounts
Manage attached filesLibraries
Review change historySelect Last Modifications on a resolved saved contact record.

Was this page helpful?

Need help using the product?