Administrator's Guide (PDF)

MarkLogic 9 Product Documentation
Administrator's Guide — Chapter 28

« Previous chapter
Next chapter »

Namespaces

Namespaces are a powerful mechanism used to differentiate between potentially ambiguous XML elements. Namespaces can be defined within individual XQuery programs. They can also be defined using the Admin Interface.

Namespaces can be defined for a group to apply to all HTTP, ODBC, XDBC, and WebDAV servers in a group or for a particular HTTP, ODBC, XDBC, or WebDAV server. However, a namespace cannot be defined to apply to a particular forest, database, or XQuery program.

For more information about namespaces, see the Namespaces chapter in XQuery and XSLT Reference Guide, which provides a detailed description of XML namespaces and their use. Be sure to review this information before using the Admin Interface to manage your namespaces.

Use the following procedures for managing namespaces in the Admin Interface:

This chapter describes how to use the Admin Interface to manage namespaces. For details on how to manage namespaces programmatically, see Group Maintenance Operations in the Scripting Administrative Tasks Guide.

Defining Namespaces for a Group

To define namespaces using the Admin Interface for a group, perform the following steps:

  1. Click the Groups icon on the left tree menu.
  2. Click the group in which you want to define the namespace, either in the tree menu or the Groups Summary page.
  3. Click the Namespaces icon on the left tree menu, under the group name.
  4. Click the Add tab. The Namespaces Configuration page displays:

  5. Enter a prefix for your namespace.
  6. Enter a URI for your namespace.

    If you are defining a prefix for the universal unnamed namespace, leave the URI blank.

  7. To add more namespace definitions, click the More Items button and repeat steps 5 and 6 for each namespace as needed.
  8. Scroll to the top or bottom and click OK.

The namespace is now defined in the group.

Defining Namespaces for an HTTP, ODBC, or XDBC Server

To define namespaces using the Admin Interface for an HTTP, ODBC, or XDBC Server, perform the following steps:

  1. Click the Groups icon on the left tree menu.
  2. Click the group which contains the HTTP, ODBC, or XDBC server for which you want to define the namespace, either in the tree menu or the Groups Summary page.
  3. Click the App Servers icon as appropriate.
  4. Click on the name of the App server for which you want to define the namespace.
  5. Click on the Namespaces icon on the left tree menu, under the specified App server.
  6. Click the Add tab at the top right. The Namespaces Configuration page displays:

  7. Enter a prefix for your namespace.
  8. Enter a URI for your namespace.

    If you are defining a prefix for the universal unnamed namespace, leave the URI blank.

  9. To add more namespace definitions, click the More Items button and repeat steps 7 and 8 for each namespace as needed.
  10. Scroll to the top or bottom and click OK.

The namespace is now defined for the App Server.

Viewing Namespace Settings for a Group

To view namespaces you have defined in the Admin Interface, perform the following steps:

  1. Click the Groups icon on the left tree menu.
  2. Click the group which contains the namespace you want to view, either in the tree menu or the Groups Summary page.
  3. Click the Namespaces icon on the left tree menu, under the specified group. The Namespace Configuration page appears.

Viewing Namespace Settings for an HTTP, ODBC, or XDBC Server

To view namespaces you have defined in the Admin Interface, perform the following steps:

  1. Click the Groups icon on the left menu tree.
  2. Click the group which contains the HTTP, ODBC, or XDBC server for which you want to view the namespace, either in the tree menu or the Groups Summary page.
  3. Click the App Servers icon as appropriate.
  4. Click on the name of the App Server for which you want to view the namespace.
  5. Click the Namespaces icon on the left tree menu, under the specified App Server. The Namespace Configuration page appears.

Deleting Namespaces for a Group

To delete namespaces that you defined in the Admin Interface, perform the following steps:

  1. Click the Groups icon on the left tree menu.
  2. Click the group from which you want to delete the namespace, either in the tree menu or the Group Summary page.
  3. Click the Namespaces icon on the left tree menu, under the specified group.
  4. Locate the namespace to be deleted and click Delete.
  5. A confirmation message displays. Confirm the delete and click OK.

The namespace is deleted from the group.

Deleting Namespaces for an HTTP, ODBC, or XDBC Server

To delete namespaces that you defined in the Admin Interface for an HTTP, ODBC, or XDBC server, perform the following steps:

  1. Click the Groups icon on the left tree menu.
  2. Click on the group which contains the App Server from which you want to delete the namespace, either in the tree menu or the Group Summary page.
  3. Click on the App Servers icon.
  4. Click on the name of the App Server from which you want to delete the namespace, either in the tree menu or the App Server Summary page.
  5. Click the Namespaces icon on the left tree menu, under the specified App Server. The namespace configuration screen appears.
  6. Locate the namespace to be deleted and click Delete.
  7. A confirmation message displays. Confirm the delete and click OK.

The namespace is deleted from the App Server.

« Previous chapter
Next chapter »
Powered by MarkLogic Server | Terms of Use | Privacy Policy