Adding redefine elements

You can use the redefine mechanism to redefine simple and complex types, groups, and attribute groups obtained from external schema files. When you redefine a component, you are modifying its contents.

Like the include mechanism, redefine requires the external components to be in the same target namespace as the redefining schema, although external components from schemas that have no namespace can also be redefined.

The following instructions were written for the Resource perspective, but they will also work in many other perspectives.

To add a redefine element, follow these steps:

  1. Open your XML schema in the XML schema editor.
  2. In the Outline view, select your schema. The entire schema and its contents should be displayed in the Graph view.
  3. In the Graph view, right-click in the Directives section and click Add Redefine.
  4. In the Properties view, click the General tab and click the Browse button to the right of the Schema location field. The XML schema file you select must have the same namespace as the current schema.
  5. If you want to select an XML schema located in the workbench, select the Workbench projects radio button and click Next.
    1. Select the schema you want to include and click Finish.
  6. If you want to select an XML schema located on the Web, select the HTTP radio button and click Next.
    1. Type the URL of the XML schema and click Finish.
    Note: A local copy of the schema will not be stored in the workbench. Every time you validate your schema, the schema's contents will be checked from the URL you specify.
  7. The XML schema editor will retrieve the location of the included XML schema file and display it as read-only in the Schema location field.
  8. Click the Documentation tab if you want to provide any information about this redefine element. The Documentation page is used for human readable material, such as a description, and the App Info page can be used to provide information for applications.

Once you have added the redefine element to your XML schema, you can redefine any of the simple and complex types, groups, and attribute groups in the XML schema you selected in the redefine element.

Related tasks
Adding an import element
Adding an include element

Related reference
XML namespaces