Executar automaticamente um script escolhido por você

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 8 min. de leitura

    • Programe scripts condicionais e não condicionais. Se a Separação de domínios estiver instalada na instância, você também poderá selecionar, filtrar, classificar e programar scripts com base em seus domínios atribuídos.

    Antes de Iniciar

    Função necessária: administrador

    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

    1. Navegar até Todos > Definição do Sistema > Trabalhos agendados.
    2. Clique em Nova.
    3. Selecione Executar automaticamente um script de sua escolha.
    4. 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 aparecerá 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). Essa caixa de texto aparecerá somente se você selecionar Usar condições.
      Aviso:
      Scripts condicionais para e-mails de relatório programado e trabalhos de coleta de dados Performance Analytics são executados na área restrita. 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 á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 agendado:
      • Diariamente: é executado diariamente, em um horário designado.
      • Semanal: é executado semanalmente, em uma hora e dia da semana designados.
      • Mensalmente: é executado mensalmente, em uma hora e dia do mês designados.
      • 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 de negócios: início de entrada: é executado nas datas de entrada iniciais do calendário de negócios selecionado no campo Calendário de negócios. 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 de negócios: Término da entrada: é executado na data de término do calendário de negócios selecionado no campo Calendário de negócios. Esta seleção é executada da mesma maneira que Calendário de negócios: início da entrada, mas para as datas de término das entradas do calendário de negócios associadas.
        Nota:
        Ao selecionar Calendário de negócios: início de entrada ou Calendário de negócios: fim de entrada, você pode aplicar um fator de deslocamento para programar o trabalho para ser executado antes ou após o período de tempo do calendário de negócios 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 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 Como criar calendários de negócios eDefinir entradas do calendário de negócios.
      Dia
      Dia em que o trabalho agendado deve ser executado.
      • Se Executar estiver definido como Semanalmente, selecione o dia da semana. Por exemplo, selecione Quarta-feira.
      • Se Executar estiver definido como Mensal, selecione o dia do mês. Por exemplo, selecione 25 para o dia 25 do mês.
      Este campo aparecerá somente se você selecionar Mensal ou Semanal no campo Executar.
      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 no campo Dias.
      • Para executá-lo a cada 26 horas, insira 26 no campo Horas.
      • Se ele repetir em um intervalo de 13:30:25, insira 13 no campo Horas e, em seguida, insira 30 e 25 nos dois campos não rotulados 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 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 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 Horário.

      • Usar fuso horário do sistema: use o fuso horário do sistema padrão especificado para a instância na qual ele é executado.

        Por exemplo, o trabalho agendado será executado às 22h15, horário de Londres, se Europa/London for o fuso horário padrão do sistema para a instância e você inserir 22:15 no campo Horário.

      • Fuso horário real.

        Por exemplo, o trabalho agendado será executado às 13h30 no fuso horário do Leste dos EUA se você selecionar EUA/Lestee inserir 13:30 no campo Horário.
      Hora Hora do dia em que o trabalho agendado deve ser executado, expressa em horas, minutos e segundos no formato 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 agendado deve ser executado.
      • Se Executar estiver definido como Semanalmente, selecione o dia da semana. Por exemplo, selecione Quarta-feira.
      • Se Executar estiver definido como Mensal, selecione o dia do mês. Por exemplo, selecione 25 para o dia 25 do mês.
      Este campo aparecerá somente se você selecionar Mensal ou Semanal no campo Executar.
      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 no campo Dias.
      • Para executá-lo a cada 26 horas, insira 26 no campo Horas.
      • Se ele repetir em um intervalo de 13:30:25, insira 13 no campo Horas e, em seguida, insira 30 e 25 nos dois campos não rotulados após ele.
      Início Data e hora da primeira geração de trabalho agendada. 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 agendado. Este campo aparecerá somente se você selecionar Entrada de negócio: data de início ou Entrada de negócio: data de término no campo Hora.
      Tipo de desvio
      Tipo de compensação 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 de tempo 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 de tempo do calendário comercial selecionado.
      • --Nenhum--: não aplica uma compensação de tempo ao programar este trabalho.
      Adicionar um fator de deslocamento permite programar o trabalho para ser executado antes ou após o período formal definido no calendário comercial para os seguintes casos de uso:
      Deslocamento
      Quantidade de compensação 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.
      Os campos Deslocamento de dias e horas serão exibidos somente se você selecionar Calendário comercial: início de entrada ou Calendário comercial: fim de entrada no campo Executar e Passado ou Futuro no campo Tipo de deslocamento.
      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ócio ou chame uma inclusão de script.
    5. Se a Separação de domínios 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 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, os campos Tabela de origem do domínio e Filtro de origem do 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 agendado 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 agendado 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 a domínios de fornecimento, a menos que você tenha um caso de uso que garanta 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 da tabela de origem de 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.
      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 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.
    6. Clique em Atualizar para atualizar o trabalho agendado, Executar agora para executar o script programado imediatamente ou Excluir para excluir o trabalho.