Restrict use of output types by role or object type

If you want to remove an output type from the Generate Output dialog for one or more specific roles, remove those output types from the Output Format dropdown menu for that role.

Important: Make configuration changes in a test environment and confirm they work before copying them to a production environment.

To restrict use of output types by role or by object type:

  1. In the TEXTML Administration perspective, connect to your server.
  2. Locate the accessrights.xml file in the repository's /system/conf collection.
  3. Check out and open accessrights.xml with a text editor.
  4. Locate the commented section for output types.
    <!-- ********************** OUTPUT TYPES ********************** -->

    The entries that follow specifically control the visibility of output types for specific roles, but they can also serve as templates for additional entries.

    Note: If an output type does not appear in accessrights.xml at all, it is visible in the Generate Output dropdown list to all users.
  5. Copy an entry, such as the entire <method name="Dita2Pdf"> element, and then paste the copy below the original.
  6. Make the appropriate changes in the copied entry for your scenario.
    Note: Remember to always include System Administrator as a role for any of your modifications.
    Suppose you want to modify your PDF-Final output type. It allows users with the Information Architect role to create the final PDF output for snapshots, maps, topics, and images. However, you want to constrain the ability to create final PDF output for localized content to users with the Translation Manager role.
      <method name="PDF-Final" type="outputtype">
        <notify enabled="false"/>
        <conditionset operator="any">
          <condition>
            <current>
              <type name="snapshot">
                <statuses>
                  <status>Authoring:*</status>              
                </statuses>
              </type>
              <type name="map">
                <statuses>
                  <status>Authoring:*</status>              
                  <status>Published:*</status>
                </statuses>
              </type>
              <type name="topic">
                <statuses>
                  <status>Authoring:*</status>
                  <status>Published:*</status>
                </statuses>
              </type>
              <type name="image">
                <statuses>
                  <status>Authoring:*</status>
                  <status>Published:*</status>
                </statuses>
              </type>
            </current>
            <users>
              <roles/>
              <groups>
                <group name="System Administrators"/>
              </groups>
              <roles>
                <role name="Information Architect"/>
              </roles>
            </users>
          </condition>
    	  <condition>
            <current>
              <type name="snapshot">
                <statuses>
                  <status>Localization:*</status>
                </statuses>
              </type>
              <type name="map">
                <statuses>
                  <status>Localization:*</status>
                </statuses>
              </type>
              <type name="topic">
                <statuses>
                  <status>Localization:*</status>
                </statuses>
              </type>
              <type name="image">
                <statuses>
                  <status>Localization:*</status>
                </statuses>
              </type>
            </current>
            <users>
              <roles/>
              <groups>
                  <group name="System Administrators"/>
              </groups>
              <roles>
                  <role name="Localization Manager"/>
              </roles>
            </users>
          </condition>
        </conditionset>
      </method>
  7. Create additional methods as necessary to define your output type permissions.
    Note: You cannot restrict an output type by its object status, such as a map output type with an Authoring:done status. However, you can disable an output type for an object type altogether.
    Suppose you want to disable the PDF-Final output type for snapshots. Delete the snapshot lines.
    <type name="snapshot">
    	<statuses>
    		<status>Localization:*</status>
    	</statuses>
    </type>
  8. Save, close, and check in the accessrights.xml file.
  9. Inform users of the changes.
    The changes are automatically applied once users close and then reopen their CCMS Desktop. Users can also apply the changes without restarting their CCMS Desktop by clicking IXIA CCMS > Synchronize Configuration. Additionally, refresh IXIA CCMS Web so that users see the change reflected there.
The output types are restricted by role or object type.