Common Elements of the Tamino Interactive Interface

The Tamino Interactive Interface consists of several tabs. Each tab displays a form with input fields necessary for executing a command to Tamino. When you enter data into the input fields and send a command to Tamino, the result is displayed in the result window in the lower part of the Tamino Interactive Interface. The content of the fields Database URL, Collection, and Encoding are shared by all forms that need one or more of these input fields. Help is available on each form, if the Tamino Interactive Interface is loaded via HTTP.

This document describes the following common input fields:


Database URL

Here you specify the URL of the (existing) Tamino database that you wish to access. Enter a valid URL for a Tamino database, for example http://localhost/tamino/mydb. Database names are case sensitive. If you want to switch to a different Tamino database, enter a new URL here. Information on how to create Tamino databases can be found in the Tamino Manager documentation.

Note:
For the examples described in the section Working with the Tamino Interactive Interface, the database you specify needs to be started. For information on how to start a database, see the Tamino Manager documentation.

Collection

Here you specify the (existing) collection that you wish to access. Enter a valid name for the collection. Collections are defined within the Tamino Schema. Information about creating and naming collections can be found in the documentation about the Tamino Schema Editor.

Encoding

Here you specify the character encoding used when sending a Query, Delete or Undefine request to Tamino. In this case, the request is sent to Tamino with the encoding you have specified in the Encoding field.

If you send a Load or Define request, the XML document itself possesses encoding information within its header. Subsequently, the entry in the Encoding field is ignored. If no encoding is specified, "ISO-8859-1" is set as default.

With Microsoft Internet Explorer, this field will be initialized with the default encoding you have specified within your browser settings. In general, the encodings accepted by the Tamino Interactive Interface depend on the encodings supported by the browser.

Favorite

With this button, you can save the current settings as a bookmark. Currently, this option is only available if your browser is Microsoft's Internet Explorer and you loaded the Tamino Interactive Interface via HTTP. If you choose this button, the current settings of the Tamino Interactive Interface are saved as a bookmark. You will be prompted to enter a name and location for the shortcut.

The parameters will automatically be read into the URL. The following parameters are available:

Parametername Description
DatabaseURL The URL of the Tamino database, e.g.: http://localhost/tamino/mydb
Collection The name of the collection.
Query A query string.
Explain Switch the usage of the ino:explain function on or off. See Analysis: Request information concerning the query.
Resultsize The result size as used in the Tamino Interactive Interface
Delete The delete string.
Undefine The undefine string (collection-name or collection-name/doctype-name).
Encoding The encoding value, e.g. utf-8 or iso-8859-1
Runcmd Executes the specified command on startup of the Tamino Interactive Interface. Possible values are:
  • query = execute the query string specified with the query parameter

  • xquery = execute XQuery

  • delete = execute the delete string specified with the delete parameter

  • undefine = execute the undefine string specified with the undefine parameter. You still will be prompted to confirm this action.

  • diagnose

Note:
This parameter does not check other parameters, e.g. it is assumed that a query string exists, if the query command is triggered.

Note that the parameter Runcmd acts like the OK button in the Tamino Interactive Interface. Press the button Favorite, then edit the URL and append the parameter &RUNCMD=... manually to the end of the URL. If you do so, the command is executed when you start the Tamino Interactive Interface again.

Also note that the parameter names are not case sensitive, but the values are.