Importação, Exportação e Automação na OTOBO-CMDB

A OTOBO-CMDB oferece poderosas interfaces e funções de automação para manter seus dados de ativos sempre atualizados e simplificar tarefas recorrentes.

---

1. Integração de Dados via APIs REST e SOAP

• API REST

  • Operações CRUD em classes de CI e DynamicFields
  • Payloads JSON: Integração simples e leve
  • Autenticação: Baseada em token ou Basic Auth

• API SOAP

  • Sistemas legados e funcionalidade profunda
  • Payloads XML com descrições WSDL
  • Sessões stateful e métodos extensivos para links de CI

Melhores Práticas

1. Processamento em Lote: Importe dados em lotes para evitar timeouts.
2. Tratamento de Erros: Verifique códigos de retorno e entradas de log ("SysLog").
3. Rate Limiting: Observe os limites da API para evitar bloqueios.

---

2. Importação/Exportação Baseada em Arquivo (CSV, XML)

• Importação/Exportação CSV

  • Mapeamento de Campos: Nomes de Coluna → Nomes de DynamicField
  • Delimitador, conjunto de caracteres e cabeçalho configuráveis
  • Atualização em massa para CIs existentes por atributo chave (ex: Nome ou ID)

• Importação/Exportação XML

  • Estruturas complexas e campos aninhados
  • Mapeamento possível via stylesheets XSLT
  • Uso com clientes SOAP e ferramentas de terceiros

Fluxo de Trabalho

1. Gerar Modelo: Primeiro, exporte um CSV/XML de exemplo.
2. Enriquecer Dados: Ajuste valores e valide localmente.
3. Iniciar Importação: Via interface do Agente ou script CLI.
4. Verificar Resultado: Verifique os logs em busca de linhas de erro e avisos.

---

3. Auto-Discovery e Sincronização

• Escaneamento de Rede: Detecção de redes IP, dispositivos e serviços
• Discovery Baseado em Agente: Agentes locais reportam detalhes do sistema para a CMDB
• Integração de Ferramentas Externas: Ansible, Puppet, SCCM, Nagios, e muitos outros.

Funcionalidades

• Escaneamentos Agendados: Planeje ciclos de inventário regulares.
• Sobrescrita vs. Enriquecimento: Configure regras para o comportamento de atualização.
• Resolução de Conflitos: Revisão manual ou priorização automática de dados antigos vs. novos.

---

4. Triggers em Definições de CI

• Triggers
  • Disparam ações em mudanças de campo (ex: Notificação, Auto-Atribuição)
  • Configuração diretamente em YAML sob VersionTrigger ou via script

VersionTrigger:
  - DefinitionUpdate
  - ValueUpdate

• Casos de Uso

  • Após a alteração de um número de série, atualizar automaticamente o log de inventário
  • Enviar lembrete por e-mail ao expirar a data de um certificado

---

5. VersionTriggers

• VersionTrigger: Controla em quais eventos uma nova versão de CI é criada

• Valores Comuns

  • NameUpdate
  • ConfigItemCreate
  • ValueUpdate
  • DefinitionUpdate

VersionStringModule: Incremental
VersionTrigger:
  - ConfigItemCreate
  - ValueUpdate

Benefício

Histórico de versões de todas as alterações para rastreabilidade e conformidade de auditoria.

---

6. Campos de Script (ScriptTemplateToolkit)

• Campos Calculados: Soma, média, blocos de texto dinâmicos
• Sintaxe: 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'

Cenários de Uso

• Valores Cumulativos (ex: memória total)
• Cálculos de Status (ex: "crítico" em certos limites)
• Geração de Texto (ex: descrições de ativos com placeholders)

---

7. Unindo Automação e Interfaces

1. Importações Automatizadas: Combine jobs REST com importação CSV em cron jobs.
2. Discovery + Trigger: Detecte novos dispositivos e inicie a criação de CI automaticamente.
3. Relatórios: Use campos de script e histórico de versões para relatórios automatizados via API.

---

Com esses mecanismos, os processos podem ser integrados perfeitamente na OTOBO-CMDB, garantindo a qualidade dos dados e minimizando tarefas manuais de rotina.