Show TOC

Editing Service InterfacesLocate this document in the navigation structure

Use

In the Service Interface Editor (SIE), you can modify existing service interfaces by editing, deleting and/or renaming their attributes and details. You can modify a service interface that you created from scratch or a back-end service you downloaded and saved locally. You can also rename the target namespace of a definition or schema in such a way that the document remains valid afterwards. In addition, you can import an external namespace into a WSDL document or extract an internal namespace from a document to an XML schema. You can:

  • Edit or delete service interfaces, service operations, parameters, and faults.

  • Delete data types contained in the WSDL.

  • Rename the target namespace of a definition or schema.

  • Import an external namespace in a WSDL document.

  • Extract a namespace from a WSDL document to an external XML schema.

You can thus customize your service interface by adding or removing elements, importing or extracting namespaces, so that it is suitable for your needs.

Procedure

Editing and Deleting an Element

  1. From your project tree, select the WSDL file you want to edit and open it with the SIE.

    Note

    If the SIE is not your default editor, from the WSDL file context menu choose Start of the navigation path Open With Next navigation step Other End of the navigation path and from the list with editors, choose the Service Interface Editor .

  2. Select the element you want to edit. In the General and Documentation sections, edit the name, type or documentation properties of the element.

    For more information on parameter types and operation types, see Creating Service Interfaces .

  3. To delete an attribute, select it and choose the Remove pushbutton.

  4. To edit the data types in an attribute, click the Type: link in the details view of the selected parameter.

    For more information on editing data types, see Managing Data Types .

Renaming of a Target Namespace

You can change the target namespace of a WSDL definition or an XML Schema. After changing the name, the whole document remains valid. This includes schema imports, element and attribute references, message parts, and so on, which are updated.

To rename the target namespace of a definition:

  1. In the SIE, open the Service Interfaces tab page.

  2. In Target Namespace field, edit the name of the namespace.

    Note

    When the WSDL definition contains a schema with matching target namespace, the namespace of the schema is also renamed with the new name.

To rename the target namespace of the types schema:

  1. In the SIE, open the Data Types tab page.

  2. Select the namespace you want to rename. In the Namespace field, edit the name of the namespace.

Importing an External Namespace

If you want to use a namespace that you previously imported in your project in your WSDL document, you can make this namespace internal to the document. All references to other namespaces are updated and remain valid. If the namespace has an included schema, it is only copied to the WSDL document and remains in the Imported Types node in the SIE. Thus, references of the imported namespace are reused, not updated, but are still valid.

To make an external namespace internal to the WSDL document:

  1. In the SIE, open the Data Types tab page.

  2. In the Imported Types tree, select the namespace that you want to make internal to your WSDL document.

  3. From the context menu, choose Start of the navigation path Refactor Next navigation step Make an Inline Namespace End of the navigation path . You can now use the namespace in your WSDL document.

Extracting a Namespace

You can easily extract a namespace from a WSDL document to an external XML schema and edit and reuse it later. Apart from the namespace itself, all directly or indirectly referenced XML schemas in the WSDL file are also extracted along with it. References to the namespace are replaced by references to the extracted XML file.

If the namespace refers to external XML schemas, all references are redirected and remain valid.

You can choose whether to completely remove the namespace and its references from the WSDL document or just extract a copy to the external XML schema.

To extract a namespace From the WSDL document:

  1. In the SIE, open the Data Types tab page.

  2. In the WSDL document, select the namespace you want to extract. From the context menu, choose Start of the navigation path Refactor Next navigation step  Extract Namespace End of the navigation path.

  3. Choose the location where you want to save the extracted XML schema.

  4. You can do one of the following:

    • To extract the namespace to an external XML file, choose Next . No copy of the namespace remains in the current WSDL document.

    • To continue to use the namespace in your WSDL file, select the Keep extracted namespaces in current document checkbox.

      A copy of the namespace is extracted to an external XML file.

  5. If the namespace refers to internal XML schemas, you can see a list of then on the next page. You can edit the XML Schema file names.

    Note

    When you edit the name of a schema, the SIE checks whether there are other schemas with the same name, whether the paths are valid and whether the schema file exists.

  6. Choose Finish .