Edição de Variáveis de Tempo de Execução

Mostra como selecionar um conjunto de variáveis que pode ser usado como parâmetro de tempo de execução para jobs de Pipeline.

Na página Variáveis, você pode selecionar um conjunto de variáveis ​​que podem ser usadas como parâmetro de tempo de execução para jobs de Pipeline. Ao executar um Pipeline, você recebe um valor de entrada para essas variáveis: um conjunto de valores prontos para uso ou valores de tempo de execução, a partir dos quais os valores de parâmetro podem ser usados ​​para jobs individuais. As variáveis ​​podem ser de tipos predefinidos, como: "Período", "Modo de Importação" ou "Modo de Exportação".

Você também pode adicionar parâmetros de variáveis ​​personalizados como um parâmetro de job. Por exemplo, se você quiser passar valores estáticos usando uma variável de substituição para o Período de Início, altere o Tipo de variável para "Texto" e especifique uma variável de substituição como parâmetro (aceita pela API REST de integração), como &ThisMonth#&ThisYear. (Uma variável de substituição é um nome de variável de usuário precedido de um ou dois caracteres de E comercial (&)).

As variáveis ​​de tempo de execução padrão incluem:

  • Período de Início
  • Período de Término
  • Modo de Importação
  • Modo de Exportação
  • Enviar E-mail
  • Enviar para
  • Anexar Log
  • Execução de Estágio

