Crystal Reports - Criando Variáveis
UMA Variableé usado para atribuir valores diferentes a um objeto, ao contrário da constante que é fixa. Quando você atribui um valor a uma variável, ela mantém esse valor até que você atribua um novo valor a ela. Antes de usar as variáveis, é necessário defini-las em um relatório.
Quando você declara uma variável no Crystal Report, você precisa atribuir um nome a ela, no entanto, este nome não deve ser o mesmo que qualquer outra função, operador, etc. Uma variável pode ser um tipo de número, tipo de string, tipo de data, Booleano tipo, tipo de intervalo ou um tipo de array. Uma variável pode conter um valor de tipo único, como se você a declarasse como um número, ela não pode ser usada para armazenar valores de string posteriormente.
Definindo uma Variável
Local Stringvar Customer_Lastname
Local numbervar Sales_percentage
A palavra-chave para declarar a variável possui 'var' no final e é verdadeira para todos os tipos de variáveis. Você também pode atribuir um valor inicial a uma variável com declaração ou em sintaxe separada.
Local NumberVar Z; //Declare Z to be a Number variable
Z := 30; //Assign the value of 30 to Z
Para usar Variáveis em fórmulas, seu escopo é definido. O escopo da variável pode ser de três tipos -
- Local
- Global
- Shared
Isso define que uma variável em uma fórmula pode ser usada em outra fórmula.
Variáveis Locais
Variáveis locais são declaradas usando a palavra-chave local seguida pelo tipo e seguida pelo nome da variável como nos exemplos acima.
Variáveis locais são restritas a uma única fórmula. Isso significa que você não pode acessar o valor de uma variável local em uma fórmula de uma fórmula diferente.
//Formula 1
Local NumberVar Z;
Z := 30;
//Formula 2
EvaluateAfter ({@Formula A})
Local NumberVar Z;
Z := z + 5;
No exemplo acima, a Fórmula 2 retornará um valor 5 quando Z for declarado como variável de número local na fórmula 1, portanto, assumirá o valor padrão para a variável Z na fórmula 2.
Variáveis globais
Variáveis globais são usadas em todo o relatório principal. Seu valor está disponível para todas as fórmulas que declaram a variável, exceto para aquelas em sub-relatórios.
Global StringVar Z;
Recomenda-se que você use a variável global apenas quando as variáveis locais não forem suficientes.
Como as variáveis globais compartilham seus valores em todo o relatório principal, você não pode declarar uma variável global em uma fórmula com um tipo e, em seguida, declarar uma variável global com o mesmo nome em uma fórmula diferente com um tipo diferente.
Variáveis Compartilhadas
Variáveis compartilhadas são usadas em todo o relatório principal e em todos os seus sub-relatórios. Variáveis compartilhadas são ainda mais gerais do que variáveis globais.
Para usar uma variável compartilhada, declare-a em uma fórmula no relatório principal -
Shared NumberVar Z := 10;
Para usar variáveis compartilhadas, ela deve ser declarada e atribuída um valor antes de poder ser usada no relatório principal e sub-relatórios.