Skip to content

Managing clients

Overview

Each client is a security company or other organisation that uses Fisher Portal. Every register, document and user belongs to a client. A new client starts empty until you deploy templates and give users access.

Only super admins can see the Clients list and client profiles.

View all clients

In the side nav, under Platform, select Clients.

The At a glance panel shows the number of Clients, Template registers, Template documents and Client registers in use.

The buttons at the top of the page are Add client and Deploy templates. Deploy templates takes you to the list so that you can choose a client.

The table has these columns:

ColumnWhat it shows
ClientThe client’s name
DetailsThe client’s description, or “No description”
UsersUsers with access to the client
RegistersRegisters deployed to the client
DocumentsDocuments deployed to the client
CreatedThe date the client was added

Each row has these controls:

  • View: opens a side panel with the client’s register, document and user counts and up to six of its registers. The panel has Open client and Edit buttons. Selecting the client’s name does the same.
  • Edit: opens the Edit client page.
  • Open: opens the client profile.
  • More actions (the three-dot menu): Deploy and Delete.

The Clients list, with counts for each client and the row controls

The side panel that opens when you select View

Add a client

  1. Select Add client.
  2. Complete the Client section.
  3. Complete the Document personalisation details section if you have the details.
  4. Select Create client.
FieldRequiredNotes
NameYesThe client’s name, such as “Guardian Security Solutions”. Each name must be different.
DescriptionNoA short description of the organisation.
LogoNoAn image file of the client’s logo.
Registered nameNoThe company’s registered name.
Company numberNoThe company registration number.
Registered addressNoThe first line of the registered address.
CityNo
PostcodeNo
Phone numberNo
Email addressNo
Managing directorNo

Fisher Portal uses the personalisation details to fill in Word templates when you deploy them. You can save the client without them and add them before you deploy.

After you save, the client profile opens.

The Add client form

View a client profile

On the Clients list, select Open.

The buttons at the top of the profile are:

ButtonWhat it opens
Deploy TemplatesThe Deploy templates page for this client
ComplianceThe client’s Compliance page
EditThe Edit client page
BrandingThe Branding page
SharePointThe SharePoint settings page
Deployed templatesThe list of templates deployed to the client
Baseline statusA check of the client against the approved starting set of templates

The At a glance panel shows the client’s number of registers, documents, users and spaces. Select Open page builder to manage the client’s spaces.

The profile also has these sections:

  • Client users: each user’s name, email and system role, with a Login as button. See User impersonation.
  • Template registers: the registers deployed to this client.
  • Template documents: the documents deployed to this client.

A client profile, with its buttons, users, registers and documents

Edit a client

  1. On the Clients list or the client profile, select Edit.
  2. Change the details on each tab.
  3. Select Save client.

The Edit client page has three tabs:

TabSections and fields
GeneralName, Description and Logo
Company detailsRegistered company information (Registered name, Company number, Trading name), Registered address (Address line 1, Address line 2, City, County, Postcode) and Contact details (Phone number, Email address, Website)
Key personnelManaging director, Operations director, Quality manager, Health and safety manager, Data protection officer and HR manager

Fisher Portal uses these details in document templates.

The Edit client page, with the General, Company details and Key personnel tabs

Set a client’s branding

Every client sees the same Fisher Portal colours and typeface. A client can change only its logo, browser icon and dashboard photo.

  1. On the client profile, select Branding.
  2. Select Use custom branding to show the client’s logo and browser icon in place of the Fisher logo.
  3. Set the branding:
    • Logo: upload a PNG, JPG, SVG or WEBP file. A wide logo of about 200 by 50 pixels works best.
    • Logo web address: the web address of a logo image. Fisher Portal uses this when no logo file is uploaded.
    • Browser icon web address: the web address of the small icon in the browser tab. A 32 by 32 pixel .ico or .png file works best.
    • Dashboard photo: a wide JPG, PNG or WEBP photo, at least 1920 pixels wide. It appears across the top of the client’s dashboard.
  4. To check the result first, select Preview.
  5. Select Save branding.

Client admins can also change their own client’s branding.

The Branding page for a client

Connect a client to SharePoint

You can connect a client’s SharePoint site so that documents and registers stay in step with Fisher Portal. You need the details of the client’s Azure AD app registration and their SharePoint site.

  1. On the client profile, select SharePoint.
  2. Enter the app details: Tenant ID, Client ID and Client secret. The secret is stored encrypted. Leave it blank to keep the saved secret.
  3. Enter the site details: Site ID and Site URL.
  4. Enter the library details: Documents library ID, Documents folder path, Registers library ID and Registers folder path. The folder paths are optional.
  5. Set how the sync works:
    • Sync automatically: keeps files in step without anyone pressing sync.
    • Sync every (minutes): at least 5 minutes.
    • Sync direction: Pull from SharePoint, Push to SharePoint or Both ways.
    • Get instant updates: SharePoint tells Fisher Portal about changes as they happen.
  6. Select Save settings.
  7. Select Connect to SharePoint and sign in to Microsoft to approve access.

The Connection panel shows Connected or Not connected. To remove the connection, select Disconnect.

Client admins can also open this page for their own client.

The SharePoint settings page for a client

Deploy templates to a client

Deploying copies template registers and documents into the client’s portal. See Template management for the full steps.

  1. On the Clients list, open More actions and select Deploy. You can also select Deploy Templates on the client profile.
  2. Tick the registers and documents to deploy.
  3. Select Deploy selected templates.

Delete a client

  1. On the Clients list, open More actions for the client.
  2. Select Delete.
  3. Confirm.

The client no longer appears in Fisher Portal. There is no button to restore a deleted client.

Tips

  • Use the client’s trading name as the client name. This makes the client easy to find in the client switcher and search.
  • Complete the company details and key personnel before you deploy Word templates. Fisher Portal uses them to personalise the documents.
  • On the Deploy templates page, check the Already deployed labels before you deploy.
  • Use Description to record the client’s services, SIA licence type or compliance goals.

Troubleshooting

ProblemWhat to do
”Name has already been taken”Another client has this name. Choose a different name.
Clients is missing from the side navYou are in client view. Select Exit in the header.
The Deploy templates page warns “Complete details before deploying Word templates”Select Complete client details and add the missing details.
Registers still shows 0 after a deploymentRefresh the page. Then read the message shown after the deployment for any errors.
Connect to SharePoint failsCheck the Tenant ID, Client ID and Client secret, then select Save settings and try again.