Função: ExistUnico - Campo existente na chave única
Versões: |
Microsiga Protheus 8.11
,
Protheus 10
|
Compatível Países: |
Todos
|
Sistemas Operacionais: |
Todos
|
Compatível às Bases de Dados: |
Todos
|
Nível de Acesso: |
Nível 1 (Acesso Clientes)
|
Idiomas: |
Espanhol
,
Inglês
|
Descrição:
Através da função ExistUnico(), é possível verificar se uma operação de inclusão ou alteração em um determinado alias é válida.
A função realiza uma busca na tabela pelos campos existentes na chave única do arquivo (X2_UNICO).
Esta função está disponível na LIB 811, em releases superiores a 'Lib 20051229'
Sintaxe:
ExistUnico - Campo existente na chave única (
cAliascChave [
cHelp ] [
lShowHlp ] )
--> lValid
Retorno:
lValid(logico)
- lValid é .T. caso a chave passada como parâmetro seja válida, isto é, não se encontre no arquivo. Caso contrário, retorna .F.
Observações
Esta função é sensível à operação em execução, setada pela função RecLock() (inclusão ou alteração). Pode ser usada em fontes Advpl de processamento e na validação de campos para interface (X3_VALID, X3_VLDUSER) .
Parâmetros:
| Nome | | | Tipo | | | Descrição | | | Default | | | Obrigatório | | | Referência | |
| cAlias | | | Caracter | | | Corresponde ao alias da tabela no SX2, a ser verificada a chave. | | | | | | X | | | | |
| cChave | | | Caracter | | | Corresponde à chave de busca a ser considerada para checar o arquivo. Ela deve ser montada de acordo com os campos definidos na chave única do alias (X2_UNICO). | | | | | | X | | | | |
| cHelp | | | Caracter | | | Corresponde à mensagem de ajuda mostrada ao usuário caso a chave não seja válida. Se não for especificada uma mensagem específica, será mostrada a mensagem default "JAEXISTUNQ". | | | | | | | | | | |
| lShowHlp | | | Lógico | | | Caso especificado .T., mostra a mensagem de help ao usuário se a chave verificada já existir no arquivo. Caso contrário, não é mostrada a mensagem de help. | | | .T. | | | | | | | |