...
Table of Contents |
---|
Component Sets
There are a small number of component sets current in OFBiz (from lowest-level to highest-level):1.
- framework
...
- applications
- plugins
3. specialpurpose
4. hot-deployDependencies between components in these sets must ONLY go up the list. For example components in specialpurpose plugins can depend on components in applications, but components in applications can not depend on components in specialpurposeplugins.
Jira | ||||||
---|---|---|---|---|---|---|
|
Components Within Sets
framework
The framework is the underlying data structures and utilities that supply the essential common features used by the base applications and the extended components. These higher level components will have many dependencies on the framework components. There should be no dependencies in the framework on other parts of OFBiz but a few have crept in. They are shown as the gray arrows in the diagram.
There should be a full discussion on the mailing list before any new dependencies are added. Actually, they should be avoided and even an effort to remove the existing one would be welcome. Framework-only distribution is the first step in this direction...
An overview of the components in the framework stack can be found here:
base applications
The base applications components
...
depend on
...
each other as shown in the diagram. The reason these dependencies are needed is because the components are organized according to high-level business concepts and in the real world business processes tend to jump between many of them. In technical terms, this results in foreign keys from an entity in one component to an entity in another, and to service calls from services in one component to services in another, and other similar effects.
While components can depend on one another in the base applications set they should follow the established priority of dependencies. In the diagram below you see existing dependencies and the component dependency priority going from the top of the page down (in other words components higher on the page depend depends on components lower on the page).
Whenever something some data structure or feature could go in two or more multiple components , or depends could depend on things elements in two or more multiple components, it should go in the highest level component so that the the design should ensure that lower level components don't depend on something in the higher level ones.
specialpurpose
The gray arrows in the diagram represent dependencies that violate the rule and are subject of ongoing discussions about how to fix them.
Digraph | ||
---|---|---|
| ||
compound=true;
fontname="helvetica-bold";
node [shape=plaintext fontname="helvetica-bold" ];
subgraph clusterBaseApplications{
style=filled; color=cornsilk;
BaseApplications [shape="plaintext" label="base applications"];
node [shape=plaintext fontname="helvetica-bold" ];
node [color=cornsilk fontcolor=blue];
{rank=same; humanres; marketing;}
{rank=same; order;}
{rank=same; workeffort;}
{rank=same; accounting;manufacturing;}
{rank=same; party;}
{rank=same; product;}
{rank=same; content;}
BaseApplications->humanres [style=invis weight=0];
BaseApplications->marketing [style=invis weight=0];
}
subgraph clusterFramework{
style=filled; color=cornsilk;
nodesep=.25;
Framework [shape="plaintext" label="framework"];
node [shape=plaintext fontname="helvetica-bold" ];
node [color=cornsilk fontcolor=purple];
"entity(ext)";
service;
webapp;
security;
common;
Framework->"entity(ext)" [style="invis"];
Framework->service [style="invis"];
Framework->webapp [style="invis"];
}
subgraph clusterExtended {
Extended [shape="plaintext" label="extended"];
style=filled; color=cornsilk;
node [color=cornsilk fontcolor=firebrick];
subgraph clusterPlugins {
plugins [shape="plaintext" label="plugins"];
style=filled; color=ivory;
node [color=cornsilk fontcolor=orange];
eCommerce;
}
Extended->plugins[style="invis"];
plugins->eCommerce [style="invis"];
}
//{rank=same; Extended}
//{rank=same; Framework; BaseApplications}
edge [color=darkgreen weight=1];
marketing->order;
marketing->product;
edge [color=seagreen weight=1];
order->workeffort;
order->accounting;
order->party;
order->content;
order->product;
humanres->accounting;
humanres->party;
manufacturing->product;
workeffort->accounting;
workeffort->party;
workeffort->content;
workeffort->product;
workeffort->manufacturing;
accounting->party;
accounting->product;
accounting->manufacturing;
accounting->workeffort;
product->party;
product->content;
"entity(ext)"->common;
service->common;
service->security;
webapp->common;
webapp->security;
edge [color=grey weight=0];
order->marketing;
party->marketing;
Framework->party[ltail=clusterFramework, sametail=t1];
Framework->content[ltail=clusterFramework, sametail=t1];
Framework->product[ltail=clusterFramework, sametail=t1];
Framework->accounting[ltail=clusterFramework, sametail=t1];
edge [color=salmon weight=0];
product->eCommerce [fontcolor="salmon", label="OFBIZ-6110", samehead=h2];
order -> eCommerce [fontcolor="salmon", label="OFBIZ-6110", samehead=h2 ];
BaseApplications->Framework[arrowsize=1,color="red",ltail=clusterBaseApplications, lhead=clusterFramework weight=10];
Extended->BaseApplications[arrowsize=1,color="red",ltail=clusterExtended, lhead=clusterBaseApplications weight=10];
Extended->Framework[arrowsize=1,color="red",ltail=clusterExtended, lhead=clusterFramework weight=10];
|
An overview of the base applications can be found here:
Plugins
Components within the plugins set should not depend on each otherComponents within the specialpurpose set should not depend on eachother. If there is a need for components in this set to depend on something in another set, that something should be put into the most appropriate component in the applications set and both specialpurpose plugins components can depend on the applications component.
hot-deploy
We have currently a dependency of the applications components from, at least, the ecommerce component with regards to the demo data, see
Jira | ||||||
---|---|---|---|---|---|---|
|
An overview of the plugins applications can be found here:
User-defined components that are not part of OFBiz, as plugins to OFBiz. The same guidelines are recommended here as well.
Other information
The Framework-only distribution page is related and about "features that should be available in the framework-only OFBiz distribution"Components in this set are created as add-ons to OFBiz, so it is up to you how to manage it. The guidelines for the specialpurpose component set are recommended.