Add advanced customizations to your framework extension

You can integrate other customizations such as using Schematron or forms in Oxygen Web Author. You need to set up Oxygen XML Editor, a copy of the IXIASOFT framework, and your framework extension. Then you can use the Oxygen Web Author Customization Guide to make the changes you want.

Important: Making changes directly to the IXIASOFT framework and integrating plugins for Oxygen XML Web Author is not supported. The IXIASOFT framework may be overwritten during updates and upgrades.
  1. Create a folder on your local disk.
    For example, create a folder called Frameworks.
  2. Locate your framework extension; for example dita-[company].zip where [company] is the name of your company.
    Tip: When you created the framework extension, you should have kept a copy of it at a safe location such as with your backups of the Content Store.
  3. Copy your framework extension, paste it in the new folder you created, and unzip it.
    For example, copy dita-company.zip into the Frameworks folder.
  4. Get the framework extension template:
    1. Go to the 6.0 area of the IXIASOFT Downloads site:
    2. Click the CCMS_Web folder.
    3. Enter the user name and password given to you by IXIASOFT Sales.
    4. Click the latest version.
    5. Download the FrameworkExtensionTemplate-[version].zip.
    6. Extract the zip file to the local drive.
  5. Paste the zip file to the folder you created and unzip it.
    For example, copy OxygenFramework-Ixiasoft-1.3-<DITA Web Build>.zip into the Frameworks folder.
  6. Open Oxygen XML Editor.
  7. Add the location of the frameworks to the Preferences dialog box. The procedure for adding the location will differ depending on the Oxygen XML Editor you are using. For example:
    1. Navigate to the area where you can select your framework:
      • Standalone Oxygen XML Editor: In the main menu, open Options > Preferences. In the left pane, open Document Type Association > Locations, and click Add.
      • Oxygen XML Editor in IXIASOFT 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, and click New.
    2. Select the folder containing the IXIASOFT framework and your framework extension; for example, the Frameworks folder. If required, click Apply.
    3. In the left pane, click Document Type Association where you should see the two frameworks listed. If you do not, close and reopen Oxygen XML Editor.
    4. Double-click your framework extension; for example, dita-company.
  8. Create the desired customizations.
    The details of how to create customizations to a framework extension are provided in the Oxygen Web Author Customization Guide available on the Oxygen XML Web Author website (https://www.oxygenxml.com/doc/versions/21.0.0/ug-waCustom/).
    Isolating customizations is a best practice to facilitate future upgrades and updates.
  9. Upload the dita-company.zip into CCMS Web.