Import, Export & Automatisation dans la OTOBO-CMDB

Import, Export & Automatisation dans la OTOBO-CMDB

La OTOBO-CMDB offre des interfaces puissantes et des fonctions d’automatisation pour maintenir vos données d’actifs à jour et simplifier les tâches récurrentes.

---

1. Intégration des données via les API REST et SOAP

• REST-API

  • Opérations CRUD sur les classes CI et les DynamicFields
  • Payloads JSON : Intégration simple et légère
  • Authentification : Basée sur des Token ou Basic Auth

• SOAP-API

  • Systèmes Legacy et fonctionnalités approfondies
  • Payloads XML avec descriptions WSDL
  • Sessions state-ful et méthodes étendues pour les liens CI

Best Practices

1. Traitement par lots (Batch) : Importez les données par lots pour éviter les timeouts.
2. Gestion des erreurs : Vérifiez les codes de retour et les entrées de journal (« SysLog »).
3. Rate-Limiting : Faites attention aux limites de l’API pour éviter les blocages.

---

2. Import/Export basé sur des fichiers (CSV, XML)

• Import/Export CSV

  • Mapping des champs : Noms de colonnes → Noms des DynamicFields
  • Délimiteurs, jeu de caractères et en-tête configurables
  • Mise à jour en masse pour les CI existants via un attribut clé (par ex. nom ou ID)

• Import/Export XML

  • Structures complexes et champs imbriqués
  • Mapping possible via des feuilles de style XSLT
  • Utilisation avec des clients SOAP et des outils tiers

Workflow

1. Générer un modèle : Exportez d’abord un exemple de CSV/XML.
2. Enrichir les données : Adaptez les valeurs et validez localement.
3. Lancer l’import : Via l’interface Agent ou le script CLI.
4. Vérifier le résultat : Contrôlez les journaux pour détecter les lignes d’erreur et les avertissements.

---

3. Auto-Discovery & Synchronisation

• Scan réseau : Détection de réseaux IP, d’appareils et de services
• Discovery basé sur des agents : Des agents locaux signalent les détails du système à la CMDB
• Intégration d’outils externes : Ansible, Puppet, SCCM, Nagios, et bien d’autres.

Features

• Scans planifiés : Programmez des cycles d’inventaire réguliers.
• Écrasement vs Enrichissement : Configurez des règles pour le comportement de mise à jour.
• Résolution de conflits : Revue manuelle ou priorisation automatique des anciennes vs nouvelles données.

---

4. Triggers dans les définitions de CI

• Trigger
  • Déclenchent des actions lors de modifications de champs (par ex. Notification, Auto-Assign)
  • Configuration directement en YAML sous VersionTrigger ou via script

VersionTrigger:
  - DefinitionUpdate
  - ValueUpdate

• Cas d’utilisation

  • Mettre à jour automatiquement le journal d’inventaire après la modification d’un numéro de série
  • Envoyer un rappel par e-mail à l’expiration d’un certificat

---

5. VersionTriggers

• VersionTrigger : Contrôle les événements qui déclenchent la création d’une nouvelle version de CI

• Valeurs courantes

  • NameUpdate
  • ConfigItemCreate
  • ValueUpdate
  • DefinitionUpdate

VersionStringModule: Incremental
VersionTrigger:
  - ConfigItemCreate
  - ValueUpdate

Avantage

Historique des versions de toutes les modifications pour la traçabilité et la conformité aux audits.

---

6. Champs de script (ScriptTemplateToolkit)

• Champs calculés : Somme, moyenne, blocs de texte dynamiques
• Syntaxe : 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'

Scénarios d’utilisation

• Valeurs cumulées (par ex. stockage total)
• Calculs de statut (par ex. « critique » selon certains seuils)
• Génération de texte (par ex. descriptions d’actifs avec des placeholders)

---

7. Combiner automatisation et interfaces

1. Imports automatisés : Combinez les jobs REST avec l’import CSV dans des Cron-Jobs.
2. Discovery + Trigger : Détectez de nouveaux appareils et lancez automatiquement la création de CI.
3. Reporting : Utilisez les champs de script et l’historique des versions pour des rapports automatisés via l’API.

---

Grâce à ces mécanismes, les processus peuvent être intégrés de manière transparente dans la OTOBO-CMDB, garantissant la qualité des données et minimisant les tâches manuelles de routine.