Using the AquaLogic Service Bus Console

XML Schemas

This section includes the following topics:

Overview of XML Schemas

Schemas describe types for primitive or structured data. XML Schemas are an XML vocabulary that describe the rules that XML business data must follow. XML Schemas specify the structure of documents, and the data type of each element and attribute contained in the document.

You use XML schemas as references for WSDL resources. To learn more, see Viewing and Changing WSDL Details and Resolving Unresolved WSDL References. You can also use XML schemas in the Message Flow of proxy services to validate an element specified with an XPath expression. To learn more, see the description of the Validation action in Validate.

The following table lists the XML Schema pages you can access from the Resource Browser and Project Explorer modules. The tasks and help topics associated with each are provided.

Page	Associated Tasks	Help Topics
Summary of XML Schemas	View a list of XML schemas	Listing and Locating XML Schemas
	Filter XML schemas	Listing and Locating XML Schemas
	Delete an XML schema	Deleting an XML Schema
Create a New XML Schema Resource	Add a new XML schema	Adding an XML Schema
XML Schema Details	View details of an XML schema	Viewing and Changing XML Schema Details
XML Schema Details	Edit an XML schema	Viewing and Changing XML Schema Details
Edit the References of an XML Schema Resource	Resolve unresolved XML schema references	Resolving Unresolved XML Schema References

Listing and Locating XML Schemas

The Summary of XML Schemas page enables you to view a list of XML schemas. Schemas describe types for primitive or structured data. XML Schemas are an XML vocabulary that describe the rules that XML business data must follow. XML Schemas specify the structure of documents, and the data type of each element and attribute contained in the document. To learn more, see Overview of XML Schemas.

To List and Locate XML Schemas

From the left navigation pane, select XML Schemas from under Resource Browser. The Summary of XML Schemas page is displayed, which displays the following information for each XML schema. For a more detailed description of the properties, see Viewing and Changing XML Schema Details.

Property	Description
XML Schema Name	The unique name assigned to the XML schema. The name is a link to the XML Schema Details page. To learn more, see Viewing and Changing XML Schema Details.
Path	The path is the project name and the name of the folder in which the XML Schema resides. It is a link to the project or folder that contains this resource. To learn more, see Viewing Project Details or Viewing Folder Details.
XML Schema namespace	The namespace used to qualify any of the definitions included in the XML schema.
Options	Click the Delete icon to enable you to delete a specific XML schema. To learn more, see Deleting an XML Schema.

To locate a specific XML schema, do one of the following:

Filter by XML schema name. In the Name, Path, and Name Space fields, enter the name, path and name space of the search target, then click Search. The path is the project name and the name of the folder in which the XML Schema resides. The XML schemas matching the search criteria are displayed.
Resort the list. Ascending and descending arrow buttons indicate sortable columns—in this case, the XML Schema Name and Path columns. Click the button to change the sort order.
Scroll through the pages. Use the controls in the lower right corner. Go to a page by selecting the page number or by using the arrow buttons to go to the next, previous, first, or last page.

Note: Click View All to display all XML schemas.

Adding an XML Schema

The Create a New XML Schema Resource page allows you to add a new XML schema. Schemas describe types for primitive or structured data. XML Schemas are an XML vocabulary that describe the rules that XML business data must follow. XML Schemas specify the structure of documents, and the data type of each element and attribute contained in the document. To learn more, see Overview of XML Schemas.

To add a new XML schema, do one of the following:

Import an existing XML schema
Enter data in the text fields to write a new XML schema
Copy and paste data from an existing XML schema into the text fields

To Add an XML Schema

If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. To learn more, see Using the Change Center.

From the left navigation pane, select Project Explorer. The Project View page is displayed.

Select the project to which you want to add the XML schema. You can add an XML schema directly to the project, or you can add the XML schema to a selected folder that resides in the project.

Note: Click the name of a folder to select it. The Folder View page is displayed.

From the Project View or Folder View page, in the Create Resource field, select XML Schema from under Interface. The Create a New XML Schema Resource page is displayed.

In the Resource Name field, enter a unique name for this XML schema. This is a required field.

In the Resource Description field, enter a description for the XML schema.

In the XML Schema field, do one of the following:

Enter text for the new XML schema.
Click Browse to locate and import an existing XML schema.
Copy and paste text from an existing XML schema into this field.

Note: This is a required field.

Do one of the following:

To save the XML schema, click Save. The new XML schema is included in the list of resources.

Note: When you click Save, if there are any unresolved references for the new XML schema, the system displays them. To learn more, see Viewing Unresolved XML Schema References.

To disregard changes, click Cancel.

Note: The new XML schema is saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.

