Contributions
The Contributions tab tab lists all business process archive (BPR) deployments. Their names are based upon the Process Developer project from which they were deployed.
Just as Process Developer keeps together all files in an orchestration project, a contribution is a unit of the deployable processes and resources from a project. It is a unique deployment to the server catalog. As developers update their projects, they can deploy new contributions while maintaining earlier ones on the server.
Here is some information about contributions:
- •Each contribution is named (by default) as project:/project name as a Process Developer location hint.
- •A contribution can contain multiple processes, which can be managed together or separately.
- •Each new version of a contribution supersedes an earlier version and becomes the current (online) version. However, you can rollback an online contribution to an earlier version. This contribution tracking system allows for easy management of processes and their resources.
- •There is only one current (online) contribution. All contributions can become the online version.
- •The current (online) contribution can be rolled back to an earlier version.
- •Process versions are associated with a specific version of WSDL, schema, and other resources. Every BPEL process is associated with the set of resources it is deployed with.
- •If you delete a contribution, all associated files and the deployment log are deleted, giving you an easy way to clean out the database during testing
- •Multiple developers can deploy the same process and resources without colliding with one another.
For details, see Contribution Detail.
What Happens When a Contribution is Updated
When a BPR contribution is deployed for the first time, Process Server tags the contribution and every file in the deployment as version 1.0, and the contribution is online. Subsequently, as developers make changes, they may update, add, or delete files and then repdeploy the same BPR. The new version becomes the online version and the old version is offline pending, eventually becoming offline when all executing processes complete.
The following scenarios illustrate what happens when a contribution is updated.
Contribution changes from V1 to V2 -- Process1 is modified, Process2 is removed
Deployment 1 project:/MyProject V1 | Deployment 2 project:/MyProject V2 | Changes on the Server |
|---|
process1.bpel | process1.bpel (modified) | V2 is online, V1 is offline or offline pending, if it has associated process instances. |
process.private.wsdl process.public.wsdl | not modified | V1.01 is online. V1 is offline. With each deployment, WSDL and XSD are incremented to avoid cache issues. |
process2.bpel | (not included) | The process is no longer in the catalog. |
Contribution changes from V1 to V2 -- All original files are removed, a new one is deployed
Deployment 1 project:/MyProject | Deployment 2 project:/MyProject V2 | Changes on the Server |
|---|
(myAVOS.avcconfig does not exist) | myAVOS.avcconfig | This file is deployed as an "Additional Resource" and is the only file deployed in the same BPR as previous deployment. V1 is online. This is the only file online because it is the only file in Contribution V2. To get all files back online, redeploy the BPR and include all files. |
process1.bpel | (not deployed) | BPEL file is removed |
process.private.wsdl process.public.wsdl | (not deployed) | WSDL files are removed |
For each contribution, basic version information is displayed, as shown in the table.
Item | Description |
|---|
Contribution | The base URI, usually the Process Developer project name, such as project:/myProject |
Version | Deployed version |
State | By default, online state is displayed; for information, see the description of all states below this table |
Date | Date the contribution was deployed |
Group | Group this contribution belongs to, if any, as added in the Export Business Process Wizard in Process Developer |
Deployer | Name of person (or system) who deployed, if authentication is required for deployers. The default is anonymous. |
Contribution Versions
Contribution versions can have one of the following states:
- •Online—By default, the newest contribution (highest numbered) is the online (current) version.
- •Offline Pending—A version is offline pending in the following cases: if you set the version offline and there are running process instances; a newer version is deployed while there are running process instances; or the contribution’s exported namespaces are referenced by other contributions.
- •Offline—When all process instances of an offline pending version complete, a contribution is offline.
Selection Filters
You can select the following Selection Filters to view a subset of contributions:
- •State—One of the contribution versions states just listed.
- •Deployed between—Enter or select the starting and ending deployment dates.
- •Name—Type in the contribution name. You can use wildcards, such as tutor*.*, and select Submit.
- •Group—If the contribution was deployed with a group name, this filter is available. Type in a group name, and select Submit. There is a default System group, which is hidden by default. Remove the checkmark from Hide System and select Submit to display System contributions.
