Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
nameblue

Modules XML file is used for defining the modules of the system along with their features, related modules, left menu items, and skins.


What does this section cover?

Table of Contents

Modules Metadata File

 

Custom modules and features are declared in modules.xml file which must be created under ../web/WebContent/metadata directory.

All custom modules', features', processes', dashboards', reports', printouts' and Web APIs' IDs should begin with the word CUSTOM. All custom feature menu option IDs should begin with the word CUSTOM as well.

 

Create Custom Feature

 

In the following example, two new features are added to Subscriptions module. To add a new feature to an existing module, you simply have to use the existing module's ID, extending this way the system's release functionality.

Expand
titleCustom Feature Example
Code Block
themeEclipse
languagexml
titlemodules.xml
<moduleconfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../xsd/modules.xsd">
	<modules>
		...
		<module>
			<moduleid>SUBSCRIPTIONS</moduleid>
			<features>
				<feature>
					<featureid>CUSTOM_SUBSCRIPTIONS</featureid>
					<reports>
						<report>
				      		<id>CUSTOM_ACTIvATION_BY_MONTH</id>
				      		<name>key_activations_by_month</name>
				      		<description>key_view_the_monthly_activations_report</description>
				      		<reportfilename>Subscriptions/subscriptionActivationsByMonth.crxml</reportfilename>
				    	</report>
					</reports>
				</feature>
				<feature>
					<featureid>CUSTOM_IMPORT_SUBSCRIPTIONS</featureid>
					<featurename>key_import_subscriptions</featurename>
					<featuredescription>key_import_subscriptions</featuredescription>
					<featuremenuoptionid>CUSTOM_IMPORT_SUBSCRIPTIONS</featuremenuoptionid>
					<additionalprocesses>
						<process>
							<id>IMPORT_SUBSCRIPTIONS</id>
							<name>key_import_subscriptions</name>
							<description>key_import_subscriptions</description>
							<methods>
								<method>
									<ejbname>COMPANYCRMImportSubscription</ejbname>
									<methodname>importSubscription</methodname>
								</method>
							</methods>
						</process>
					</additionalprocesses>
				</feature>
			</features>
			<leftmenuoptions>
				<id>CUSTOM_IMPORT_SUBSCRIPTIONS</id> <!-- Billing > Subscriptions > Import Subscriptions -->
			</leftmenuoptions>
		</module>
 
		...
 
	</modules>
</moduleconfig>


Create Custom Module


In the following example, a custom module is added to Billing Application. To add a new module to an existing application, you simply have to use the existing application's ID, extending this way the system's release functionality.

...