Import, Export & Automatisierung in der OTOBO-CMDB

Die OTOBO-CMDB bietet mächtige Schnittstellen und Automatisierungs-Funktionen, um Ihre Asset-Daten stets aktuell zu halten und wiederkehrende Aufgaben zu vereinfachen.

---

1. Datenintegration per REST- und SOAP-APIs

• REST-API

  • CRUD-Operationen auf CI-Klassen und DynamicFields
  • JSON-Payloads: Einfache und leichtgewichtige Integration
  • Authentifizierung: Token-basiert oder Basic Auth

• SOAP-API

  • Legacy-Systeme und tiefe Funktionalität
  • XML-Payloads mit WSDL-Beschreibungen
  • State-ful Sessions und umfangreiche Methoden für CI-Verknüpfungen

Best Practices

1. Batch-Verarbeitung: Daten in Chargen importieren, um Timeouts zu vermeiden.
2. Fehler-Handling: Überprüfen Sie Rückgabecodes und Log-Einträge („SysLog“).
3. Rate-Limiting: Achten Sie auf API-Limits, um Sperrungen zu verhindern.

---

2. Dateibasierter Import/Export (CSV, XML)

• CSV-Import/Export

  • Feldzuordnung: Spaltennamen → DynamicField-Namen
  • Trennzeichen, Zeichensatz und Kopfzeile konfigurierbar
  • Massenupdate für bestehende CIs per Schlüsselattribut (z. B. Name oder ID)

• XML-Import/Export

  • Komplexe Strukturen und verschachtelte Felder
  • Mapping über XSLT-Stylesheets möglich
  • Nutzung bei SOAP-Clients und Dritt-Tools

Workflow

1. Vorlage generieren: Exportieren Sie zunächst ein Beispiel-CSV/XML.
2. Daten anreichern: Passen Sie Werte an und validieren Sie lokal.
3. Import starten: Über Agent-Interface oder CLI-Skript.
4. Ergebnis prüfen: Protokolle auf Fehlerzeilen und Warnungen prüfen.

---

3. Auto-Discovery & Synchronisation

• Netzwerk-Scanning: Erkennen von IP-Netzwerken, Geräten und Diensten
• Agent-Based Discovery: Lokale Agenten melden System-Details an die CMDB
• Integration externer Tools: Ansible, Puppet, SCCM, Nagios, u. v. m.

Features

• Zeitgesteuerte Scans: Planen Sie regelmäßige Inventarisierungsläufe.
• Überschreibung vs. Anreicherung: Konfigurieren Sie Regeln zum Update-Verhalten.
• Konfliktauflösung: Manuelles Review oder automatische Priorisierung alter vs. neuer Daten.

---

4. Trigger in CI-Definitionen

• Trigger
  • Lösen Aktionen bei Feldänderungen aus (z. B. Notification, Auto-Assign)
  • Konfiguration direkt in YAML unter VersionTrigger oder per Skript

VersionTrigger:
  - DefinitionUpdate
  - ValueUpdate

• Anwendungsfälle

  • Nach Änderung einer Seriennummer automatisch Inventar-Log aktualisieren
  • Bei Ablaufdatum eines Zertifikats E-Mail-Erinnerung versenden

---

5. VersionTriggers

• VersionTrigger: Steuert, bei welchen Events eine neue CI-Version angelegt wird

• Gängige Werte

  • NameUpdate
  • ConfigItemCreate
  • ValueUpdate
  • DefinitionUpdate

VersionStringModule: Incremental
VersionTrigger:
  - ConfigItemCreate
  - ValueUpdate

Vorteil

Versions-History aller Änderungen zur Nachvollziehbarkeit und Audit-Compliance.

---

6. Skript-Felder (ScriptTemplateToolkit)

• Berechnete Felder: Summe, Durchschnitt, dynamische Textbausteine
• Syntax: TemplateToolkit ([% … %])

DynamicFields:
  TotalRAMGB:
    FieldType: ScriptTemplateToolkit
    Label: Total RAM (GB)
    Config:
      Expression: |
        [% Count = DynamicField_RAMCount %]
        [% Size  = DynamicField_RAMSize %]
        [% Total = Count * Size %]
        [% Total %] GB
      RequiredArgs:
        - DynamicField_RAMCount
        - DynamicField_RAMSize
      Readonly: '1'

