English
Español
ExecutaFormularioSGI
Esta função é utilizada para executar formulários SGI X-Window, passando como parâmetro valores para os campos-chave do formulário que será executado.
Sintaxe: Funcao ExecutaFormularioSGI(Alfa pNomeForm; Alfa pParams);
Parâmetros:
| Nome | Tipo | Descrição |
|---|---|---|
| pNomeForm | Alfa | Variável que recebe o nome do formulário SGI a ser executado. |
| pParams | Alfa | Deve ser informado uma string que contenha a lista com os valores que devem ser preenchidos os campos do formulário. |
Atenção: Mesmo que seja informado apenas um campo como parâmetro deverá conter o separador ";" no final da string. E os campos que receberão os valores, devem ser obrigatoriamente campos do tipo 'chave'.
Exemplo: Exemplo do formato da string para que seja repassado o valor para o campo do formulário:
"NomeDaTabela.NomeDoCampo='ValorInformadoParaCampo';NomeDaTabela.NomeDoCampo='ValorInformadoParaCampo'".
vNomeForm = "FormSGI"
ExecutaFormularioSGI(vNomeForm, "E000XXX.Codigo='1';E000XXX.Valor='2';"); /* Irá executar o formulário SGI FormSGI */
@ Exemplo concatenando variáveis no parâmetro @
vNomeForm = "FormSGI";
vParametros = "E000XXX.Codigo = '"+vVariavel+"';E000XXX.Codigo = '"+vVariavel+"';";
ExecutaFormularioSGI(vNomeForm,vParametros);
Observações:
- Mesmo que seja informado apenas um campo como parâmetro deverá conter o separador ";" no final da string;
- Os campos que receberão os valores, devem ser obrigatoriamente campos do tipo 'chave';
- Esta função deve ser utilizada com cautela, por exemplo, não utilizá-la em uma seção detalhe de um modelo de relatório, pois causaria múltiplas execuções do formulário, atrapalhando quem o utiliza;
- Ao informar o nome do formulário cuidar com as letras maiúsculas e minúsculas, logo deve-se passar o nome do formulário exatamente como ele foi definido na criação;
- Deve ser verificado nas propriedades dos campos informados no parâmetro, se a opção está marcada "Valor do campo não pode ser nulo.", ocorrendo que não aceite valor nulo para o campo. Lembrando que o zero não é considerado um valor nulo e o vazio (" ") é considerado nulo.
English
Español
