Um die Cognos TM1 Java API verwenden zu können, muss man zunächst das JAR-File der API dem gewünschten Java-Projekt hinzufügen. Dieses befindet sich z.B. hier: C:\Program Files\Cognos\TM1\bin\classes\TM1JavaApi.jar.
Ist dies geschehen kann man eine Verbindung per Java zum TM1-Server herstellen. Der nachfolgende Code demonstriert das:
import com.applix.tm1.*;
...
TM1Bean bean = new TM1Bean();
bean.setAdminHost("tm1AdminHost");
TM1Server server = bean.openConnection("tm1ServerName", "tm1UserName", "tm1UserPW");
Wenn sich der TM1-Server auf dem gleichen Rechner befindet ist es nicht nötig, den Admin Host zu setzten.
Über das Bean erhält man mit der Methode openConnection unter Angabe des Servernamen, eines Usernamen und des passenden Passworts ein Serverobjekt. Mit diesem kann man nun die gewünschten Operationen auf dem TM1-Server ausführen, wie beispielsweise das Erstellen von Dimensionen oder Cubes oder das Ausführen von Prozessen.
Wichtig beim Verwenden der Java-API ist es, das TM1-SSl-Zertifikat ins JRE zu integrieren, da es ansonsten zu einer SSL Certificate Exception kommt. Näheres zum Vorgehen dazu in diesem Artikel.
