Executar automaticamente um script escolhido por você
Programe scripts condicionais e não condicionais. Se o Domain Separation estiver instalado na instância, você também poderá selecionar, filtrar, classificar e programar scripts com base nos domínios atribuídos.
Antes de Iniciar
Por Que e Quando Desempenhar Esta Tarefa
A seguir está um exemplo de 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
- Navegar até Tudo > Definição do Sistema > Trabalhos agendados.
- Selecione Novo.
- Selecione Execute automaticamente um script de sua escolha .
-
No formulário, preencha os campos.
Tabela 1. Programar execução de script 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 Um 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 será exibida 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 Script sandbox.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.
- Dia e mês no ano : É executado anualmente em um dia e mês específicos (por exemplo, 14 de julho), em um horário designado.
- Dia na semana em mês no ano : É executado anualmente em um dia específico da semana em uma semana específica de um mês específico (por exemplo, a segunda segunda-feira de outubro), em um horário designado.
- Semana no mês : É executado mensalmente durante uma semana específica do mês (por exemplo, a terceira semana de cada mês), em dias designados e em um horário designado.
- Semanalmente : Executa semanalmente, em um horário e dia designados da semana.
- Mensal : É executado mensalmente, em uma hora e dia designados do mês.
- Periodicamente : É executado em um intervalo de repetição designado.
- Uma vez : É executado somente para uma única ocorrência.
- Sob demanda : É executado imediatamente sob demanda.
- Calendário comercial: Início da entrada : É executado nas datas de entrada inicial 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.
- 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 essa é 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 Criação de calendários de negóciose. Defina entradas de calendário comercial.
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.
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 ser repetido 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.
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.
- 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.
- Fuso horário real.
Por exemplo, o trabalho agendado é executado às 1:30 no fuso horário da Leste dos EUA, se você selecionar EUA/Leste e insira 13:30 em Tempo campo.
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.
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 ser repetido 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.
Iniciando Permite definir a janela de início de tempo em que você deseja que seu trabalho comece a ser executado. O trabalho será realmente executado no horário especificado em Tempo de execução . Selecione a data e a hora do calendário. . Iniciando o campo será exibido somente se você selecionar uma das seguintes opções Executar tipos no Executar campo: - Diariamente
- Dia e mês do ano
- Dia na semana no mês no ano
- Mensalmente
- Uma vez
- Periodicamente
- Semana no mês
- Semanalmente
Para o tipo de execução Periodicamente . Iniciando a hora é a data e a hora da primeira geração de trabalho programado.
Calendário de negócios 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.
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 programadas. Por exemplo, copie a lógica de script de uma regra de negócios ou chame uma inclusão de script. -
Se Domain Separation estiver instalado nesta instância, os seguintes campos também serão exibidos para selecionar, classificar e programar trabalhos por domínio.
Nota:O plug-in Domain Support - Domain Extensions Installer instala esses campos. Para saber mais, consulte Solicitar separação de domínio .
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 . Nota:É uma boa ideia criar uma tabela separada por domínio exclusivamente dedicada a domínios de origem, 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. - Selecione o campo a ser usado para filtrar registros.
- Adicione condições de filtragem e operadores para restringir os critérios de seleção de domínio. Para saber mais, consulte Filtros .
O processamento a seguir ocorre ao programar um trabalho em uma instância separada por domínio:- Primeiro, ele 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 de registros resultante.
- Por fim, ele recupera sua lista de domínios exclusivos das colunas sys_domain desses registros.
- Selecione Atualizar para atualizar o trabalho agendado, Executar agora para executar o script agendado imediatamente, ou Excluir para excluir o trabalho.