Difference between revisions of "OS4X plugin groups"

From OS4X
Jump to navigation Jump to search
Line 43: Line 43:
 
After submitting the form, a new plugin group has been created and will be listed in the plugin group list.
 
After submitting the form, a new plugin group has been created and will be listed in the plugin group list.
  
[[editing plugin group name]]
+
==== editing plugin group name ====
 +
You may change the name of any plugin group by clicking on the "''edit''" icon [[Image:pencil.png]]. The next screen asks you to change the name:
 +
 
 +
[[Image:Edit plugingroup.png]]
 +
 
 +
By submitting the form the name changes. This namechange has no influence to any configured partner since the internal ID is always used.
 +
 
 +
 
  
 
[[managing plugin group]]
 
[[managing plugin group]]

Revision as of 01:01, 26 May 2012

Defined OS4X plugins can be grouped into plugin groups. These plugin groups can be administrated via web GUI. Configured plugin groups are available for any hierarchical level (company, location, department and recipient) to be defined for incoming and outgoing jobs.

Plugin group usage

There are three cases for plugin group using: incoming before a recipient is known, incoming jobs when a recipient is known and outgoing jobs.

Outgoing jobs

The most easiest case is the outgoing job: all job parameters are known when the job starts. In this case, a usable plugin group for sending jobs are searched. This is done in four steps:

  • search for a send plugin group at the configured defined recipient
  • if not found: search for a send plugin group at the configured defined recipient department
  • if not found: search for a send plugin group at the configured defined recipient location
  • if not found: search for a send plugin group at the configured defined recipient company

If no send plugin group is defined in any of these hierarchy levels, the job gets the status "aborted" and a log entry is added to the job (complaining about a non-configured send plugin group for that recipient).

The first found plugin group with its configuration (if any is set) is used for that outgoing job. It's processed from the first to the last plugin of that plugin group.

Incoming jobs before a recipient is known

When an incoming job starts (after all files are received for that job), the globally configured default receive plugin group will be executed. Its main goal should be defining the correct recipient (and optionally the sender; globally: interpreting the hopefully available ENGDAT abstract file).

Incoming jobs when a recipient is known

After the execution of the default receive plugin group, the recipient plugin group is searched:

  • search for a receive plugin group at the configured defined recipient
  • if not found: search for a receive plugin group at the configured defined recipient department
  • if not found: search for a receive plugin group at the configured defined recipient location
  • if not found: search for a receive plugin group at the configured defined recipient company

If no receive plugin group is defined in any of these hierarchy levels, the job gets the status "aborted" and a log entry is added to the job (complaining about a non-configured receive plugin group for that recipient).

The first found plugin group with its configuration (if any is set) is used for that incoming job. It's processed from the first to the last plugin of that plugin group.

plugin group management

listing plugin groups

When OS4X Enterprise is installed properly (see is OS4X Enterprise installed?), the left-hand menu contains Plugin groups. Clicking on that link opens the list of configured plugins:

Plugingroup list.png

creating plugin group

In order to add a new plugin group, click on the "Add" button: File:Add.png

This leads you to the "Adding plugin group" form. You have to give the new plugin group a unique name.

Insert plugingroup.png

After submitting the form, a new plugin group has been created and will be listed in the plugin group list.

editing plugin group name

You may change the name of any plugin group by clicking on the "edit" icon File:Pencil.png. The next screen asks you to change the name:

Edit plugingroup.png

By submitting the form the name changes. This namechange has no influence to any configured partner since the internal ID is always used.


managing plugin group

cloning plugin group

deleting plugin group