Import, Export & Automatisering in de OTOBO CMDB

De OTOBO CMDB biedt krachtige interfaces en automatiseringsfuncties om uw assetgegevens up-to-date te houden en terugkerende taken te vereenvoudigen.

---

1. Gegevensintegratie via REST- en SOAP-API's

• REST API

  • CRUD-bewerkingen op CI-klassen en DynamicFields
  • JSON-payloads: Eenvoudige en lichtgewicht integratie
  • Authenticatie: Token-gebaseerd of Basic Auth

• SOAP API

  • Legacy-systemen en diepe functionaliteit
  • XML-payloads met WSDL-beschrijvingen
  • State-ful sessies en uitgebreide methoden voor CI-koppelingen

Best Practices

1. Batchverwerking: Importeer gegevens in batches om time-outs te voorkomen.
2. Foutafhandeling: Controleer retourcodes en logboekvermeldingen ("SysLog").
3. Rate Limiting: Houd rekening met API-limieten om blokkades te voorkomen.

---

2. Bestandsgebaseerde Import/Export (CSV, XML)

• CSV Import/Export

  • Veldtoewijzing: Kolomnamen → DynamicField-namen
  • Scheidingstekens, tekenset en header configureerbaar
  • Bulkupdate voor bestaande CIs via sleutelattribuut (bijv. Naam of ID)

• XML Import/Export

  • Complexe structuren en geneste velden
  • Mapping mogelijk via XSLT-stylesheets
  • Gebruik met SOAP-clients en tools van derden

Workflow

1. Sjabloon genereren: Exporteer eerst een voorbeeld-CSV/XML.
2. Gegevens verrijken: Pas waarden aan en valideer lokaal.
3. Import starten: Via Agent-interface of CLI-script.
4. Resultaat controleren: Controleer logboeken op foutregels en waarschuwingen.

---

3. Auto-Discovery & Synchronisatie

• Netwerkscanning: Detectie van IP-netwerken, apparaten en services
• Agent-Based Discovery: Lokale agents melden systeeminformatie aan de CMDB
• Integratie van externe tools: Ansible, Puppet, SCCM, Nagios, en vele andere.

Functies

• Tijdgestuurde scans: Plan regelmatige inventarisatieruns.
• Overschrijven vs. Verrijken: Configureer regels voor updategedrag.
• Conflictoplossing: Handmatige beoordeling of automatische prioritering van oude vs. nieuwe gegevens.

---

4. Triggers in CI-definities

• Triggers
  • Starten acties bij veldwijzigingen (bijv. Notificatie, Auto-Assign)
  • Configuratie direct in YAML onder VersionTrigger of via script

VersionTrigger:
  - DefinitionUpdate
  - ValueUpdate

• Gebruiksscenario's

  • Na wijziging van een serienummer automatisch inventarisatielogboek bijwerken
  • Bij verlopen van een certificaat een e-mailherinnering verzenden

---

5. VersionTriggers

• VersionTrigger: Bepaalt bij welke events een nieuwe CI-versie wordt aangemaakt

• Veelvoorkomende waarden

  • NameUpdate
  • ConfigItemCreate
  • ValueUpdate
  • DefinitionUpdate

VersionStringModule: Incremental
VersionTrigger:
  - ConfigItemCreate
  - ValueUpdate

Voordeel

Versiegeschiedenis van alle wijzigingen voor traceerbaarheid en audit-compliance.

---

6. Scriptvelden (ScriptTemplateToolkit)

• Berekende velden: Som, gemiddelde, dynamische tekstblokken
• 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'

Toepassingsscenario's

• Geaccumuleerde waarden (bijv. totaal geheugen)
• Statusberekeningen (bijv. "kritiek" bij bepaalde drempels)
• Tekstgeneratie (bijv. assetbeschrijvingen met placeholders)

---

7. Automatisering en Interfaces samenvoegen

1. Geautomatiseerde Imports: Combineer REST-job met CSV-import in Cron-jobs.
2. Discovery + Triggers: Detecteer nieuwe apparaten en start CI-creatie automatisch.
3. Rapportage: Gebruik scriptvelden en versiegeschiedenis voor geautomatiseerde rapporten via API.

---

Met deze mechanismen kunnen processen naadloos worden geïntegreerd in de OTOBO CMDB, de gegevenskwaliteit worden gewaarborgd en handmatige routine taken worden geminimaliseerd.