Client Administration

Create, modify, merge or delete a Client

Clients can be created, or updated by filling out the necessary information on the Client Details screen and then clicking on the Apply button. Access the Client Details screen via the Entities menu on the Ribbon.

Creating new clients

  1. Open the Clients screen via the navigation above
  2. Click on New.  This will open the Client Details screen
  3. Enter the client’s name, or click on Full name to open the name details box
  4. Hit the tab key.  This will automatically create the ClientID for you unless you entered the name via the name details box
  5. Enter the company name or use the selector button to select the name from the sites screen
  6. Enter all other details. Personal, Employment etc
  7. Apply any Links, Permissions or Custom requirements
  8. Click Apply

Settings Explanation

Time zone: Set this to match the timezone of the client at their location. This will allow HelpMaster to display the current time in their timezone to staff using HelpMaster. This information is also used if this client logs onto the Web Portal to present dates and times in their local zone.

Creating a new staff member

See Creating a new staff member for details about this.

Modify a Client

Modifying a client is to change their relevant details.  A client may change their name, receive a change in their job title or change their phone numbers. 

  1. Open the Clients screen
  2. Use the Search functions of the Clients screen to find the client you require
  3. Select the client required
  4. Click on the Update button. This will open the client details screen
  5. Enter the altered details
  6. Click on Apply
  7. Click on Close

Your changes have been entered and saved.

Merge a Client

Duplicates happen!

Sometimes you may inadvertently create multiple versions of the same client, other times they may be automatically created by the Email Manager, the Active Directory synchronization, or via the API etc.  When this occurs, you may wish to merge the clients together into just one.  This is achieved via the client merge tool.

azure app registration Permissions checklist!

Merging clients/staff is a permission-based feature that must be granted to each staff member that requires this ability.  See Application Security Roles

application security role merging clients permission

What happens to merged data?

When you merge 2 or more clients together into just one “master” client, all of the historical data is transferred from the duplicates into the master.  This includes job history, any links (assets, sites etc) as well as any personal information and contact details.  Quite often, the duplicate clients will have different data for each of the different data fields that HelpMaster supports (phone, email, web, etc).  Where there is a conflict between the master client and the duplicates, the client merge tool will appear to assist you to resolve these differences and make your selection.

Once a client has been merged into the “master”, the duplicate client is completely and irrecoverably purged from the database.

To merge:

  1. From the client search screen, perform a search that will display the duplicate client names
  2. Select each of the clients
  3. Right click the “master” client (ie. the client that you want all the others to be merged into), and select “Merge selected clients” from the pop-up menu
  4. The Merge Client screen will appear
  5. The client merge screen will display all of the differences between each of the clients
  6. Double-click on the column / row of information that is the correct version

Deleting Clients

Clients that have job or other links will only be soft deleted (marked as deleted). Their ClientID is changed to Deleted«PKID» and their original ClientID will be stored in another field along with a deletion date/time stamp. Ensure that any client to be deleted has their Enable Active Directory Synchronisation option from the Permissions tab disabled and they have been Un-associated from Active Directory. Any client that is still Active Directory synchronized will be automatically undeleted by the Active Directory service if it is running.

Client Permissions Tab

Single client deletion

For single Client deletion this can be easily accomplished from the client’s Properties tab by just clicking the Delete button.

Multiple client deletion

  1. Open the Clients screen
  2. Use the Search functions of the Clients screen to find the client you require
  3. Select the client required
  4. Click Delete
  5. Click Yes in the confirmation box

Determining the unique PKID of a client

Each client has a unique PKID number. This is a unique number that is used to identify this client in the database. This number may be used in SQL scripts for workflow, reporting, as well as the WebAPI for authentication purposes.

The PKID is displayed on the Properties tab of the client, similar to most other entities.

Get Client PKID

See Also

Client Overview

Creating a staff member

Grouping, Classifying and Controlling Access

Linking other entities to a Client

Viewing job history for a Client

Automatically generating the Client ID

System Event Log