> 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/tile-actions/guard-tour-tile-actions.md).

# Guard Tour Tile actions

The Guard Tour tile displays the details of a *Guard Tour\** that has previously been configured in Configuration Client. It is anticipated this tile will be used in a Monitor Site Viewer where the Panel is either all Guard Tour tiles or a mixture of Guard Tour tiles and other. It is quite feasible that the Panel may contain a mixture of tiles some of which are pre configured for a particular Tour and others that allow the Operator to choose the Tour in operation.

{% hint style="info" %}
**\*Guard Tour**

A sequence of checkpoints on a site that a guard must visit in the designated order.
{% endhint %}

<table><thead><tr><th width="346">If the tile is configured to...</th><th>then...</th></tr></thead><tbody><tr><td>show a particular Guard Tour</td><td>the details shown will be for the specific Tour.</td></tr><tr><td>allow the user to choose the Guard Tour to be shown</td><td>the details shown will be for the last Tour selected from this Tile.<br>By default the first Tour in the list will selected.</td></tr><tr><td>display the Tour that generated the Alarm</td><td>the details shown will be for the Tour related to the Alarm selected.</td></tr></tbody></table>

Columns on the Guard Tour Tile can be resized and/or reordered if required. See below for further detail.

<details>

<summary>Resizing/reordering columns</summary>

It is possible to resize and/or reorder columns on any of the Administration Viewer Panels and some tiles if required, as follows:

<table><thead><tr><th width="126">To...</th><th>Steps</th></tr></thead><tbody><tr><td>reorder columns</td><td>Click on the column tile and drag it to the required position.</td></tr><tr><td>resize columns</td><td><ol><li>Hover over the column divider until the mouse pointer changes to a "double-ended arrow".<br><img src="https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-7ca7c1c062c2f40f24571968c0c20565b4351b89%2Fresize_macrocolumn.png?alt=media" alt=""></li><li>Click and hold down the mouse button.</li><li>Move the mouse in the required direction until the column is the required size.</li></ol></td></tr></tbody></table>

</details>

### Operator Privileges

<table><thead><tr><th width="197">To...</th><th>you need...</th></tr></thead><tbody><tr><td><strong>view</strong> a Guard Tour,</td><td><p>one of the following privileges in the division of the Tour:</p><ul><li>"View Guard Tours"</li><li>"Edit Guard Tours"</li><li>"Manage Guard Tours"</li></ul></td></tr><tr><td><strong>select</strong> a Guard Tour and/or <strong>run</strong> a Tour,</td><td>the "Manage Guard Tours" privilege in the division of the Tour.</td></tr></tbody></table>

### Tile Actions

<details>

<summary>Selecting a Tour</summary>

The ability to select a tour is only available if the tile was configured to allow the user in operation to choose the Guard Tour to be shown. All Guard Tours display in the list, even if they have not been configured properly. However, when selected, the message *"tour not configured"* will display.

</details>

<details>

<summary>Selecting a Guard</summary>

Only Cardholders belonging to the Access Group configured for the Guard Tour can be selected. A Guard must be selected before a Tour can be started. A different Guard cannot be selected while a Tour is in Progress. If a Tour is halted and then started again it is considered to be a new Tour so an alternative Guard can be selected.

</details>

<details>

<summary>Starting a Tour</summary>

It is only possible to start a Tour which is not currently in progress and for which the selected Guard is not on another Tour which is in progress. Only Operators with the appropriate privilege can start a Guard Tour.

![](https://2455150842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi6UYAoyykM6nimMN9yss%2Fuploads%2Fgit-blob-9614ca82f9ca1b934a6476000c8fd1cbedb92f89%2Fguardtour_operational.png?alt=media)

1. Is the **Tour** field a drop-down list?

   <table><thead><tr><th width="78">If...</th><th>then...</th></tr></thead><tbody><tr><td>no</td><td>this tile was configured to monitor a specific Guard Tour, (i.e. the Guard Tour displayed).</td></tr><tr><td>yes</td><td>select the Guard Tour you want to start from the <strong>Tour</strong> drop-down list.</td></tr></tbody></table>

   A tour status appears below the **Tour** field, (e.g. Tour not Running), and the **Checkpoints** on the tour display in the grid.
2. Select the guard that is responsible for performing the tour from the **Guard** drop-down list.

   The **Start Tour** button becomes enabled.
3. Select the checkpoint you want the tour to start at by selecting the appropriate row in the checkpoint grid.
4. Click the **Start Tour** button.

   The following occurs:

   * the **Started on** date is set to the current date
   * the tour status of **Tour not Running** (in black text) changes to **Tour in Progress** (in green text)
   * any checkpoints before the selected start checkpoint in the grid will go grey
   * the **Expected time** field will be populated for the start checkpoint and any following checkpoints
   * the **Status** will be set for the start checkpoint.
   * the **Stop Tour** button becomes enabled.

</details>

<details>

<summary>Stopping/Halting a Tour</summary>

A Tour that is in progress can be stopped (halted) at any stage by an Operator with the appropriate privileges, as follows:

1. Click the **Stop Tour** button.

   The following occurs:

   * prompts the Operator to enter a comment (up to 200 characters). Entry of a comment is optional
   * the **Status** of the next Checkpoint the Guard is due to visit is set to 'Halted'
   * the tour staus of **Tour in Progress** (in green text) changes to **Tour Halted** (in red text), and the text for any Checkpoints before the Tour's start Checkpoint are set to black. This is because the Operator can choose to (re)start the Tour at a Checkpoint prior to the start Checkpoint the last time the Tour was run.

   **Note:** When a Tour is halted, all the details of the Tour including Guard selected, (e.g. the expected times, actual times, status', etc.) will remain until the Tour is run again.

</details>


---

# 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/tile-actions/guard-tour-tile-actions.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.
