#InterSystems IRIS

Há algumas semanas eu estava tentando entender por que uma mensagem enviada por uma Business Service não chegava do jeito esperado na Business Operation. No Management Portal eu conseguia ver a mensagem entrando na fila e, mais tarde, uma entrada no Event Log dizendo que algo tinha saído errado. Entre esses dois pontos, porém, eu não enxergava nada. A mensagem passava pela Business Process, sofria alguma transformação no meio do caminho, e o resultado final não batia com o que eu esperava. Eu simplesmente não sabia em qual dos três componentes o problema estava.

Introdução

Na semana passada eu estava criando a terceira Business Operation do mesmo projeto de integração e parei no meio do código com uma sensação familiar. Eu já tinha escrito aquele trecho antes. A montagem dos headers HTTP (Content-Type, Authorization com o token) e o parsing da resposta JSON apareciam praticamente idênticos nas três classes. Só mudava o endpoint e o corpo da requisição.

Em C#, essa situação tem solução óbvia para mim. Eu extrairia esse comportamento para uma classe de serviço e injetaria ela onde precisasse, ou criaria uma classe base com os métodos comuns.

Introdução

Em ambientes de interoperabilidade na área da saúde, o InterSystems Health Connect normalmente contém componentes críticos, como produções, processos de negócio, operações, serviços, classes utilitárias, rotinas e outros artefatos ObjectScript. Tradicionalmente, muitas implantações desses componentes são realizadas manualmente, por meio da cópia de classes, importação de XML ou utilização de ferramentas administrativas disponíveis no portal de gerenciamento.

Uma das principais diferenças é o sistema de plugins. No VS Code, tudo é construído em torno de extensões. Por exemplo, para desenvolvimento InterSystems, existe o "InterSystems ObjectScript Extension Pack", que inclui as ferramentas essenciais. Com esse plugin você pode se conectar a servidores InterSystems, navegar pelo código, editar classes, compilar e trabalhar com ObjectScript diretamente do VS Code.

E não é só para ObjectScript. O VS Code também suporta Git, Docker, clientes REST, YAML, JSON, Python e muitas outras tecnologias.

Olá Comunidade,

As ferramentas de Inteligência Artificial estão se tornando parte do dia a dia de muitos desenvolvedores, e estou curioso para saber como outras pessoas estão usando essas ferramentas dentro do ecossistema InterSystems.

Vocês estão usando IA para:

- Gerar código ObjectScript?
- Resolver erros?
- Escrever documentação?
- Escrever documentação?
- Aprender novas tecnologias InterSystems mais rápido?

Tenho percebido que a IA pode ser uma ferramenta útil de produtividade, mas estou interessado em ouvir experiências reais da comunidade.

Este artigo apresenta uma abordagem simples para ajustar hiperparâmetros de modelos de machine learning de forma automática e eficiente utilizando o Optuna como framework de otimização. Exploramos como utilizar tanto as opções nativas de armazenamento do Optuna quanto o InterSystems IRIS como backend de banco de dados para acompanhar o progresso das buscas por hiperparâmetros. Também mostramos como o MLflow pode ser usado para monitorar experimentos e gerenciar modelos por meio de sua interface de rastreamento e registro de modelos.

Esta página não pode ser encontrada Nenhuma página da Web foi encontrada para o endereço Web:..... HTTP ERROR 404

Criei uma classe herdando de %CSP.REST, defini o UrlMap com uma rota GET e configurei a aplicação web no Management Portal

A versão 25.3 do InterSystems Reports já está disponível no site InterSystems Software Distribution, na seção Componentes. O software é denominado InterSystems Reports Designer e InterSystems Reports Server e está disponível para sistemas operacionais Mac OSX, Windows e Linux.

Não se deixe enganar pelo número da versão secundária - há muita coisa incluída nesta versão. Inclui uma interface de usuário atualizada – linhas mais limpas e cores mais frescas no “modo Claro” e a capacidade de voltar ao “modo Clássico” em seu perfil de usuário.

Eu tinha uma mensagem chegando numa Production e três destinos possíveis. Dependendo de um campo do request, ela precisava seguir para uma Business Operation diferente. Abri o meu Business Process, escrevi um IF, um ELSEIF e um ELSE, apontei cada caminho para a operação certa, compilei e testei. Funcionou de primeira. A dúvida veio alguns minutos depois, quando parei para olhar o que eu tinha feito e me perguntei se aquela decisão deveria mesmo morar ali dentro.

Foi essa pergunta que acabou virando um post na comunidade, e foi a partir das respostas que recebi que escrevi este artigo.

Introdução

No .NET, serializar um objeto para JSON virou para mim um problema resolvido. Eu decorava a classe com alguns atributos, chamava JsonSerializer.Serialize ou JsonConvert.SerializeObject, e seguia em frente. Raramente eu parava para pensar no que acontecia embaixo.

Quando comecei a mexer com integrações no IRIS durante o estágio na Shift, encontrei o %JSON.Adaptor e tive uma sensação familiar: parecia o mesmo atalho. Você faz a classe herdar de , ganha %JSONExport() e , e o objeto vira JSON. A pergunta que não saiu da minha cabeça foi outra: até onde isso vai?