Para modificar variáveis ​​de tempo de execução do Pipeline:

  1. Na página inicial da Integração de Dados, clique A imagem mostra o ícone Selecionar. à direita do Pipeline e, em seguida, selecione Detalhes do Pipeline.

  2. Na página Pipeline, selecione a guia Variáveis.

  3. Selecione a variável a ser modificada.

  4. Em Nome da Variável, para adicionar ou modificar um nome de variável predefinido, especifique o nome.

    É possível fazer referência ao nome da variável como um parâmetro de job. O nome não pode ter mais de 20 caracteres e não pode conter espaços.

  5. Em Nome para Exibição, especifique o nome do prompt de exibição da variável.

  6. Em Ordem de Exibição, especifique a ordem de exibição da variável.

  7. Marque a opção Obrigatório se for necessário um valor da variável para executar o Pipeline.

  8. Na lista suspensa Tipo de Validação, selecione o tipo de valor usado para validar a variável.

    Os tipos de validação incluem:

    • Lista — O uso de uma consulta da LOV e de valores de vinculação é obrigatório.
    • Texto — Campo de texto de formato livre
    • Arquivo — Nome do arquivo. Uma janela do navegador de arquivos está disponível para selecionar um arquivo.

    • Lista Personalizada — Lista de valores definida pelo usuário

      Para usar esse tipo de validação, forneça uma lista de valores na janela Parâmetro de Validação. Os valores devem ser especificados no formato Value,Label, e cada linha deve terminar com um caractere de nova linha. Por exemplo,

      M,Month
      Q,Quarter
      Y,Year
    • Consulta — Uso de valores de Consulta disponíveis.

  9. Na lista suspensa Parâmetros de Validação, selecione os parâmetros predefinidos para a variável com base no tipo de validação.

    Por exemplo, você pode selecionar um parâmetro da variável Período Inicial com base em um tipo de validação de lista, como:

    • Status do Pipeline
    • Consulta da LOV do Modo de Exportação do Pipeline
    • Consulta da LOV de Nome de Período Global
    • Consulta da LOV sem Segurança de Local
    • Balancete Convertido por Entidade de Destino/Consulta de conta
    • Consulta do Monitor de Processos
  10. Em Valor Padrão, selecione o valor padrão para a variável.

    O valor padrão pode ser um valor estático ou uma variável de substituição do Planning.

    As variáveis de tempo de execução padrão e suas descrições são fornecidas na tabela a seguir.

    Table 12-40 Variáveis e Descrições de Tempo de Execução Padrão

    Nome da Variável Valores Disponíveis
    Período de Início Especifique o primeiro período incluído no escopo de processamento de importação/exportação do pipeline. Essa variável define o início do intervalo de períodos usado pela etapa de Troca de Dados (em geral, juntamente com o Período de Término) para determinar os dados dos períodos a serem processados.
    Período de Término Especifique o último período incluído no escopo de processamento de importação/exportação do pipeline. Essa variável define o fim do intervalo de períodos (usado com Período de Início) para definir os dados de períodos que a etapa de Troca de Dados processará.
    Modo de Importação

    Especifica como o pipeline de Troca de Dados deve tratar o carregamento dos dados de entrada durante uma etapa de importação, ou seja, se a importação substituirá os dados existentes ou adicionará/atualizará os dados existentes no destino.

    • Substituir: (Valor padrão) Substitui os dados de destino existentes para o escopo de importação e, em seguida, carrega os novos dados.
    • Acrescentar: Retém dados de destino existentes e adiciona novos registros e/ou atualiza registros correspondentes com base nas regras de importação.
    • Nenhuma Importação: Não carrega dados.
    • Mapear e Validar: Executa a importação usando os mapeamentos definidos e as regras de validação para transformar e validar os dados de origem, mas não grava os dados no destino. Essa opção é usada para confirmar o arquivo/formato, a cobertura de mapeamento e as validações de regra e para revisar erros ou advertências antes de executar um modo de carregamento/commit.
    Modo de Exportação

    Especifica como o pipeline do Data Exchange deve exportar os dados:

    • Mesclar: (Valor padrão) Exporta somente os dados no escopo de execução atual e os combina com qualquer saída de exportação existente para o arquivo/local de destino. Os registros existentes poderão ser atualizados onde houver correspondência de chaves; novos registros serão adicionados.
    • Acumular: Adiciona a saída de exportação da execução atual à saída existente como um conjunto adicional de registros (apenas acrescenta), preservando o conteúdo exportado anterior.
    • Substituir: Gera uma nova saída de exportação para o escopo de execução atual e substitui o conteúdo/arquivo de exportação existente no local de destino.
    • Simulação: Executa o processo de exportação (seleção de escopo, formatação, validações) sem produzir ou gravar a saída de exportação final, permitindo que você verifique os resultados e detecte problemas antes de gerar arquivos.
    • Sem Exportação: Não exporta os dados.
    Enviar E-mail

    Controla se o pipeline enviará uma notificação por e-mail para a execução do pipeline:

    • Sempre: Envia uma notificação por e-mail para cada execução de pipeline, independentemente do resultado (sucesso, advertência ou falha).
    • Não: (Valor padrão) Não envia notificações por e-mail para a execução do pipeline.
    • Com Falha: Envia uma notificação por e-mail somente quando a execução do pipeline falha (ou termina em um status de erro).
    • Com Sucesso: Envia uma notificação por e-mail somente quando a execução do pipeline é concluída com sucesso.
    Enviar para Especifique a lista de destinatários de e-mail para notificações de execução de pipeline quando a opção Enviar E-mail estiver habilitada.
    Anexar Logs

    Controla se os logs de execução do pipeline serão incluídos como anexos de arquivo com os resultados/notificações do pipeline (por exemplo, na saída do job ou em qualquer carga útil de e-mail/notificação configurada).

    • Não: (Valor padrão) Não anexa logs
    • Sim: Anexa logs
    Execução de Estágio
    • Iniciar a partir do começo: (Valor padrão) Quando o Pipeline falhar, reinicie o processo desde o início.
    • Iniciar a partir falha: Quando falhar, em vez de reiniciar o processo, o Pipeline iniciará o job a partir do último estágio em que houve a falha. Quando um pipeline é reiniciado a partir de um estágio em que houve uma falha, o status dos jobs do estágio anterior é transportado para a nova execução do Pipeline.

    Note:

    O pipeline não será executado se você selecionar Iniciar a partir da falha e ele tiver sido bem-sucedido.
  11. Clique em Salvar.