Chapter 3. Writing Server-Side Plug-ins: Procedures

3.1. Tip: Checking XSD Annotations

There are a number of XSD files that provide elements for server-side plug-ins: rhq-configuration.xsd, rhq-serverplugin.xsd, and type-specific files like rhq-serverplugin-alert.xsd.
Different properties and attributes are defined in these schema files. They are annotated so you can see what the existing, default schema makes available.
For example, for the <control> element:
	<xs:element name="control" type="serverplugin:ControlType" minOccurs="0" maxOccurs="unbounded">
                <xs:annotation>
                    <xs:documentation>
                        Defines operations a user can invoke on the plugin component.
                        Typically, a user interface will allow a user to invoke these operations to
                        control the server plugin component during runtime. 
                    </xs:documentation>
                </xs:annotation>
	</xs:element>
Read through the annotations in the XSD files to help plan what your plug-in will do and determine whether your configuration requires custom schema.