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. You can also use XML schemas in the Message Flow of proxy services to validate an element specified with an XPath expression. See Adding Validate Actions.

Locating XML Schemas

Do either of the following:

Select Project Explorer to display the Projects View page or the Project/Folder View page. Then navigate through projects and folders to find the XML schema.
Select Resource Browser > XML Schemas. The Summary of XML Schemas page displays the information shown in Table 4-1. For a more detailed description of the properties, see Editing XML Schemas.

To locate a specific XML schema:

Click the Open icon to display additional search filters. If you specify multiple search criteria, only results that match all the criteria will be returned.
To restrict the number of items in the list, you can filter by name, path, and namespace. In the Name, Path, and Namespace fields, enter the name, path and namespace of the search target(s), then click Search.

The path is the project name and the name of the folder in which the XML schema resides.

Click View All to remove the search filters and display all XML schemas.

Table 4-1 XML Schema Information
Property	Description
XML Schema Name	The unique name assigned to the XML schema. The name is a link to the XML Schema Details page. See Editing XML Schemas.
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. See Qualifying Resource Names Using Projects and Folders.
XML Schema Namespace	The namespace used to qualify any of the definitions included in the XML schema.
Options	Click the Delete icon to delete a specific XML schema. See Deleting XML Schemas.

Adding XML Schemas

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 XML schema. The Project/Folder View page is displayed.
From the Create Resource drop-down list, select XML Schema to display the Create a New XML Schema Resource page.
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.

This is a required field.

Click Save. The new XML schema is saved in the current session.

When you click Save, if there are any unresolved references for the new XML schema, the system displays them. See Viewing Unresolved XML Schema References.

To end the session and deploy the configuration to the run time, click Activate under Change Center.

Editing XML Schemas

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.
Locate the XML schema, as described in Locating XML Schemas.
Click the XML schema name. The View XML Schema Details page displays the information shown in Table 4-2, Table 4-3, and Table 4-4.

Table 4-2 XML Schema Details
Property	Description
Last Modified By	The user who created this XML schema or imported it into the configuration.
Last Modified On	The date and time that the user created this XML schema or imported it into the configuration. Click the date and time link to view the change history of this resource. See View Change History page.
References	The number of objects that this XML schema references. If such references exist, click the numeric link to view a list of the objects. See Viewing References to Resources.
Referenced by	The number of objects that reference this XML schema. If such references exist, click the numeric 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. See Viewing References to Resources.
Description	A description of this XML schema, if one exists.

The structural view of the XML schema is displayed by default, which includes the information shown in Table 4-3.

Table 4-3 XML Structure Details
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. See Resolving Unresolved XML Schema References.

Click Text View to display a text view of the XML schema details. The text view includes the information shown in Table 4-4.

Table 4-4 XML Schema Text Details
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.

To make changes to the fields, click Edit. See Adding XML Schemas for descriptions of the fields.
Make the appropriate edits.
Click Save to commit the updates in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.

Deleting XML Schemas

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 Resource Browser > XML Schemas.
Click the Delete icon in the Options field of the XML schema you want to delete. The XML schema 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.

Viewing Unresolved XML Schema References

For each unresolved XML schema reference, this page displays the information shown in Table 4-5.

Table 4-5 Unresolved XML Schema Details
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. See Editing XML Schemas.
Namespace	The namespace used to qualify any of the definitions included in the XML schema.

Resolving Unresolved XML Schema References

Use the Edit the References of an XML Schema Resource page to resolve unresolved XML schema references by configuring the mapping for XML schema references such as XML schema imports.

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.
On the Summary of XML Schemas page, in the XML Schema Name column, click the appropriate XML schema name to view details of the unresolved reference. The View XML Schema Details page is displayed.
Click Edit References to display the Edit the References of an XML Schema Resource page.
In the Resource Type field, select XML Schema.
Click Browse. The XML Schema Browser is displayed.
In the XML Schema Browser, select an XML schema, then select a definition from the Definitions pane.
Click Submit. The XML schema you selected is displayed in the Resource Name field.
Click Save to resolve the reference.
On the XML Schema Details page, click OK. The state of the XML schema is displayed as Valid.

Using the AquaLogic Service Bus Console