Migrating customized forms

You can migrate forms you have customized in IBM® Lotus® Quickr® places to IBM Connections Content Manager.

Before you begin

The customized form that can be migrated are those based on the Simple Form template. The Microsoft™ Office- and Imported HTML-based forms cannot be migrated. Pages created based on the Microsoft form will be migrated with the Microsoft document as an attachment, but pages based on HTML form will be ignored during the migration process.

Procedure

  1. Get a list of all customized forms from the desired Quickr places to be migrated by running the qptool getcustomizedforms command from the command line. For example, to generate a list of customized forms for the place_0328 place:
    D:\QD853\Domino\nqptool.exe getcustomizedforms -p place_0328 -o d:\output.xml
  2. Edit the output.xml file to select the customized forms you want to migrate by setting their migrate flags to "true". You also need to set the migrate configuration item of the containing room element to "true".
    The customized form's migrate setting contains two levels: room level and form level with the default settings set to "false" for both levels. The room level migrate setting has a higher priority than the form level setting.

    In the generated XML file containing the customized forms list, select the customized forms to be migrated. For example, if you want to migrate customized Form1, you first need to enable the migrate setting for its containing room, and then enable the migrate setting for the customizedForm Form1 as follows:

    <places>
<place>
<name>place_0328</name>
<room migrate="true" name="Main.nsf">
<customizedForm description="migrate="false" name="CForm2" unid="59A3C9B7945A8A64A00257B3C00F2CB4">
<customizedField dataType="h_TextInput" descriptionText="plain text instruction" displayName="Plain Text1" name="c_PlainText1"/>
....
</customizedForm
...
<customizedForm description="migrate="true" name="Form1" unid="54AE15B7945A8A6D00257B3C00F2F05">
<customizedField dataType="h_TextInput" descriptionText="Plain Text Instructions" displayName="Plain Text Title" name="c_PlainText1"/>
...

<\room>
...
    Customized form Form1 will be migrated, but CForm2 will not be migrated.
    Note: If the room level setting is "false", all forms in the room will not be migrated, even if you set a form to "true".
  3. Complete the migration of the selected customized forms by running the qptool migratecustomizedforms command using the output.xml file as an input parameter, for example:
    D:\QD853\Domino\nqptool.exe migratecustomizedforms -i d:\output.xml -u wpsadmin -pw passw0rd
    The console output will show which customized forms have been successfully migrated, and how many customized forms are migrated for each room and place.
  4. Migrate normal pages and pages created based on selected customized forms by running the migration command. This command migrates normal pages and pages created based on successfully migrated customized forms for the specified place.
    D:\QD853\Domino\nqptool.exe migration -p place_0328 -u wpsadmin -pw passw0rd