Programar uma exportação

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 4 min. de leitura
  • Você pode programar uma exportação para enviar regularmente dados de um conjunto de exportação para um destino remoto. Ao configurar uma exportação programada recorrente, você pode enviar dados por push regularmente para um local externo, como para relatórios ou para preservar um snapshot dos dados.

    Antes de Iniciar

    Função necessária: export_set_scheduler ou export_set_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode configurar conjuntos de exportações programadas para exportar somente registros novos ou alterados usando exportações delta.

    Procedimento

    1. Navegar até Todos > Conjuntos de exportação do Sistema > Administração > Exportações Programadas.
    2. Clique em Nova.
    3. Preencha os seguintes campos.
      Tabela 1. Campos de programação de exportação de dados
      Campo Descrição
      Nome Insira um nome descritivo para esta exportação programada.
      Conjunto de exportação Selecione o conjunto de exportação para programação.
      Executar como Selecione o usuário para executar a exportação programada. Certifique-se de que o usuário tenha as funções necessárias para exibir os dados a serem exportados.
      Executar Selecione a frequência da exportação programada.
      Dia Selecione em que dia da semana ou mês esta exportação programada será executada. Este campo aparece quando o campo Executar é definido como Semanalmente ou Mensalmente
      Intervalo de repetição Insira o número de dias e horas de espera antes de repetir esta exportação programada. Este campo aparece quando o campo Executar é definido como Periodicamente.
      Tempo Insira a hora do dia para executar a exportação programada.
      Exportações Delta
      Habilitar exportações delta Marque esta caixa de seleção para habilitar a funcionalidade delta para esta exportação programada. Quando selecionado, somente registros novos ou alterados são exportados.
      Delta imediato ou posterior Selecione Atualizado para exportar todos os registros que foram alterados desde a última exportação, incluindo novos registros. Selecione Criado para exportar somente novos registros criados após a última exportação.
      Nota:
      Se a definição de exportação já incluir uma condição de filtro nos campos sys_updated_on ou sys_created_on, habilitar as exportações delta impedirá que você salve o registro de exportação de dados programado. Um erro aparece na parte superior do formulário neste evento.
      Execução programada da última exportação Deixe este campo em branco para exportar todos os registros da definição de exportação. Ao usar exportações delta, este campo é definido automaticamente sempre que a exportação programada é executada. Registros atualizados ou criados após esta data e hora são incluídos no delta de exportação, dependendo do valor Delta em ou após.
      Scripts
      Condicional Marque esta caixa de seleção para executar a programação somente quando uma condição for atendida.
      Condição Grave o script a ser usado para avaliar se a exportação deve ser executada. Este campo ficará visível se você marcar a caixa de seleção Condicional.
      Executar script de pré-exportação Marque esta caixa de seleção para executar um script antes do início da exportação.
      Pré-script Grave o script que você deseja executar antes que os dados sejam exportados. Este campo ficará visível se você marcar a caixa de seleção Executar script de pré-exportação.
      Executar script de pós-exportação Marque esta caixa de seleção para executar um script após o término da exportação.
      Post script Grave o script que você deseja executar após o término da exportação. Este campo ficará visível se você marcar a caixa de seleção Executar script de pós-exportação.
    4. Clique em Enviar.

    O que Fazer Depois

    Você pode clicar no botão Executar agora para executar a exportação imediatamente e confirmar que os dados foram exportados conforme o esperado.

    Exportações delta do conjunto de exportações programadas

    As exportações delta incluem somente os registros que foram alterados desde a última exportação programada.

    Você pode usar a exportação delta somente para tabelas regulares, como as tabelas de tarefas e problemas.
    Importante:
    Você não pode usar a exportação delta para uma tabela de exibição de banco de dados, que é uma tabela virtual que une tabelas físicas.

    Uma exibição de banco de dados não inclui campos do sistema, como sys_created on, sys_created by e sys_updated on. Como os campos de data do sistema não estão incluídos na exibição do banco de dados, você não pode usar exportações delta com exibições de banco de dados, pois não há como saber quando a tabela foi atualizada pela última vez.

    Opções de script do conjunto de exportação programada

    Ao programar um conjunto de exportação, você pode acessar determinados objetos JavaScript.

    Use esses objetos em scripts de conjunto de exportação programados, como os campos Pré-script e Pós-script.
    cancelar
    Defina este objeto como verdadeiro para parar a ação de exportação. Todos os conjuntos de exportação secundários também serão cancelados se o primário for cancelado. Este objeto está disponível somente no campo Pré-script.
    Exemplo: use o campo Pré-script para avaliar as condições da exportação e determinar se o processo de exportação deve ser cancelado. Para cancelar o processo de exportação, use a seguinte chamada:
    cancel = true;
    export_set
    Obtenha o objeto GlideRecord para o novo conjunto de exportação. Esta variável permite consultar as seguintes colunas da tabela sys_export_set:
    • nome
    • SYS_ID
    • estado
    • table_name

    Este objeto está disponível nos campos Pré-script e Pós-script.

    Exemplo: se você quiser usar informações do conjunto de exportação, poderá especificar uma das propriedades da variável export_set.

    var x = export_set.sys_id;