The Project Explorer organizes configurations and resources into projects and folders. In the Project Explorer, you can display the Projects View page, which lists all projects in the domain, and Project/Folder View pages, which list folders and resources in each project.
Projects are non-hierarchical, non-overlapping, top-level grouping constructs.
All Oracle Service Bus resources (for example, services, WS-Policies, WSDLs, XQuery transformations, and so on) reside in exactly one project. Projects do not overlap. Resources can be created directly under a project, or they can be further organized into folders. However, you can reference any resource regardless of the project in which it resides.
When you create a domain in Oracle Service Bus, a default project is created.
Naming Projects and Folders
Project names and folder names are limited to 64 characters, and must not contain the following characters:
\, <, >, |, {, }, %, (, ), :, `, /, commas
The names, length, and levels of nesting of projects and folders are ultimately affected by the limits of your operating system. Creating folders or projects with very long names or deeply nesting folders can fail due to the limitations of the operating system.
Qualifying Resource Names Using Projects and Folders
Projects and folders qualify the names of Oracle Service Bus resources. A reference to a resource is constructed as follows:
Click the Clone Project icon to clone the project. See Cloning Projects.
Click the Delete Project icon to delete the project. A Deletion Warning icon is displayed when other resources reference this resource. You can delete this resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource. See Deleting Projects.
When you perform any of these actions, the result is saved in the current session. To end the session and deploy the configuration to the run time, click Activate under Change Center.
Project/Folder View page
The Project/Folder View page displays details of a single project. Table 3-2 describe the options and controls on the page.
Table 3-2 Project/Folder View Page - Options and Controls
Option or Control
Description
Project Name
References
Click the number in this field (if greater than 0) to display a list of the resources outside of this project on which resources inside this project depend.
Referenced By
Click the number in this field (if greater than 0) to display a list of the resources outside of this project that are dependent on resources inside this project.
Description
Click Edit Description to add or edit a description of this project, then click Submit Description to update it.
Folders
Enter a New Folder Name
To create a new folder in this project, enter a name in the text field and click Add Folder. See Adding Folders.
For any folder listed, you can do any of the following:
Click the Rename Folder icon to rename the folder. See Renaming Folders.
Click the Upgrade to Project or Move Folder icon to move the folder or to upgrade it to a project. See Moving or Upgrading Folders.
Click the Clone Folder icon to clone the folder. See Cloning Folders.
Click the Delete Folder icon to delete the folder. A Deletion Warning icon is displayed when other resources reference this resource. You can delete the resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource. See Deleting Folders.
When you perform any of these actions, the result is saved in the current session. To end the session and deploy the configuration to the run time, click Activate under Change Center.
Delete
To delete folders, select the check boxes next to the names of the folders to delete, then click Delete.
Resources
Create Resource
To create a new resource for this project, select a resource type from the Create Resource list. See Creating Resources.
Name
Click a resource name to display details about the resource.
Resource Type
The type of this resource.
Actions
The actions available for a resource depend on the type of resource:
The Launch Test Console icon is displayed for business services, proxy services, XQuery transformations, XSL transformations, and MFL files. Click this icon to invoke the Test Console, which you use to validate and test the design of services and transformations. For services, you can only use the Test Console at run time; that is, when the session is activated. For transformations, you can use the Test Console whether you are inside or outside a session. See Testing Services and Testing Transformations.
The Export WSDL icon is displayed for WSDL-based proxy services. Click this icon to export a WSDL, which you can then view or modify in an external tools such as an IDE. Note that this is different than the Export Resources functionality in the System Administration module, which you use to move and stage resources between two domains. See Exporting a WSDL.
The Generate WSDL icon is displayed for transport-typed business services, such as EJB and Flow. Click this icon to generate a WSDL, which you can then view or modify. See Generating a WSDL.
Options
The Options column displays the following icons:
Click the Rename Resource icon to rename the resource. See Renaming Resources
Click the Move Resource icon to move the resource. See Moving Resources.
Click the Clone Resource icon to clone the resource. See Cloning Resources
Click the Delete icon to delete the resource. A Deletion Warning icon is displayed when other resources reference this resource. You can delete this resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource.
When you perform any of these actions, the result is saved in the current session. To end the session and deploy the configuration to the run time, click Activate under Change Center.
Adding Projects
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
In the Enter New Project Name field, enter a unique name for the project, then click Add Project. See Naming Projects and Folders. The new project is saved in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Renaming Projects
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
If you use the name of an existing project, the resources of both projects are merged under that name. For example, consider project MyProject with resources A and B, and project ThisProject with resources C and D. If you rename MyProject as ThisProject, the new ThisProject will have resources A, B, C, and D.
Click Rename. The project is renamed in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Moving Projects (Converting to a Folder)
When you “move” a project, the project is converted to a folder in the new location.
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Click the Move Project icon in the row of the project you want to move. The Move Project page is displayed with the current location of the project highlighted.
Under Location, select a project or folder to “move” the project into. The project is converted to a folder in the new location and is saved in the current session.
If you move a project to a new location and a folder with the same name already exists in that location, the contents of the project are merged with the contents of the existing folder.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Cloning Projects
There are three ways to clone (copy) a project:
Clone the project with a new name at the root level. In this case, the original project and its clone exist as peer projects. The cloned project contains the same folders and resources as the original (at least until you modify the source or the clone). For instructions, see Cloning a Project at the Root Level.
Clone the project using the name of an existing project (other than the source project). In this case, the folders and resources from the source project are merged with the folders and resources of the project whose the name was assigned to the clone. The original project remains unchanged. For instructions, see Cloning a Project at the Root Level.
Clone the project in a new location, in an existing project or project folder. In this case, the cloned project is demoted to a folder in the new location. It contains the same folders and resources as the original project.
If you clone a project with the same name and in the same location as an existing folder, the contents (subfolders and resources) of the project are merged with the contents of the target folder.
In either case, the original project remains unchanged.
Click the Clone Project icon in the row of the project you want to clone. The Clone Project page is displayed with the current location of the project highlighted.
Click the Clone Project icon in the row of the project you want to clone. The Clone Project page is displayed with the current location of the project highlighted.
Use a unique name to create a new folder, or use the name of an existing folder to merge the clone with the existing folder (in the location you will select in the next step).
In the Location panel, select a project or folder, then click Clone Project. The cloned project is converted to a folder in the new location and is saved in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Deleting Projects
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Click the Delete Project icon in the row of the project you want to delete. The project is deleted in the current session.
When you delete a project, all resources under the project are deleted. If any resources under this project are referenced by resources under a different project, you can delete the project but with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource.
Instead of the Delete icon, a Deletion Warning icon is displayed for these resources.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Adding Folders
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Project Explorer, then select a project or folder in which to add the new folder.
Click Add Folder. The new folder is saved in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Renaming Folders
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Project Explorer, then select the project or folder containing the folder whose name you want to change. The Project/Folder View page is displayed.
Click the Rename Folder icon in the row of the folder you want to rename. The Rename Folder page is displayed.
Click Rename. The renamed folder is saved in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Moving or Upgrading Folders
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Project Explorer, then select the project or folder that contains the folder that you want to move or upgrade. The Project/Folder View page is displayed.
Click the Move Folder icon in the row of the folder you want to move or upgrade. The Move Folder page is displayed with the current location of the folder highlighted.
Determine whether you will move the folder to a new location under a different project or upgrade the folder to a project:
To move it to a new location, in the Location panel, select a project or folder to move the folder into.
To upgrade the folder to a project, select the Root location.
Click Submit. The folder (or project, if it was upgraded from a folder) is saved in its new location in the current session.
When you move or upgrade a folder, if another folder already exists in that location with the same name, the contents of the moved or upgraded folder are merged with the contents of the existing folder or project.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Cloning Folders
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Project Explorer, navigate to the parent project or folder that contains the folder that you want to clone. The Project/Folder View page is displayed.
Click the Clone Folder icon in the row of the folder you want to clone. The Clone Folder page is displayed with the current location of the folder highlighted.
Clone the folder in the same location or a different location, or upgrade the folder to a project:, as follows:
To clone the folder in the same location, enter a new name in the New Name field. See Naming Projects and Folders.
When cloning in the same location, either do not select any location at all in the Location panel (which is equivalent to selecting the current location), or explicitly select the current project and folder.
To clone the folder in a different location, optionally enter a new name in the New Name field, and select a project and/or folder from the Location area. See Naming Projects and Folders.
If you use the same name as an existing folder, the contents of the original folder are merged with the contents of the target folder.
To upgrade the folder to a project, select the Root location.
Click Clone Folder. The folder is cloned in the current session.
When you clone a folder, all folder and resources under the folder are cloned recursively
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Deleting Folders
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Project Explorer, then select the project or folder that contains the folder that you want to delete.
On the Project/Folder View page, Click the Delete Folder icon in the row of the folder you want to delete. The folder is deleted in the current session.
When you delete a folder, all resources under the folder are deleted. If any resources under this folder are referenced by resources under a different folder, you can delete the folder but with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource.
Instead of the Delete icon, a Deletion Warning icon is displayed for these resources.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Creating Resources
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Project Explorer, then select the project or folder in which you want to create the resource.
From the Create Resource drop-down list on the Project/Folder View page, select the type of resource you want to create. Different pages are displayed, depending on the type of resource you select.
Follow the prompts to add information to each page to create the resource. For more information about creating each kind of resource, see the appropriate topic, as listed in Table 3-3.
When you create the resource, it is created in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Loading Resources from a Zip File
You can select a Zip or JAR file that contains the resources you want to load; Oracle Service Bus locates and imports the resources from this Zip file.
Resources like WSDLs or XML Schemas can define full trees of dependent resources. The bulk load feature allows you to upload a set of resources at once; you need not resolve the dependencies manually.
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Project Explorer, then select the project or folder to which you want to add resources. The Project/Folder View page is displayed.
From the Create Resource drop-down list, select Zipped Resources. The Load Resources page is displayed.
In the Select Zip File field, specify a Zip file to import. Enter the name of the file (qualified by its path); or, click Browse, locate the file, then click Open.
Review the mapping of resource types to file extensions. Change or add extensions, according to your needs. Separate multiple extensions with commas.
Each file in the Zip file is a possible resource, and the file extension is the commonly used way to identify the file type. Oracle Service Bus defines a default extension for each resource, but if you have additional extensions to describe those resources, this map enables you to declare those extensions to the loader.
After you define the Zip file and extension map, the Oracle Service Bus loader scans the contents of the Zip file and tries to associate a resource type with each file. A file without an extension or one that does not have an extension defined in the map is considered unknown and is automatically excluded from the load.
For known files, the name of the resource is the name of the file without its extension. The folder structure of the Zip file is recreated in the target Oracle Service Bus Console folder.
An extension can only be associated with one file type.
Click Next.
On the Load Resources - Review Loaded Resources page, review the resources you are importing. You can clear the check boxes next to any resources you do not want to include in this import.
To import the selected resources, click Import.
The Load Resources - Import Result page displays the imported resources. Click Load Another to import resources from another file, or proceed with other tasks by selecting a different page from the left navigation pane.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Load Resources - Select Zip File and Review Type Extensions page
Use the Load Resources - Select Zip File and Review Type Extensions page to import resources from a Zip file, as documented in Loading Resources from a Zip File.
Table 3-4 describes the options and controls on the page.
Table 3-4 Load Resources: Select Zip File and Review Type Extensions page - Options and Controls
Options and Controls
Description
Select Zip File
Enter the fully qualified name of a Zip file to import, or click Browse to select it.
Resource Type and File Extension
Each file in the Zip file is a possible resource, and the file extension is the commonly used way to identify the file type. Oracle Service Bus defines a default extension for each resource, but if you have additional extensions to describe those resources, this map enables you to declare those extensions to the loader.
After you define the Zip file and extension map, the Oracle Service Bus loader scans the contents of the Zip file and tries to associate a resource type with each file. A file without an extension or one that does not have an extension defined in the map is considered unknown and is automatically excluded from the load.
For known files, the name of the resource is the name of the file without its extension. The folder structure of the Zip file is recreated in the target Oracle Service Bus Console folder.
Loading Resources from a URL
You can perform a bulk import of resources available at a URL or on the file system. Bulk import lets you import a root resource, such as a WSDL, along with its dependents, such as other WSDLs and schemas. The dependency map is resolved automatically.
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Project Explorer, then select the project or folder to which you want to add resources. The Project/Folder View page is displayed.
In the URL/Path field, enter the URL or path of the resource.
To specify a local resource, you can use the file protocol with a file name fully qualified by its path, for example, file:///c:/osbresources/ForeachAction.jar
In the Resource Name field, enter the resource’s name.
From the Resource Type drop-down list, select the type of the resource.
The Load Resources - Import Result page displays the imported resources. Click Load Another to import resources from another file, or proceed with other tasks by selecting a different page from the left navigation pane.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Load Resources - Load Resources from URL page
Use the Load Resources - Load Resources from URL page to import resources from a file available on the Web, as documented in Loading Resources from a URL.
Table 3-5 describes the options and controls on the page.
Table 3-5 Load Resources: Load Resources from URL page - Options and Controls
Options and Controls
Description
URL/Path
Enter the URL where the file is located.
To specify a local resource, you can use the file protocol with a file name fully qualified by its path, for example, file:///c:/osbresources/ForeachAction.jar
The file name of the resource, including the file extension.
Name
The name of the resource.
Path
The path of the resource, which is the project and folder where the resource resides.
Resource Type
One of the resource types:
WSDL
XML Schema
WS-Policy
XQuery
XSLT
MFL
JAR
A Warning icon next to file name indicates that the resource type is unknown. (A file without an extension or one that does not have an extension defined in the map is considered unknown.) Files of unknown file types cannot be imported.
Load Resources - Import Result page
The Load Resources - Import Result page displays the results of loading resources from an imported Zip file or from a URL.
The Import Result page is displayed, which displays the following information.
Table 3-7 Project/Folder View Page - Options and Controls
Option or Control
Description
Status
The status of the resource; for example, whether or not it has been imported successfully.
A WSDL may be temporarily marked as invalid until all of its dependencies are imported. When the import action is completed, however, the configuration service re-validates the files marked invalid.
Name
The name of the resource.
Path
The path of the resource, which is the project and folder where the resource resides.
Resource Type
One of these resource types:
WSDL
XML Schema
WS-Policy
XQuery
XSLT
MFL
JAR
Split-Join
Error Message
Displays the details of the error message if the resource has not been imported successfully.
View References page
Depending on whether you clicked References or Referenced By on a Project/Folder View page, the View References page displays a list of:
Resources outside of the current project or folder that are referenced by resources inside the project or folder.
Resources outside of the current project or folder that reference resources inside the project or folder.
Table 3-8 describes the options and controls on the page.
Table 3-8 Project References Page - Options and Controls
Option or Control
Description
Name
Click the name of the resource to display details of the resource.
Resource Type
Displays Project, Folder, or any of the following resource types:
Proxy Service
Business Service
WSDL
XML Schema
WS-Policy
XQuery
XSLT
MFL
Service Account
Service Key Provider
JAR
Alert Destination
JNDI Provider
SMTP Server
Proxy Server
MQ Connection
Split-Join
Viewing References to Resources
You can view references to resources whether or not you are in a session. See Using the Change Center.
Click References or Referenced By on a project, folder or resource details page in the Project Explorer or Resource Browser modules.
Click References to display resources outside of a project or folder that are referenced by resources inside the project or folder.
Click Referenced By to display resources outside of a project or folder that reference resources inside the project or folder.
Click a name of a resource to display details about it, or click Back to return to the previous page.
View Change History page
The View Change History page displays the ten most recent changes to a resource, across all session activations.
Table 3-9 describes the options and controls on the page.
Table 3-9 Change History Page - Options and Controls
Option or Control
Description
Task
The type of task performed:
Create
Update
Clone
Rename
Move
User
The user who created or edited this resource.
Execution Time
The date and time that the user created or edited this resource.
Using the Resource Browser
The Resource Browser provides tools for locating resources and for performing simple actions on them, such as Display, Edit, Export, and Delete.
To display the Resource Browser, select Resource Browser from the left navigation pane.
On the left side of the page, click the name of the type of resource you want to locate. Table 3-10 shows the items you can select and the tasks associated with the page displayed for each one.
Table 3-10 Resource Types Available from the Resource Browser
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Project Explorer, then select the project or folder containing the resource you want to rename. The Project/Folder View pageis displayed.
Click the Rename icon in the row of the resource you want to rename. The Rename page is displayed.
In the New Resource Name field, enter a new name for the resource. Comma (,) and slash (/) characters are not allowed.
Click Rename.
Note:
If you rename a business service imported from the UDDI registry, the service will become detached from the registry
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Moving Resources
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Project Explorer, then select the project or folder containing the resource you want to move. The Project/Folder View page is displayed.
Click the Move icon in the row of the resource you want to move. The Move page is displayed with the current location of the resource highlighted.
In the Location field, select the project and folder to which you want to move the file.
Click Move File. The resource is moved to the new location in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Cloning Resources
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Project Explorer, then select the project or folder containing the resource you want to clone. The Project/Folder View page is displayed.
Click the Clone Resource icon in the row of the resource you want to clone. The Clone Resource page is displayed with the current location of the resource highlighted.
You can clone the resource in the same location or a different location:
To clone the resource in the same location, enter a new name in the New Resource Name field. Comma (,) or slash (/) characters are not allowed.
To clone in the same location, either do not select any location at all in the Location panel (which is equivalent to selecting the current location), or explicitly select the current project and folder.
To clone the resource in a different location, optionally enter a new name in the New Resource Name field, and select a project and/or folder from the Location area.
Click Clone Resource. The resource is cloned in the current session.
If you clone a business service imported from the UDDI registry, the cloned service will be detached from the registry
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Exporting a WSDL
Use the Project/Folder View pageto export a WSDL associated with a proxy service or a business. The WSDL is exported as a JAR file. You can export a WSDL only when you are outside a session. See Using the Change Center.
Use the Export WSDL feature to make a WSDL available for consumption by external tools such as IDEs. Note that this is different than the Export Resources feature in the System Administration module, which you use to move and stage resources between two domains.
From the left navigation pane, click a project or folder from under Project Explorer. The Project/Folder View pageis displayed.
Click the Export WSDL icon in the row of the proxy service whose WSDL you want to export. The File Download dialog box is displayed.
In the File Download dialog box, click Open to open the JAR file or click Save to save the JAR file to your desktop.
Generating a WSDL
A generatedWSDL is a WSDL resource that Oracle Service Bus generates for a service that did not start with a WSDL resource but which can be described using a WSDL. For example, a WSDL created from an EJB-based service is a generated WSDL. For more information, see How WSDL is Used in Oracle Service Bus in the Oracle Service Bus User Guide.
Use the Project/Folder View pageto generate a WSDL associated with an EJB or Flow transport-typed business service.
From the left navigation pane, click a project or folder from under Project Explorer. The Project/Folder View pageis displayed.
Click the Generate WSDL icon in the row of the business service whose WSDL you want to generate. The Generate WSDL Resource dialog box is displayed with the current location (project name and the name of the folder in which the business service resides) highlighted.
In the Generate WSDL Resource dialog box, specify a New WSDL Resource Name and location for the WSDL, and click Generate WSDL.
After you finish
Continue in Editing WSDLs to view or modify the generated WSDL.
Viewing Resources in a Web Browser
View Oracle Service Bus resources in a standard Web browser, using the following URLs
Path for WSDL resources: http://host:port/sbresource?WSDL/project/...wsdlname
Path for WSS resources: http://host:port/sbresource?POLICY/project/...policyname
Path for MFL resources: http://host:port/sbresource?MFL/project/...mflname
Path for SCHEMA resources: http://host:port/sbresource?SCHEMA/project/...schemaname
Path for Proxy Service resources: http://host:port/sbresource?PROXY/project/...proxyname
Deleting Resources
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Project Explorer, then select the project or folder containing the resources you want to delete.
Click the Delete icon in the row of the resource you want to delete. The resource is deleted in the current session. A Deletion Warning icon is displayed when other resources reference this resource. You can delete the resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Rename Project icon in the row of the project you want to rename. The Rename Project page is displayed.
Move Project icon in the row of the project you want to move. The Move Project page is displayed with the current location of the project highlighted.
Clone Project icon in the row of the project you want to clone. The Clone Project page is displayed with the current location of the project highlighted.
Delete Project icon in the row of the project you want to delete. The project is deleted in the current session.
Deletion Warning icon is displayed for these resources.
Move Folder icon in the row of the folder you want to move or upgrade. The Move Folder page is displayed with the current location of the folder highlighted.
Warning icon next to file name indicates that the resource type is unknown. (A file without an extension or one that does not have an extension defined in the map is considered unknown.) Files of unknown file types cannot be imported.
Rename icon in the row of the resource you want to rename. The Rename page is displayed. 
Export WSDL icon in the row of the proxy service whose WSDL you want to export. The File Download dialog box is displayed.
Generate WSDL icon in the row of the business service whose WSDL you want to generate. The Generate WSDL Resource dialog box is displayed with the current location (project name and the name of the folder in which the business service resides) highlighted.
Edit Message Flow icon is displayed for proxy services. Click this icon to edit the message of a proxy service. See 
Launch Test Console icon is displayed for business services, proxy services, XQuery transformations, XSL transformations, and MFL files. Click this icon to invoke the Test Console, which you use to validate and test the design of services and transformations. For services, you can only use the Test Console at run time; that is, when the session is activated. For transformations, you can use the Test Console whether you are inside or outside a session. See 
Delete icon in the row of the resource you want to delete. The resource is deleted in the current session. A 
