Import, Export & Automatisering in de OTOBO-CMDB

De OTOBO-CMDB biedt krachtige interfaces en automatiseringsfuncties om uw assetgegevens altijd 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 lichtgewichtige 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. Batch-verwerking: Gegevens in batches importeren om time-outs te voorkomen.
2. Foutafhandeling: Controleer retourcodes en logboekregels („SysLog“).
3. Rate-beperking: Let op API-limieten om blokkeringen te voorkomen.

---

2. Bestandsgebaseerde import/export (CSV, XML)

• CSV-import/export

  • Veldtoewijzing: kolomnamen → DynamicField-namen
  • Scheidingsteken, tekenset en kopregel configureerbaar
  • Massabijwerking voor bestaande CI's per sleutelkenmerk (bijv. Naam of ID)

• XML-import/export

  • Complexe structuren en geneste velden
  • Toewijzing via XSLT-stylesheets mogelijk
  • Gebruik bij SOAP-clients en derden-tools

Werkstroom

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 diensten
• Agent-Based Discovery: Lokale agenten melden systeemdetails aan de CMDB
• Integratie van externe tools: Ansible, Puppet, SCCM, Nagios, enz.

Functies

• Tijdgestuurde scans: Plan regelmatige inventarisatieruns.
• Overschrijving vs. verrijking: Configureer regels voor update-gedrag.
• Conflictoplossing: Manuele controle of automatische prioritering oude vs. nieuwe gegevens.

---

4. Triggers in CI-definities

• Triggers
  • Acties uitvoeren bij veldwijzigingen (bijv. notificatie, Auto-Assign)
  • Configuratie rechtstreeks in YAML onder VersionTrigger of per script

VersionTrigger:
  - DefinitionUpdate
  - ValueUpdate

• Toepassingsgevallen

  • Na wijziging van een serienummer automatisch inventarislog bijwerken
  • Bij verloopdatum van een certificaat e-mailherinnering verzenden

---

5. VersionTriggers

• VersionTrigger: Regelt wanneer een nieuwe CI-versie wordt aangemaakt

• Gangbare waarden

  • NameUpdate
  • ConfigItemCreate
  • ValueUpdate
  • DefinitionUpdate

VersionStringModule: Incremental
VersionTrigger:
  - ConfigItemCreate
  - ValueUpdate

Voordeel

Versiegeschiedenis van alle wijzigingen voor naspeuring en audit-compliance.

---

6. Scriptvelden (ScriptTemplateToolkit)

• Berekende velden: Som, gemiddelde, dynamische tekstblokken
• Syntax: TemplateToolkit ([% … %])

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

Inzetsscenario's

• Gecumuleerde waarden (bijv. totale opslag)
• Statusberekeningen (bijv. „kritiek“ bij bepaalde drempels)
• Tekstgeneratie (bijv. asset-beschrijvingen met placeholders)

---

7. Automatisering en interfaces combineren

1. Geautomatiseerde imports: Combineer REST-taak met CSV-import in Cron-taken.
2. Discovery + Trigger: Detecteer nieuwe apparaten en start CI-aanmaak automatisch.
3. Rapportage: Gebruik scriptvelden en versiegeschiedenis voor geautomatiseerde rapporten via API.

---

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