Utilização de variáveis

As variáveis fornecem um local temporário para o armazenamento de dados, que podem então ser acessados de qualquer contexto no arquivo. Você pode definir variáveis em:

• cálculos usando as funções Let e While
• scripts usando etapas de script, como Definir variável, Obter caminho da pasta, Mostrar caixa de diálogo personalizada, Ler a partir do arquivo de dados, e determinadas etapas de script Inserir

As variáveis não estão disponíveis fora do arquivo no qual foram definidas e não estão disponíveis para outros usuários. Se você precisar que os dados fiquem disponíveis para outro arquivo ou para vários usuários, use um campo (sem armazenamento global) e não uma variável.

Ao definir uma variável, você pode especificar seu escopo adicionando um prefixo antes do nome da variável.

Variáveis locais e globais (ou até mesmo duas variáveis locais em scripts diferentes) podem ter o mesmo nome, mas serão tratadas como variáveis diferentes e armazenar valores diferentes.

Você pode usar variáveis em:

• cálculos
• scripts
• caminhos de arquivo (consulte Criação de caminhos de arquivo)
• solicitações de busca criadas e editadas na caixa de diálogo Editar solicitação de busca (consulte Caixas de diálogo Especificar solicitações de busca e Editar solicitação de busca)
• layouts como variáveis de mesclagem (consulte Inserção de variáveis de mesclagem em um layout)

Repetições em variáveis

As variáveis locais e globais podem incluir um número de repetição opcional que aparece entre colchetes [ ] imediatamente após o nome da variável. Por exemplo, a seguinte fórmula retorna 111:

Let ( [
    $var[1] = 1;
    $var[2] = 10;
    $var[3] = 100
];
$var[1] + $var[2] + $var[3] )

As repetições em variáveis não são suportadas em:

• variáveis de função

• variáveis de mesclagem

• solicitações de busca

Notas

• Os nomes de variável têm as mesmas restrições de nomenclatura dos nomes de campo. Consulte Sobre a nomeação de campos.
• As variáveis não são aceitas em caminhos de arquivo que estiverem armazenados em campos de container.
• O tipo de dados de uma variável é determinado dinamicamente com base nos dados atribuídos. As variáveis têm os mesmos tipos de dados que campos, exceto os campos de cálculo e resumo. Consulte Sobre a escolha de um tipo de campo.
• Para obter mais informações sobre como trabalhar com variáveis, consulte a Base de conhecimento.