Skip to main content

Forms - Roll Call: Set up and deploy the workflow

Set up Forms - Roll Call to give designated marshalls a shared, real-time register for accounting for people during a roll call.

Who it’s for: Administrators

Platform: Sense Automate, Forms, Sense Mobile, Sense HR

Available on: Enterprise plan

Before you begin

Make sure you’ve:

  • An active Sense Forms Licence for your organisation.

  • Permission to install, configure, and deploy workflows in Sense Automate.

  • Decided who should act as Roll Call marshalls.

  • Decided how people should be grouped during a Roll Call.

  • Configured the relevant Sense HR data if you’re using a Custom grouping.

  • Identified the relevant Anviz device IDs and locations if you’re using Presence Location or Combined mode.

  • Decided whether each Roll Call should cover all locations or whether the person starting it should choose the affected locations.

  • Decided who should be allowed to end a Roll Call.

  • Decided how long a Roll Call should remain open if nobody ends it manually.


Overview

Forms - Roll Call provides a live, shared register that designated people can use to account for everyone during a roll call.

Multiple marshalls can work on the same Roll Call at the same time, using a mobile device or laptop/PC. When one marshall accounts for someone, the register updates for the other marshalls in real time.

You can configure:

  • who acts as a Roll Call marshal;

  • who should be included based on clocking activity and scheduled working times;

  • whether people appear in a single list or are divided into groups;

  • how people are grouped using Sense HR information, Presence location information, or a combination of both;

  • whether a Roll Call covers all locations or the starter chooses the affected locations;

  • who can end a Roll Call; and

  • how long a Roll Call can remain open before it ends automatically.

When a Roll Call starts, the workflow identifies the relevant people and locations, creates the live register, and notifies the configured marshals that a Roll Call is in progress.


How Roll Call works

When a designated person starts a Roll Call, the workflow coordinates the process behind the scenes.

It:

  1. identifies the configured marshals;

  2. identifies the locations included in the Roll Call;

  3. identifies the people who need to be accounted for;

  4. groups those people according to the configured Mode; and

  5. notifies the marshals that a Roll Call has started.

All marshals can open the same live Roll Call. When one marshal accounts for someone, the change is immediately reflected for the others.

Depending on the configuration, separate Roll Calls can run at the same time for different locations.

For instructions for marshals, see:


Who is included in a Roll Call?

When a Roll Call starts, the workflow creates a snapshot of the people who need to be accounted for.

It includes:

  • anyone who is currently clocked in;

  • anyone who clocked out within the configured number of minutes;

  • anyone whose scheduled shift is already in progress but who hasn’t clocked in or out that day; and

  • anyone whose scheduled shift starts within the configured number of minutes and who hasn’t clocked in or out that day.

Someone who is currently clocked in remains on the register even if their scheduled shift end time has passed.

The default inclusion windows are:

  • Starting within: 30 minutes

  • Clocked out within: 20 minutes

People who are recorded as being on leave are excluded, unless they have clocked in.

⚠️ Important: The list is created when the Roll Call starts and doesn’t update automatically afterwards. If someone clocks in or out, or their working information changes after the Roll Call has started, the active register isn’t recalculated.


Install the workflow

  1. Open Sense Automate.

  2. Go to Workflow Hub.

  3. Locate Forms - Roll Call.

  4. Click Install.

The workflow is added to Automate > Installations ready for configuration.

For general information about installing Library workflows, see:


Configure the workflow

Go to:

Automate > Installations

  1. Locate Forms - Roll Call.

  2. Open the More actions (…) menu.

  3. Click Configuration.

Review each setting before deploying the workflow.


Marshals

Choose who should act as Roll Call marshals.

You can select one or both of the following:


Admins

Makes Roll Call available to administrators based on their assigned Access Role.

Fire Marshals

Makes Roll Call available to employees who have been specifically designated as Fire Marshals.

To use this option, your organisation must have access to Screen Designer and you must add the required custom field to Job Details.

