# Mappings

Mappings within KeyNamics are used to provide '**startup**' data to your Keyfax diagnostic scripts and to retrieve information from the Keyfax '**export**' data in order to populate entity form fields on completion of the script.

Mappings can...

* Be defined at **Global** or overridden at **Entity** level (Entities represent different forms/case types e.g. Sales Order, Enquiry, Repair, Complaint)
* Use ‘FetchXml’ queries for deep extraction of hierarchical/other data within Dynamics
* be grouped by Entity, Send/Receive or any other element for ease of access
* Support Date, Boolean, Option Set, Option Pairs, Lookup data types
* supply default values 

{% hint style="info" %}
**TIP** If you create Mappings which send data to Keyfax, to use this data within your scripts you will need to define [Import XML](/product-suite/admin/entities/databoxes/import-xml.md) **databoxes** using [Keyfax Administrator Tools](/product-suite/admin.md).
{% endhint %}

Here is an sample set of **Global mappings**. These mappings apply across all entities unless overridden by **entity-level mappings** with the same **Target**:

<figure><img src="/files/35FqXRS3Qu9AGYLh0JTr" alt=""><figcaption></figcaption></figure>

Similarly, a sample set of **entity-level mappings**. The first few mappings can be seen as '**SEND to Keyfax**'; these are used to provide startup data for Keyfax:

<figure><img src="/files/YFpIAQgbZ9oFMAlidf7M" alt=""><figcaption></figcaption></figure>

There are some [Minimum Mapping Requirements](/product-suite/keynamics/configuration/mappings/minimum-mapping-requirements.md) that are required by Keyfax and these will normally be created at the **global** level. These define the basic settings required to launch Keyfax.\
**Note:** There is no limit to the amount of data you can send to Keyfax for consumption by your scripts. \
\
The amount of data available for mapping into Form fields is only limited by the data that is generated by your Keyfax scripts. To expand upon this, it may require additional scripting techniques such as the inclusion of **Notes** which can easily export any script data that you wish to use in Dynamics. For further information, contact Support.&#x20;

### See Also

* [Creating Mappings](/product-suite/keynamics/configuration/mappings/creating-mappings.md)
* [Minimum Mapping Requirements](/product-suite/keynamics/configuration/mappings/minimum-mapping-requirements.md)
* [Mapping Entity Form Fields](/product-suite/keynamics/configuration/mappings/mapping-entity-form-fields.md)
* [Mapping Examples](/product-suite/keynamics/configuration/mappings/mapping-examples.md)


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.keyfax.biz/product-suite/keynamics/configuration/mappings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.