# 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](https://docs.keyfax.biz/product-suite/admin/entities/databoxes/import-xml "mention") **databoxes** using [admin](https://docs.keyfax.biz/product-suite/admin "mention").
{% 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="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2FUq19a7uTkRJdTu71npjl%2Fimage.png?alt=media&#x26;token=b805053a-5384-4888-8bff-1162f5cf2ede" 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="https://2882349412-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MARm6St_qFGM52R3pBa%2Fuploads%2FU33Nnvucclka8TKQbHnb%2Fimage.png?alt=media&#x26;token=adf09fa3-4a87-4718-8e42-c56a5b7a779e" alt=""><figcaption></figcaption></figure>

There are some [minimum-mapping-requirements](https://docs.keyfax.biz/product-suite/keynamics/configuration/mappings/minimum-mapping-requirements "mention") 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](https://docs.keyfax.biz/product-suite/keynamics/configuration/mappings/creating-mappings "mention")
* [minimum-mapping-requirements](https://docs.keyfax.biz/product-suite/keynamics/configuration/mappings/minimum-mapping-requirements "mention")
* [mapping-entity-form-fields](https://docs.keyfax.biz/product-suite/keynamics/configuration/mappings/mapping-entity-form-fields "mention")
* [mapping-examples](https://docs.keyfax.biz/product-suite/keynamics/configuration/mappings/mapping-examples "mention")