Set up the Fire Marshal field

  1. In Sense HR, go to Settings > Screen Designer > Screens.

  2. Open Job Details.

  3. Click the New fields tab in the left control panel.

  4. Add a Radio Button field to the screen.

  5. In the Field properties panel on the right, name the field exactly:

    Is Fire Marshall?

  6. Click Manage options and add:

    Yes
    ​No

  7. Click Apply in the Field properties panel to save the field properties.

  8. Click Save changes to save the screen.

You can then designate individual employees as Fire Marshals from their Job Details screen by setting Is Fire Marshall? to Yes.

When Fire Marshals is selected in the workflow configuration, employees with Yes recorded in this field are given access to Roll Call.

🖊️ Note: The Is Fire Marshall? field must be added to the Job Details screen for the workflow to use it.

For more information, see:


Mode

Choose how people should be grouped in the Roll Call register.

You can select:

  • All

  • Presence Location

  • Custom

  • Combined

The additional configuration required depends on the Mode you select.


All

Select All to show everyone included in the Roll Call in a single list.

This is the simplest configuration and doesn’t require a custom field or location mapping.


Presence Location

Select Presence Location to group people according to where they clocked in.

To do this, use Anviz Device Id to tell the workflow which location each Anviz clock represents. For example, 1 = London, 2 = Doncaster, 3 = Manchester.

When someone clocks in using one of those clocks, the workflow can place them in the corresponding location group when the Roll Call starts.

🖊️ Note: For this workflow Presence location refers to the person’s mapped clock-in location.


Custom

Select Custom to group people using a dropdown field from the Job Details screen in Sense HR.

Enter the field you want to use in Custom Field.

Each dropdown option from that field becomes a selectable group in the Roll Call.

For example, you could use a Job Details dropdown such as:

  • Department

  • Location

  • Sub-company, or

  • another dropdown field available in your organisation

Organisations with Screen Designer may also have additional custom dropdown fields available in Job Details.


Combined

Select Combined to use both a Custom Field grouping and Presence location information.

Complete:

  • Custom Field

  • Anviz Device Id

  • Group Location Map

This allows the Roll Call to use the employee’s normal group alongside their actual clock-in location.

For example, if someone clocks in away from their usual site, they can appear as a visitor at the location where they’ve actually clocked in.

Forms - Roll Call configuration showing All, Presence Location, Custom and Combined Mode options.

Choose how people should be grouped in the Roll Call.


Custom Field

Complete Custom Field when Mode is set to:

  • Custom

  • Combined

Enter the name of a dropdown field from the employee’s Job Details screen.

The field can be a standard Job Details dropdown or a custom dropdown available to your organisation.

Each option configured for that field becomes a selectable group in the Roll Call.

For example, if you use Department, the register can present the relevant departments as groups.

🖊️ Note: Custom Field uses a dropdown field. Free-text fields aren’t used to generate Roll Call groups.


Anviz Device Id

Complete Anviz Device Id when using:

  • Presence Location

  • Combined

Use this setting to map Anviz clock source IDs to location names.

Enter each mapping as:

ID = Location

Separate multiple mappings with commas.

For example:

1 = London, 2 = Doncaster, 3 = Manchester

If an employee clocks in using device 2, their clock-in location is treated as Doncaster for the Roll Call.

You can map multiple device IDs to the same location if more than one clock is used at that site.

Leave this setting blank if you aren’t using Presence Location information.


Group Location Map

Complete Group Location Map when using Combined mode.

This maps the location prefix used by a Custom Field group to the corresponding Presence location.

Enter each mapping as:

Prefix = Location

Separate multiple mappings with commas.

For example:

S = Sheffield, L = London

Your Custom Field group names must start with the prefix in round brackets, for example (S) Fire 1 and (S) Fire 2. The prefix can be any letters or word, as long as it’s in brackets at the very start of the group name. Groups that don’t start with a bracketed prefix are never shown as visitors.

This allows the workflow to recognise when someone has clocked in away from their usual group location and show them as a visitor at the location where they’re present.

