> For the complete documentation index, see [llms.txt](https://help.security.gallagher.com/knowledge-hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.security.gallagher.com/knowledge-hub/command-centre-client/using-command-centre/working-with-viewers/cardholder-viewer/creating-manual-access-events-for-cardholders.md).

# Creating manual access events for Cardholders

A privileged Operator can create a manual access event, where Cardholders move:

* from outside the system to a specific Access Zone
* between Access Zones (i.e. from Access Zone 1 to Access Zone 2)
* from an Access Zone to outside the system.

The event can be created with a movement time of now or in the past. If the movement time is now or after the Cardholder’s most recent movement event, then the Cardholder’s current location is updated. If the movement time is before the Cardholder’s most recent movement event, then the Cardholder’s current location does not change.

**Notes:**

* Once an Operator moves a Cardholder, Command Centre generates an event.
* The Zone count does not increase or decrease when a Cardholder is moved to a Zone or outside the system, whether the time is set to now or in the past.
* To move a Cardholder to an Access Zone with a movement time of now, an Operator requires the "Manage Cardholder Location" privilege in the target Access Zone's division.
* To move a Cardholder to an Access Zone with a movement time in the past, an Operator requires the “Manage Historical Cardholder Location” privilege in the target Access Zone’s division. This privilege also allows a movement time of now.
* To move a Cardholder outside the system, now or in the past, an Operator requires the appropriate above privilege(s) in *any* division, and the **Allow moving cardholders outside of the system** option must also be enabled on the **General** tab of the Mobile Viewer Global Settings.

### Reports

Manual access events can be included in ‘Time Report’ and ‘Time Report - Overview’ reports. To be included, the ‘Exception’ filter must be added, with the E\_MAE (entry manual access events) and/or X\_MAE (exit manual access events) exceptions selected. Manual access events are not included by default.

**Note:** If a Cardholder only has manual access events within a report’s period (defined in the ‘Report Date and Time’ filter), and no regular access events, the Cardholder’s events only appear in the report if at least one of their events has a specified entry or exit Access Zone

### Procedure

To move a Cardholder into a Zone or outside the system, either now or in the past, perform the following procedure:

1. Click **Viewers** > **Cardholder Viewer**.
2. Enter a search item in the search field.

   A minimum of three characters starts the search.

   **Notes:**

   * You can search Cardholders by Name, Description, Division, Card Number(s), Last Zone Entered, Authorised, or all.
   * If a filter (i.e. Last Zone Entered) is not available in the Cardholder Viewer, you need to access the Viewer Configuration and add the required filter.
3. Select the Cardholder(s) you want to move (now or in the past) to a specific Zone or outside the system.
4. Click the **Actions** button.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-fdaa06d9f9f80d95be6245a8a5e1fe3b27fb7eb8%2Fchold_actionsdropdown.png?alt=media)
5. Select **Create Manual Access Event** from the drop-down.

   The Create Manual Access Event window displays.

   ![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-ff3d5388c7884054af81a6ad96b10be45090c40b%2Ftagboard_createmanualaccessevent.png?alt=media)
6. Configure as required.

   <table><thead><tr><th width="204" valign="top">To...</th><th valign="top">then...</th></tr></thead><tbody><tr><td valign="top">remove Cardholder(s) from the list</td><td valign="top"><ol><li>Select the Cardholder you want to remove.</li><li>Click the <strong>Remove from list</strong> button.<br>The Cardholder is removed from the list.</li></ol></td></tr><tr><td valign="top">move Cardholder(s) outside the system</td><td valign="top"><p><strong>To move outside the system now:</strong></p><ol><li>In ‘Movement Time’, select the <strong>Now</strong> option.</li><li>Click <strong>OK</strong>.<br>The Cardholder(s) is moved outside the system, and an event is generated for each Cardholder who was moved by the Operator.<br><strong>Example:</strong><br>Operator "System Operator" moved Cardholder "Harding, Dan" to outside of the system.</li></ol><p><strong>To create a past movement to outside the system:</strong></p><ol><li>In ‘Movement Time’, select the <strong>In the past</strong> option.</li><li>Select the time and time zone at which the Cardholder’s movement would have occurred.</li><li>Click <strong>OK</strong>.</li><li>In the pop-up that displays, check that the event details are correct, then click <strong>Yes</strong>.<br>An event is generated for each selected Cardholder.<br><strong>Example:</strong><br>“System Operator” moved "Harding, Dan" to outside of the system historically.<br><br><strong>Note:</strong> Errors will display if the ‘In the past’ time is in the future or precedes the ‘Maximum age of historical manual access events’. For information about the maximum age, refer to the topic “Operator Defaults” in the <em>Gallagher Configuration Client Online Help</em>.</li></ol></td></tr><tr><td valign="top">move Cardholder(s) to a specific Access Zone</td><td valign="top"><ol><li>In ‘Cardholder’s Target Location', select the <strong>Specific Access Zone</strong> option.<br>The Select an Access Zone window displays.<br><img src="https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-81f2de9f44e9a33cf252c511f89f456626ab8614%2Faddoperatorprivileges_popup.png?alt=media" alt=""><br></li><li>Select the required Access Zone, then click <strong>OK</strong>.<br>The Select an Access Zone window closes and the Select an Access Zone button changes to the name of the Access Zone you selected.</li></ol><p><strong>To move to an Access Zone now:</strong></p><ol><li>In ‘Movement Time’, select the <strong>Now</strong> option.</li><li>Click <strong>OK</strong>.<br>The Cardholder(s) is moved to the Access Zone, and an event is generated for each Cardholder who was moved by the Operator.<br><strong>Example:</strong><br>Operator "System Operator" moved Cardholder "Winter, Dan" into zone "Level 1".</li></ol><p><strong>To create a past movement to an Access Zone:</strong></p><ol><li>In ‘Movement Time’, select the <strong>In the past</strong> option.</li><li>Select the time and time zone at which the Cardholder’s movement would have occurred.</li><li>Click <strong>OK</strong>.</li><li>In the pop-up that displays, check that the event details are correct, then click <strong>Yes</strong>.<br>An event is generated for each selected Cardholder.<br><strong>Example:</strong><br>“System Operator” moved "Harding, Dan" into “Level 1” historically.<br><br><strong>Note:</strong> Errors will display if the ‘In the past’ time is in the future or precedes the ‘Maximum age of historical manual access events’. For information about the maximum age, refer to the topic “Operator Defaults” in the <em>Gallagher Configuration Client Online Help</em>.</li></ol></td></tr></tbody></table>

**Notes:**

* When an Operator moves a Cardholder to outside the system ‘Now’ or later than their previous access event, in the Cardholder Viewer, the Last Zone Entered is empty.
* When an Operator moves a Cardholder to a Zone ‘Now’ or later than their previous access event, in the Cardholder Viewer, the Last Zone Entered shows the name of the selected Zone.
* When an Operator moves a Cardholder at a time ‘In the past’ earlier than their previous access event, their Last Zone Entered does not change.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.security.gallagher.com/knowledge-hub/command-centre-client/using-command-centre/working-with-viewers/cardholder-viewer/creating-manual-access-events-for-cardholders.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
