> 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/configuration-client/site-installation/doors/action-on-access.md).

# Action on Access

### Introduction

Action on access feature can be used to configure a door to respond to entry and/or exit events.

Competency actions that can be configured to take place (per door) are:

* Disable, enable, expire, or reset the expiry for a Competency immediately
* Disable, enable, expire, or reset the expiry for a Competency after a specified period of time
* Disable or enable a Competency for a specified period

Access Group actions that can be configured to take place (per door) are:

* Assign Access Group membership for a specified time period
* Assign Access Group membership immediately until a specified time (at which time the Access Group membership will expire)
* Expire Access Group membership after a specified period of time.

Credential actions that can be configured to take place (per door) are:

* When a Cardholder presents a credential at a nominated reader, the credential is immediately disabled or enabled.
* When a Cardholder presents a credential at a nominated reader, the credential is disabled or enabled for a specified period of time.

**Notes:**

* For Competency and Access Group Field actions to take place, an entry granted and taken event, or a successful exit action event must occur for the Cardholder. For Credential actions to take place, present the credential at the appropriate reader.
* This feature has not been tested in a Command Centre multi-server environment.
* The Door FT item configuration options introduced by this feature are not supported in the Command Centre Configuration Client Site Configuration report.
* The ‘Require card to be disabled on creation’ option supported in customisation is not part of the Card Type properties in vEL7.90. Instead, Command Centre allows you to create a Card in any required state via ‘Card States.’ If the Action on Access feature is installed as customisation and you are upgrading to vEL7.90xxx, you can use ‘Disabled (manually)’ state to disable a Card upon creation. See creating a Card State Set and Cardholder Cards Tile actions topics in the Command Centre Client help file.

### Configuration

To configure this feature, perform the following procedures:

<details>

<summary>Configuring Competencies</summary>

