Version 6.3.13 for Windows
 —  Database Management System Interfaces  —

Natural for Tamino

This document describes how to prepare Natural in order to use it with Tamino.

The following topics are covered:


Preparing Tamino

Natural accesses Tamino through HTTP requests. Therefore, Tamino must be set up with an HTTP server component as a connection to the X-Machine. This can be configured during the Tamino installation. See the Tamino Installation documentation for more details.

Prerequisites:

See also Database Access with Natural for Tamino (in the Natural Programming Guide).

Top of page

Configuring Natural for Tamino Access

Configuring Natural in order to be able to access a Tamino database involves three important steps:

To be able to work with Natural for Tamino, you must modify the global configuration file.

Start of instruction set To modify the global configuration file

  1. Invoke the Natural Configuration Utility.

  2. Edit by selecting the path Global Configuration File/DMBS Assignments in the tree view. A dialog appears in which you must specify the DBID parameter.

  3. Enter a new DBID under which you want to access the Tamino database in the DBID column. Valid DBIDs for Tamino access are from 1 to 65535.

  4. Select the type XML in the Type column.

  5. Enter a valid parameter string in the Parameter column. See the section Parameter Strings for Tamino Access for more information.

  6. Save the global configuration file.

Parameter Strings for Tamino Access

The parameter string for a Tamino database consists of the URL of the database server, the name of the database itself and the name of the collection which is to be accessed within this database.

This following is an example of a generic parameter string:

http://<hostaddress>/tamino/<dbname>/<collectionname>

Parameter Description:

Parameter Description
hostaddress The hostaddress is the address of the machine running the web server which communicates with Tamino.
tamino The keyword tamino is used by the web server as an identifier to open a connection with Tamino.
dbname The dbname is the name of your existing database on the Tamino database server.
collectionname The collectionname is the name of the collection within this database to be accessed from your Natural application.

All database accesses are based on collection granularity and not on complete databases. If you want to access a different collection within the same database, you will have to add a separate DBID entry for this in the NATCONF.CFG, as described above.

For more information on collections, see the DDM Editor .

Sample Parameter String

The following is an example of a valid XML database parameter string:

http://taminohost.xyz.com/tamino/employeedb/NATDemoData

Top of page

Authorization Aspects

Natural for Tamino supports the following methods of authorization as provided by Tamino:

For a detailed description of the authorization methods refer to the Tamino documentation.

If authorization is necessary, Natural for Tamino will ask for the required user and password combination. Alternatively, the user and password data can be provided in environment variables:

Alternatively, the user and password data can be provided in the table XML Authorization in the global configuration file. Here a DBID specific setting is possible. Please refer to the Configuration Utility documentation.

When using the environment variables for authorization, each connection to a Tamino database will be established with the same pair of user and password. If different users and passwords should be provided for different DBIDs then the usage of the XML Authorization table in the global configuration file or the interactive prompting are recommended.

Top of page