> 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/licensable-features/enterprise-data-interface/configuring-an-interface/mapping-booking-data/creating-a-booking-id-transformation-mapping.md).

# Creating a booking ID transformation mapping

### Introduction

This procedure describes how to create a booking ID transformation mapping.

An ID transformation mapping enables you to transform a source value into a Bookable Resource Name.

When an import is run, the bookings for the source value will be applied to the selected bookable resource.

**Notes:**

* Only one ID mapping can be set.
* The ID mapping must be set to the Command Centre Bookable Resource Name field.
* The source field used as an ID mapping can also be used to map to other Command Centre fields.
* When mapping from a database, the source field used as an ID mapping must contain a single value.
* If the source field used as an ID mapping contains a blank or null value, the bookings will not be imported.

### Procedure

1. Select the ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-f94116c4818e02a5123c1d279b08c3fc74837353%2Fbookinginterface_idtransformation.gif?alt=media) tool.
2. Select the source field containing the source value you wish to transform.
3. Hold down the mouse button and drag the cursor over the Command Centre Bookable Resource Name field.

   **Note:** The ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-30eb3b9061eef6810746ce07bd9edf9dda196209%2Fmouse.gif?alt=media) icon will only appear for the Command Centre Bookable Resource Name field.
4. Release the mouse button. A red line and the transformation icon are shown between the two fields.

   The transformations grid displays below. This grid lists the transformations for this mapping.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-8062c1c5dabbbce79ebe67cee7f6b4cb29da2f5d%2Fbookinginterface_idtransformationmapping.png?alt=media)
5. Click the **Add** button to add a transformation. The Add Transformation window displays.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-95cae99499d1254790b68f3adcdc9dbb5e8ecc23%2Fbookinginterface_addidtransformation.png?alt=media)
6. In the upper field, enter the source value you wish to transform.

   **Note:** This field accepts wildcard characters. Refer to [Wildcard characters](https://help.security.gallagher.com/knowledge-hub/configuration-client/licensable-features/enterprise-data-interface/configuring-an-interface/defining-the-source-data-location/wildcard-characters.md).
7. In the lower field select the Bookable Resource Name you wish to set when this source value is transformed.
8. Click the **OK** button. Your transformation is added to the Transformations grid.
9. Repeat as necessary, to add additional transformations.

   ![](https://3000903572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfCvaxj3suxNBzdwQndVT%2Fuploads%2Fgit-blob-c4aee886037416d012b01abd88eba074e223cce9%2Fbookinginterface_idtransformationgrid.png?alt=media)
10. To edit a transformation, select the transformation you wish to edit then click the **Edit** button. The Edit Transformation window displays. Edit the transformation as required.
11. To delete a transformation, select the transformation you wish to delete then click the **Delete** button.
12. To move a transformation up, select the transformation you wish to move then click the **Move up** button.
13. To move a transformation down, select the transformation you wish to move then click the **Move down** button.

**Notes:**

* Transformations are performed in the order specified by the transformations grid. The first transformation that matches will be performed only. Any later matches are ignored.
* You can use the wildcard character "\*" as a transformation to catch all remaining values within the source field. This transformation should be listed last in the grid. It is recommended that this transformation is mapped to a default value. If the date and time of one booking coincides with that of another booking, the booking that is processed later will be imported.
* If the source value doesn't match a transformation, refer to [Mapping a value that doesn't match a transformation](https://help.security.gallagher.com/knowledge-hub/configuration-client/licensable-features/enterprise-data-interface/configuring-an-interface/mapping-cardholder-data/mapping-a-value-that-doesnt-match-a-transformation.md).


---

# 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/licensable-features/enterprise-data-interface/configuring-an-interface/mapping-booking-data/creating-a-booking-id-transformation-mapping.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.
