Do "Ops!" ao "Aha!" - Evitando erros de principiante no ObjectScript

Começar a usar ObjectScript é realmente empolgante, mas também pode parecer um pouco estranho se você está acostumado com outras linguagens. Muitos iniciantes tropeçam nos mesmos obstáculos, então aqui estão alguns "pegadinhas" que você vai querer evitar. (Além de algumas dicas amigáveis para contorná-las.)

---

Nomear Coisas Aleatoriamente

Todos nós já fomos culpados de nomear algo como Test1 ou MyClass apenas para seguir em frente rapidamente. Mas quando seu projeto cresce, esses nomes se tornam um pesadelo.

➡  Escolha nomes claros e consistentes desde o início. Pense nisso como deixar um rastro para o seu "eu" do futuro e para seus colegas de equipe.

---

Confundir Globais e Variáveis

Globais (^GlobalName) podem ser confusas no começo. Eles não são apenas variáveis normais. Eles vivem no banco de dados e persistem mesmo depois que seu código para de rodar.

➡ Use-os apenas quando você realmente precisar de dados persistentes. Para todo o resto, use variáveis locais. (Isso também economiza armazenamento.)

---

Esquecer Transações

Imagine atualizar um registro de paciente e sua sessão travar na metade. Sem uma transação, você fica com dados incompletos.

➡ Envolva atualizações importantes em TSTART/TCOMMIT. É como apertar "salvar" e "desfazer" ao mesmo tempo.

---

Construir SQL em Strings

É tentador simplesmente colocar SQL em strings e executá-lo. Mas isso rapidamente se torna confuso e difícil de depurar.

➡ Use SQL embutido. É mais limpo, mais seguro e mais fácil de manter.

EXEMPLO:

❌ Construindo SQL em Strings

Set id=123
Set sql="SELECT Name, Age FROM Patient WHERE ID="_id
Set rs=##class(%SQL.Statement).%ExecDirect(,sql)

✅ Usando SQL Embutido

&SQL(SELECT Name, Age INTO :name, :age FROM Patient WHERE ID=:id)
Write name_" "_age,!

---

Ignorar o Tratamento de Erros

Ninguém gosta de ver seu aplicativo travar com uma mensagem enigmática. Isso geralmente acontece quando o tratamento de erros é ignorado.

➡Envolva operações arriscadas em TRY/CATCH e forneça a si mesmo mensagens de erro significativas.

---

Deixar de Usar Ferramentas Melhores

Sim, o terminal funciona. Mas se você só codifica por lá, está perdendo muito.

➡ Use o VS Code com a extensão ObjectScript. A depuração, o autocompletar e o destaque de sintaxe tornam a vida muito mais fácil.

---

Reinventar a Roda

Novos desenvolvedores frequentemente tentam escrever suas próprias utilidades para registro ou manipulação de JSON, sem perceber que o ObjectScript já tem soluções integradas.

➡ Explore a %Library e os objetos dinâmicos antes de criar os seus.

---

Escrever "Código Misterioso"

Todos nós já pensamos: "Vou me lembrar disso depois."

⚠️SPOILER: VOCÊ NÃO VAI!

➡ Adicione comentários curtos e claros. Mesmo uma única linha explicando por que você fez algo ajuda muuuito.

---

 

Considerações Finais : )

Aprender ObjectScript é como aprender qualquer outra língua nova. É preciso um pouco de paciência, e você cometerá erros ao longo do caminho. O segredo é reconhecer essas armadilhas comuns cedo e construir bons hábitos desde o início. Dessa forma, em vez de lutar contra a linguagem, você realmente aproveitará o que ela pode fazer. :)