Importação, Exportação & Automação no OTOBO-CMDB

O 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 por meio de APIs REST e SOAP

• API REST

  • Operações CRUD em classes de CI e DynamicFields
  • Cargas JSON: integração simples e leve
  • Autenticação: baseada em token ou autenticação básica

• API SOAP

  • Sistemas legados e funcionalidade profunda
  • Cargas XML com descrições WSDL
  • Sessões com estado e métodos abrangentes para links de CI

Melhores Práticas

1. Processamento em Lotes: Importe dados em lotes para evitar timeouts.
2. Tratamento de Erros: Verifique códigos de retorno e logs („SysLog“).
3. Limitação de Taxa: Atente para os limites da API para evitar bloqueios.

---

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

• Importação/Exportação CSV

  • Mapeamento de campos: nomes de colunas → nomes de DynamicField
  • Separador, conjunto de caracteres e cabeçalho configuráveis
  • Atualização em massa para CIs existentes por meio de atributo de chave (por exemplo, nome ou ID)

• Importação/Exportação XML

  • Estruturas complexas e campos aninhados
  • Mapeamento por meio de folhas de estilo XSLT possível
  • Uso em clientes SOAP e ferramentas de terceiros

Fluxo de Trabalho

1. Gerar Modelo: Exporte primeiro um exemplo de CSV/XML.
2. ** Enriquecer Dados:** Ajuste valores e valide localmente.
3. Iniciar Importação: Por meio da interface do agente ou script CLI.
4. Verificar Resultado: Verifique logs para linhas de erro e avisos.

---

3. Auto-Discovery & Sincronização

• Varredura de Rede: Detecção de redes IP, dispositivos e serviços
• Descoberta Baseada em Agente: Agentes locais relatam detalhes do sistema para a CMDB
• Integração de Ferramentas Externas: Ansible, Puppet, SCCM, Nagios, etc.

Recursos

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

---

4. Gatilhos em Definições de CI

• Gatilhos
  • Dispare ações em caso de alterações de campo (por exemplo, notificação, auto-assign)
  • Configuração direta em YAML sob VersionTrigger ou por meio de script

VersionTrigger:
  - DefinitionUpdate
  - ValueUpdate

• Casos de Uso

  • Atualize automaticamente o log de inventário após alterar um número de série
  • Envie um lembrete por e-mail quando um certificado expirar

---

5. VersionTriggers

• VersionTrigger: Controla quando uma nova versão de CI é criada

• Valores Comuns

  • NameUpdate
  • ConfigItemCreate
  • ValueUpdate
  • DefinitionUpdate

VersionStringModule: Incremental
VersionTrigger:
  - ConfigItemCreate
  - ValueUpdate

Vantagem

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, textos 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 Acumulados (por exemplo, armazenamento total)
• Cálculos de Status (por exemplo, "crítico" em certos limites)
• Geração de Texto (por exemplo, descrições de ativos com espaços reservados)

---

7. Automação e Interfaces Integradas

1. Importações Automáticas: Combine trabalhos REST com importação CSV em jobs Cron.
2. Descoberta + Gatilho: 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, é possível integrar processos de forma contínua no OTOBO-CMDB, garantir a qualidade dos dados e minimizar tarefas manuais rotineiras.