Tenho uma Business Operation chamando um método SOAP via InvokeMethod, passando vários parâmetros individuais. A chamada retornou $$$OK sem nenhum SoapFault, mas o objeto de saída voltou indefinido, causando um erro quando tentei utilizá-lo.

Descobri que o método do WebClient gerado havia sido refatorado para aceitar um único objeto de requisição em vez de parâmetros individuais - então minha chamada já não correspondia mais à assinatura.

Introdução

Estava configurando uma Business Operation dentro de uma Production no Portal de Gerenciamento, no meu estágio. Preenchi host, porta, um caminho de arquivo e o endpoint de um serviço externo. Tudo certo, a Production subiu. O problema veio um minuto depois, quando pensei em levar aquilo para o ambiente de teste. No .NET, esse pensamento nem chega a virar pergunta: eu teria um appsettings.Test.json com os valores de teste e pronto. Fui procurar o equivalente no IRIS e não achei.

Olá Comunidade!

Temos o prazer de compartilhar o primeiro vídeo da série "Tutoriais do InterSystems Instruqt" em nosso canal do YouTube, InterSystems Developers:

⏯ Modelos de Dados do InterSystems IRIS - Guia passo a passo do InterSystems Instruqt

Quando comecei a trabalhar com Productions no InterSystems IRIS, achei que entendia bem os papéis de cada componente. O Business Service recebe a mensagem do mundo externo. O Business Process coordena o fluxo. O Business Operation entrega o resultado. Parecia simples.

Aí veio a primeira dúvida real: se eu preciso validar uma mensagem antes de rotear, onde essa validação deve ficar? No Business Service, antes de enviar para frente? Ou no início do Business Process, que é quem vai decidir o que fazer com ela?

Na época em que eu trabalhava como Engenheiro de Suporte ao Desenvolvedor no Worldwide Response Center (WRC) da InterSystems, ocasionalmente eu recebia casos envolvendo grandes acúmulos (backlogs) de mensagens em um ambiente de produção. 

O cliente descobria que um subconjunto das mensagens enfileiradas não era mais útil e fazia uma pergunta semelhante a esta:

Existe uma prática recomendada (best practice) consagrada para abortar em massa mensagens na fila de um componente específico que correspondam a um conjunto específico de critérios?

Durante minhas primeiras semanas estudando IRIS, cheguei a um momento que mudou bastante minha forma de olhar para essa plataforma. Eu estava explorando uma classe persistente simples, daquelas que a gente cria seguindo qualquer tutorial introdutório, e decidi abrir o Management Portal para ver como os dados estavam armazenados de fato. Esperava encontrar algo parecido com uma tabela do SQL Server, com linhas e colunas bem definidas. Em vez disso, encontrei uma global.

Para quem vem do modelo relacional, como é o meu caso, isso quebra um pouco a intuição.

Olá pessoal!

Suponha que uma nova versão da sua incrível solução de software construída sobre o IRIS precise de alguma mudança de persistência: alguns dados precisam ser convertidos, algumas classes recebem novas propriedades ou até são renomeadas, e alguns dados devem ser pré-populados para classes persistentes recém-introduzidas, para manter toda a base de dados da aplicação consistente.

Quais são as abordagens de vocês?

Scripts baseados em SQL? ObjectScript, ou Python? Para as duas direções da migração, up e down?

Vocês geram isso automaticamente com Claude/Codex?

Olá a todos. 

