Quando precisamos executar tarefas pontuais, manipular registros em massa ou testar scripts rapidamente no ServiceNow, uma das ferramentas mais poderosas (e perigosas) é o Background Script.
Neste artigo, você vai entender o que é o Background Script, para que ele serve, como usá-lo com segurança e ver exemplos práticos de uso.
O Que É o Background Script?
O Background Script é uma funcionalidade dentro do módulo Scripts – Background do ServiceNow. Ele permite a execução de scripts em tempo real diretamente no servidor, utilizando JavaScript com a API do Glide.
É como um “console de desenvolvedor” para tarefas administrativas, testes rápidos e operações em massa.
Para Que Serve?
✅ Casos comuns de uso:
- Atualizar registros em massa.
- Corrigir dados incorretos diretamente no banco.
- Testar trechos de código usando GlideRecord.
- Executar tarefas que não precisam de interface, como criação de registros técnicos.
- Realizar verificações ou buscas avançadas.
Benefícios
🔹 Rápido e direto
Ideal para tarefas pontuais que seriam demoradas via interface.
🔹 Flexível
Permite usar todo o poder da API de servidor (GlideRecord, GlideDateTime, etc.).
🔹 Excelente para testes
Você pode testar scripts rapidamente antes de colocá-los em Business Rules, Scripts Includes ou Flows.
Exemplo Prático
🎯 Exemplo: Atualizar o campo “active” para false em todos os usuários com o email vazio:
javascriptCopiarEditarvar gr = new GlideRecord('sys_user');
gr.addQuery('email', '');
gr.query();
while (gr.next()) {
gr.active = false;
gr.update();
}
Esse script busca todos os usuários sem email e os desativa.
⚠️ Cuidados Importantes
O Background Script executa ações diretamente no banco de dados. Não há botão de desfazer.
Recomendações:
- Sempre teste primeiro em um ambiente de desenvolvimento.
- Use
gr.setLimit(x)para testar com poucos registros. - Comente partes do script até ter certeza do que será executado.
- Nunca rode scripts desconhecidos ou não testados em produção.
Dicas de Boas Práticas
- Comece com um
gs.info()para verificar a lógica sem fazer alterações. - Use
gr.autoSysFields = false;se quiser evitar que campos padrão comoupdatedsejam alterados. - Documente scripts utilizados no ambiente para rastreabilidade.
Conclusão
O Background Script é uma ferramenta poderosa para administradores e desenvolvedores ServiceNow. Quando usada com responsabilidade, ela agiliza tarefas do dia a dia e dá liberdade para testar e corrigir dados rapidamente.
Mas lembre-se: com grande poder, vem grande responsabilidade. Sempre teste em ambientes seguros antes de aplicar mudanças em produção.
No responses yet