Lotus Notes Domino Form Converter To SharePoint Manual
The Lotus Notes Domino Form Converter to SharePoint is a tool to convert Lotus Notes forms to SharePoint forms with support for Dell Quest NMSP. The tool currently supports converting to SharePoint Forms Designer and Nintex.
This tool is used in projects where Notes and Domino applications are converted to SharePoint applications with Dell Quest NMSP and the SharePoint forms are designed with the Forms Designer tool or the Nintex Forms tool.
In the near future other SharePoint forms designer tools like KWizCom will be supported as well.
The steps to produce a SharePoint Forms Designer form is very straight forward:
- Select a Notes database from which you want to convert a form to SharePoint Forms Designer
- Select the Notes form that you want to convert
- Click the ‘1. Convert Notes to XML’ button
- Click the ‘2. Convert XML to Forms Designer / Nintex’ button
- Open the SharePoint Forms Designer or Nintex Forms application and import the XFDS/XML file you created in step 4
When you first open the tool, enter the license key that was sent to you when you downloaded the tool.
Enter the key in one of the available boxes as shown below, and click OK. When you reopen the license, the User Certifier shows the ID that is licensed to use the tool. Please note that some characters (like hyphens [-]) are removed from the certifier that is displayed.
You can enter multiple license keys, for instance if you use multiple ID’s with different certifiers.
Error messages are saved in the log. By clicking the ‘logging’ link, a pop-up displays the messages, for example when you use a Notes ID that is not licensed to be used with this tool.
Select the product that you want to use for converting Notes forms.
Both Forms Designer and Nintex Forms conversion follow the same procedure. However, there is a difference in the conversion options for both products. This will be explained in more detail later.
Select database and form(s)
Click the ‘Select database’ button to select the Notes database that contains the form(s) that you want to convert. You can select a local database as well as a database on the server. Make sure you have sufficient access to this database.
When you have selected the database, the tool will generate and display a list with all the database forms. Depending on the size and the location (local/server) of the database, this may take some time.
From this list, you can select one or more forms that you want to convert. When a form is only to be used for the Web, a [W] is added to the form name. The same for forms only to be used for Notes [N].
The Base Output directory is the ‘root’ location where the tool writes the output files. You can change this by clicking the button next to ‘Base Output directory’.
The App Output directory shows the directory path where the output files are written for each Notes database.
Field Mapping via Transfer Job (*.pmjob)
This option is optional. A Transfer Job is a file that has been created with Dell Quest NMSP, and is used to map Notes fields with SharePoint columns. In case you have altered the SharePoint columns names with Dell Quest NMSP you may select the Quest NMSP job file here. Please note that:
- When you have selected multiple Notes forms in order to convert them at once, this option is disabled (not visible).
- When all Notes form fields and SharePoint Forms Designer / Nintex fields should be named equally, you do not need to use this option.
- When a Transfer Job is specified, the rendering of columns in SharePoint is determined by the Transfer Job specifications by default. When converting to Nintex, you can override this setting by de-selecting the checkbox ‘Use field rendering as specified in the Transfer Job’. Notes field specifications will then determine the display of columns in SharePoint.
- When no Transfer Job is specified, the rendering in SharePoint is determined by the Notes field settings.
Button 1. Convert to XML
When you select one or more Notes forms from the list, a button ‘1. Convert Notes to XML’ appears. By clicking this button, the selected Notes form(s) are converted to an XML file that is saved in the App Output directory.
Because forms may contain subforms, all subforms will be converted to XML as well. However, when a form contains a computed subform, this part is not converted.
XML files containing subform data are preceded with ‘sub_’.
Convertion to XML may take some time. When the tool is ready processing, a message pops up:
Button 2. Convert to Forms Designer / Nintex
After you have clicked the ‘Convert to XML’ button, the ‘Convert XML to Forms Designer (e.g. Nintex)’ button will appear. This button will convert the Notes form xml file(s) to SharePoint Forms Designer or Nintex file(s).
When the tool is ready processing, a message pops up:
The ‘Open Output folder’ button will open the windows explorer in the directory where the xml and xfds files were saved.
When converting to Forms Designer, the output file will be an *.xfds file. The output file of a Nintex conversion will be an XML file, starting with ‘nintex_’
The Lotus Notes Domino Form Converter to SharePoint Forms Designer tool is available free of charge. It is possible that the tool will not be able to convert all Notes Domino forms. To further improve this tool, we appreciate it when you contact us, so that we can supply you with an offer to update the tool for your forms.