Add advanced customizations to your framework extension

You can integrate other customizations such as using Schematron or forms in Oxygen Web Author. This procedure shows how to create and upload a copy of the IXIASOFT framework and your framework extension, so you can customize your installation of Oxygen XML Editor.

Before you can customize your framework extension, you must set up the following:

  • Oxygen XML Editor
  • A copy of the IXIASOFT framework
  • Your framework extension

Once set up, you can use the Oxygen Web Author Customization Guide to make the changes you want.

Important: You cannot make changes directly to the IXIASOFT framework or integrate plug-ins for Oxygen XML Web Author, since updates and upgrades overwrite the IXIASOFT framework.

To add advanced customizations to your framework extension:

  1. To save and test your framework, create a folder on your local disk, such as Frameworks.
    Note: The framework extension is created during the installation of IXIA CCMS Web. Save it in a safe location, similar to your backups of the Content Store.
  2. Get the IXIASOFT framework and the framework extension template:
    1. Go to the 7.3 area of the MadCap Software Downloads site:
      https://cms.ixiasoft.com/downloads/CCMS_7.2/
    2. Click the Oxygen_Framework_Templates folder.
    3. Download MadCap Software's Oxygen Framework files.
      These files are referred to by the framework extension template.
    4. Extract the zip file to the local drive, such as your Frameworks folder.
    5. If you do not already have a custom framework, download the FrameworkExtensionTemplate-version.zip.
  3. Paste the zip file into the folder you created, such as copying OxygenFramework-Ixiasoft-version.zip into the Frameworks folder
  4. Unzip the files.
  5. Open Oxygen XML Editor.
  6. Add the location of the frameworks to the Preferences dialog box.
    Note: The procedure for adding the location depends on the Oxygen XML Editor you are using.
    1. Browse to the area containing your framework, based on your editor.
      Standalone Oxygen XML Editor
      • In the main menu, open Options > Preferences.
      • In the left pane, open Document Type Association > Locations.
      • Click Add.
      Oxygen XML Editor in IXIA CCMS Desktop
      • In the main menu, open Window > Preferences.
      • In the left pane, open oXygen XML Editor > Document Type Association.
      • Click the Change frameworks (Document Type Associations) directory location link.
      • Click New.
    2. Select the folder containing the IXIASOFT framework and your framework extension, such as the Frameworks folder.
    3. If required, click Apply.
    4. In the left pane, click Document Type Association.
      You should see the two frameworks listed. If you do not, close and reopen your Oxygen XML Editor.
    5. Double-click your framework extension, such as dita-company.
  7. Create the desired customizations in the dita-company folder.
    CAUTION: Do not edit the files in OxygenFramework-Ixiasoft-1.X-version.

    Details on how to customize a framework extension are provided in the Oxygen Web Author Customization Guide available on the Oxygen XML Web Author website at https://www.oxygenxml.com/doc/versions/21.0.0/ug-waCustom/.

    Note: Isolating customizations is a best practice to facilitate future upgrades and updates.
  8. Zip your customization folder to dita-company.zip
  9. Upload the dita-company.zip into CCMS Web.