Exportando dados de configuração de Interoperabilidade para CSV

Ao trabalhar com a Interoperabilidade da InterSystems (Iris / Health Connect / Ensemble), os dados de configuração costumam estar distribuídos entre vários itens de produção: serviços, processos, operações, adaptadores e suas configurações.

Uma necessidade operacional ou de segurança comum é responder a perguntas como:

• Quais interfaces fazem referência a caminhos do sistema de arquivos?
• Onde estão configurados diretórios, compartilhamentos de rede ou caminhos absolutos?
• É possível auditar ou documentar rapidamente essas informações em todas as minhas produções?

A utilidade ObjectScript abaixo resolve exatamente esse problema, exportando as configurações selecionadas para um arquivo CSV.

Este script:

1. Percorre todos os namespaces existentes
2. Consulta todos os itens de configuração de Interoperabilidade (Ens_Config.Item) em todos os namespaces
3. Itera pelas Configurações de cada item
4. Extrai caminhos de sistema de arquivos/URLs (valores que contêm :, /, ou \)
5. Grava os resultados em um arquivo CSV, agrupados por Categoria
6. Produz uma saída adequada para auditoria, que pode ser aberta no Excel ou compartilhada com as equipes de operações/segurança

Casos de uso comuns

Você deve usar esta ferramenta quando precisar:

• 🔍 Auditar o uso do sistema de arquivos em todas as produções
• 🛡 Revisar a exposição de segurança (caminhos locais, compartilhamentos de rede, conexões de banco de dados)
• 📄 Documentar a configuração para migrações, atualizações ou planejamento de recuperação de desastres (DR)
• 🔄 Comparar ambientes(DEV vs TEST vs PROD)
• 🧹 Limpar paths legados ou não utilizados

Isso é especialmente útil em grandes instâncias com várias produções que utilizam muitas interfaces e adaptadores.

Formato de saída

O CSV gerado contém as seguintes colunas:

Namespace, Category, Item Name, Class Name, Property Name, Value

Alem disso:

• Os itens de configuração são agrupados por Categoria
• Apenas os caminhos de configurações relevantes são exportados — você pode alterar facilmente a lógica para exportar usando o nome da configuração (como "DSN" para conexões SQL) ou qualquer outro valor de configuração
• Fácil de filtrar e analisar no Excel
• Execute a ferramenta a partir do terminal e forneça o parâmetro com o caminho completo e o nome do CSV

por exemplo:

> do ##class(Test.Properties).GetData("c:\temp\loop.csv")

Exemplo de CSV gerado:

Notas e Dicas

• 🧪Teste primeiro em um ambiente que não seja PROD se você não tiver certeza sobre as permissões
• 📂 Certifique-se de que o diretório de destino existe e que é gravável pelo IRIS/Health Connect
• 🔎 Você pode facilmente estender a lógica para:
  • Exportar propriedades adicionais
  • Filtrar por categoria ou classe
  • Mascarar valores sensíveis (senhas)
  • Alterar a lógica para dados relevantes

Se você estender ou melhorar a ferramenta, sinta-se à vontade para compartilhar suas melhorias com a comunidade.