This section describes how to prepare Natural in order to use it with Tamino. The following topics are covered:
See also Database Access with Natural for Tamino (in the Programming Guide).
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.
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 global configuration file
Invoke the 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>
The hostaddress is the address of the machine running the
web server which communicates with Tamino.
The keyword tamino is used by the web server as an
identifier to open a connection with Tamino.
The dbname is the name of your existing database on the
Tamino database server.
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 .
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.
