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 programado 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é Todos > Definição do Sistema > Trabalhos programados.
- Clique em Nova.
- Selecione Executar 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 programado. Ativo Opção que indica que o trabalho programado está ativo e deve ser executado na data e hora especificadas. Aplicação Nome da aplicação que contém o script. Global aparecerá se o script estiver no escopo global. Condicional Opção para habilitar a execução do trabalho programado se determinadas condições forem atendidas no script associado. Condição Script condicional que determina se um trabalho programado 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 Usar condições. Aviso:Scripts condicionais para e-mails de relatório programados e trabalhos de coleta de dados Performance Analytics são executados na área restrita. Portanto, as 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 área restrita de script.Após o upgrade, os trabalhos com scripts condicionais que contêm esses componentes de API não permitidos são concluídos com erros.
Executar Intervalo de tempo a ser usado para executar o trabalho programado:- Diariamente: é executado diariamente, em um horário designado.
- Semanalmente: é executado semanalmente, em um horário e dia da semana designados.
- Mensalmente: é 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 iniciais do calendário comercial selecionado no campo Calendário comercial. Um trabalho programado é executado para a data de início de cada uma das entradas de negócios que você definiu para o calendário de negócios.
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 programado será executado no primeiro dia de cada mês.
- Calendário comercial: fim da entrada: executado na data de término do calendário comercial selecionado no campo Calendário comercial. Essa seleção é executada da mesma maneira que Calendário comercial: início da entrada, mas para as datas de término das entradas do calendário comercial associadas.Nota:Ao selecionar Calendário comercial: início da entrada ou Calendário comercial: fim da entrada, você pode aplicar um fator de deslocamento para programar o trabalho para ser executado antes ou depois do período do calendário comercial selecionado. Para saber mais, consulte os campos Tipo de deslocamento e Deslocamento.
Para saber mais sobre como criar e usar calendários de negócios e definir entradas de calendário de negócios, consulte Criação de calendários de negócios eDefinir entradas do calendário comercial.
Dia Dia em que o trabalho programado deve ser executado.- Se Executar estiver definido como Semanalmente, selecione o dia da semana. Por exemplo, selecione Quarta-feira.
- Se Executar estiver definido como Mensalmente, 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 programada. Insira a duração em número de dias, horas ou minutos. Por exemplo:- Para executar o trabalho programado a cada quatro dias, insira 04 no campo Dias.
- Para executá-lo a cada 26 horas, insira 26 no campo Horas.
- Se ele se repetir em um intervalo de 13:30:25, insira 13 no campo Horas e insira 30 e 25 nos dois campos sem rótulo após ele.
Fuso horário Fuso horário a ser usado com a entrada do campo Hora ao especificar a hora em que o trabalho programado 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 programado.
Por exemplo, o trabalho programado será executado às 16h45, horário dos EUA/Pacífico, se for o fuso horário atribuído ao usuário e você inserir 16:45 no campo Hora.
- Usar 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 programado será executado às 22h15, horário de Londres, se Europa/Londres for o fuso horário do sistema padrão para a instância e você inserir 22:15 no campo Hora.
- Fuso horário real.
Por exemplo, o trabalho programado será executado às 13h30 no fuso horário Leste dos EUA se você selecionar EUA/Lestee inserir 13:30 no campo Hora.
Hora Hora em que o trabalho programado deve ser executado, expressa em horas, minutos e segundos em um relógio de 24 horas. A seleção feita no campo Fuso horário determina o fuso horário desta entrada. Dia Dia em que o trabalho programado deve ser executado.- Se Executar estiver definido como Semanalmente, selecione o dia da semana. Por exemplo, selecione Quarta-feira.
- Se Executar estiver definido como Mensalmente, 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 programada. Insira a duração em número de dias, horas ou minutos. Por exemplo:- Para executar o trabalho programado a cada quatro dias, insira 04 no campo Dias.
- Para executá-lo a cada 26 horas, insira 26 no campo Horas.
- Se ele se repetir em um intervalo de 13:30:25, insira 13 no campo Horas e insira 30 e 25 nos dois campos sem rótulo após ele.
Iniciando Data e hora da primeira geração de trabalho programada. Selecione a data e a hora do calendário. Este campo aparecerá somente se você selecionar Periodicamente no campo Executar. Calendário comercial Entrada de calendário de negócios que você está usando para determinar a data de início ou de término do calendário de negócios do trabalho programado. Este campo será exibido somente se você selecionar Entrada do negócio: data de início ou Entrada do negócio: data de término no campo Hora.
Tipo de desvio Tipo de deslocamento de tempo, se houver, a ser aplicado ao calendário de negócios que você selecionou para programar este trabalho:- Passado: aplique um fator de deslocamento para programar o trabalho para ser executado antes do início do período do calendário comercial selecionado.
- Futuro: aplique um fator de deslocamento para programar o trabalho para ser executado após o fim do período do calendário comercial selecionado.
- --Nenhum--: não aplique uma compensação de tempo ao programar este trabalho.
Deslocamento Quantidade de deslocamento de tempo, expressa em dias, horas, minutos e segundos, a ser aplicada ao calendário de negócios que você selecionou para programar este trabalho. Por exemplo, se você quiser programar o trabalho para iniciar 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 no campo Tipo de deslocamento.
- Insira 3 no campo Dias.
- Insira 14, 10e 45 no campo Horas.
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 o Domain Separation estiver instalado nesta instância, os campos a seguir 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 selecionados, os campos Tabela de origem dedomínio e Filtro de origem de domínio serã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 programado deve ser executado. Por exemplo, selecione Departamento (cmn_department) se quiser usá-lo como a origem dos domínios atribuídos usados para programar scripts. O trabalho programado determina esses domínios do 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 aos 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 de domínio Condição opcional que você pode especificar para filtrar os registros consultados da tabela de origem de 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 de domínio selecionada.
- Se você especificou uma condição no campo Filtro de origem do domínio, ele aplicará 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.
- Clique em Atualizar para atualizar o trabalho programado, em Executar agora para executar o script programado imediatamente ou em Excluir para excluir o trabalho.