Make appropriate configuration settings from the WebSphere® Application Server administrative console to map the existing IBM® Lotus® Quickr™ property sheets to their ECM equivalents.
About this task
In Lotus Quickr you can customize a form to include different fields. Here a form is treated as a kind of document type, and you can then create a document from that customized form.
When metadata mapping between Quickr and ECM is enabled you can map a form to a document type. Then, when you publish a Quickr document created from that form, Lotus Quickr uses the mapped document type to create an ECM document, and the property's value will be the mapped field's value.
Below is a list of the metadata mapping types that are supported in Lotus Quickr.
- Explicit mapping: Configures which form is mapping to which document type on the ECM server side, and which field is mapping to which property implicitly.
- Semi-implicit mapping: Configures which form is mapping to which document type on the ECM server side explicitly, but does not configure which field is mapping to which property. If one field's name in Quickr matches one property's name, then they are mapped implicitly.
- N fields to One property mapping: More than one field is mapping to only one property (this is a subcategory of Explicit mapping). The fields' names should be separated by a blank space.
Perform the following steps to use metadata mappings:
- Customize a DemoForm in Lotus Quickr, adding a Plain Text field, a Date Pop-up field, and an Attachments field.
- Configure qpconfig.xml to apply one of these three mapping types.
You can run qptool to help to generate the mapping table:
- load qptool execute -i input.xml -o output.xml
Below is a sample of the input.xml file:
Change “hostname” to your actual Quickr server's hostname, and change “name” to your place name.
- The draft mapping is generated in an output.xml file.
The following is a sample of the mapping information:
<mapping field="c_DemoText" property="" propertySheetType=""/>
<mapping field="c_DemoDate" property="" propertySheetType=""/></mappingInfo>
- Copy and paste the draft mapping into qpconfig.xml.
You can then change it to set the different mapping types, as follows:
- Restart Lotus Quickr.
Note: Lotus Quickr must be restarted every time updates are made to this configuration.
What to do next
Use the following mapping strategy when filling in the property fields:
- 1. If a property value exists for a Lotus Quickr document or page, then use that value even if an ECM value exists.
- 2. If a property value only exists for ECM, then use the ECM document value.
- 3. If a value does not exist for the Lotus Quickr document or the ECM document, then use the default value for that property according to the ECM property type.
When a Lotus Quickr document/page has been published before, then the corresponding ECM document/page already exists. ECM property value means the value of the property in this existing ECM document/page. The default value for ECM means the default value defined in an ECM document type.
Parent topic: Map Lotus Quickr metadata with the ECM metadata for document publishing