Skip to content

Import, Export & Automatisation dans la CMDB OTOBO

La CMDB OTOBO offre des interfaces puissantes et des fonctions d'automatisation pour garder vos données d'actifs à jour et simplifier les tâches répétitives.


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

  • API REST

    • Opérations CRUD sur les classes CI et les champs dynamiques
    • Charges utiles JSON : intégration simple et légère
    • Authentification : basée sur les jetons ou l'authentification de base
  • API SOAP

    • Systèmes hérités et fonctionnalités approfondies
    • Charges utiles XML avec descriptions WSDL
    • Sessions à état et méthodes complètes pour les liens CI

Bonnes pratiques

  1. Traitement par lots : Importer des données par lots pour éviter les délais d'attente.
  2. Gestion des erreurs : Vérifiez les codes de retour et les entrées de journal ( « SysLog »).
  3. Limitation de débit : Respectez les limites d'API pour éviter les blocages.

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

  • Import/Export CSV

    • Mise en correspondance des champs : noms de colonnes → noms de champs dynamiques
    • Séparateurs, jeux de caractères et en-tête configurables
    • Mise à jour en masse des CI existants par attribut clé (par exemple, nom ou ID)
  • Import/Export XML

    • Structures complexes et champs imbriqués
    • Mise en correspondance via des feuilles de style XSLT possibles
    • Utilisation avec des clients SOAP et des outils tiers

Flux de travail

  1. Générer un modèle : Exportez d'abord un exemple de CSV/XML.
  2. Enrichir les données : Modifiez les valeurs et validez-les localement.
  3. Lancer l'import : Via l'interface Agent ou le script CLI.
  4. Vérifier les résultats : Vérifiez les journaux pour les lignes d'erreur et les avertissements.

3. Découverte automatique et synchronisation

  • Analyse du réseau : Détecter les réseaux IP, les appareils et les services
  • Découverte basée sur les agents : Les agents locaux signalent les détails du système à la CMDB
  • Intégration d'outils externes : Ansible, Puppet, SCCM, Nagios, etc.

Fonctionnalités

  • Analyse planifiée : Planifiez des analyses d'inventaire régulières.
  • Écrasement vs enrichissement : Configurez des règles pour le comportement de mise à jour.
  • Résolution des conflits : Examen manuel ou priorisation automatique des anciennes vs nouvelles données.

4. Déclencheurs dans les définitions de CI

  • Déclencheurs
    • Déclenchez des actions lors de la modification de champs (par exemple, notification, auto-affectation)
    • Configuration directe dans YAML sous VersionTrigger ou via script
yaml
VersionTrigger:
  - DefinitionUpdate
  - ValueUpdate
  • Cas d'utilisation

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

5. VersionTriggers

  • VersionTrigger : Contrôle lorsqu'une nouvelle version de CI est créée

  • Valeurs courantes

    • NameUpdate
    • ConfigItemCreate
    • ValueUpdate
    • DefinitionUpdate
yaml
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 ([% … %])
yaml
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 exemple, stockage total)
  • Calculs de statut (par exemple, « critique » à certaines limites)
  • Génération de texte (par exemple, descriptions d'actifs avec des espaces réservés)

7. Intégrer l'automatisation et les interfaces

  1. Imports automatisés : Combinez les travaux REST avec l'import CSV dans les tâches Cron.
  2. Découverte + Déclencheur : Détectez de nouveaux appareils et démarrez automatiquement la création de CI.
  3. Rapports : Utilisez des champs de script et l'historique des versions pour les rapports automatisés via l'API.

Avec ces mécanismes, les processus peuvent être intégrés de manière transparente dans la CMDB OTOBO, la qualité des données peut être assurée et les tâches manuelles répétitives peuvent être minimisées.