How do I import one map file into another?

If more than one company produces HotDocs templates to be used with your application, there could be different versions of the application's map file in circulation. For example, the map file that comes with Template Set A would not have the mappings for Template Set B, and vice versa. Yet, end users need to have all mappings for all templates that work with the same source application in one map file. Additional versions of the map file must be merged into the current version of the map file.

You can allow users to import one version of a map file into another version so they can update their mappings.

To import one map file into another

1. Provide a button in your application that will display the HotDocs Variable Mapping dialog box. To give users this option, use the function calls described in VarMap.ShowUserInterface.
2. The dialog box contains an Import button that will merge a new map file into the current map file.
3. If during the merge HotDocs finds that a variable has been mapped in the new map file to a different source field than the one it was mapped to in the current map file, a dialog box will appear asking if the user would like to keep he current mapping or accept the new mapping.