This document describes how to prepare Natural in order to use it with Tamino.
The following topics are covered:
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.
See also Database Access with Natural for Tamino (in the Natural Programming Guide).
Configuring Natural in order to be able to access a Tamino database involves three important steps:
Defining a new DBID.
Defining the DBMS type "XML" for this DBID.
Introducing a new parameter string for this DBID.
To be able to work with Natural for Tamino, you must modify the global configuration file.
To modify the global configuration file
Invoke the Natural Configuration Utility.
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.
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.
Select the type XML in the Type column.
Enter a valid parameter string in the Parameter column. See the section Parameter Strings for Tamino Access for more information.
Save the global configuration file.
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 For more information on collections, see the DDM Editor . |
The following is an example of a valid XML database parameter string:
http://taminohost.xyz.com/tamino/employeedb/NATDemoData
Natural for Tamino supports the following methods of authorization as provided by Tamino:
Non-authenticated authorization.
Authorization using web server authentication.
Authorization using the internal Tamino authentication.
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:
The variables XML_HTTP_USER and
XML_HTTP_PASSWORD are used for web server
authentication.
The variables XML_DB_USER and
XML_DB_PASSWORD are used for the internal Tamino
authentication.
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.
