Desenvolvimento > Utilitários > Manutenção > Em linhas 

Esta função permite modificar os dados de uma tabela quaisquer da base, em não fazendo nenhum controlo sobre a coerência dos dados que aqueles induzidos pelos tipos internos dos dados (data, cadeia de caracteres, valores numéricos). trata-se de uma operação de manutenção destinada essencialmente aos programadores e que não deve em nenhum caso deixado entre as mãos de utilizadores não competentes. A sua utilização inconsiderada está suscetível de corromper a integridade dos dados guardados na base.

Apenas os utilizadores tendo o perfil do administrador (definido pela variável ADMUSR) podem executar esta função. Por outro lado, se o parãmetro ASIGMNT está igual a Sim, uma confirmação será pedida pelo registo da palavra chave, assimque o registo de um código motivo.

Todas as tabelas podem ser visiualizadas, e a maior parte dentre elas modificadas por esta função.

Modo operatório

Regista-se o nome do dossier, seguidamente o nome da tabela sobre a qual se deseja efectuar uma manutenção a uma primeira janela. Por defeito, o dossier corrente é proposto, mas é possível dar o nome de um outro dossier acessível, com as sintaxes seguintes:

* DOSSIER(o nome do dossier directamente: neste caso, o dossier é suposto directamente serem acessíveis sobre o mesmo servidor e o mesmo serviço)

*serveur@DOSSIER (o nome rede do servidor onde se encontra o dossier deve ser indicado: um serviço adxd deve funcionar sobre o número de serviço corrente para permitir a conexão)

*serveur:service@DOSSIER ( mesmo princípio que acima, mas o número de serviço pode ser diferente. Isto dá, por exemplo, a sintaxe serveur_01:1802@DEMO)

Atenção: as duas últimas sintaxes supõem que existe sobre o servidor distante um dossier que tem o mesmo nome que o dossier onde é lançada a função (ainda que não é sobre este dossier que se lança a operação). Esta condição sempre é preenchida quando se parte do dossier supervisor, dado que qualquer instalação supõe que um processo deste tipo (cujo nome está, de acordo com software, X3, PAYE, GX) quer instalado no mínimo. Por conseguinte é aconselhado não utilizar esta sintaxe única neste caso. Além disso, de acordo com as configurações rede, o registo de um nome rede incorrecto pode provocar uma espera bastante longa após o registo do campo (o controlo de stocks do servidor que se faz sobre a rede, há um prazo de aproximadamente um minuto, às vezes mesmo vários minutos antes que uma mensagem de erro chegue).

Vê-se então aparecer os campos da tabela dos 15 separadores (todos necessariamente não são preenchidos, porque aquilo depende do número de campos da tabela). São apresentados na ordem alfabética. Os campos que compõem a chave principal da ficha são apresentados à parte. É então possível:

*Escolher uma ficha dactilografando a sua chave, seguido de TAB. Atenção, se esta ficha não existe, passa-se em modo criação, então é desaconselhado dactilografar Retornar após ter dactilografado a chave, porque a ficha será criada se a chave não existe.

* Percorrer a tabela com a ajuda dos botões grandes.

* Alterar valores e validar pelo botão , ou por Tabs sucessivos ou por Return

* Criar uma nova ficha registando uma chave inexistente e informando todos os valores.

* Apagar a ficha corrente utilizando o botão .

*Alterar de tabela corrente, utilizando o botão . Neste caso, a janela de escolhas inicial reafixada, e um novo ecrã adequado à tabela em manutenção será afixado.

* Posicionar um filtro para não seleccionar unicamente uma parte das linhas da tabela, com a ajuda da escolha Selecção/Selecção na barra de menus. O primeiro registo superior ou igual ao valor corrente (o primeiro se lá não tem) vai então ser apresentado. Se nenhum registo superior ou igual ao valor corrente existe, a mensagem Início/Fim de ficheiro é apresentada, e reencontra-se sem registo corrente. Atenção, isto não significa necessariamente que nenhum registo não responde aos critérios (ele poderá assegurar-se utilizando então o botão grande que permite obter o primeiro registo; se a mensagem dura, não há nenhum registo que responde aos critérios).

Observações

Esta função de manutenção não é susceptível de aferrolhar logicamente uma ficha. Assim, é possível de modificar uma ficha então que um utilizador está em vias de a modificar por funções normais.

Os campos de tipo menu local devem aqui ter entrado sob forma de valores numéricos (nenhum controlo é feito no que diz respeito ao número máximo de valores possíveis no menu local em questão)

Um rasto detalhado das operações de manutenção assim realizadas é gerido pelo sistema.

Mensagens de erro

Erro sobre critério de selecção

 (seguido de uma mensagem mais explícita)

A sintaxe do critério de selecção está incorrecta, ou o critério feito referência a campos inexistentes.

