Adding a new module requires some additional steps, outlined below.
To add a new module to Commerce Reference Store:
Create the module’s directory. If the new module will be a child of an existing module, create its directory inside the parent module’s directory. For example, to create a
Store.NewModule
module, create aNewModule
directory under<ATG10dir>/CommerceReferenceStore/Store/
. This directory should contain any source Java and/or configuration files as well as aMETA-INF
directory that contains amanifest.mf
file for the new module (see the ATG Platform Programming Guide for information on creating aMANIFEST.MF
file).Write a
build.xml
file for the module. Make sure thebuild.xml
file importscommon.xml
. Also, if you need to override any of the targets defined incommon.xml
, define those overrides in this build file.Edit the
build.properties
file of the new module’s parent to add the new module’sbuild.xml
file to themodules.build.order
property. Assuming that the new module is a sub-module of the rootStore
module, the path would look similar to this:modules.build.order=NewModule/build.xml
Write a
build.properties
file for the module. This file must specify the module’s:Name (
module.name
property)Parent (
module.parent
property)Installation directory (
install.dir
property)
Optionally, you may also want to specify:
The build files for any child modules (
modules.build.order
property)A module-specific class path that references other Commerce Reference Store modules required to build the module (
classpath
property).A module-specific class path that references any third-party libraries required to build the module (
lib.classpath
property)Any custom properties required for the module’s build project.
Build the module using the
ant all
command. See Building a Commerce Reference Store Module and its Sub-Modules for detailed instructions.After building the new module, you must stop and remove the affected ATG server instances and then re-assemble and re-deploy them. See Re-assembling and Re-deploying an ATG Server Instance for detailed information on this step.