Can I create a new Miramo template?

You can customize a new Miramo template within your existing plugin.

Description

When generating Output using Miramo, the layout of the PDF is defined in a Miramo template file (with the .mfd extension) that is contained in your custom Miramo plugin. You can create a new PDF layout with Miramo by creating and customizing a new Miramo template within your existing plugin. When you create a new template, you need to create a transformation scenario for the Output Generator to use this new template.

Solution

  1. From the RDP, use the desktop shortcut to access the DEV-OG files using OGAT.
  2. Navigate to the mmtemplates folder in your custom Miramo plugin. Typically, the path is like: Z:\data\dita-ot-x.x.x\plugins\com.company_name.mmpdf\mmtemplates. There, you find your Miramo template, which has the .mfd extension.
  3. Copy your existing template file, paste the copy in the same folder, and rename it. For example: default_User-Manual.mfd
  4. Edit Z:\conf\client\outputtypes.xml:
    1. Copy and paste the whole content of your current custom Miramo <outputtype> to create a new output type. Make the below changes in that new output type:
    2. Change the @name value for the <outputtype> to what you want your output type to be named when you generate output from the CCMS.
    3. Change the @name value for the <preprocessor> to something new.
    Note: You will need to copy your new <outputtype> in all the instances of that file, if you have any. (outputtypes.xml.dev, outputtypes.xml.test, outputtypes.xml.prod).
  5. Edit Z:\conf\client\preprocessors.xml:
    1. Copy and paste the entire content of your custom Miramo <preprocessor> to create a new preprocessor. Make the below changes in that new target:
    2. Change the @name value for the <preprocessor> to the <preprocessor> @name you defined in outputtypes.xml.
    3. Change the @name value for the <target> to something new.
    Note: You will need to copy your new <preprocessor> in all the instances of that file, if you have any. (preprocessors.xml.dev, preprocessors.xml.test, preprocessors.xml.prod).
  6. Edit Z:\data\conductor-miramo.xml:
    1. Copy and paste the whole content of your custom Miramo <target> to create a new target.
    2. Change the @name value for the <target> to the <target> @name you defined in preprocessors.xml
    3. Change the @value for the @mmpdf:mfd.file <ot_build_set_parameter> to the name of your new Miramo template. For example: 
      <ot_build_set_parameter name="mmpdf:mfd.file" value="default_User-Manual.mfd"/>
  7. Try to generate output using the DEV-OG in using the IXIA CCMS Desktop client. You should see your new output type in the drop-down list.
  8. You can now start making changes to your new template, using Miramo Designer.
Note: You should define your own naming convention for Miramo templates, <outputtypes>, <preprocessors> and <targets>.