Create custom properties for resources

You can create custom properties for resource objects so that users can enter additional information about them. Custom properties index the content to make searches easier.

Custom properties for resources that are not directly managed by the IXIASOFT CCMS, such as videos or legacy documentation, can prove useful. For example, you could create a custom property called ISBN to store the document number for legacy documentation. You could also create a property to indicate whether a resource should be included in builds when documentation is built every night.

Important: Make configuration changes in a test environment and confirm they work before copying them to a production environment. For dedicated SaaS deployments, test the changes and then ask IXIASOFT Customer Support to copy the changes to your production environment.
Figure: Configuring properties for a resource


When users add values to the custom properties of a resource, the information is written into the Indexed Content file of the resource as metadata.
<metadata class="- topic/metadata ">
   				<othermeta class="- topic/othermeta " content="false" name="user:build"/>
   				<othermeta class="- topic/othermeta " content=" 1-23456-789-0" name="user:ISBN"/>
				</metadata>

To create custom properties for resource objects:

  1. In the TEXTML Administration perspective, connect to your server.
  2. Locate the userproperties.xml file in the repository's /system/conf collection.
  3. Check out the file and open it for editing.
  4. Locate the "resource" object element:
    <objecttype type="resource">
  5. Use the <property> element to give the custom property an ID and a name:
    For example:
    <property id="isbn" label="ISBN Number">
    </property>
    <property id="build" label="Include in build">
    </property>
    Note: The label value appears in the Property column of the User Properties dialog box as shown in the screenshot above.
  6. If applicable, enter an <allowedvalue> element for each possible value of the property:
    <property id="build" label="Include in build">
       <allowedvalue>true</allowedvalue>
       <allowedvalue>false</allowedvalue>
    </property>
  7. (Optional) Repeat the previous steps to create additional custom properties.
  8. Save, close, and check in the file.
  9. Inform users of the changes.
    The changes will be applied automatically once users close and then reopen their IXIASOFT CCMS Desktop. Users can also apply the changes without restarting their CCMS Desktop by clicking IXIASOFT CCMS > Synchronize Configuration.
The custom properties for resource objects are created.