# The daily occurrence log

Guards write what happens on a site into the occurrence log, from the phone app. You read it at Occurrence log in the Scheduling group of the menu, filter it, add your own entries, mark entries internal or hide them from the client, download a PDF, and set up the site's client access, daily e-mail, entry types and phrases. Nothing in the log can be edited or deleted.

## What is this for?

It is the site's day book. A guard on shift taps **Log** in the phone app and writes down a visitor, a delivery, a patrol, a fault or an incident. You read it here, with the time, the type and who wrote it. When a client asks what happened on Tuesday night, the answer is on one page.

## Who can use it?

Admins, Managers and Control. Three permissions decide what you can do:

- **View Occurrence Log** lets you read the page.
- **Add Occurrence Log Entries** lets you add entries and follow-ups, and hide entries from the client.
- **Export Occurrence Log** lets you download the PDF.

An Admin sees every site. A Manager or Control user sees only the sites an Admin has assigned to them as site manager. With no site assigned, the page is empty.

Changing a site's settings needs the permission to edit sites. An agency cannot read the log of a site it does not own.

## How do you read the log?

Open **Occurrence log** in the Scheduling group of the menu. The page opens on today.

- **Site.** Choose one site or all sites.
- **Dates.** A range of up to 31 days. A longer range is refused with a message.
- **Entry type.** Show one type only.
- **Incidents only.** Show only entries marked as an incident.
- **Show automatic events.** Appears when you have chosen one site. See below.

The filters are kept in the address, so a refresh or a shared link shows the same view. Entries are grouped by day, newest first. A follow-up sits indented under the entry it belongs to. Press **Load more** at the bottom for older entries.

## What do the tags mean?

- **Incident.** The guard marked it as an incident.
- **Internal.** It is never shown to the client.
- **Hidden from client.** A manager hid it after it was written.
- **Not acknowledged.** A handover entry that no other guard has acknowledged 30 minutes after it was written.

Under a handover you see **Acknowledged by** each guard's name and the time.

## How do you add an entry?

Press **Add entry**. Choose the site and the type, write the note and press save. Two switches sit below the note:

- **Incident** marks the entry as an incident. An incident always needs a note.
- **Internal only (not shown to the client)** keeps the entry from the client. It starts on for the type **Position** and for any site type you set as internal by default. You can change it.

The entry is time-stamped when you save it. You cannot choose another time on the web. To add to an entry that already exists, press **Follow up** beside it. A follow-up is a new entry. The web page does not take photos.

## What are the types?

All in order, Position, Patrol, Visitor, Delivery, Vehicle, Keys, Alarm, Hazard or fault, Lost and found, Client instruction, Handover and Other. Every type needs a note except **All in order** and **Patrol**. Each site can add its own types, see below.

## What are automatic events?

With one site and **All types** chosen, and **Show automatic events** on, the page also shows rows that nobody wrote. They come from the check-call records and carry an **Automatic** tag: booked on, booked off, check call, emergency, missed check call and not booked on. They sit between the written entries in time order. With **Incidents only**, the only automatic rows left are emergencies.

At most 500 automatic events are shown. When there are more the page says so. Choose a shorter range to see them all.

## What are photos?

A guard can attach up to four photos to an entry from the phone. An entry with photos shows a **Photos (N)** button. It opens the pictures one by one. Each time a photo is opened, the access is recorded in the audit log. The photos are not shown as small pictures in the list.

## Who sees an entry besides you?

Guards on shift at the site see the last 24 hours of its log in their app. If the site has client access switched on, the client sees the entries described under **Client access** below. A banner above the list tells you when that is the case.

## How do you keep an entry from the client?

Two ways.

1. **When it is written.** The guard, or you, marks it **Internal**. This is decided when the entry is saved and cannot be changed afterwards.
2. **After the fact.** Press **Hide from client** on the entry. The entry then shows **Hidden from client**. Press **Show to client** to undo it. This button appears only when the site has client access on and the entry is not internal. It does not reload the list.

Both are recorded in the audit log.

## How do you download a PDF?

Choose one site and a range of 31 days or fewer, then press **Export PDF**. The button is off until you do, and says why. The PDF has the site name and your branding, then the entries by day: time, type, the text and the author. Follow-ups are indented, incidents are marked **INCIDENT**, internal entries are marked, and photos show as a count. The footer says who generated it and when. A range with more than 2000 entries is refused. Choose a shorter one. Each download is recorded in the audit log.

## How do you set up a site?

Open the site, choose the **Settings** tab and find **Occurrence log** in the jump links. Press **Save occurrence log** when you are done. The save button stays off until you change something.

- **Client can read the log.** Off by default. Needs a client on the site. See below.
- **E-mail the client each morning.** Off by default. See below.
- **Extra recipients.** Up to 10 more addresses for the daily e-mail, one per line. Only people who can edit sites see this box.
- **Entry types for this site.** Up to 12 of your own, with a name of up to 30 characters. For each, **Text is optional** lets a guard send it with no note, and **Internal by default** switches Internal on when a guard picks it. A guard sees them after the standard types.
- **Phrases.** Up to 30 short texts of up to 200 characters. In the phone app a guard taps one and it is added to the note.

A custom type keeps the name it had when the entry was written. Renaming or removing the type later does not change old entries.

## What does client access do?

When you switch it on, the client's portal gets a **Daily log** page for that site. The client sees:

- entries written from the moment you switched it on, and not earlier ones;
- not entries marked Internal or hidden, and not follow-ups to an entry the client cannot see;
- the guard's first name only if your client portal settings show first names, otherwise **Officer** or **Staff**;
- photos, and booked on and booked off rows. No other automatic rows, no locations and no acknowledgements.

If the site moves to another client, the access switches off. Switch it on again to give the new client the log from that moment.

## What is the daily e-mail?

When both switches are on, the client gets an e-mail each morning with the previous day's log as a PDF. It goes to the client's contact address and your extra recipients, one message each. It is sent from 07:00 in your organisation's time zone. A late run is caught up the same morning. A day with no visible entries sends nothing. If sending fails for everyone it is tried again, up to 3 times. If it reached at least one address it is not sent again. If a PDF is too large to attach, the e-mail links to the portal instead.

To stop it, switch off **E-mail the client each morning**. The client cannot unsubscribe themselves.

## Who is told about an incident?

When a guard or a manager saves an entry marked as an incident, the site's alarm recipients are told at once, except the author. These are Admins, Control and the site's managers. They get an in-app message and a push, and an e-mail. The in-app message and the push say the site, the type and the time only, because a lock screen shows them. The e-mail adds who wrote it and the first 200 characters. The message links to the log filtered to that incident. Internal incidents alert the same way.

To switch the e-mail off, open your notification preferences and turn off the e-mail channel for **Occurrence Log Incidents**. See [Notifications](/docs/organisation/notifications). The alert is never held up by the guard's connection and a failed alert does not stop the entry being saved.

## What cannot be edited or deleted, and why?

No entry, follow-up, photo or acknowledgement can be changed or removed, by anyone, in the app or in the database. The log is evidence. If a guard writes something wrong, they add a follow-up that corrects it. The only things that change afterwards are the **Hidden from client** setting and the site's settings. Both are audited. The system keeps the log with no automatic clean-up. How long you must keep it is for your own legal advice.
