Mapping Entity Form Fields

Learn how to work with entity form fields within KeyNamics.

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.

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.

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

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

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:

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. You can display the field names by clicking 'Logical Names' as below. Note that it is important to use the exact same case:

Level up for Dynamics 365 / Power Apps