Criar e Usar Variáveis

Variável é um objeto que armazena um único valor, que pode ser uma string, um número ou uma data.

Tópicos

Criar uma Variável

Você pode especificar o valor das variáveis ao criar a variável ou definir o valor usando uma expressão de consulta.

A página Variáveis lista todas as variáveis existentes. Clique no ícone Ações (Ícone Ações) de uma variável para editá-la, atualizá-la ou excluí-la. Todas as variáveis disponíveis também são listadas no painel esquerdo da página Detalhes do Workflow. Você pode usar variáveis como etapas em fluxos de dados e workflows.

Para criar uma variável:

  1. Na Home page, clique no título do Projeto obrigatório. Você vai navegar até a página Project Details.
  2. No painel esquerdo, clique em Variáveis. A página Criar Variável é exibida.
  3. Informe um nome para a variável.
  4. Na lista suspensa Tipo de Dados, selecione uma das seguintes opções:
    • Texto curto - O valor pode ser alfanumérico, pode conter caracteres especiais e não pode exceder 255 caracteres.
    • Texto longo - O valor pode ser alfanumérico, pode conter caracteres especiais e não pode exceder 64000 caracteres.
    • Numérico - O valor pode ser um valor numérico e pode ser precedido por um sinal de menos (-). O valor não pode exceder 10 dígitos. O intervalo de valores possível é de -999999999 a 999999999.
    • Data - O valor é um formato de data.
  5. No campo Valor Padrão, digite o valor que você deseja atribuir à variável. O valor permitido depende do Tipo de Dados que você selecionar.
  6. Para variáveis que você modifica, clique no menu Ações ao lado da variável para abrir a página Atualizar Variável para atualizar o valor. Na lista drop-down Manter Histórico, selecione como você deseja que o valor da variável seja exibido na página Atualizar Variável:
    • Todos os Valores - Você pode ver o histórico de todos os valores mantidos por essa variável.
    • Valor Mais Recente - Você só pode ver o valor mais recente especificado para a variável.
    • Sem Histórico - O Data Transforms não mantém o histórico dos valores mantidos por essa variável.
    • Valor Seguro - Isso é útil quando a variável contiver senhas ou outros dados confidenciais. O valor não é exibido na página Atualizar Variável.
  7. Insira uma descrição para a variável.
  8. Se quiser que o valor da variável seja definido por uma consulta, clique na guia Atualizar. Selecione o tipo de conexão e o esquema em que deseja executar o comando. Informe a consulta e clique em Validar para verificar a sintaxe de sua expressão.
  9. Clique em Salvar.

    A variável recém-criada é listada na página Variáveis, bem como no nó Variáveis no painel esquerdo da página Detalhes do Workflow.

Usar Variáveis em um Fluxo de Dados

Você pode usar variáveis em um fluxo de dados usando-as como uma definição de filtro. Você pode fazer referência a variáveis em um fluxo de dados usando o formato #<variable_name>. Durante a execução, a variável é substituída pelo valor.

Quando você executa o fluxo de dados, a página Valores da variável é exibida e exibe a lista de variáveis que você adicionou ao fluxo de dados. Você pode optar por usar o valor atual, o valor padrão ou definir um valor personalizado para cada variável. Observe que o valor personalizado é aplicado somente à execução atual do fluxo de dados. O valor personalizado não persiste para nenhuma sessão subsequente.

Veja a seguir um exemplo do uso de uma variável em um fluxo de dados:



Neste exemplo, o fluxo de dados usa a variável DEVICE_TYPE como uma etapa com o conjunto de condições de filtro da seguinte forma:

MOVIESALES_CA.DEVICE = '#DEVICE_TYPE'

A variável é cotada porque o valor substituído precisa ser cotado. Como o valor da variável é substituído durante a execução, você pode usá-lo para muitos casos de uso, como na expressão de transformação no mapeamento.

Usar Variáveis em um Workflow

O painel esquerdo da página Detalhes do Workflow lista as variáveis que podem ser usadas como etapas em um workflow.

Você pode arrastar e soltar as variáveis que deseja usar no workflow na tela de design. O Painel de Propriedades disponível no lado direito da tela de design exibe vários detalhes sobre a etapa, como a seguinte.
  • Nome, Tipo e o número de sequência da Etapa. Estes são valores não editáveis.
  • Clique no link em Objeto Vinculado para exibir e atualizar os detalhes sobre a variável.
  • Operação: Selecione qualquer uma das seguintes:
    • Definir Variável - Existem duas funções para esta etapa:

      Atualizar define o valor atual de uma variável.

      O acréscimo aumenta ou diminui um valor numérico pelo valor especificado.

    • Atualizar Variável - Esta etapa de variável atualiza a variável executando a consulta especificada na definição de variável.
    • Avaliar Variável: Esse tipo de etapa de variável compara o valor da variável com um determinado valor de acordo com um operador. Se a condição for atendida, então a etapa de avaliação será verdadeira; caso contrário, será falsa.
  • Número de tentativas com falha
  • Tempo entre tentativas, em segundos
  • Etapas de log no lançamento - Você pode selecionar Sempre, Nunca ou Erro.

Quando você executa o workflow, a página Valores da variável é exibida e exibe a lista de variáveis que você adicionou ao workflow. Você pode optar por usar o valor atual, o valor padrão ou definir um valor personalizado para cada variável. Observe que o valor personalizado é aplicado somente à execução atual do workflow. O valor personalizado não persiste para nenhuma sessão subsequente.

Este é um exemplo do uso de uma variável em um workflow:



Neste exemplo, uma variável chamada DEVICE _TYPE com o valor "iphone" é usada como uma etapa no fluxo de trabalho. O workflow executa as seguintes ações:

  1. Execute o fluxo de dados "REFRESH_DEVICE.
  2. Se a execução do fluxo de dados "REFRESH_DEVICE" for bem-sucedida, execute o fluxo de dados "Load_movies_for_device".
  3. Se a execução do fluxo de dados "Load_movies_for_device" for bem-sucedida, execute a etapa de avaliação da variável "IF_IPHONE".
  4. Se o valor da variável for igual a 'iphone', execute o caminho para "true".
  5. Se o valor da variável não for igual a 'iphone', execute o caminho para "false".