Leave this setting blank if you aren’t using Combined mode.


Configuration summary

Mode

Custom Field

Anviz Device Id

Group Location Map

All

Not required

Not required

Not required

Presence Location

Not required

Configure location mapping

Not required

Custom

Required

Not required

Not required

Combined

Required

Required

Required


Include people starting within

Use Include people starting within (minutes) to include people whose scheduled shift:

  • is already in progress; or

  • starts soon.

Enter the number of minutes before a scheduled start time that someone should appear in the Roll Call.

The default is:

30 minutes

For example, with 30 configured, someone due to start at 10:00 can be included in a Roll Call started from 09:30.

Leave the setting blank to include scheduled people only after their shift has started.

🖊️ Note: This setting applies to people who haven’t already clocked in or out that day. Anyone currently clocked in is included regardless of their scheduled working time.


Include people who clocked out recently

Use Include people who clocked out within (minutes) to keep people on the register for a short time after they clock out.

The default is:

20 minutes

For example, with 20 configured, someone who clocked out 10 minutes before the Roll Call started is still included.

After the configured period passes, they are no longer included.

Anyone who is still clocked in remains included regardless of how long ago they clocked in.

Leave the setting blank to remove people from the register as soon as they clock out.


Choose which locations a Roll Call covers

Use Locations when starting to choose whether every Roll Call covers all configured locations or the person starting it chooses the affected locations.

Select:

All locations

Every Roll Call covers all locations.

Only one Roll Call can run at a time.

This is the default.

Choose when starting

The person starting a Roll Call chooses which locations it covers.

Different Roll Calls can then run at the same time for different locations.

A location that already has a live Roll Call can’t be selected for another one until the existing Roll Call ends.

🖊️ Note: The available locations come from the groups configured through Mode and Custom Field. This setting isn’t used when Mode is set to All.


Choose who can end a Roll Call

Use Who can end a roll call to control who can finish an active Roll Call.

Select:

Roll call starter only

Only the person who started the Roll Call can end it.

This is the default.

Any fire marshall

Any configured Fire Marshal can end the Roll Call.

Ending a Roll Call closes it for all marshals and sends the final report.

🖊️ Note: All marshals can still see and work with every live Roll Call. This setting only controls who can end it.


Set how long a Roll Call can remain open

Use Automatically end after (hours) to set how long a Roll Call can remain active if nobody ends it manually.

Select from 1 to 5 hours.

The default is:

5 hours

When the time limit is reached, the workflow ends the Roll Call automatically and sends the final report.


Deploy the workflow

Once you’ve reviewed the configuration:

  1. Return to Automate > Installations.

  2. Locate Forms - Roll Call.

  3. Open the More actions (…) menu.

  4. Click Deploy.

Once deployed, the Roll Call tile is available in Sense Mobile to the people configured as Marshalls.

Any marshall can then use the tile to start a Roll Call.


What happens when a Roll Call starts?

When a marshal starts a new Roll Call, the workflow:

  • determines which locations the Roll Call covers;

  • identifies the people who should be included;

  • creates the configured groups;

  • starts the shared live register; and

  • notifies the other configured marshals that a Roll Call has started.

All configured marshals can see and open every live Roll Call. Marshals aren’t assigned to particular locations.

If Locations when starting is set to Choose when starting, separate Roll Calls can run at the same time for different locations. A location already included in a live Roll Call can’t be selected for another one.


How the Roll Call ends

A Roll Call stays open until:

  • someone with permission ends it; or

  • it reaches the configured automatic time limit.

Who can end it depends on Who can end a roll call:

  • Roll call starter only — only the person who started it can end it.

  • Any fire marshall — any configured Fire Marshal can end it.

Before a Roll Call is ended manually, an IMPORTANT warning shows how many people are still unaccounted for.

Ending the Roll Call closes the live register for all marshals and emails the final report to its marshals.

If nobody ends it, the workflow ends it automatically after the number of hours configured in Automatically end after (hours). The final report records that the Roll Call ended automatically.


Basic troubleshooting

