Appendix A. Reference Material
A.1. Glossary of Terms Used in Windup
A.1.1. Rules Terms
- Rule
A piece of code that performs a single unit of work during the migration process. The following is an example of an XML-based rule that finds and reports on instances of
weblogic-ejb-jar
XML files and provides a link to an article on the Red Hat Customer Portal that describes how to migrate the file.<rule id="weblogic-xml-descriptor-04000"> <when> <xmlfile matches="/weblogic-ejb-jar" /> </when> <perform> <classification title="WebLogic EJB XML" severity="mandatory" effort="3"> <link href="https://access.redhat.com/articles/1326823" title="Map weblogic-ejb-jar.xml Elements to the jboss-ejb3.xml Descriptor" /> <tag>ejb</tag> </classification> </perform> </rule>
- RuleProvider
- An implementation of OCPSoft ConfigurationProvider class specifically for Windup. It provides Rule instances and the relevant RuleProviderMetadata for those Java-based and XML-based Rule instances.
- Ruleset
A ruleset is a group of one or more RuleProviders that targets a specific area of migration, for example,
Spring
orJava EE 6 WebLogic
. A ruleset is packaged as a JAR and contains additional information needed for the migration, such as operations, conditions, report templates, static files, metadata, and relationships to other rulesets. The following Windup projects are rulesets.JBoss EAP - rules-java-ee
- rules-xml
- Rules Metadata
- Information about whether a particular ruleset applies to a given situation. The metadata can include the source and target platform and frameworks.
- Rules Pipeline
- A collection of rules that feed information into the knowledge graph.
A.1.2. Reporting Terms
- Level of effort
- The effort required to complete the migration task. Level of effort is represented as story points in the Windup reports.
- Story Point
- A term commonly used in Scrum Agile software development methodology to estimate the level of effort needed to implement a feature or change. It does not necessarily translate to man-hours, but the value should be consistent across tasks. Story points are covered in more detail in the Windup Rules Development Guide.
Revised on 2017-02-17 00:07:20 EST