|
Key
This line was removed.
This word was removed. This word was added.
This line was added.
|
Changes (24)
View Page History{section}
{column}
{column}
A BPEL croquis is an alternative to BPEL projects.
They should be used for the cases where you have an external BPEL to run in Petals, or when all or most of the services to orchestrate are not yet imported in Petals.
Once the croquis is completed, it can be exported as concrete Service-Unit (SU) and Service Assembly (SA) projects. The resulting projects are ready for packaging and deployment.
They should be used for the cases where you have an external BPEL to run in Petals, or when all or most of the services to orchestrate are not yet imported in Petals.
Once the croquis is completed, it can be exported as concrete Service-Unit (SU) and Service Assembly (SA) projects. The resulting projects are ready for packaging and deployment.
h1. Introduction
\\
Here is a table to compare BPEL projects and BPEL croquis.
Here is a table to compare BPEL projects and BPEL croquis.
Let's assume you have an external BPEL to run in Petals.
This process was tested with another BPEL engine and invoking web services.
This process was tested with another BPEL engine and invoking web services.
|| Property || BPEL (Service-Unit) Project || BPEL Croquis ||
| Result of the export | A zipped archive to deploy in Petals. | A set of Petals projects (for the BPEL and SOAP components). |
| Constraints | The orchestrated services must be Petals services (e.g. provided through service-units). | \- |
| Scope | It targets the Petals BPEL component. | It indirectly targets both the BPEL and SOAP components. |
| Specific wizard / validation | No. | No (they have similar wizards and validation). |
| Interest | Gather resources for a BPEL service-unit. | Ease and speed up the creation of service-units to run a BPEL process in Petals. |
| Typical use-case | Orchestrate Petals services. | Orchestrate external Web Services. |
| Result of the export | A zipped archive to deploy in Petals. | A set of Petals projects (for the BPEL and SOAP components). |
| Constraints | The orchestrated services must be Petals services (e.g. provided through service-units). | \- |
| Scope | It targets the Petals BPEL component. | It indirectly targets both the BPEL and SOAP components. |
| Specific wizard / validation | No. | No (they have similar wizards and validation). |
| Interest | Gather resources for a BPEL service-unit. | Ease and speed up the creation of service-units to run a BPEL process in Petals. |
| Typical use-case | Orchestrate Petals services. | Orchestrate external Web Services. |
\\
From a concrete point of view, the export of a BPEL croquis will go through the BPEL process, find all the partners' WSDL definitions and propose a list of SU and SA projects to create.
Let's now assume you want to test it inside the ESB (Petals BPEL engine can also be used in stand-alone mode, but this si not the subject here). In that case, you would have 2 steps to perform:
* First, [import the web services to invoke inside Petals|Importing a Web Service into Petals].
* And then, [create a configuration for the Petals BPEL component|Creating a BPEL project].
* First, [import the web services to invoke inside Petals|Importing a Web Service into Petals].
* And then, [create a configuration for the Petals BPEL component|Creating a BPEL project].
{column}
{column:width=350px}
{panel:title=Table of contents}{toc}{panel}
{column}
{section}
{column:width=350px}
{panel:title=Table of contents}{toc}{panel}
{column}
{section}
To ease such a use case, an export wizard was created.
h1. Creating a BPEL croquis
h1. Importing a BPEL process
In the menu, select *File > New > Croquis*.
If you do not see it, go into *File > New > Other...* Then, select *Croquis* under the *Petals* category.
If you do not see it, go into *File > New > Other...* Then, select *Croquis* under the *Petals* category.
First, make sure the BPEL and its dependencies are in the workspace. If they are not, you can [import them|Importing a BPEL in the workspace].
!petals-studio-create-bpel-croquis-2.jpg!
Then, click *File > Export* and select *Petals > BPEL to Petals Projects*.
\\ !petals-studio-tuto-export-bpel-1.jpg!
A wizard opens, showing three drop-down lists.
In the *Use Case* combo, select *Use a Petals technical service*.
In the *Petals Component* combo, select *BPEL // petals-se-bpel*.
In the *Component Version* combo, select the version of the Petals-SE-BPEL that you are using in Petals.
In the *Use Case* combo, select *Use a Petals technical service*.
In the *Petals Component* combo, select *BPEL // petals-se-bpel*.
In the *Component Version* combo, select the version of the Petals-SE-BPEL that you are using in Petals.
!petals-studio-create-bpel-croquis-3.jpg!
\\
In the scope of this page, we will use the version 1.0 of the component.
Click Next. A new page appears.
Click Next. A new page appears.
The wizard asks you to select a BPEL process inside the workspace. Click *Browse...* to select it.
!petals-studio-create-bpel-croquis-4.jpg! !petals-studio-tuto-export-bpel-2.jpg!
\\
This page, and the next ones, are similar to those that are shown in [the creation of a BPEL project|Creating a BPEL project].
Please, refer to [this page|Creating a BPEL project] for the remaining instructions.
\\
On wizard completion, the project is created under the *Croquis* (or *Sketches*) category.
!petals-studio-create-bpel-croquis-1.jpg!
h1. Editing a BPEL croquis
A BPEL croquis can be edited [like any other BPEL process|Editing a BPEL process].
One of the differences is that you are not required to orchestrate Petals services. You can work with any WSDL.
Another difference is a specialized export.
h1. Exporting a BPEL croquis
The export process is quite simple.
Once your BPEL croquis is finished, right-click it and select *Petals > Create concrete project(s)*.
!petals-studio-tuto-export-bpel-1.jpg!
\\
Please, refer to [this page|Creating a BPEL project] for the remaining instructions.
\\
On wizard completion, the project is created under the *Croquis* (or *Sketches*) category.
!petals-studio-create-bpel-croquis-1.jpg!
h1. Editing a BPEL croquis
A BPEL croquis can be edited [like any other BPEL process|Editing a BPEL process].
One of the differences is that you are not required to orchestrate Petals services. You can work with any WSDL.
Another difference is a specialized export.
h1. Exporting a BPEL croquis
The export process is quite simple.
Once your BPEL croquis is finished, right-click it and select *Petals > Create concrete project(s)*.
!petals-studio-tuto-export-bpel-1.jpg!
\\
The BPEL process is introspected. A dialog then shows up and lists projects to create.
This list is built in the following way:
This list is built in the following way:
* Eventually, there is a Service Assembly project that gathers all the Service-Unit projects together.
!petals-studio-tuto-export-bpel-23.jpg!
\\
It is also possible to overwrite an existing project, by enabling the *Overwrite* property.
Click *Finish* to run the generation process.
Click *Finish* to run the generation process.
h1. Packaging the result
The export result in a set of Service-Unit (SU) and Service Assembly (SA) projects.
!petals-studio-tuto-export-bpel-4.jpg!
\\
This phase created Petals artifacts from your BPEL project. Each created artifact is involved in the fact that the BPEL process can now run in Petals ESB.
These projects can be exported for deployment as any [other SU|Working with Service Unit projects#Export for Petals] and [SA projects|Working with Service Assembly projects#Export for Petals].
Obviously, it is also possible to edit or change things in the exported projects prior to package them.