TANSS

Die TANSS-Integration bietet eine umfassende Anbindung an das TANSS IT-Service-Management-System. Die Integration synchronisiert Geschäftsdaten und ermöglicht die automatische Verknüpfung von Dokumenten mit Kunden, Geräten und Tickets.

Kernfunktionen

• Datensynchronisation — Firmen, Mitarbeiter, Tickets, Ticketstatus und Geräte werden regelmäßig synchronisiert und stehen als Datenbanktabellen zur Verfügung.
• Ordner-Synchronisation — Für jeden TANSS-Kunden wird automatisch ein Ordner im DMS angelegt. Template-basierte Namensgebung mit Variablen.
• Device Mapping — TANSS-Geräte mit DMS-Ordnern verknüpfen für die automatische Dokumentenzuordnung.
• Ticket-Integration — Tickets erstellen, aktualisieren und kommentieren direkt aus ELONIQ.

• Firmenverwaltung — Firmen, Mitarbeiter und Kontaktdaten aus TANSS synchronisieren.
• Ticket-Management — Tickets erstellen, aktualisieren und kommentieren. Interne und externe Kommentare unterstützt.
• Geräteverwaltung — Geräte aus TANSS abrufen und mit DMS-Dokumenten verknüpfen (Device Mapping).
• Ordner-Synchronisation — Automatisch DMS-Ordner für jeden TANSS-Kunden anlegen mit Template-basierten Ordnernamen.
• Datenbank-Adapter — TANSS-Daten als Tabellen (Firmen, Mitarbeiter, Tickets, Geräte) für andere Module bereitstellen.
• 2FA-Unterstützung (TOTP) — Automatische TOTP-Generierung für TANSS-Instanzen mit Zwei-Faktor-Authentifizierung.
• Intelligentes Caching — Firmen, Mitarbeiter, Ticketstatus und Geräte werden gecacht mit konfigurierbarer TTL.
• Exponentielles Backoff — Automatische Wiederholungsversuche bei Netzwerkfehlern mit exponentieller Verzögerung.
• Zeiterfassung — Zeiteinträge aus TANSS für die Dokumentation und Abrechnung abrufen.
• Template-Variablen — Ordnernamen mit Variablen wie {CustomerName}, {CustomerNumber}, {City} dynamisch generieren.

1. Integration öffnen — Navigieren Sie zu Integrationen > TANSS im AdminUI.
2. Verbindung konfigurieren — Base URL, Benutzername und Passwort eintragen. Bei 2FA: TOTP-Secret hinterlegen.
3. Verbindung testen — Testen Sie die API-Verbindung und prüfen Sie den Verbindungsstatus.
4. Funktionen aktivieren — Wählen Sie die gewünschten Funktionen: Database Sync, Ticket-Erstellung, Auto Cache.
5. Ordner-Synchronisation einrichten — Definieren Sie ein Ordner-Template, den Basis-Ordner im DMS und das Sync-Intervall.
6. Erste Synchronisation — Starten Sie die erste Synchronisation manuell und prüfen Sie die Ergebnisse.
7. Device Mapping konfigurieren — Optional: TANSS-Geräte mit DMS-Ordnern verknüpfen.
8. Status überwachen — Prüfen Sie regelmäßig die Sync-Statistiken und Cache-Status.

• TOTP einrichten — Wenn Ihr TANSS-System 2FA erfordert, konfigurieren Sie das TOTP-Secret für unterbrechungsfreie Authentifizierung.
• Cache-TTL anpassen — Verkürzen Sie die TTL, wenn sich Firmendaten häufig ändern. Standard ist für die meisten Szenarien ausreichend.
• Ordner-Templates testen — Testen Sie Ordner-Templates mit einer kleinen Kundengruppe, bevor Sie die vollständige Synchronisation aktivieren.
• Retry-Policy beibehalten — Die Standard-Retry-Einstellungen (3 Versuche, exponentielles Backoff) sind für die meisten TANSS-Instanzen optimal.
• Gerätezuordnung pflegen — Überprüfen Sie regelmäßig die Gerätezuordnungen, um sicherzustellen, dass DMS-Ordner korrekt verknüpft sind.
• Funktionen gezielt aktivieren — Aktivieren Sie nur die Funktionen (DB-Sync, Tickets, Cache), die tatsächlich benötigt werden.

1. Grundlegende TANSS-Anbindung

Base URL: https://kunde.tanss.de
Username: api_user
Password: ***
Funktionen: Database Sync, Auto Cache

2. TANSS mit 2FA und Ticket-Management

Base URL: https://kunde.tanss.de
Username: api_user
Password: ***
TOTP Secret: JBSWY3DPEHPK3PXP
Funktionen: Database Sync, Create Tickets, Update Tickets, Auto Cache

3. Ordner-Synchronisation nach ELO

Folder Template: {CustomerName} ({CustomerNumber})
Base Folder: ¶Kunden¶
Sync Interval: 60 Minuten

Für jeden TANSS-Kunden wird automatisch ein Ordner in ELO angelegt, z.B. ¶Kunden¶/Firma ABC (K-001).

4. Template mit Variablen

Verfügbare Variablen:
  {CustomerName}   → Firma ABC GmbH
  {CustomerNumber}  → K-001
  {CompanyID}       → 42
  {City}            → Berlin
  {Year}            → 2026
  {Month}           → 03
  {Day}             → 02