UNION
UNION ( conjunto1 ; conjunto2 ; conjuntoResultado )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| conjunto1 | Text | → | Primeiro conjunto |
| conjunto2 | Text | → | Segundo conjunto |
| conjuntoResultado | Text | → | Conjunto Resultado |
Descrição
UNION cria um novo conjunto que contém todos os registros de conjunto1 e conjunto2. A seguinte tabela mostra todos os possíveis resultados de uma operação de união de conjuntos.
| Conjunto1 | Conjunto2 | Conjunto resultante |
|---|---|---|
| Sim | Não | Sim |
| Sim | Sim | Sim |
| Não | Sim | Sim |
| Não | Não | Não |
O resultado de uma operação de união se mostra a continuação. A parte sombreada é o conjunto resultante.
O conjuntoResultado se cria por UNION. O conjunto resultado substitui todo conjunto existente que tenha o mesmo nome, incluindo conjunto1 e conjunto2. Os conjuntos conjunto1 e conjunto2 devem ser da mesma tabela. O conjunto resultado pertence à mesma tabela que conjunto1 e conjunto2. O registro atual de resultado é o registro atual de conjunto1.
4D Server: em modo cliente/Servidor, os conjuntos são "visíveis" dependendo do tipo (interprocesso, processo e local) e onde eles foram criados (servidor ou cliente). UNION exige que todos os três conjuntos estejam na mesma máquina. Para maior informação consulte 4D Server, conjuntos e seleções temporais no manual de referência de 4D Server.
Exemplo
Este exemplo adiciona registros ao conjunto de melhores clientes. Os registros são mostrados em tela com a primeira linha. Depois de mostrar os registros na tela, um conjunto dos melhores clientes é carregado a partir do disco, e todos os registros selecionados pelo usuário (o conjunto sistema chamado “UserSet”) se adicionam ao conjunto. Finalmente, o novo conjunto é guardado no disco:
ALL RECORDS([Clientes]) // Seleciona todos os clientes
DISPLAY SELECTION([Clientes]) // Mostrar todos os clientes de uma lista
LOAD SET("$Melhores";"$SalvarMelhores") // Carregar o conjunto dos melhores clientes
UNION("$Melhores";"UserSet";"$Melhores") // Adição da seleção ao conjunto
SAVE SET("$Melhores";"$SalvarMelhores") // Salvar o conjunto dos melhores clientes