This document lists the prerequisites and procedures for successfully installing the Tamino API for .NET.
Here you will find general information about the Tamino API for .NET and how to deploy it.
Tamino Component Profile for the Tamino API for .NET |
|
---|---|
Supported Platforms |
Any hardware and operating-system platform that supports both Software AG's Tamino XML Server and Microsoft's .NET. |
Location of Installed Component |
TaminoInstallDir/SDK/TaminoAPI4DotNET (henceforth called TaminoAPIDir) |
Component Files |
Library:
TaminoAPIDir/lib/TaminoAPI.dll |
Documentation:
TaminoInstallDir/Documentation
|
|
Samples:
TaminoAPIDir/samples
|
|
Bundled Software |
none |
The Tamino API for .NET is installed with the Tamino XML Server installation. For more information, refer to the installation section of the Tamino XML Server documentation.
The installation procedure installs TaminoAPI.dll automatically. In order to use it, you must either reference the DLL explicitly in your .NET project, or register it in the normal manner.
To work with the Tamino API for .NET
You need a running Tamino database server in order to be able to use an API. If you want to access an existing Tamino database, you need to know the database URI, for example: http://localhost/tamino/mydb).
The TaminoAPI.dll is a managed .NET assembly. The easiest way to develop an application with Microsoft Visual Studio .NET is explicitly to add a reference to the TaminoAPI.dll from your Visual Studio .NET project. When adding this reference, ensure that TaminoAPI.xml is in the same directory as TaminoAPI.dll. If this is not the case, the Visual Studio .NET tooltips will not work correctly.
TaminoAPI.dll is a strong-named assembly. You can use either of these techniques to use it from your application:
Copy TaminoAPI.dll into your application directory;
Use the appropriate .NET tools to install TaminoAPI.dll in the global assembly cache (GAC).
To use the Tamino API for .NET examples
Please refer to the README file, which you can find at the location TaminoAPIDir/samples/readme.txt. This includes information for building the samples, loading test data, running the samples, and cleaning up.