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. 🚀