1. What Are Dumpers?
2. How Do I Use Dumpers?
3. AntDumper
4. DocumentationDumper
5. ExportedProjectDefinitionDumper
Dumpers are the means by which Invicta creates the output files according to the information gathered from the Project Definition Files. Each Dumper has a name that needs to be used when setting properties that will affect it.
The main Dumper is AntDumper that creates an ANT build.xml file for a project. Other Dumpers allow creating project documentation, or a project export file; other Dumpers will be added. In addition, a general extendable mechanism for creating customized output files is available.
Only enabled Dumpers are being executed to create output files. However, all Dumpers are disabled by default, so naturally to use a Dumper you must set its enabled property to true first.
The property's full name is invicta.dumpers.<dumper_name>.enabled.
Examples:
invicta.dumpers.ant.enabled=true
This will tell the AntDumper to run the next time Invicta is activated.
invicta.dumpers.exportedProjectDefinition.enabled=false
This will disable the ExportProjectDefinitionDumper.
See Invicta Usage for more details on setting properties.
In much the same way, additional Dumper-specific properties are passed:
invicta.dumpers.<dumper_name>.<property_name>=value
Most Dumpers require receiving the output file (.file) property:
invicta.dumpers.<dumper_name>.file
For example:
invicta.dumpers.ant.file=build.xml
invicta.dumpers.exportedProjectDefinition.file=exportedProjDef.xml
Description
Generates an ANT build script (build.xml) for the components defined in the definition files of the project.
Properties
file - output file to which the ANT build script will be written.
Description
Generates HTML pages with a project's documentation (components, dependencies, products, properties, etc.).
Properties
file - output directory to which the HTML files will be written.
5. ExportedProjectDefinitionDumper
Description
Generates an Invicta project definition file for the distribution of a project, i.e. so that it can be used inside another Invicta project. The file contains a single component with multiple products, which are the products of the project's components. Refer to Inter-project relations for more details.
Properties
file - output file to which the export file will be written.