Após tentar executar métodos Python no Docker intersystemsdc/irishealth-community, que agora não permite executar nenhum método com Python, decidi deixar essa versão e começar a trabalhar com o [containers.intersystems.com/intersystems/iris-community](https://containers.intersystems.com/intersystems/iris-community). 

Neste ambiente os métodos Python funcionam, o que já foi um passo bem grande. Estou tentando importar minhas bibliotecas com pip install -r requirements.txt

A construção e implementação bem-sucedidas de agentes de IA para atender a diversos casos de uso no setor de saúde dependem de dados e APIs de alta qualidade, governança eficaz e gerenciamento eficiente. O servidor InterSystems IRIS FHIR oferece tudo isso e também é fluente em Python, vetores e interoperabilidade. Combinado com um LLM robusto, pacientes, médicos, cuidadores e gestores obtêm acesso à tecnologia de ponta para saúde pessoal e pública.

Se o seu código em Embedded Python chamar a biblioteca tkinter (que é utilizada por várias bibliotecas de geração de gráficos, incluindo a matplotlib), você poderá se deparar com o seguinte erro:

<THROW> *%Exception.PythonException <CLASS DOES NOT EXIST> 230 ^^0^DO ##CLASS(User.Test).Test() 
<class '_tkinter.TclError'>: Can't find a usable init.tcl in the following directories:

c:/intersystems/irispy/lib/python/lib/tcl8.6
c:/intersystems/irispy/lib/tcl8.6
c:/intersystems/lib/tcl8.6
c:/intersystems/irispy/library
c:/intersystems/library
c:/intersystems/tcl8.6.9/library
c:/tcl8.6.9/library

This probably means that Tcl wasn't installed properly.

Introdução

Quando comecei a trabalhar com InterSystems IRIS no meu estágio, o primeiro obstáculo não foi o banco de dados nem a arquitetura da plataforma. Foi a linguagem em si. Olhei para o ObjectScript (COS) pela primeira vez e não consegui ler o que estava na tela. Parecia familiar o suficiente para me dar confiança, e diferente o suficiente para me confundir logo em seguida.

Venho do C# e do .NET, com foco em arquitetura em camadas, Windows Forms e SQL Server.

Bem-vindo ao próximo capítulo da minha série sobre CI/CD, onde discutimos possíveis abordagens para o desenvolvimento de software com tecnologias InterSystems e GitLab. Hoje, continuamos falando sobre Interoperabilidade, especificamente sobre o monitoramento de implantações de Interoperabilidade. Se você ainda não fez isso, configure o Alerting para todas as suas produções de Interoperabilidade para receber alertas sobre erros e sobre o estado geral da produção.

Inactivity Timeout é uma configuração comum a todos os Business Hosts de Interoperabilidade.

Assim como no pacote anterior, tudo roda a partir de uma página CSP. O código é todo escrito no estilo clássico de CSP, usando InterSystems ObjectScript, JavaScript e HTML.
Além do gráfico, você também obtém números concretos coletados em tempo real da sua instância local ou de instâncias remotas que também tenham o pacote instalado. 

O resultado final

As etapas do processamento

• Uma página CSP é chamada pela sua URL
• No método OnPreHTTP
  • A System Query preenche a tabela temporária a partir do %SYS
  • Se o parâmetro de URL correto for fornecido: 

No artigo anterior, usamos o pyprod para criar componentes de produção enquanto dependíamos da interface de usuário (UI) para a configuração da produção. Essa mesma produção agora pode ser definida inteiramente em Python:

from intersystems_pyprod import Production, ServiceItem, ProcessItem, OperationItem

iris_package_name = "HelloWorld"

class MyProduction(Production):
    services = [
        ServiceItem(
            "MyServiceName",
            "HelloWorld.MyService",
            host_settings={"target": "MyProcessName"},
        )
    ]
    processes = [
        ProcessItem(
            "MyProcessName",
            "HelloWorld.MyProcess",
            host_settings={"target": "MyOperationName"},
        )
    ]
    operations = [
        OperationItem("MyOperationName", "HelloWorld.MyOperation")
    ]

O IRIS 2026.1 trouxe as Partitioned Tables (tabelas particionadas) como uma nova opção para grandes conjuntos de dados. É uma excelente melhoria, pois padroniza esse recurso de forma nativa.

No entanto:
Já era possível atingir esse mesmo objetivo antes, atendendo aos requisitos e deixando espaço para a criatividade. Uma abordagem menos elegante, com um pouco mais de código e menos automatismos.

Ao desenvolver produções de interoperabilidade, pode ser útil ter configurações fora de um Business Host. O motivo principal é quando você precisa que uma configuração afete vários Business Hosts diferentes e quer garantir que o valor seja o mesmo. Embora as Configurações Padrão do Sistema (System Default Settings - SDS) possam ser usadas para propagar configurações para Business Hosts, elas podem ser alteradas ao sobrescrever o valor no nível do BH (embora a vantagem das configurações de Business Host definidas via SDS seja que elas não exigem código personalizado, o que a nossa abordagem atual exige).

Outro motivo é quando você precisa afetar partes da configuração do Business Host que não são propriedades de configuração padrão (PoolSize, Enabled, etc.).

Nós adicionaremos uma configuração de ambiente (env setting) a uma produção.

Olá,

Sou eu de novo 😁, recentemente estou trabalhando na geração de alguns dados fictícios de pacientes para fins de teste com a ajuda do Chat-GPT usando Python. E, ao mesmo tempo, gostaria de compartilhar minha curva de aprendizado. 😑

Antes de mais nada, construir um serviço de API REST personalizado é fácil estendendo a classe %CSP.REST. Criando um Serviço REST Manualmente Vamos começar! 😂

1. Crie uma classe datagen.restservice que estende %CSP.REST

ClassExtends%CSP.REST

2. Adicione uma função

Geralmente, parece haver um uso generoso de ClassMethods no código ObjectScript. Espero que minhas próprias experiências não sejam representativas, mas aposto que são. Perdoe-me por revelar o final deste artigo, mas em resumo: não os use. A menos que você consiga apresentar um argumento bastante convincente de que precisa, simplesmente nunca os use.¹

O que é um ClassMethod? Em uma classe ObjectScript, você pode definir métodos de duas maneiras diferentes: em um Method (método de instância), você deve instanciar uma instância da classe para chamar o método; e em um ClassMethod (método de classe), você pode chamar o método sem instanciar a classe. Claro que, em um ClassMethod, você não tem acesso a nenhuma propriedade do objeto (porque não há objeto), mas pode acessar globais (afinal, elas são globais) e Parâmetros (que são constantes da classe).