You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+14-15Lines changed: 14 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,9 @@
1
-
# Holodeck B2B Pull Request trigger extension
2
-
This extension allows the _Consumer_ application to control when _Pull Request_s are send by Holodeck B2B
3
-
instead of the default fixed intervals. It also allows to specify the _simple selection criteria_ of a "selective"
4
-
Pull Request as specified in [section 5.1 of ebMS V3 part 2 (Advanced Features)](http://docs.oasis-open.org/ebxml-msg/ebms/v3.0/part2/201004/cs01/ebms-v3.0-part2-cs01.html#__RefHeading__435723_822242408).
1
+
# Holodeck B2B Pull Request Trigger extension
2
+
This extension allows the _Consumer_ application to control when a _Pull Request_ is sent by Holodeck B2B
3
+
instead of using the default fixed intervals.
4
+
This extension also allows you to specify the _simple selection criteria_ of a "selective" Pull Request as specified in [section 5.1 of ebMS V3 part 2 (Advanced Features)](http://docs.oasis-open.org/ebxml-msg/ebms/v3.0/part2/201004/cs01/ebms-v3.0-part2-cs01.html#__RefHeading__435723_822242408). This advanced ebMS3 feature lets you specify in your Pull Request which message you want to receive.
5
5
6
-
Currently the trigger mechanism is file based; the back-end application writes a XML document to a specific
7
-
directory where it is read by the extension and a corresponding Pull Request is triggered.
6
+
The trigger mechanism is file based; the back-end application writes an XML document to a specific directory where it is read by the extension and a corresponding Pull Request is triggered.
8
7
__________________
9
8
For more information on using Holodeck B2B visit the website at http://holodeck-b2b.org
10
9
Lead developer: Sander Fieten
@@ -19,22 +18,22 @@ This extension can be used with Holodeck B2B version 4.1.0 and later.
19
18
To enable the trigger mechanism a _worker_ that will watch for _trigger documents_ has to be added to the
20
19
Holodeck B2B instance. The worker class is `org.holodeckb2b.ebms3.pulling.trigger.filebased.WatchForTriggerFile`
21
20
and it takes one parameter _watchPath_ that should point to the directory where the trigger documents are
22
-
placed by the back-end. As the worker will look for any file with "xml" extension it is recommended to use
21
+
placed by the back-end. As the worker will look for any file with an ".xml" extension it is recommended to use
23
22
a specific directory for triggers only.
24
-
Furthermore the regular worker _interval_ parameter can be used to set the interval at which the worker
23
+
The regular worker _interval_ parameter can be used to set the interval at which the worker
25
24
should check for new triggers.
26
25
27
26
If you will only be using "trigger based" pulling on this Holodeck B2B instance you should disable the
28
27
standard "interval based" pull mechanism by removing or deactivating the _pullConfigWatcher_ worker.
29
28
30
29
## Usage
31
-
Pull Request can only be triggered for existing P-Modes that define how the Pull Request must be
32
-
processed.So before triggering a request the P-Mode must have been registered in Holodeck B2B, either
30
+
A Pull Request can only be triggered for existing P-Modes that define how the Pull Request must be
31
+
processed. Before triggering a request the P-Mode must have been registered in Holodeck B2B, either
33
32
manually by an operator or automatically by the back-end.
34
33
35
34
To trigger a Pull Request the back-end application must create a _"Pull Request trigger document"_ in the
36
35
directory specified in the _watchPath_ parameter of the watcher described above. These "trigger" documents
37
-
are XML documents that MUST have the "xml" extension. They must contain at least the P-Mode that governs
36
+
are XML documents that MUST have the ".xml" extension. They must contain at least the P-Mode that governs
38
37
the processing of the Pull Request and can further configure the _MessageId_ of the Pull Request, the MPC
39
38
[sub-channel] and selection criteria to use for pulling. Their structure is defined by XML schema
@@ -43,9 +42,9 @@ ebMS V3 Part 2 Specification are supported.
43
42
44
43
When the watcher detects a trigger document it will check that the P-Mode exists and submit a Pull Request
45
44
Signal message unit to the Holodeck B2B Core to trigger the pull process. After processing the file, i.e.
46
-
after the Pull Request has been submitted, the extension will be changed to "triggered". When an error
47
-
occurs on submit the extension will be changed to "rejected" and information on the error will be written
48
-
to a file with the same name but with extension "err".
45
+
after the Pull Request has been submitted, the extension will be changed to ".triggered". When an error
46
+
occurs on submit the extension will be changed to ".rejected" and information on the error will be written
47
+
to a file with the same name but with extension ".err".
49
48
50
49
## Contributing
51
50
We are using the simplified Github workflow to accept modifications which means you should:
@@ -71,4 +70,4 @@ Version numbering follows the [Semantic versioning](http://semver.org/) approach
71
70
This Holodeck B2B extension is licensed under the General Public License V3 (GPLv3) which is included in the LICENSE file in the root of the project.
72
71
73
72
## Support
74
-
Commercial Holodeck B2B support is provided by Chasquis Consulting. Visit [Chasquis-Consulting.com](http://chasquis-consulting.com/holodeck-b2b-support/) for more information.
73
+
Commercial Holodeck B2B support is provided by Chasquis. Visit [Chasquis-Consulting.com](http://chasquis-consulting.com/holodeck-b2b-support/) for more information.
0 commit comments