Tabelas levadas a efeito

Qualquer tabela da base de dados pode ser visualizada no mínimo (ou mesmo alterado) por esta função.

Advertência legal

Este tipo de função é uma função de desenvolvimento cuja utilização está interdito no quadro de uma exploração normal.

As consequências legais de utilização de utilitários de desenvolvimento sobre bases de dados contendo os dados cuja lei interdita a alteração são da inteira responsabilidade do cliente. Para mais informações, consulte oanexo correspondente.

Pré-requisitos

SEEREFERTTO Consulte a docuemntação de Implementação

Gestão do ecrã

Regista-se o nome do dossier, depois o nome da tabela sobre a qual se deseja efetuar uma manutenção numa primeira janela. Por defeito, o dossier corrente está proposto, mas é possível de dar o nome de um outro dossier acessível, com as sintaxes seguintes :

  • DOSSIER (o nome do dossier directamente : neste caso, o dossier está suposto de ser acessível directamente sobre o mesmo servidor e o mesmo serviço)
  • serveur@DOSSIER (o nome rede do servidor onde se encontra o dossier deve ser indicado: um serviço adxd deve funcionar sobre o número de serviço corrente para permitir a conexão)
  • serveur:service@DOSSIER (mesmo princípio que acima, mas o número de serviço pode ser diferente. Isto dado, por exemplo, a sintaxe serveur_01:1802@DEMO)

Vê-se aparecer os campos da tabela sobre 15 separadores (todos não são forçosamente preenchidos, porque isso depende do número de campos da tabela). São apresentadas na ordem alfabética. Os campos compondo a chave principal da ficha são apresentados acima. É possível igualmente :

  • Escolher uma ficha em inserido a chave, seguimento de TAB Atenção, se esta ficha não existe, passa-se em modo criação, também está desaconselhado de inserir Return após ter escrito a chave, porque a ficha será criada se a chave não existe.
  • Percorrer a tabela com a ajuda dos botões rádio.
  • Modificar dos valres e validar pelo botão, ou por os Tab sucessivas ou por Return.
  • Criar uma nova ficha em registando uma chave inexistente e em preenchendo todos os valores.
  • Apagar a ficha corrente em utilizando o botão.
  • Altarar a tabela corrrente, em utilizando o botão. Neste caso, a janela de escolha inicial será reafixada,e um novo ecrã apropriado à tabela em manutenção será afixado.
  • Posicionar um filtro para não selecionar que uma parte das linhas da tabela, com a ajuda da escolha Seleção / Seleção na barra de menus. O primeiro registo superior ou igual ao valor corrrente (o primeiro se não existe) vai ser afixado. Se nenhum registo superior ou igual ao valor corrente não existe, a mensagem Início/Fim de ficheiro está afixado,e se reencontra sem registo corrrente. Atenção, isto não significa forçosamente que nenhum registo não responde aos critérios (poder-se-á assegurar em utilizando então o botão rádio permitindo obter o primeiro registo, se mensagem perdura, não existe nenhum registo respondendo aos critérios)

O ultimo separador da ficha, nomeado Clob/Blob, permite visualizar (e de modificar segundo os casos) um campo de tipo binário ou texto longo, se existe um guardado na tabela.

Para que esta modificação seja possível, deve existir na tabela um campo de tipo AT, controlado pelo menu local 7806. Os valores possíveis para este menu local estão Indeterminado, Texto, Imagem, e Burótico Em função deste valor, o dado correspondente está editável no separador Clob/Blob.

Separador Imagem

Campos

Os seguintes campos estão presentes neste separador :

Bloco número 1

  • Imagem (campo INTPHO)

 

Bloco número 2

  • campo ZONPHO

 

Fechar

 

Separador Burótica

Campos

Os seguintes campos estão presentes neste separador :

Bloco número 1

  • Burótica (campo INTBUR)

 

Bloco número 2

  • campo ZONBUR

 

Fechar

 

Remarques

Esta função de manutenção não está suscetível de fechar logicamente uma ficha. Assim, é possível de modificar uma ficha então mesmo que um utilizador está em vias de a modificar pelas funções normais.

Os campos de tipo Menu local devem aqui ser entrados sob a forma de valores numéricos (nenhum controlo está feito face a face do número máximo de valores possíveis no menu local em questão)

Um rasto ddetalhado das operações de manutenção assim realizados está gerado pelo sistema.

Botões específicos

Permite alterar a tabela sem sair a função de manutenção.

Mensagens de erro

Para além das mensagens genéricas, as seguintes mensagens de erro podem aparecer durante o reg. :

Erro sobre critério de seleção
(exceto de uma mensagem não explicita)

A sintace do critério de seleção está incorrecto, ou o critério faz referência a campos inexistentes.

Tabelas consideradas

SEEREFERTTO Consulte a docuemntação de Implementação