Viewing and Changing XML Schema Details

The XML Schema Details page displays structural and text views of a specific XML schema. Schemas describe types for primitive or structured data. XML Schemas are an XML vocabulary that describe the rules that XML business data must follow. XML Schemas specify the structure of documents, and the data type of each element and attribute contained in the document. To learn more, see Overview of XML Schemas.

To View and Change XML Schema Details

Locate the XML schema. To learn more, see Listing and Locating XML Schemas.

Click the XML schema name. The XML Schema Details page displays the following information:

Property	Description
Resource Name	The name and path assigned to this XML schema.
Created By	The user who created this XML schema or imported it into the configuration.
Created On	The date and time that the user created this XML schema or imported it into the configuration.
References	The number of objects that this XML schema references. If such references exist, click the link to view a list of the objects. To learn more, see Viewing References.
Referenced by	The number of objects that reference this XML schema. If such references exist, click the link to view a list of the objects. For example, if this XML schema is referenced by a specific WSDL, the WSDL is listed as a reference when you click the link. To learn more, see Viewing References.
Description	A description of this XML schema, if one exists.

The structural view of the XML schema is displayed by default, which includes the following information: Property Description Target Namespace The namespace used to qualify any of the definitions included in the XML schema. XML Schema definitions The attributes and groups associated with the XML schema: XML Schema Types XML Schema Elements XML Schema Imports XML Schema Includes/Redefines Schema State Status of the XML schema: Valid An XML schema is shown as valid when all of the locations for XML schemas included by the current XML schema are specified. Furthermore, all of the locations for nested XML schemas (XML schemas subsequently included by the included XML schemas) are specified. Invalid An XML schema is shown as invalid when one or more of the locations for the XML schema is not specified. Additionally, the location for one or more nested XML schemas (XML schemas subsequently included by the included XML schemas) may not be specified. To resolve an invalid XML schema, click Edit References. To learn more, see Resolving Unresolved XML Schema References.

Click Text View to display a text view of the XML schema details. The text view includes the following information:

Property	Description
Target Namespace	The namespace used to qualify any of the definitions included in the XML schema.
XML Schema	The text for this XML schema.

If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session or click Edit to enter an existing session to make changes to the current configuration. To learn more, see Using the Change Center.

To make a change to the fields, click Edit. See Adding an XML Schema for a description of the fields.

Make the appropriate edits.

Do one of the following:

To update the XML schema, click Save. The XML schema is updated.

The Summary of XML Schemas page is displayed.

To disregard changes, click Cancel.

Note: The XML schema is updated in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.

Deleting an XML Schema

The Summary of XML Schemas page enables you to delete XML schemas. Schemas describe types for primitive or structured data. XML Schemas are an XML vocabulary that describe the rules that XML business data must follow. XML Schemas specify the structure of documents, and the data type of each element and attribute contained in the document. To learn more, see Overview of XML Schemas.

Note: You cannot delete a resource if it is referenced by other resources in AquaLogic Service Bus. Instead of the Delete icon, a Delete icon with a red X is displayed for these resources.

To Delete an XML Schema

From the left navigation pane, select XML Schemas from under Resource Browser. The Summary of XML Schemas page is displayed.

In the Options field of the XML schema you want to delete, click the Delete icon.

The XML schema is removed from the list.

Note: If necessary, you can undo the deletion of this resource. To learn more, see Undoing a Task.
The XML schema is deleted in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.

Viewing Unresolved XML Schema References

The View Unresolved Schema References page displays the following information for each unresolved XML schema reference. To learn more about XML schemas, see Overview of XML Schemas.

Property	Description
Schema Name	The unique name assigned to the XML schema. Click the name of a specific XML schema to view details for that XML schema. To learn more, see Viewing and Changing XML Schema Details.
Namespace	The namespace used to qualify any of the definitions included in the XML schema.

To List and Locate References

To locate a specific reference, do one of the following:

Resort the list. Ascending and descending arrow buttons indicate sortable columns. Click the button to change the sort order.
Scroll through the pages. Use the controls in the lower right corner. Go to a page by selecting the page number or by using the arrow buttons to go to the next, previous, first, or last page.

XML Schemas

Overview of XML Schemas

Listing and Locating XML Schemas

To List and Locate XML Schemas

Related Topics

Adding an XML Schema

To Add an XML Schema

Related Topics

Viewing and Changing XML Schema Details

To View and Change XML Schema Details

Related Topics

Deleting an XML Schema

To Delete an XML Schema

Related Topics

Viewing Unresolved XML Schema References

To List and Locate References

Related Topics

Resolving Unresolved XML Schema References

To Resolve a Reference

Related Topics