1. Edit tool

This tool works in two steps:

  1. Click on one of the following buttons:

    Replace

    (See Edit → Replace for a complete description of the command.)

    Insert Before

    (See Edit → Insert Before for a complete description of the command.)

    Insert

    (See Edit → Insert for a complete description of the command.)

    Insert After

    (See Edit → Insert After for a complete description of the command.)

    Convert

    (See Edit → Convert for a complete description of the command.)

    Wrap

    (See Edit → Wrap for a complete description of the command.)

    This first action just fills the list below these buttons with all the allowed arguments (element name or text node) for the selected command.

  2. Choose an element name from the list or type its name in the text field. It is this second action which actually triggers the command.

How to specify an argument for one of the editing commands described above

  • An element is specified by clicking on its name in the list. A single click is sufficient.

    If the selected operation allows to specify a text node as its argument, the list contains not only element names but also a "(text)" item.

  • Alternatively, the element name can be specified using the text field above the list:

    1. Type the element name in the field (or type "(text)" if this item is found in the list).

    2. Press Enter or click on the OK button.

    [Tip]

    The text field supports auto-completion.

    This auto-completion feature can be configured using the Options dialog box.

  • Type Esc or click on the Cancel button to cancel current command and to clear the form.

Procedure 7.1. Procedure for specifying an element argument when the command is applied to an element of the unconstrained type

  1. Type any element name in the text field.

    If the namespace of the element name has not been declared, you will have to declare it using Tools → Declare Namespace before being allowed to specify this name.

  2. Press Enter or click on the OK button.

[Note]What is an element of the unconstrained type?

The type of an element is unconstrained if

  • the element is contained in a document which is not constrained by a grammar,

  • OR the content of the element is invalid according to the grammar used to constrain the document.

  • OR the content of an ancestor of the element is invalid according to the grammar used to constrain the document.

In all cases, XXE allows the user to add or remove any child element or text node.

In the second case, fixing the invalid element will automatically make it recover its actual, constrained, type.

Procedure 7.2. Procedure for specifying an element argument that matches an element wildcard

  1. Type an element name that matches the wildcard in the text field.

    If the namespace of the element name has not been declared, you will have to declare it using Tools → Declare Namespace before being allowed to specify this name.

  2. Press Enter or click on the OK button.

    XXE will of course check that the name you have typed conforms to the element wildcard.

[Note]What is a element wildcard?

Using a W3C XML Schema or a RELAX NG schema (but not a DTD), it is possible to specify an element type which constrains some of its child elements just to belong to a certain set of namepaces and nothing more.

The set of allowed namespaces is called a wildcard.