> For the complete documentation index, see [llms.txt](https://docs.keyfax.biz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keyfax.biz/product-suite/keynamics/configuration/mappings/mapping-entity-form-fields.md).

# Mapping Entity Form Fields

Any of the Fields containing data on the **current Form** can be sent to Keyfax for use by scripts. When the Keyfax launch button is clicked, the current fields can be accessed by Mapping individual items into the startup data sent to Keyfax.

Fields that are populated with data are assembled into an XML packet and can be accessed by Mapping entries by specifying an **xPath** statement in the **Source** field.

### Discovering Field Names

You can discover the names of all Fields on the current Form (i.e. all Fields and Option Lists containing data or selections) by including a special mapping that 'dumps' all the current form fields in the *startup* data intended for Keyfax. This technique can also be useful if you want to find out the names of various form fields that you might want to populate from *export* data.

{% hint style="info" %}
Empty fields on the current Form are ignored so in order to be included in the dump you will need to populate them with *something*.
{% endhint %}

Simply include a mapping and specify a **Source** of `//formFields` (note: it's case sensitive!) and a target named (say) **FormFieldDumper**, e.g.

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

Then, launch Keyfax and examine the Startup data in the KeyNamics Log entry. It should look something like this:

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

So, if you wanted to convey the contents of the **notes** field from the current form to make it available to Keyfax scripts, create a mapping something like this:

<figure><img src="/files/4sxoTZcDRzONZs8Xr7Z7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
In setting up your send/receive mappings, if you're unsure of the field names on the current form, there is a very handy way to discover these by using the Chrome/FireFox add-on [**Level up for Dynamics 365/Power Apps**](https://chrome.google.com/webstore/detail/level-up-for-dynamics-365/bjnkkhimoaclnddigpphpgkfgeggokam?hl=en). You can display the field names by clicking 'Logical Names' as below. Note that it is important to use the exact same case:
{% endhint %}

<figure><img src="/files/nOErh9dBuYyzzyr7rDQE" alt=""><figcaption><p>Level up for Dynamics 365 / Power Apps</p></figcaption></figure>
