Um das Portal zu benutzen, muss zunächst ein Aktivierungsschlüssel im Portal eingegeben werden, um das Modul VAT@GTC freizuschalten. Zu diesem Modul existiert ein Lizenztoken, der vom VAT@GTC beim Serverstart benutzt wird, um den Registrierungshandshake mit dem Portal durchzuführen. 

VAT ab 23.25

Im Tomcat für die VAT@GTC Parameter kann eine Portal API URL optional angegeben werden wenn die API von der Portal-URL abweicht. Die Portal-API-URL wird für API Aufrufe zwischen Portal und VAT genutzt.

Beispiel wie eine solche Konfiguration aussehen kann:

-Dvat.url.portalApi=http://localhost:8081/portalApi

VAT ab 23.08

Die Einrichtung des VAT@GTC mit dem Portal kann wie folgt durchgeführt werden:

1. Portal eingerichtet und gestartet (inkl. JDBC-Treiber für MsSQL und Anpassung der context.xml mit Ressource-Name "jdbc/portaldatasource")

2. Lizenzschlüssel im Portal bei Aktivierungen hinterlegen

3. Im Tomcat fürs VAT@GTC Parameter hinterlegen

   1. Dynamische Registrierung: (empfohlen)
      Beispiel wie eine solche Konfiguration aussehen kann:

      -Dvat.url.base=http://localhost:8082/vat
      -Dvat.url.portal=http://localhost:8081/portal

      -Dvat.url.api=http://localhost:8082/vat/-/api/portal (optional, muss nur angegeben werden, wenn API von Base-URL abweicht)

   2. Statische Registrierung:

      1. Im Portal ein neues Modul VAT@GTC anlegen. Dabei Root URL (Base aus dem Tomcat Parameter “-Dvat.url.base”), Login URL (Base aus dem Tomcat Parameter “-Dvat.url.base”+ "/login.do") und API URL (API aus dem Tomcat Parameter “-Dvat.url.api”) eintragen

      2. Es werden Secret und Client-ID erzeugt. Diesen müssen nach dem Speichern gesichert und in den VM-Parametern des VAT@GTC eingetragen werden

      3. 
         Beispiel wie eine solche Konfiguration aussehen kann:

         -Dvat.url.base=http://localhost:8082/vat
         -Dvat.url.portal=http://localhost:8081/portal

         -Dvat.url.api=http://localhost:8082/vat/-/api/portal (optional, muss nur angegeben werden, wenn API von Base-URL abweicht)

         -Dvat.clientId=ErzeugteClientID
         -Dvat.clientSecret=ErzeugtesClientSecret

4. VAT@GTC-Server starten

5. In der Modulübersicht im Portal prüfen, ob der Status "Verbindung hergestellt" ist und das Modul mit einem grünen Punkt bei "aktiv" gekennzeichnet ist

6. Absprung ins VAT@GTC testen

7. Falls Absprung erfolgreich, dann prüfen, ob USE_SSO in TSYSTEM gesetzt ist und Flag ggf. entfernen