Uma consulta permite extrair as informações de uma ou várias tabelas, apresentadas sob a forma de um quadro. A seleção se faz em função de critérios registáveis ao lançamento da pesquisa.

A gestão das consultas dá a possibilidade :

 de parametrizar o ecrã de consulta,

 de apresentar os resultado da consulta sob forma de gráfico,

 de ter uma gestão dos memos, para registar os critérios de seleções. O código extensão memo está a registar na tabela de codificação de memos. 

Uma consulta se apresenta sob a forma :

 de uma janela composta de um cabeçalho compreendendo os critérios principais para a seleção e de um separador afixando o resultado da seleção forma um quadro. Não estamos no entanto limitados a um separador.

 de uma janela constituida de um único ecrã. Esta janela chamável depois o botão "Critério" Ela permite, como o seu nome indica, o registo completo dos critérios de seleção, dos critérios de ordenação de registos, de memos, de um ecrã parametrizável para a afixação do resultado da consulta

 Não existe lista de esquerda.

O gráfico está personalizével e é considerado como da parametrização. Está a preencher nos ecrãs de parametrização das consultas.

    Pré-requisitos

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

    Gestão do ecrã

    Cabeçalho

    Campos

    Os seguintes campos estão presentes neste separador :

    Este código identifica a consulta.

    • Descr. (campo DES)

    Este texto está retomado do separador da janela principal de consulta.

    Fechar

     

    Separador Ecrãs

    Apresentação

    O primeiro separador permite identificar as janelas utilizadas pela consulta assim que definir as características gerais.

    Fechar

     

    Campos

    Os seguintes campos estão presentes neste separador :

    Características

    • Módulo (campo MODULE)

    Sélectionnez un module pour le paramétrage.

    Ce champ vous permet de renseigner si l'écran doit être créé dans la base de données du dossier. Il l'est si le module auquel l'écran est rattaché est actif pour le dossier.

    Un code activité vous permet de :

    • rendre optionnel un élément du dictionnaire si la valeur associée au code activité est nulle,
    • signer les éléments spécifiques dès lors qu'ils sont marqués par un code commençant par X, Y ou Z,
    • dimensionner un nombre de lignes maximum lorsque le code activité marque des éléments d'un tableau,

    Si le code activité est désactivé :

    • l'élément marqué n'est pas utilisable,
    • le code associé n'est pas généré ou activé.

    Scripts

    • Tratamento standard (campo PRGSTD)

    Neste tratamento, devem ser desenvolvidos :

    • o carregamento do quadro de consulta
    • os túneis e desdobramentos pelo botão direito.
    • A análise dos parâmetros de entrada na consulta.
    • O carregamento de código de ecrã segundo a chave de pesquisa.

    Este tratamento deve conter uma etiqueta $ACTION.
    Para mais amplas informações, consultar a Ajuda ao desenvolvimento

    • Tratamento especifico (campo PRGSPE)

    Reservado ao distribuidor. Comportamento idêntico ao tratamento standard.

    Dados

    Janela de base da consulta constituido de um ecrã de cabeçalho e de um separador com um quadro tendo por zona de rodapé NBLIG. Não é no entanto interdito acrescentar os separadores suplementares na condição de os alimentar por tratamento. Regras de construção.

    O ecrã quadro está também utilizado como ecrã de referência em gestão dos écrans de consulta

    Esta janela é facultativa. Ela agrupa os critérios de selecções, os critérios de ordenação, o código memo, o código de um ecrã parametrizável. Ela deve estar sem cabeçalho e com um separador único. Regras de construção.

     

    • campo SCRABB1

     

     

    • campo SCRABB2

     

     

    • campo SCRABB0

     

    Bloco número 4

    Esta zona é facultativa.

    • Se a janela de critérios está definida com uma zona ECRAN preenchido, o quadro afixado corrresponde ao ecrã associado ao código ecrã da janela de critérios (ecrã WM+Código consulta+Código ecrã).
    • Se a janela de critérios está definida com uma zona ECRAN vazia e que o código ecrã por defeito está parametrizado, o quadro afixado corresponde ao ecrã associado ao código ecrã por defeito (ecrã WM+Código da consulta+Código ecrã por defeito).
    • Senão, o quadro afixado corresponde ao ecrã quadro da janela principal.

    Quadro

    • Campos cabeç. (campo FLD1)

    Este quadro permite fazer corresponder as zonas critérios de ecrã cabeçalho com aqueles do ecrã de critérios e de identificar os critérios de afixação que sejam no ecrã de cabeçalho ou a janela de critérios. Em curso de consulta, a modificação dos critérios de afixação conduzirá a reafixação da página corrente de consulta, então que a modificação dos outros critérios conduzirá a uma nova pesquisa depois da primeira página.

    • Campos critério (campo FLD0)

     

    • Critério visualiz. (campo DSYCRI)

     

    Fechar

     

    Separador Tabelas

    Apresentação

    Neste separador, pode-se dar a listas das tabelas da base a abrir no início da consulta. Estas tabelas serão abertas com a abreviação do dicionário e acessíveis na consulta.

    Fechar

     

    Campos

    Os seguintes campos estão presentes neste separador :

    Quadro

    Indicar as tabelas a abrir em início de consulta. Elas serão abertas com a abreviação definido no dicionário das tabelas.

    Fechar

     

    Separador Diversos

    Campos

    Os seguintes campos estão presentes neste separador :

    Chave de pesquisa

    Indica-se o objecto associado, quando se deseja explorar e actualizar os últimos lidos pela consulta.

    permite a gestão dos botões redondos, se eles são parametrizados para esta consulta. Se um objecto foi indicado, a tabela gerada por este objecto será carregada aqui. Indica-se aqui sob qual abreviação utilizar esta tabela em gestão das consultas. Por defeito, a abreviação do dicionário das tabelas é proposta. Este campo não está utilizado para filtrar os registos a consultar.

    • campo FILABB

     

    • Chave (campo FILKEY)

    Indicar a chave de percurso da tabela, para os botões "redondos" e a gestão dos últimos lidos.

    • Zona estab. (campo ZSITE)

     

    • Zona cód. acesso (campo ZACC)

     

    • Condições (campo FILCND)

    Esta zona é facultativa. Ela permite de indicar um critério de selecção sobre a tabela de maneira a saltar certos registos inapropriados em utilização dos botões redondos ou em gestão dos últimos lidos.

    • Magnetos (campo MAGNETO)

    Permite de activar os botões redondos : Primeiro, Precedente, Seguinte e Último em alto da janela principal de consulta.

    Quadro

    • Componente de chave (campo CPNKEY)

     

    • Campos cabeç. (campo CPNSCR)

    Indicar a correspondência entre os componentes da chave e os campos do ecrã de cabeçalho de consulta.

    Bloco número 3

    Fechar

     

    Botões específicos

    permite gerar o tratamento automático ligado à consulta ( WWCNSxxx, ou xxx é o código da consulta)

    Os seguintes campos estão presentes na janela aberta por este botão :

    Bloco número 1

    • campo OBJET

     

    • campo CLES

     

    Bloco número 2

    • A partir do dossier (campo DOSORG)

    Use this field to define the folder from which the record will be copied. The possible syntaxes are described in the Dedicated appendix.

    • Todos dossiers (campo TOUDOS)

    Use this option to copy the record to all the folders defined in the dictionary (ADOSSIER table of the current solution).

    • Para o dossier (campo DOSDES)

    Use this field to define the folder to which the record will be copied. The possible syntaxes are described in the Dedicated appendix.

    Fechar

    Permite recopiar a definição da consulta versus um outro dossier Atenção, falta validar a consulta no dossier de destino.

    Este botão permite visualizar o desenho da janela principal. A consulta deve ter sido validado.

    Este botão permite visualizar o desenho da janela principal em modo web A consulta deve ter sido validada.

    Barra de menu

    Documentação / Parágrafos

    Esta função permite aceder à gestão da documentação, sobre o primeiro parágrafo da documentação (se ela existe) associada à ficha corrente.

    Documentação / Ligações

    Esta função permite aceder à gestão das ligações. Ela permite definir as relações entre a ficha corrente e de outras fichas (por exemplo das ligações entre funções e parâmetros). Estas ligações, puramente documentários, permitindo alimentar o mecanismo de geração dos esqueletos de documentação.

    Documentação / Geração

    Apresentação

    Este menu permite lançar uma geração de documentação. A geração pode-se lançar igualmente a partir do botão [Génération] em baixo da janela.

    Três tipo de geração podem ser lançadas, separadamte ou simultaneamente :

    • a geração do esqueleto de documentação a partir do dicionário (tabelas ADOCUMENT, ADOCBLB, ADOCCLB).
    • a geração da documentação a partir das tabels precedentes.
    • a geração da documentação sobre campo.

    Os limites propostos por defeito têm em conta da ficha em curso, mas elas podem ser modificados ao lançamento.

    Fechar

     

    Campos

    Os seguintes campos estão presentes neste separador :

    Selecções

    • Todas as línguas existentes (campo ALLLAN)

    Se esta check box está assinalada, todas as línguas são tomadas em conta pela operação.

    Se a check box não foi assinalada, tomar-se-á segundo o caso :

    • A língua por defeito do utilizador, se nenhum código língua não foi registado.
    • A língua registada por outro lado senão.

    Permite de definir a língua de geração (quando a check box permitindo de gerar em todas as línguas não foi assinalada).

    • Todos os tipos (campo ALLTYP)

    Se esta check box está assinalada, todos os tipos de documentação são tomados em conta para a geração. Deve-se referir que, neste caso, limita-se a geração às documentações standard (apenas as documentações de código inferior a X são tomados em conta).

    Permite definir o tipo de documentação a tomar em conta no tratamento (quando não se assinalou a check box para os tomar todos em conta).

    • Desde códigos documentos (campo FUNDEB)

    Permite de dar um limite sobre os códigos a ter em conta para a geração de documentação.

    • Cód. documentação fim (campo FUNFIN)

     

    Geração ADOCUMENT

    • campo GENDOC

    Este botão redondo permite criar/atualizar a parametrização da documentação (hierarquia dos parágrafos) a partir dos elementos técnicos encontrados no dicionário dos dados. Pode-se escolher de retomar unicamente as documentações existentes ou criar novas documentações se necessário

    As relações de documentação são igualmente tomados em conta. Os parágrafos susceptíveis de serem criados são definidos no anexo técnico correspondante.

    • Para todos os grupos (campo ALLCREGRP)

    Este campo permite escolher entre :

    • Tratar todas as documentações ou ajudas sobre campo indeferentemente do grupo de pertença de utilizador.
    • Tratar unicamente as documentações ou ajudas sobre campos cujo grupo de utilizador é equivalente ao grupo criador da documentação encontrada na tabela AOBJGRPDEV

    Geração documento final

    • campo GENFIN

    Este botão redondo permite gerar a documentação final a partir do conteúdo dos parágrafos de documentação. Esta documentação foi criada em diferentes sub-directórios do directório definido pelo parâmetro utilizador DIRDOC.

    A geração "Completa" trata o conjunto das documentações não tendo código de atividade mas também aquelas tendo os códigos atividades standards (código atividade < "X")

    Falta utilizar a geração "segundo o código atividade" para obter a geração das documentações das funções tendo os códigos atividades ativos (quer sejam standards ou específicos).

    • Somente as documentações validadas (campo HLPVLD)

    Permite gerar o documento final unicamente para as documentações válidas.

    • Ajudas sobre campos ligados às documentações (campo HLPLNKFLD)

    Si cette case est cochée, sont traitées spécifiquement les aides sur champs relatives aux documentations sur fonction ou objet traitées par ailleurs. Pour savoir quelles sont les aides sur champ à traiter, explorez les écrans associés aux paragraphes de documentation correspondants.

    • Outras ajudas sobre campos (campo HLPFLD)

    Se esta check box assinalada, cria-se a documentação final a partir do conteúdo dos parágrafos de documentação. Esta documentação foi criada em diferentes sub-directórios FLD do directório definido pelo parâmetro utilizador DIRDOC.

    • Códigos ajuda campos inicio (campo HLPDEB)

    Permite de dar um limite sobre os códigos a ter em conta para a geração de documentação.

    • Cód. ajuda campos fim (campo HLPFIN)

     

    • Directorio de geração (campo REPERT)

     

    Fechar

     

    Mensagens de erro

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

    Janela ... registo fechado

    Existe um lock lógico sobre esta janela.

    Janela inexitente

    A janela preenchida na consulta não foi declarada no dicionário das janelas.

    Janela sem ecrã de cabeçalho

    A janela principal deve obrigatoriamente ser composta de um cabeçalho e de ao menos um separador.

    Janela sem separador

    A janela principal deve obrigatoriamente ser composta de um cabeçalho e de ao menos um separador. A janela de critério deve obrigatoriamente ser composto de um separador.

    Janela com vários separadores

    A janela de critério não pode conter que um só separador.

    Janela com ecrã de cabeçalho

    A janela de crtério não pode conter o cabeçalho.

    Ecrã inexistente

    O ecrã associado à janela não está declarado no dioionário dos ecrãs.

    Ecrãs de mesma abreviação

    O ecrá de cabeçalho e separador associados à janela principal assim que o separador da janela de critérios devem ter uma abreviação diferente, Verificar o dicionário destes ecrãs.

    Ecrã sem quadro de baixo de págima NBLIG

    Para as necessidades do modelo de consulta, o separador da janela principal deve conter um quadro cuja variável de baixo de quadro deve se nomear NBLIG.

    Zona obrigatória

    Num quadro que associa campos de cabeçalho e campos da janela dos critérios, quando se cria uma linha, um campo deve estar indicado ao mínimo.

    O quadro de corespondente dos elementos da chave e os campos de cabeçalho deve estar registado.

    Campo inexistente

    Os campos definidos no quadro que associa campos de cabeçalho e campos da janela de critérios devem estar declarados nos ecrãs cabeçalho ou separador "critérios".

    Os campos definidos no quadro que associa campos de chave e campos de entidade devem estar declarados nos cabeçalhos cabeçalho.

    Este campo deve ser de tipo.

    No quadro que associa campos de cabeçalho e campos da janela de critérios, o campo de criterio deve pelo mesmo tipo de dado que aquele do cabeçalho.

    No quadro que associa campos de chave e campos de cabeçalho, os campos devem ser do mesmo tipo de dois a dois.

    Chave inexistente

    A chave declarada deve existir no dicionário da tabelas preenchida no campo precedente.

    Zona inexistente

    O campo para o estabelecimento deve existir o dicionário da tabela prenchida sobre este separador.

    Ficheiro inexistente:

    O tipo de gráfico deve estar um ficheiro de extenção vtc, e deve estar presente no sub-diretorio GRAPH do dossier corrente.

    Tabelas consideradas

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