Importing BPEL Files
The BPEL Process importer copies a BPEL file to the repository and creates a set of objects in the registry that represent the BPEL process definition.
The entries created are summarized in the following diagram:
The registry objects are as follows:
A BPEL Process asset. This asset has an External Link that points to the BPEL definition file in the repository.
A BPEL Partner object that refers to the BPEL Process asset using an association.
A BPEL Partner Link object that refers to the BPEL Process asset using an association.
A BPEL Role object that is referred to by the BPEL Partner Link object. If the BPEL Process definition contains the activation of a Web service interface, a reference is created from the BPEL Role object to a Web service's Interface object. The Web service's Interface object must already exist in the repository, otherwise the import of the BPEL process will fail.
A BPEL Partner Link Type object that is referred to by the BPEL Role object.
The Service, Interface, BPEL Partner Link Type objects are objects that already exist from a previous import of a Web service.
Additionally, when imp andorting a BPEL asset that refers to other XML Schemas, keep the following points in mind:
When you have at least a Modify permission on the referenced XML Schema, both the BPEL file and XML schema are imported automatically.
When you have only View permission on the referenced XML Schema, the BPEL file is imported and the referenced XML Schema implicitly reused.
When you do not have any permission on the referenced XML Schema, the BPEL file is imported and a warning message logged.
To import a new BPEL asset to the catalog
Before you begin, you must have the BPEL file that you want to import. This file must reside on the file system of the computer where your browser is running.
1. In CentraSite Control, go to Asset Catalog > Browse.
2. Click the Import icon.
3. In the Import dialog, specify the following attributes:
In this field... | Do the following... |
Organization | Choose the organization to which the asset will be added. (The drop-down list will contain the list of organizations to which you are permitted to add assets.) If you select an organization other than your own organization, you will nevertheless be the owner of the asset. Note: | Choose the organization with care. You cannot change the organization assignment after the asset is added to the catalog. You can, however, export an asset from one organization and import it to another. |
|
Import as | Choose BPEL. |
Initial Version | |
File | The input file's fully qualified name. |
Product | Optional. This option allows the user to assign a category from the Products taxonomy to the BPEL asset. |
4. Click Finish.
Be aware that if the BPEL file references another asset, CentraSite will automatically check whether the referenced asset exists in the catalog. If not, CentraSite will attempt to locate the required file and add it to the catalog. If CentraSite cannot locate the file, it will prompt you for the file's location.
CentraSite retrieves the specified file and generates the catalog entry. The BPEL asset’s details page is displayed.
5. During import of a BPEL process asset, CentraSite will not allow you to add the asset to the asset catalog unless you have specified all required attributes in the BPEL process type definition and all referenced objects to which the BPEL file has an association. The value for the required attribute must be specified in the BPEL asset's profile. Additionally, if the BPEL asset has internally referenced objects, the value for the required attributes of all such referenced objects should be specified by choosing the Next button at the top right side of the details page in order to add the BPEL process asset to the asset catalog. Thus, for example, if the XML schema file that is referenced in the main XML file have required attributes, then you will be prompted to specify a value for the required attributes in order to save the asset.
6. After you specify the value for all of the required attributes, click Save to save the BPEL asset.
7. Review the import log that CentraSite generates for the import process. If errors occur while reading and processing the file, they will be reported in this log.
