Sites and site devices

A site is a place where your people work. Each site has its own time zone, weekly days off, office address and, if you want one, a site device. Open Management → Sites to add and edit them.

Adding a site

  1. Choose Add a site and give it a name.
  2. Pick its time zone and its weekly days off. Every day is counted in the site's own local time, so a night shift that crosses midnight belongs to the day it started.
  3. Choose How this site records:
    • With a site device: a tablet at the entrance where people check in with a PIN or a card. Phones can still be used, and the tablet shows a changing QR code phones can scan.
    • Phones only: employees check in on their own phones. This needs the office internet address below.
  4. Set a default schedule if you use schedules. A site added later takes the account's first schedule until you change it.

The office internet address

For a phone to check in, Pulseform must see the request coming from your office. It compares the request's public internet address with the addresses you registered for the site. No location is ever read.

On the site's page, under Office internet addresses:

  • Use my current address reads the address you are on right now. Open the screen from the office, press it, and confirm It is the office. If the address shown is not your office's, tell your IT team: it can mean a proxy sits in front of the server.
  • Add the address lets you type one, after you confirm the office uses it alone. Home and private addresses are refused.
  • Dynamic DNS name (optional): if your router's address changes, give the name of a dynamic DNS service. Pulseform follows it every few minutes.
  • A site device that finds itself on a new address tells HR. HR decides whether it is the office, and records made through an address stopped by mistake are flagged for review.

Shared addresses. If the office shares its public address with other subscribers (some ISPs do), the address says nothing about your office. Use a site device and the QR code there instead.

Site devices

A site device is a tablet, an old phone or a computer with a camera at the entrance. It runs in the browser, so there is nothing to install from a store. Open Management → Site devices and phones.

Setting one up

  1. Choose Add a site device, give it a name and choose its site. You get a setup code, shown as text and as a QR code. It is valid for 30 minutes; choose New setup code for another.
  2. On the tablet, open the site device address (copy it from the yellow panel on the Today page): /attendance/device/app. Type the code, or scan the QR with the tablet's camera.
  3. Allow the camera when asked. The device registers, shows its main screen, and from then on opens straight to it.
  4. Keep the tablet powered, in the browser's kiosk or "pinned" mode so nobody leaves the page, and ideally on a charger or backup power.

The main screen has Check in, Check out and My records buttons, and a QR code that changes every 10 seconds. Phones scan it to prove they are at the entrance, even with no internet. The device also takes a photo at each check-in for review. See Checking in and out.

Main and spare devices

Each site can have one main device and any number of spare devices. A spare records like the main one, so if the main tablet breaks you can Make it the main device at once. Keep a spare for every site.

Without internet or power

The device keeps a copy of the employees and their PINs, stamps each record with its own corrected clock, stores it with the photo, and sends everything when the connection returns. HR sets Site devices must sync within (hours) in the settings; records that arrive later than that wait for a manager's approval. If a site's devices have been silent for too long, HR is alerted and the dashboard says that site's numbers may be incomplete.

What the tablet shows. A line at the top of its screen says Online, Offline or Trying to reach pulseForm, followed by Waiting to send: N when records are waiting. Offline means the tablet has no network at all. Trying to reach pulseForm means it is on Wi-Fi but pulseForm cannot be reached, for example because the office router lost its internet. In both cases the tablet keeps recording normally.

When the waiting records are sent. Nobody has to press anything. The tablet tries again on its own: every 20 seconds while it is connected, and after a failure the pause between tries grows from 5 seconds up to at most 30 seconds. It also tries at once when the browser says the connection is back, when its screen wakes or the app comes back to the front, and with every new check-in. So the waiting records arrive within about half a minute of the internet coming back, each with the time it was made, not the time it arrived. They are stored on the tablet, so reloading the page or a power cut does not lose them, and the line goes back to Online after the first successful send. If the count has not cleared a few minutes after the internet is back, look at the site's card on the Today page, which shows the device's last connection, and contact us.

The QR code keeps changing without internet. The tablet makes every code itself: it signs it with a key that never leaves the device and puts in it the time from its own corrected clock and a number that goes up with each code. So it draws a new code every 10 seconds whether or not it is connected, and a phone can scan the newest one with no network at all. Pulseform checks the code later, when the phone sends its scan.

The tablet's clock while it is offline. The device keeps the difference it measured from Pulseform's clock at its last connection. If someone changes the tablet's clock meanwhile, the records made are marked The site device clock jumped; if the page was reloaded, Time not checked against pulseForm. Both are for review, never refused, and the next connection clears the mark when it shows no drift. See Requests and review.

Reference photos and the HR session

A reference photo is a clear photo of an employee's face, taken once, so a reviewer can compare it with the photo taken at check-in. Like every photo, it stays on the tablet. Take one for each employee, and a new one whenever someone's look changes: a new photo replaces the old one.

  1. On HR's computer, open Management → Site devices and phones and press the camera button, Take reference photos, on the tablet's row (the button is on active devices only). A six-digit code appears. It works once and for 10 minutes.
  2. On the tablet, press and hold the site's name at the top of the screen for three seconds. A box asks for the code.
  3. Type the code and press Continue. This opens HR's session on that tablet, which lasts 30 minutes, and lists the site's employees. An employee who cannot be photographed shows No photo for this employee.
  4. Ask the employee to look at the camera and press Take photo. A tick (✓) appears beside their name.
  5. Press Finish when you are done.

The tablet's browser must be allowed to use the camera. To check the result, open a record in Requests and review (see Requests and review): the reference photo appears beside the photo taken at check-in.

Photos on the device, and how long they are kept

Pulseform's server never stores the photos. The tablet keeps them, encrypted, and deletes them by these rules:

Photo When it is deleted
A check-in's photo When the retention period ends: 30 days after it was taken, unless HR changed Keep photos on site devices for (days) under Attendance settings → Rules. A photo that a review is waiting for is kept until the review is decided. Deciding it releases it, and the tablet deletes it with the others when the retention period ends.
A photo that matched no phone scan (taken while someone stood in front of the tablet) After the sync deadline, 72 hours by default (Site devices must sync within (hours)), so passers-by are not kept.
A reference photo Never by time. It stays until HR takes a new one for the employee, or the employee's attendance ends.
When the tablet's storage is nearly full (80%) The oldest photos nothing is waiting on go first, half of them at a time, until there is room. If no space is left, check-ins are still recorded, without photos, and those records are flagged for review.
A removed device Everything, including its photos and its copy of the employees, at its next connection.

After a review is decided. Approving or rejecting a review item does not delete its photo. It only ends the hold the review put on it: from then on the photo is treated like any other check-in photo, and the tablet deletes it when its age reaches the retention period (30 days after it was taken), or earlier only if the tablet's storage runs low. So a photo you reviewed today stays on the tablet until its 30 days are over. The decision itself, with who decided, when and why, stays in the record.

The tablet applies the age rules by itself, even with no internet, and it deletes while it syncs.

Removing a device

Remove stops a lost or retired device. Its records are refused, and at its next connection it erases its photos and its copy of the employees. HR is then offered Reset the PINs for the site, so PINs the lost device held stop being useful.

Archiving a site

Archive hides a site from the lists. Its records stay. Employees of an archived site keep their history.