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 as variáveis de um usuário 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
• caminhos de arquivo
• 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.