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.
Table 5-1 XML Schema Pages, Tasks, and Help Topics
The Summary of XML Schemas page allows 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.
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. Click on an underlined column name. Ascending and descending arrows indicate the sort order. Click the column name to change the sort order.
Scroll through the pages. Use the page controls above or below the table. 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.
The Create a New XML Schema Resourcepage 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 Browseto 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 and is saved in the current session.
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.
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 discard the changes you have made so far in the current session.
The XML Schema Detailspage 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.
Click the XML schema name. The XML Schema Details page displays the following information.
Table 5-3 XML Schema Details
Property
Description
Resource Name
The name and path assigned to this XML schema.
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.
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.
Table 5-4 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. 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.
Table 5-5 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.
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 in the current session.
The Summary of XML Schemas page is displayed.
To disregard changes, click Cancel.
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 discard the changes you have made so far in the current session.
The Summary of XML Schemas page allows 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
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 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 discard the changes you have made so far in the current session.
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.
Table 5-6 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. 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. Click on an underlined column name. Ascending and descending arrows indicate the sort order. Click the column name to change the sort order.
Scroll through the pages. Use the page controls above or below the table. 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.
The Edit the References of an XML Schema Resource page allows you to resolve unresolved XML schema references by configuring the mapping for XML schema references such as XML schema imports. To learn more about XML schemas, see Overview of XML Schemas.
To Resolve a Reference
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. For more information, 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 XML Schema Details page is displayed.
Click Edit References. The Edit the References of an XML Schema Resource page is displayed.
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.
Do one of the following:
To resolve the reference, click Save. The XML Schema Details page is displayed.
To disregard changes, click Cancel.
On the XML Schema Details page, click OK. The state of the XML schema is displayed as Valid.