Einsatzszenarien

• Kumulierte Werte (z. B. Gesamtspeicher)
• Statusberechnungen (z. B. „kritisch“ bei bestimmten Schwellen)
• Textgenerierung (z. B. Asset-Beschreibungen mit Platzhaltern)

---

7. Automatisierung und Schnittstellen zusammenführen

1. Automated Imports: Kombinieren Sie REST-Job mit CSV-Import in Cron-Jobs.
2. Discovery + Trigger: Erkennen Sie neue Geräte und starten Sie CI-Erstellung automatisch.
3. Reporting: Nutzen Sie Skript-Felder und Version-History für automatisierte Berichte via API.

---

Mit diesen Mechanismen lassen sich in der OTOBO-CMDB Prozesse nahtlos integrieren, Datenqualität sichern und manuelle Routineaufgaben minimieren.

Häufig gestellte Fragen

Wie importieren und exportieren Sie CMDB-Daten in OTOBO?

Die OTOBO-CMDB bietet flexible Wege für den Datenimport und -export. Für die programmatische Integration und den Echtzeit-Datenaustausch eignen sich die REST- und SOAP-APIs. Die REST-API nutzt JSON-Payloads für CRUD-Operationen und ist leichtgewichtig, während die SOAP-API mit XML und WSDL für komplexere, möglicherweise ältere Systeme gedacht ist. Für Massenupdates oder einmalige Datenmigrationen können Sie dateibasierte Methoden nutzen: CSV-Import/Export ermöglicht eine einfache Feldzuordnung und Konfiguration von Trennzeichen, während XML-Import/Export komplexere Strukturen über XSLT-Stylesheets abbilden kann. Bei der Nutzung von APIs sollten Best Practices wie Batch-Verarbeitung, Fehler-Handling und Rate-Limiting beachtet werden, um eine reibungslose Integration zu gewährleisten.---* Quellen: * Import, Export & Automatisierung in der OTOBO-CMDB * Web Services — OTOBO Admin Guide 10.1 documentation * Import/Export — OTOBO Admin Guide 11.0 documentation

Welche Automatisierungsfunktionen bietet die OTOBO-CMDB, um CI-Daten aktuell zu halten?

Die OTOBO-CMDB bietet eine Reihe von Automatisierungsfunktionen, um die Datenqualität zu sichern und manuelle Pflege zu minimieren. Dazu gehören Trigger, die bei Änderungen an CI-Feldern Aktionen wie Benachrichtigungen oder automatische Zuweisungen auslösen können. VersionTriggers steuern, wann eine neue Version eines Configuration Items (CI) angelegt wird, was eine detaillierte Historie aller Änderungen für Nachvollziehbarkeit und Audit-Compliance ermöglicht. Skript-Felder (ScriptTemplateToolkit) erlauben die Definition von berechneten Werten, wie Summen oder dynamischen Textbausteinen, die sich automatisch aktualisieren. Darüber hinaus sorgt Auto-Discovery und Synchronisation durch Netzwerk-Scanning, Agenten-basierte Erkennung oder Integration externer Tools dafür, dass Ihre CMDB-Daten stets den aktuellen Zustand Ihrer IT-Infrastruktur widerspiegeln.---* Quellen: * Import, Export & Automatisierung in der OTOBO-CMDB * Web Services — OTOBO Admin Guide 10.1 documentation

Wann sollte ich die REST/SOAP API für die Datenintegration nutzen und wann ist der dateibasierte Import (CSV/XML) geeigneter?

Die Wahl zwischen API-basierter und dateibasierter Integration hängt stark vom Anwendungsfall ab. REST- oder SOAP-APIs sind ideal für die laufende System-zu-System-Synchronisation und Echtzeit-Updates, bei denen Daten kontinuierlich zwischen OTOBO und anderen Systemen ausgetauscht werden müssen. Sie ermöglichen präzise CRUD-Operationen (Erstellen, Lesen, Aktualisieren, Löschen) auf einzelnen CIs oder kleinen Datensätzen und sind gut für die Integration in automatisierte Workflows geeignet. Dateibasierte Importe per CSV oder XML hingegen sind besser für einmalige Datenmigrationen, Massenimporte oder -updates aus Tabellenkalkulationen oder Datenbanken geeignet, bei denen große Mengen an Daten auf einmal verarbeitet werden. CSV ist dabei einfacher für flache Datenstrukturen, während XML komplexere, verschachtelte Daten abbilden kann.---* Quellen: * Import, Export & Automatisierung in der OTOBO-CMDB * OTOBO REST API Guide – Configuration, Endpoints & Examples