The Roll Call tile isn’t available

Check that:

  • Forms - Roll Call is deployed.

  • The person is included in the configured Marshalls setting.

  • The Sense Workplace mobile app has been closed and reopened since the workflow was deployed.

If Admins is selected in Marshalls, check that the person has the appropriate administrator Access Role.

If Fire Marshalls is selected, check that:

  • the Is Fire Marshall? radio button field has been added to the Job Details screen

  • the field includes the options Yes and No

  • Is Fire Marshall? is set to Yes in that person’s Job Details

🖊️ Note: If you’ve only recently changed someone’s Is Fire Marshall? setting, confirm that the workflow and mobile app are reflecting the updated access before troubleshooting further.


People appear in the wrong groups

Check the configured Mode.

If using Custom or Combined, check that:

  • Custom Field exactly matches the intended Job Details dropdown field

  • employees have the correct value recorded in that field

If using Presence Location or Combined, check the mappings entered in Anviz Device Id.

For Combined mode, also check Group Location Map.


Someone expected at work isn’t on the register

The Forms - Roll Call workflow uses current clocking activity and scheduled shift times to decide who should be included when a Roll Call starts.

If someone you expect to see isn’t on the register, check:

  • whether they’re currently clocked in;

  • whether they clocked out within the configured Include people who clocked out within (minutes) period;

  • whether their scheduled shift is currently in progress; or

  • whether their shift starts within the configured Include people starting within (minutes) period.

⚠️ Important note: The register is a snapshot taken when the Roll Call starts. Once triggered, it doesn’t update if someone clocks in or out, or their schedule changes, after the Roll Call has started.


A location isn’t available when starting a Roll Call

If Locations when starting is set to Choose when starting, a location can’t be selected if it is already included in another live Roll Call.

Open the existing Roll Call for that location rather than starting another one.


FAQs

Q: Can more than one marshal work on the same Roll Call?

A: Yes. Forms - Roll Call allows multiple marshals to work on the same Roll Call simultaneously. Everyone works from the same live register, so when one marshal accounts for someone, the other marshals see the update in real time.


Q: Do all marshalls need to use a mobile phone?

A: No. Marshalls can work with their register from a mobile device or a laptop/PC. Updates are shared in real time regardless of which supported route each marshall is using.


Q: Who is included in a Forms - Roll Call?

A: A Forms - Roll Call includes anyone currently clocked in, anyone who clocked out within the configured recent clock-out period, and people whose scheduled shift is already in progress or starts within the configured upcoming-shift period. The register is a snapshot taken when the Roll Call starts and doesn’t automatically update for later clocking or schedule changes.


Q: Can I group people by location?

A: Yes. You can group people by their registered location in Sense HR by selecting Custom mode and using the Location field from Job Details as the Custom Field. Alternatively, Presence Location groups people according to their mapped clock-in location. Combined mode can use both a Custom Field, such as registered Location, and clock-in location information together.

This grouping is separate from Locations when starting, which controls whether a new Roll Call covers all configured locations or selected locations only.


Q: Can I group people using information from Sense HR?

A: Yes. Use Custom mode and specify a dropdown field from Job Details in Custom Field. Each dropdown option becomes a selectable group in the Roll Call.


Q: Can more than one Forms - Roll Call run at the same time?

A: Yes, if Locations when starting is set to Choose when starting, then more than one Roll Call can run simultaneously. Separate Roll Calls can run at the same time for different locations. A location already covered by a live Roll Call can’t be selected for another one. If All locations is configured, only one Roll Call can run at a time.


Q: Does every Fire Marshal need to finish their own register before a Roll Call can end?

A: No. Forms - Roll Call uses one shared Roll Call and individual marshals don’t close separate registers. The Roll Call ends when an authorised person ends it or when it reaches the configured automatic time limit.


Q: What happens if nobody ends a Forms - Roll Call?

A: The Roll Call ends automatically after the period configured in Automatically end after (hours). The default is five hours. The final report records that the Roll Call ended automatically.

Did this answer your question?