Business Process Services Overview

ENOVIA Business Process Services contains schema for all the ENOVIA products and is the framework, or foundation, for those products. It includes the programs and JavaServer Pages needed to construct the user interface shared by all the applications. The framework must be installed before you can install any ENOVIA product. The framework can also be used as the basis for creating your own applications.

The following topics are discussed:

This diagram describes the framework architecture:



The above graphic shows a sampling of ENOVIA products. All ENOVIA applications rely on the same architecture.

Business Process Services Components

This section lists the components ENOVIA Business Process Services provides to support the ENOVIA applications.

The ENOVIA Business Process Services contains these schema items as defined in the Schema Reference Guide (Overview):


  • associations
  • attributes
  • business objects
  • commands
  • formats
  • groups
  • menus
  • persons
  • policies
  • programs, including Java Program Objects (but not those specific to an application)
  • relationships
  • roles
  • stores
  • types
  • vaults
  • wizards (for administrative uses only, not for business processes)

ENOVIA Product Components

Each ENOVIA product contains the items listed in this table.

Application Components
Item For information, refer to:
Web pages used by the application's users The user guide that accompanies the application.
Programs specific to the application

To configure programs and for descriptions of utility trigger programs, see Configuring Using Schema and Triggers.

For application-specific trigger programs, see the Administrator's Guide that accompanies the application. The Administrator's Guides are located in ENOVIA_INSTALL\Apps\APP_NAME\VERSION\pdf

For information on how to call the included JavaBeans in your custom applications, see the Javadocs located at: ENOVIA_INSTALL\Apps\APP_NAME\VERSION\Doc\javadoc

Other administrative objects specific to the application, such as formats The Administrator's Guide for the application.
Business objects that accomplish system-related tasks, such as objects for automatically-naming objects and for executing trigger programs

For general information on how the objects function and how to configure them, see Configuring BPS Functions and Configuring Using Schema.

For a list of the objects included in the application, see the Administrator's Guide that accompanies the application.

Some applications, such as Materials Compliance Central, install other components that may be shared between applications. When this is the case there are 2 directories installed under ENOVIA_INSTALL\Apps, one which includes "base" in the name, such as MaterialsComplianceBase. These base directories are where the doc directories can be found.

For example: c:\enovia\studio\Apps\APP_NAME\VERSION\pdf.

The documentation that describes the common components installed with ENOVIA Business Process Services can be found in the ENOVIA_INSTALL\doc directory.

Dynamic UI Components

Whether building a new application from scratch or extending an existing application, the UI components significantly reduce coding effort and make your code easier to upgrade.

The application interface consists of the following:


  • Application Login
  • Navigator Page and Toolbars
  • Global Toolbar
  • Menus
  • Global/Generic Search component
  • Application-specific Search Pages
  • View Table Pages
  • Mass Editable Configurable Tables
  • Structure Browser Tables
  • Navigation Trees / Structure Navigator Pages-.
  • Configurable Web Forms
  • Configurable Type Chooser Forms
  • Configurable Vault Chooser Forms
  • Calendar Popup Forms
  • PowerView Configurable Pages (Portal Pages)
  • Internet Portals

Database Objects

ENOVIA Business Process Services uses several database objects to support applications.

ENOVIA Business Process Services uses these database objects:


  • Pre-defined schema (administrative and business objects)
  • Program (Tcl and JPO) objects
  • User Interface objects

The schema files contain these items:


  • JPOs contain business logic.
  • XML files contain schema definition and rules.
  • The XML definition file contains the actual schema definition for types, attributes, relationships, and so on.
  • The XML manifest file lists what schema is required by an application or functional area.
  • The mapping file drives the installation wizard and defines prerequisites.
  • The conversion file describes what version a conversion should run at and specifies the prerequisite schema.

Application Jar Files

Each application installs its own jar file that contains Beans and utility classes and the ENOVIA Business Process Services installs multiple jar files. This installation scheme allows ENOVIA products to be updated without having to update everything.

You can look at the version field in the manifest files for each jar to figure out what versions you currently have installed. A pictorial representation of the multiple-tier jar hierarchy is shown below.



ENOVIA Business Process Services is responsible for these jar files: framework.jar and common.jar.

The framework jar file contains the base classes DomainObject and DomainRelationship, as well as several interfaces and classes needed to support these base classes. This jar file also contains a number of utility classes.

The framework jar file also contains custom tags that make up our custom tag library, and classes that wrap the dynamic UI components (often referred to as the UI Beans).

To promote reuse of business logic, a common jar file has been established independent of any application. The common jar file contains domain Beans that are shared by more than one application. The common jar file also contains utility classes shared by more than one application.

Jar Name Packages
framework com.matrixone.apps.domain, com.matrixone.apps.domain.util

com.matrixone.apps.framework.ui, com.matrixone.apps.framework.taglib

common com.matrixone.apps.common, com.matrixone.apps.common.util

There are strict rules on the dependencies allowed among the framework, common, and application tiers (as shown in the figure). Framework JSPs, JPOs, and Beans can only reference the framework jar files. The common components JSPs, JPOs, and Beans can only reference the common components and framework jar files. Each ENOVIA product's JSPs, JPOs, and Beans can only reference their own jar file and the common components and framework jar files.

An ENOVIA product can never reference another ENOVIA product's jar file.

Naming Conventions

The ENOVIA products allow you to use your exact business terminology. Names are case-sensitive and spaces are allowed. You can use complete names up to a maximum of 128 characters. Leading and trailing spaces are ignored.

The naming conventions for the ENOVIA Business Process Services ensure that:


  • Programs refer to each other correctly.
  • Business process application programs can be distinguished from non-business process application programs.
  • It is easy to identify the purpose of the file and the application it belongs to.

Some object names installed with the ENOVIA Business Process Services are prefixed with "eService" and the version number of the installation. The installation program adds this prefix to prevent name collisions between objects in the framework and objects in the existing database. For example, if you install version V6R2011x BPS onto a database that contains a Part type, the installation program renames the Part type within the framework to "eServiceV6R2011x~Part". Other administrative objects within the framework that refer to the type--such as attributes for the type, relationships that connect the type, and policies that govern the type--refer to the framework Part type, now named "eServiceV6R2011x~Part." The installation makes no change to the existing Part type.

To list the name collisions the system found during installation, open the file named installFrameworkVERSION.log, where VERSION is the software version number, located in ENOVIA_INSTALL\Apps\BusinessProcessServices\VERSION. The file also lists all the administrative objects installed or modified during installation. For instructions on configuring objects in the framework, using existing objects instead of the objects installed with the framework, and for information about the installation process, see Configuring Using Schema.