--- sourceDocument: Yokohama Administração da Now Platform sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/platform-administration Release : - yokohama ft:locale : - pt-BR ft:publication_title : - Yokohama Administração da Now Platform ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Executar automaticamente um script escolhido por você # Executar automaticamente um script escolhido por você {#ariaid-title1} * Versão de lançamento: Yokohama * * Atualizado 30 de jan. de 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 min. de leitura Programe scripts condicionais e não condicionais. Se a Separação de domínio estiver instalada na instância, você também poderá selecionar, filtrar, classificar e programar scripts com base nos domínios atribuídos. ## Antes de Iniciar Função necessária: administrador ## Por Que e Quando Desempenhar Esta Tarefa O exemplo a seguir é um script condicional. Ele executa o trabalho agendado somente se houver incidentes ativos com mais de 30 dias. // Only run this Scheduled Job if there are active Incidents over 30 days old var ga = new GlideAggregate('incident'); ga.addAggregate('COUNT'); ga.addQuery('active', 'true'); ga.addQuery('sys_created_on', '<', gs.daysAgo(30)); ga.query(); ga.next(); ga.getAggregate('COUNT') !== '0' ## Procedimento 1. Navegar até TudoDefinição do SistemaTrabalhos agendados. 2. Clique em Novo. 3. Selecione Execute automaticamente um script de sua escolha . 4. No formulário, preencha os campos. {#t_ScheduleAScriptExecution__t_ScheduleScriptExecution__entry__2} | Campo | Descrição | |-|-| | Nome | Nome que identifica este trabalho agendado. | | Ativo | Opção que indica que o trabalho agendado está ativo e deve ser executado na data e hora especificadas. | | Aplicação | Nome da aplicação que contém o script. Global aparece se o script estiver no escopo global. | | Condicional | Opção para habilitar a execução do trabalho agendado se determinadas condições forem atendidas no script associado. | | Condição | Script condicional que determina se um trabalho agendado deve ser executado. A última expressão do script deve ser avaliada como um valor booliano (verdadeiro/falso). Esta caixa de texto aparecerá somente se você selecionar Condições de uso . Aviso: Scripts condicionais para e-mails de relatório agendados e. Performance Analyticsos trabalhos de coleta de dados são executados na sandbox. Portanto, definições de função não são permitidas. Algumas chamadas de API e palavras-chave também não são permitidas. Para obter mais informações, consulte [Propriedade da sandbox de script](https://www.servicenow.com/docs/access?context=r_ScriptSandboxing&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). Após o upgrade, os trabalhos com scripts condicionais que contêm esses componentes de API não permitidos terminam com erros. | | Executar | Intervalo de tempo a ser usado para executar o trabalho agendado: * Diariamente : É executado diariamente, em um horário designado. * Semanalmente : Executa semanalmente, em um horário e dia designados da semana. * Mensal : Executa mensalmente, em uma hora e dia designados do mês. * Periodicamente : É executado em um intervalo de repetição designado. * Uma vez : Executa somente para uma única ocorrência. * Sob demanda : É executado imediatamente sob demanda. * Calendário comercial: Início da entrada : É executado nas datas de entrada iniciais do calendário comercial selecionado no Calendário comercial campo. Um trabalho agendado é executado para a data de início de cada uma das entradas de negócios que você definiu para o calendário comercial. Por exemplo, se o calendário comercial representar um ano fiscal e a data de início de cada entrada for um mês fiscal, o trabalho agendado será executado no primeiro dia de cada mês. {#t_ScheduleAScriptExecution__p_nyg_nfg_h1c} * Calendário comercial: Término da entrada : É executado para a data de término do calendário comercial selecionado no Calendário comercial campo. Esta seleção é executada da mesma maneira que Calendário comercial: Início da entrada , mas para as datas de término das entradas de calendário comercial associadas. Nota: Quando você seleciona Calendário comercial: Início da entrada ou Calendário comercial: Término da entrada , você pode aplicar um fator de deslocamento para programar a execução do trabalho antes ou depois do intervalo de tempo do calendário comercial selecionado. Se você selecionar um calendário comercial e todos os períodos do calendário comercial estiverem no passado, o trabalho nunca será executado, pois esta é uma configuração inválida. Para saber mais, consulte Tipo de deslocamento e. Deslocamento campos. Para saber mais sobre como criar e usar calendários comerciais e definir entradas de calendário comercial, consulte [Criando calendários de negócios](https://servicenow-prod.fluidtopics.net/QwniUzrtqS9QvXLVzjqfSg "Crie calendários de negócios no Now Platformpara que você possa agendar eventos para seus usuários e acompanhar o tempo deles em todas as aplicações. Você define cronogramas e calendários de todos os tipos, incluindo calendários fiscais, no menu Calendário comercial.")e. [Defina entradas do calendário comercial](https://servicenow-prod.fluidtopics.net/CcDGK_yVOTM6aE7XnU~jSg#define-business-calendar-entries "Crie registros de entrada do calendário comercial que definem os períodos de tempo individuais que compõem um calendário comercial. Você cria uma entrada de calendário comercial para cada intervalo de tempo individual no calendário."). {#t_ScheduleAScriptExecution__ul-run-sched-job} | | Dia | Dia em que o trabalho agendado deve ser executado. * Se Executar está definido como Semanalmente , selecione o dia da semana. Por exemplo, selecione Quarta-feira. * Se Executar está definido como Mensal , selecione o dia do mês. Por exemplo, selecione 25 para o 25º dia do mês. {#t_ScheduleAScriptExecution__ul-day-sched-job}Este campo será exibido somente se você selecionar Mensal ou Semanalmente em Executar campo. | | Intervalo de repetição | Duração do intervalo de repetição para cada execução de trabalho agendada. Insira a duração no número de dias, horas ou minutos. Por exemplo: * Para executar o trabalho agendado a cada quatro dias, insira 04 em Dias campo. * Para executá-lo a cada 26 horas, insira 26 em Horas campo. * Se ele deve repetir em um intervalo de 13:30:25, insira 13 em Horas e insira 30 e. 25 nos dois campos não rotulados após ele. {#t_ScheduleAScriptExecution__ul_bmk_m2b_njb} | | Fuso horário | Fuso horário a ser usado com Tempo entrada do campo quando você especifica a hora em que o trabalho agendado deve ser executado. Selecione uma entrada de fuso horário: * -Nenhum- : Use o fuso horário padrão para o usuário conectado que está criando o trabalho agendado. Por exemplo, o trabalho agendado é executado às 04:45 horas, horário dos EUA/Pacífico, se for o fuso horário atribuído ao usuário e você inserir 16:45 em Tempo campo. {#t_ScheduleAScriptExecution__p_qyg_nfg_h1c} * Use o Fuso horário do sistema : Use o fuso horário padrão do sistema especificado para a instância em que ele é executado. Por exemplo, o trabalho agendado é executado às 10:15 horas, horário de Londres, se Europa/Londres for o fuso horário padrão do sistema para a instância, e você inserir 22:15 em Tempo campo. {#t_ScheduleAScriptExecution__p_ryg_nfg_h1c} * Fuso horário real. Por exemplo, o trabalho agendado é executado às 1:30 no fuso horário da Leste dos EUA, se você selecionar Leste/EUA e insira 13:30 em Tempo campo. {#t_ScheduleAScriptExecution__p_syg_nfg_h1c} {#t_ScheduleAScriptExecution__ul_zxv_cnb_njb} | | Hora | Hora do dia em que o trabalho agendado deve ser executado, expressa em horas, minutos e segundos em um relógio de 24 horas. A seleção que você faz no Fuso horário o campo determina o fuso horário desta entrada. | | Dia | Dia em que o trabalho agendado deve ser executado. * Se Executar está definido como Semanalmente , selecione o dia da semana. Por exemplo, selecione Quarta-feira. * Se Executar está definido como Mensal , selecione o dia do mês. Por exemplo, selecione 25 para o 25º dia do mês. {#t_ScheduleAScriptExecution__d1959e231}Este campo será exibido somente se você selecionar Mensal ou Semanalmente em Executar campo. | | Intervalo de repetição | Duração do intervalo de repetição para cada execução de trabalho agendada. Insira a duração no número de dias, horas ou minutos. Por exemplo: * Para executar o trabalho agendado a cada quatro dias, insira 04 em Dias campo. * Para executá-lo a cada 26 horas, insira 26 em Horas campo. * Se ele deve repetir em um intervalo de 13:30:25, insira 13 em Horas e insira 30 e. 25 nos dois campos não rotulados após ele. {#t_ScheduleAScriptExecution__d1959e272} | | Iniciando | Data e hora da primeira geração de trabalho agendado. Selecione a data e a hora do calendário. Este campo será exibido somente se você selecionar Periodicamente em Executar campo. | | Calendário comercial | Entrada de calendário comercial que você está usando para determinar a data de início ou término do calendário comercial do trabalho agendado. Este campo será exibido somente se você selecionar Entrada de negócios: Data de início ou Entrada de negócios: Data de término em Tempo campo. | | Tipo de desvio | Tipo de deslocamento de tempo, se houver, a ser aplicado ao calendário comercial selecionado para programar este trabalho: * Passado : Aplique um fator de deslocamento para programar a execução do trabalho antes do início do intervalo de tempo do calendário comercial selecionado. * Futuro : Aplique um fator de deslocamento para programar a execução do trabalho após o término do intervalo de tempo do calendário comercial selecionado. * --Nenhum-- : Não aplique um deslocamento de tempo ao programar este trabalho. {#t_ScheduleAScriptExecution__ul_dfj_ptw_5lb}A adição de um fator de deslocamento permite programar o trabalho para ser executado antes ou depois do intervalo de tempo formal definido no calendário comercial para os seguintes casos de uso: | | Deslocamento | Deslocamento de tempo, expresso em dias, horas, minutos e segundos, para aplicar ao calendário comercial selecionado para programar este trabalho. Por exemplo, se você quiser programar o trabalho para começar três dias, 14 horas, 10 minutos e 45 segundos antes da data de início do calendário comercial, execute as seguintes ações: * Selecione Passado em Tipo de deslocamento campo. * Insira 3 em Dias campo. * Insira 14 , 10 e. 45 em Horas campo. {#t_ScheduleAScriptExecution__ul_aty_1ww_5lb} . Dias de deslocamento e. Horas os campos serão exibidos somente se você selecionar Calendário comercial: Início da entrada ou Calendário comercial: Término da entrada em Executar campo, e. Passado ou Futuro em Tipo de deslocamento campo. | | Executar como \[Opcional\] | Selecione outro usuário para executar a execução do script. Configure o formulário para adicionar este campo se ele não estiver presente. | | Executar este script | Nome do script a ser executado na data e hora agendadas. Por exemplo, copie a lógica de script de uma regra de negócios ou chame uma inclusão de script. | [Tabela 1. Programe a execução do script] {#t_ScheduleAScriptExecution__t_ScheduleScriptExecution} 5. Se a Separação de domínio estiver instalada nesta instância, os seguintes campos também serão exibidos para selecionar, classificar e programar trabalhos por domínio. Nota: O plug-in Instalador de extensões de domínio - Suporte de domínio instala esses campos. Para saber mais, consulte [Solicitar separação de domínio](https://www.servicenow.com/docs/access?context=t_ActivateDomainSeparation&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). {#t_ScheduleAScriptExecution__table_m2n_yyf_tlb__entry__2} | Campo | Descrição | |-|-| | Iterador de domínio | Caixa de seleção que permite que este trabalho seja executado em vários domínios. Se selecionado, o. Tabela de origem do domínio e. Filtro de origem do domínio os campos são exibidos. | | Tabela de origem do domínio | Nome da tabela separada por domínio que é a origem dos domínios nos quais o trabalho agendado deve ser executado. Por exemplo, selecione Departamento (cmn_department) se você quiser usá-lo como a origem dos domínios atribuídos usados para programar scripts. O trabalho agendado determina esses domínios no campo sys_domain dos registros da tabela de origem. Para saber mais, consulte [Atribuição de domínio](https://www.servicenow.com/docs/access?context=c_DomainAssignment&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). Nota: É uma boa ideia criar uma tabela separada por domínio exclusivamente dedicada a domínios de fornecimento, a menos que você tenha um caso de uso que justifique o uso de um existente. Se você criar um novo, basta selecioná-lo usando este campo. | | Filtro de origem do domínio | Condição opcional que você pode especificar para filtrar os registros consultados na tabela de origem do domínio selecionada. 1. Selecione o campo a ser usado para filtrar registros. 2. Adicione condições de filtragem e operadores para restringir os critérios de seleção de domínio. Para saber mais, consulte [Filtros](https://www.servicenow.com/docs/access?context=c_Filters&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US). {#t_ScheduleAScriptExecution__ol_tbc_fck_vlb} | [ ] {#t_ScheduleAScriptExecution__table_m2n_yyf_tlb} O processamento a seguir ocorre ao programar um trabalho em uma instância separada por domínio: * Primeiro, consulta a tabela de origem do domínio selecionada. * Se você especificou uma condição em Filtro de origem do domínio aplica a condição de filtragem para restringir o conjunto resultante de registros. * Por fim, ele recupera sua lista de domínios exclusivos das colunas sys_domain desses registros. {#t_ScheduleAScriptExecution__ul_wnp_kff_vlb} 6. Clique em Atualizar para atualizar o trabalho agendado, Executar agora para executar o script agendado imediatamente, ou Excluir para excluir o trabalho. **Tarefas relacionadas** * [Criar um trabalho agendado](https://servicenow-prod.fluidtopics.net/P77fnX7pZb~kFZhIQJHjOg "Crie um trabalho agendado na tabela Agendar trabalho [sysauto].") * [Personalize o formato de data do sistema](https://servicenow-prod.fluidtopics.net/u46cEOQI1spWrHWiv7GamQ "Você pode personalizar o formato no qual os valores de data aparecem em sua instância.") * [Defina um fuso horário do sistema](https://servicenow-prod.fluidtopics.net/zVkBqgt3sGAIYNQZcXecgw "Defina o fuso horário do sistema com uma propriedade do sistema.") **Tópicos relacionados** * [Domain Separation para provedores de serviço](https://www.servicenow.com/docs/access?context=domain-sep-landing-page&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)