Establishes a session with a BPM Directory. The Tasks contained as nested elements are executed using this session.
An external BPM Passport can be referenced for convenience.
All the BPM Ant tasks that use a directory session must be a children of this task.
Example:
<!-- Define a fuego "passport" -->
<fuego:passport id="fuego.passport"
directoryid="${fuego.directoryid}"
participant="${fuego.participant}"
password="${fuego.password}" />
<target name="publish">
<!-- Open a session to the BPM directory -->
<fuego:session
passportref="fuego.passport"
verbose="true"
properties="${fuego.basedir}/conf/directory.xml"
haltonerror="true" >
... include other BPM tasks here...
</fuego:session>
</target>
| Attribute | Description | Type | Required? |
| haltonerror | Stop the build process if an error occurs. | boolean | No Default is false |
| directorypreset | Specify a "preset" for authentication to the BPM directory. | String | No Defaults to the "engine" preset. |
| verbose | Verbose output. | boolean | No Default is false |
| passportref | Use a passport defined previously instead of defining all the properties in the session task | Reference |
Yes Unless directoryid or directoryurl are specified.
|
| directoryid |
The id of the BPM Directory to used, as defined in the
directory.xml file.
|
String |
Yes Unless passportref or directoryurl are specified.
|
| properties | Use a different directory.xml file instead of the default one locate in the conf dir | File |
No Defaults to |
| fuegobasedir | Path to Oracle BPM Enterprise installation directory. | File |
No Defaults to value of fuego.basedir property of your
Ant script.
|
| loaderref | Reference to BPM classloader. Used internally. | Reference | No |
| participant | ID of the participant to use | String |
Yes Unless passportref is specified.
|
| password | Password for the participant | String |
Yes Unless passportref is specified.
|
| directoryfile |
Path to the directory.xml configuration file, used to connect to the BPM
directory.
|
File | No |
| preset | Specifies a preset to use in the Directory Passport. | String | No |
This Task is a Container (it accepts nested Tasks).