A ObjectScript pode parecer apenas mais uma linguagem de programação, mas aqui está a reviravolta:

Seu código pode viver para sempre (sim, mesmo depois que você tiver passado para outro projeto). É por isso que é importante mantê-lo organizado, fácil de ler e seguro contra bugs misteriosos.

(Um guia para iniciantes para manter seu código limpo, amigável e à prova de futuro)

Bem-vindo à selva do ObjectScript, onde seu código pode ter escopo global e natureza persistente. Vamos manter as coisas limpas, legíveis e resistentes a bugs.

 1️⃣Nomeie como se fosse sério

Variáveis e globais devem ser nomeadas como se tivessem um perfil no LinkedIn.
Pule o x, y, z; use patientID, invoiceTotal, ^MyApp("Users",...).

Set patientID = 1023
Set ^Hospital("Patients",patientID,"Name") = "Marshmallow"

💡 Por que: Quando você revisitar isso em 6 meses, “Marshmallow” ainda fará sentido, ^H(1,"N") não.

 2️⃣ Conscientização sobre o aquecimento global  🌍

Globais são poderosas, mas não jogue dados nelas como se fosse uma cesta de roupa suja.
Prefixe com o nome do seu aplicativo para evitar colisões.
Mantenha a ordem de sua chave lógica: a maior categoria primeiro, os detalhes por último.

Set ^PetStore("Cats","Persian",1,"Name") = "Luna"

💡Dica: Se você não rotularia uma caixa como “Coisas”, não nomeie uma global ^DATA.

 3️⃣ O tamanho do método importa 🐹

Se o seu método for mais longo que a paciência de um hamster, divida-o.
Métodos pequenos e focados são mais fáceis de testar, reutilizar e manter.

ClassMethod GetPatientName(patientID As %Integer) As %String
{
    Quit ^Hospital("Patients",patientID,"Name")
}

 4️⃣ Pegue esses erros sorrateiros 🎣

Não deixe seu código ter um ataque de nervos em produção. Embrulhe operações perigosas em Try/Catch.

Try {
    Write ^Hospital("Patients",9999,"Name")
}
Catch ex {
    Write "Error: ", ex.DisplayString(), !
}

💡Não deixe seu código ter um ataque de nervos em produção. Embrulhe operações perigosas em Try/Catch.

 5️⃣ Comente como se você se importasse 💌

Comentários são cartas de amor para o seu eu futuro. Mantenha-os curtos, relevantes e atualizados.

// Assign the patients therapy cat
Set ^Hospital("Patients",patientID,"Pet") = "Mittens"

Bons hábitos de codificação vão além de qualquer linguagem de programação; eles são universais. Talvez você seja um campeão de nomes de variáveis claros, um mestre em tratamento de erros sólido como uma rocha, um crente em desenvolvimento orientado a testes, ou você tem um pequeno truque peculiar que faz seu código brilhar. Seja o que for, compartilhe! Publique suas melhores práticas, lições aprendidas ou sabedoria em pequenas porções nos comentários e vamos criar um tesouro de dicas para ajudar tanto iniciantes quanto desenvolvedores experientes a escrever código mais limpo, inteligente e eficiente. 🚀