Acrescentar registros em um arquivo do banco de dados.
INCLUA <arquivo> [ORDEM <item> CHAVE <chave]
|
<arquivo> |
representa o nome arquivo do banco de dados em uso, no qual deve ser incluído o registro. |
|
<item> |
representa um nome de um item do arquivo <arquivo>. |
|
<chave> |
representa um nome de um item chave do arquivo<arquivo >,para uma inclusão ordenada. |
Quando é fornecido o comando INCLUA <arquivo> o GERAL habilita o usuário a digitar valores de itens individuais, exibindo o nome de cada item na ordem em que os itens estão definidos no esquema.
O valor digitado deve ser do mesmo tipo que o definido para o item no esquema de dados. Se um valor de item é introduzido com caracteres inválidos será enviada uma mensagem advertindo a operação.
Se o caractere especial " for usado, este deverá aparecer duas vezes numa cadeia entre aspas.
No caso do item chave primária, é verificado se já existe o registro sendo emitida a mensagem "CHAVE JÁ EXISTE", não permitindo a duplicidade de chaves.
As opções ORDEM e CHAVE são utilizadas para inclusões ordenadas em uma cadeia de registros.
Será feita uma pesquisa na cadeia de <chave> até encontrar-se <item> com valor imediatamente superior ao valor do item <item> do registro a incluir, então o registro é inserido antes do registro encontrado, mantendo assim a cadeia de <chave> ordenada por <item>.
Este procedimento de inclusão perde um pouco em velocidade, pois para cada registro a ser incluído é feita uma pesquisa para encontrar o local no arquivo onde o registro deve ser incluído logicamente.
Na inclusão de chaves estrangeiras, é verificada a existência do valor para chave primária do arquivo ENTIDADE, sendo emitida a mensagem "CHAVE NÃO EXISTE", quando o valor digitado não for encontrado em nenhuma chave do arquivo ENTIDADE.
Após serem digitados valores para todos os itens de um arquivo , é solicitada a inclusão do próximo registro. Caso não se deseje incluir outro registro, a tecla {ESC} deve ser digitada duas vezes para finalizar a inclusão.
Os exemplos a seguir mostram como o GERAL procede depois que o usuário digitar um comando INCLUA MATERIAL.
O GERAL envia ao usuário o nome de um item e o seu tipo, aguardando que o mesmo digite o valor para aquele item.
COMANDO ? INCLUA MATÉRIAL
PNUM1 (N 5) = ? 11008
PNOME1 (U 20) = ? "8K MEMORIA"
MODELO (N 4) = ? 4100
LOCAL1 (U 12) = ? "BR MEIOESTE"
PRECO (N 8) = ? 3500
CUSMAO (N 5) = ? 120
CUSMAT (N 5) = ? 200
PNUM1 (N 5) = ?