Wie funktioniert OTOBOs Auto-Discovery und welche Schlüsselfunktionen bietet sie zur Aktualisierung von CMDB-Daten?

OTOBOs Auto-Discovery ist ein leistungsstarkes Werkzeug, um Ihre CMDB-Daten automatisch aktuell zu halten. Sie kann auf verschiedene Weisen erfolgen: durch Netzwerk-Scanning, das IP-Netzwerke, Geräte und Dienste erkennt, oder durch Agenten-basierte Discovery, bei der lokale Agenten Systemdetails an die CMDB melden. Zudem können externe Tools wie Ansible, Puppet oder SCCM integriert werden, um deren Inventardaten zu nutzen. Zu den Schlüsselfunktionen gehören zeitgesteuerte Scans, die regelmäßige Inventarisierungsläufe ermöglichen, sowie konfigurierbare Regeln für das Update-Verhalten (Überschreibung vs. Anreicherung). Bei Datenkonflikten bietet die CMDB Mechanismen zur Konfliktauflösung, sei es durch manuelles Review oder automatische Priorisierung von Datenquellen.---* Quellen: * Import, Export & Automatisierung in der OTOBO-CMDB * OTOBO Interface: Web Services & Integrations

Was sind "Trigger" und "VersionTriggers" in der OTOBO-CMDB und wie helfen sie bei der Automatisierung und Nachverfolgung von Änderungen?

In der OTOBO-CMDB sind Trigger Mechanismen, die bei bestimmten Feldänderungen an Configuration Items (CIs) vordefinierte Aktionen auslösen. Dies kann beispielsweise das Senden einer E-Mail-Benachrichtigung bei einer Statusänderung oder das automatische Aktualisieren eines Inventar-Logs nach einer Seriennummernänderung sein. Sie werden direkt in der CI-Definition konfiguriert und ermöglichen eine proaktive Reaktion auf Datenereignisse. VersionTriggers hingegen steuern, unter welchen Bedingungen eine neue Version eines CIs in der CMDB angelegt wird. Gängige Werte sind ConfigItemCreate (bei Erstellung), ValueUpdate (bei Wertänderung) oder DefinitionUpdate (bei Definitionsänderung). Dies ist entscheidend für die Versions-History eines CIs, die eine lückenlose Nachvollziehbarkeit aller Änderungen gewährleistet und somit für Audit-Compliance und Änderungsmanagement unerlässlich ist.---* Quellen: * Import, Export & Automatisierung in der OTOBO-CMDB * Web Services — OTOBO Admin Guide 10.1 documentation

Wie können Skript-Felder in der OTOBO-CMDB verwendet werden, um dynamische und berechnete Werte zu erstellen?

Skript-Felder, die das TemplateToolkit ([% … %]) nutzen, sind eine leistungsstarke Funktion in der OTOBO-CMDB, um dynamische und berechnete Werte direkt in Ihren Configuration Items (CIs) anzuzeigen. Anstatt statische Daten zu speichern, können diese Felder Werte aus anderen DynamicFields eines CIs abrufen, Berechnungen durchführen und das Ergebnis anzeigen. Ein typisches Einsatzszenario ist die Berechnung kumulierter Werte, wie zum Beispiel der Gesamtspeicher (Total RAM), indem die Anzahl der RAM-Module mit deren Größe multipliziert wird. Auch Statusberechnungen (z. B. "kritisch" bei bestimmten Schwellenwerten) oder die Generierung dynamischer Asset-Beschreibungen mit Platzhaltern sind möglich. Die Konfiguration erfolgt über ein Expression-Feld, das die Logik des Skripts enthält, und RequiredArgs, die die benötigten DynamicFields definieren.---* Quellen: * Import, Export & Automatisierung in der OTOBO-CMDB * OTOBO REST API Guide – Configuration, Endpoints & Examples