If required, create the Competencies that will be modified when a Cardholder enters or exits through a Door. Ensure these Competencies are assigned to the relevant Cardholders. Refer to the topics [Configuring Competencies](https://help.security.gallagher.com/knowledge-hub/configuration-client/licensable-features/cardholder-competencies/configuring-competencies.md) and [Assigning Competencies to Cardholders](https://help.security.gallagher.com/knowledge-hub/configuration-client/licensable-features/cardholder-competencies/assigning-competencies-to-cardholders.md).

</details>

<details>

<summary>Configuring Access Groups</summary>

If required, create the Access Groups that the Cardholder will be assigned when the Cardholder enters or exits through a Door. Refer to [Setting up Access Groups](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-management/access-groups/setting-up-access-groups.md) topic.

**Notes:**

* Do not add Cardholders when creating the Access Group. Cardholders will be added to the Access Group when entering or exiting through a Door.
* Ensure the **Automatically remove expired memberships** check box is ticked on the Access Group Membership Defaults tab.

</details>

<details>

<summary>Configuring Entry and Exit Actions on a Door</summary>

#### Configuring a Door

If not already created, create the Door. Refer to the topic [Creating Doors](https://help.security.gallagher.com/knowledge-hub/configuration-client/site-installation/doors/creating-doors.md).

#### Entry Actions

1. Open the properties for the Door (that will modify items upon entry).
2. Click the **Devices** tab. Select an input to act as the Door open sensor.

   This enables Command Centre to distinguish between "access granted" and "access granted but not taken" events.
3. If using a turnstile door, click the **Advanced** tab. Check the **Access is via turnstile** checkbox.

   This means that when the door opens, only the last person who badged and was granted access is logged as having entered and if two people badge without the door opening, then the first person gets logged as not having entered.
4. Click the **Entry Actions** tab.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-5ce834f47bc4d35e569c8dc7382f46db7e5f717e%2Fdoor_entryactionstab.png?alt=media)
5. Configure as required. Refer to the following table.

   <table><thead><tr><th width="151">If you want to...</th><th>then...</th></tr></thead><tbody><tr><td>disable, enable, expire, or reset the expiry for a Cardholder's Competency upon entry</td><td><ol><li>Drag and drop the Competency that will be modified from the Competency list window to the Entry Action related items grid.</li><li>Select the Competency, then select the action to be performed upon entry from the <strong>Action</strong> drop-down list and enter the period of time. Maximum 999 days, 23 hours, 59 minutes and 59 seconds.<br><br><strong>Note:</strong> If the Competency has already expired, the <strong>Expire Competency</strong> action will not adjust the expiry time. Use the <strong>Reset item to expire</strong> action to reset the expiry time.</li></ol></td></tr><tr><td>assign Access Group membership for a specified time period upon entry</td><td><ol><li>Drag and drop the Access Group that the Cardholder will be assigned membership to upon entry, from the Access Group list window to the <strong>Entry Action related items</strong> grid.</li><li>Select the Access Group then select the <strong>Add Access</strong> action from the <strong>Action</strong> drop-down list. Enter the period of time in the <strong>From</strong> and <strong>Until</strong> fields.</li></ol></td></tr><tr><td>assign Access Group membership immediately until a specified time upon entry</td><td><ol><li>Drag and drop the Access Group that the Cardholder will be assigned membership to upon entry, from the Access Group list window to the <strong>Entry Action related items</strong> grid.</li><li>Select the Access Group then select the <strong>Add Access to Expire</strong> action from the <strong>Action</strong> drop-down list. Enter the period of time in the After field. Maximum 999 days, 23 hours, 59 minutes and 59 seconds.</li></ol></td></tr><tr><td>expire Access Group membership after a specified period of time upon entry</td><td><ol><li>Drag and drop the Access Group that the Cardholder will be assigned membership to upon entry, from the Access Group list window to the <strong>Entry Action related items</strong> grid.</li><li>Select the Access Group then select the <strong>Expire Access</strong> from the <strong>Action</strong> drop-down list. Enter the period of time in the <strong>After</strong> field. Maximum 999 days, 23 hours, 59 minutes and 59 seconds.</li></ol></td></tr><tr><td>disable or enable a credential upon entry</td><td><ol><li>Drag and drop the Card Type that will be disabled or enabled upon entry, from the Card Type list window to the Entry Action related items grid.</li><li>Select the Card Type then select the action to be performed upon entry, from the Action drop-down list and enter the period of time in the After field. Maximum 999 days, 23 hours, 59 minutes and 59 seconds.</li><li>When a credential of this type is presented at the entry reader of this Door, the selected action will be performed for the credential.</li></ol></td></tr></tbody></table>
6. Click the **OK** button.

#### Exit Actions

1. Open the properties for the Door (that will modify items upon exit).
2. Click the **Devices** tab. Select an input to act as the Door open sensor.

   This enables Command Centre to distinguish between "access granted" and "access granted but not taken" events.
3. If using a turnstile door, click the **Advanced** tab. Check the **Access is via turnstile** checkbox.

   This means that when the door opens, only the last person who badged and was granted access is logged as having entered and if two people badge without the door opening, then the first person gets logged as not having entered.
4. Click the **Exit Actions** tab.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-0aec4d7002827d249073ab61332d54a09add2694%2Fdoor_exitactionstab.png?alt=media)
5. Configure as required. Refer to the following table.

   <table><thead><tr><th width="151">If you want to...</th><th>then...</th></tr></thead><tbody><tr><td>disable, enable, expire, or reset the expiry for a Cardholder's Competency upon exit</td><td><ol><li>Drag and drop the Competency that will be modified from the Competency list window to the <strong>Exit Action related items</strong> grid.</li><li>Select the Competency then select the action to be performed upon exit, from the <strong>Action</strong> drop-down list and enter the period of time. Maximum 999 days, 23 hours, 59 minutes and 59 seconds.<br><strong>Note</strong>: If the Competency has already expired, the <strong>Expire Competency</strong> action will not adjust the expiry time. Use the <strong>Reset item to expire</strong> action to reset the Competency expiry time.</li></ol></td></tr><tr><td>assign Access Group membership for a specified time period upon exit</td><td><ol><li>Drag and drop the Access Group that the Cardholder will be assigned membership to upon exit, from the Access Group list window to the <strong>Exit Action related items</strong> grid.</li><li>Select the Access Group then select the <strong>Add Access</strong> action from the <strong>Action</strong> drop-down list. Enter the period of time in the <strong>From</strong> and <strong>Until</strong> fields.</li></ol></td></tr><tr><td>assign Access Group membership immediately until a specified time upon exit</td><td><ol><li>Drag and drop the Access Group that the Cardholder will be assigned membership to upon exit from the Access Group list window to the <strong>Exit Action related items</strong> grid.</li><li>Select the Access Group then select the <strong>Add Access to Expire</strong> action from the <strong>Action</strong> drop-down list. Enter the period of time in the <strong>After</strong> field. Maximum 999 days, 23 hours, 59 minutes and 59 seconds.</li></ol></td></tr><tr><td>expire Access Group membership after a specified period of time upon exit</td><td><ol><li>Drag and drop the Access Group that the Cardholder will be assigned membership to upon exit, from the Access Group list window to the <strong>Entry Action related items</strong> grid.</li><li>Select the Access Group then select the <strong>Expire Access</strong> from the <strong>Action</strong> drop-down list. Enter the period of time in the <strong>After</strong> field. Maximum 999 days, 23 hours, 59 minutes and 59 seconds.</li></ol></td></tr><tr><td>disable or enable a credential upon exit</td><td><ol><li>Drag and drop the Card Type that will be disabled or enabled upon exit, from the Card Type list window to the <strong>Exit Action related items</strong> grid.</li><li>Select the Card Type then select the action to be performed upon exit, from the <strong>Action</strong> drop-down list and enter the period of time in the <strong>After</strong> field. Maximum 999 days, 23 hours, 59 minutes and 59 seconds.</li><li>When a credential of this type is presented at the exit reader of this Door, the selected action will be performed for the credential.</li></ol></td></tr></tbody></table>
6. Click the **OK** button.

</details>

### Consideration

**Record locks and conflicts**

This feature is unable to alter Competencies, Access Groups, Card Types, or write to Personal Data Fields for locked Cardholders. The workaround for this is to enforce the following conditions:

1. Only modify a Cardholder's record if that Cardholder is unlikely to enter or exit the site at the same time.
2. If (1) cannot be ensured, then it must be assumed that the operator's changes are of greater importance.

   **Note:** The record is locked as soon as the operator starts modifying the Cardholder details and until the changes are applied.


---

# 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/configuration-client/site-installation/doors/action-on-access.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.
