# 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>


---

# 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/mapping-entity-form-fields.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.