Janelas
Esta função permite criar e alterar as janelas do software definindo a sua descrição numa tabela.
De modo que um tratamento possa ser executado em modo cliente-servidor como em modo Web, é imperativo agrupar os ecrãs de uma mesma afixação numa janela.
Cada janela é constituída de uma lista de ecrãs, menus, botões baixos de ecrã, e de motores de pesquisa. Para cada menu e botão, tem-se as suas acções respectivas, bem como os parâmetros eventuais destas acções.
Para um modelo objecto, uma janela deve ser criada com um código Oxxxonde xxxé o código objecto desta norma, e é aconselhada fortemente mas contudo não obrigatória. Contudo, é possível associar várias janelas um objecto e para permitir os objectos à alternativa. Estas janelas suplementares são geradas automaticamente em validação de transacção de registo com um código WOxxxyyy onde xxx é o código do objecto e yyy o código da transacção.
Pré-requisitos
Consulte a docuemntação de Implementação
Gestão do ecrã
A definição de uma janela faz-se através de 4 separadores: um conjunto de lista dos ecrãs, um separador de listas dos botões e menus, um separador de um conjunto de botões banalizados e um separador de um conjunto de browsers..
Cabeçalho
Apresentação
Janela
Identificador único dos 10 caracteres.
Fechar
Campos
Os seguintes campos estão presentes neste separador :
| O código da janela deve ser composto de 1 a 10 caracteres (letras ou caracteres mas começando obrigatoriamente por uma letra). É recomendada de nomear uma janela ligada a um objeto Oxxx où xxx é o código objeto. As palavras reservadas de Sage são interditas. |
|
|
Fechar
Separador Ecrãs
Apresentação
Lá encontram-se as informações ligadas à gestão global da janela:
Janela de modelo
Este campo permite definir janelas que nunca serão validadas. Do mesmo modo, se uma janela, contem um ecrã exemplar, ela não será validada.
“Flag” activa
Este campo permite activar ou desactivar uma janela.
Código actividade
Se for definido, um código actividade lista unida a uma janela permite tornar esta opcional: se o código actividade não for activado no dossier, a janela não será acessível aos utilizadores do dossier. Um código actividade que começa por uma das 3 letras X, Y ou Z tornará a janela específica; esta não será actualizada aquando de uma próxima validação de dossier.
Módulo
Este valor permite unir a janela a um grupo funcional.
Tipo de janela
Este campo indica ao supervisor o contexto no qual a janela é chamada:
Objecto:Janela chamada em gestão objecto.
Consulta: janela principal chamada em consulta.
Critérios de consulta: janela de critérios chamado em consulta.
Diversos: A indicar para todo outro contexto de chamada para esta janela.
Afixação
Este campo indica ao supervisor sob qual forma esta janela deve ser afixada:
Pleno écran:janela aberta para a instrução Inpbox.
Caixa de diálogo: janela aberta pela instrução Dlgbox.
Caixa de mensagem: Janela aberta pela instrução Messbox. Neste caso, não há barra de menu.
Código de acesso
Este código permite proibir o acesso à janela para certos utilizadores. Se a zona for informada, só os utilizadores que terão este código acesso no seu perfil, poderão aceder a esta janela de acordo com os direitos atribuídos.
Objecto / Transacção / Título transacção
Quando a função é gerida por um objecto, a janela é gerada à validação deste objecto. O código objecto permite a relação desta janela com o objecto. Sobre objectos à alternativa, ter-se-á tantas janelas que há de transacções. Estas janelas são geradas à validação das transacções de registos. O código transacção permite a relação desta janela com a transacção.
Consulta
Este campo deve informar-se para uma janela de tipo consulta ou critérios de consulta.
Ecrã de cabeçalho/separadores
Lista dos ecrãs a afixarem. Quando se tem apenas só um ecrã, é necessário definir em como separador.
Para as janelas ligadas no objecto e nas sequências da transacção (código transacção informadas), estas informações são procedente da transacção. Atenção! Não serve de nada alterar os códigos separadores dado que estas informações são geradas a partir da validação da transacção.
Quando se posiciona-se um separador invisível, a classe [ M ] do ecrã está bem presente. Quando se desactiva um separador por um código de actividade inactivo, a classe [ M ] do ecrã está ausente.
Fechar
Campos
Os seguintes campos estão presentes neste separador :
Características
| Este campo permite definir as janelas que não serão nunca validadas. Assim, se uma janela, contém um ecrã modelo, ela não será válida. |
| Este campo permite desativar a janela. Se esta janela faz parte de um conjunto de transações ligadas ao mesmo objeto, ela não aparecerá mais no botão transação da gestão de objeto |
| Esta flag indica que esta janela está ao formato VT. |
Bloco número 2
| Este código de acesso permite interdir o acesso à janela (transação) para certos utilizadores. Se a zona está preenchida, apenas os utilizadores que terão este código de acesso no seu perfil poderão aceder à janela segundo os direitos acordados. |
| É possível de definir várias janelas para um mesmo objeto Neste caso, para distinguir as janelas entre elas, falta definir as transações. Na gestão do objeto, o botão transação permite visualizar os títulos das transações acessíveis. A variável GFLAG permite definir uma transação antes de reentrar na gestão de objeto. Pode-se definir as transações sem que haja um objeto definido. Neste caso, falta gerar "manualmente" as diferentes transações. |
|
|
|
|
| Este campo está a registar para uma janela de tipo consulta ou critérios de consulta. |
Bloco número 5
| Un code activité vous permet de :
Si le code activité est désactivé :
|
| Indique o módulo para o qual é utilizada esta janela. Se a janela é utilizada por vários módulos, indique "supervisor". |
| Este campo indica ao supervisor o contexto no qual a janela está chamada :
|
| Permite indicar o tipo da janela :
|
Ecrãs a abrir
| Dá o nome do ecrã que está posicionado acima do ou dos separadores Quando não existe que um único ecrã, está a definir em tanto que um separador. |
Quadro Separadores
| Indique o nome dos ecrãs de gestão na ordem de afixação das páginas. Falta ao menos um ecrã numa janela Para as janelas ligadas ao objeto mas emitidas das transações (código transação registado), estas informações são emitidas da transação. Atenção! não serve de nada modificar os códigos separadores pois que estas informações são regeradas desde a validação da transação. |
|
|
| A fila permite ordenar os separadores na janela. É inicializada de 5 em 5. O acréscimo de um ecrã específica deve se fazer ao fim do quadro; é a fila que permite de a colocar no local pretendido na janela. |
| Se este campo não está assinalado, o separador e os campos deste estão invisíveis. Esta função permite de utilizar uma mesma gestão de objeto seja para um registo completo (janela com todos os separadores) seja para uma visualização rápida em mascando certos separadores. Quando se posiciona um separador invisível, a classe [M] do ecrã está bem presente. |
| Quando se desativa um separador por um código atividade inativa, a classe [M] de ecrã está ausente. |
Fechar
Separador Botões/menus
Apresentação
Se encontra o conjunto dos botões disponíveis na parte inferior da janela, assim como os menus que aparecem em parte superior da janela. Ter-se-á uma acção associada a cada botão ou menu. Um botão ou um menu declara-se da maneira seguinte:
Tipo
Menu local que permite de distinguir o botão do menu, ou da linha de menu.
Código botão
Código sobre 1 caracter para os botões.
Código sobre 1 de 2 caracteres para os menus (1 caracter para os menus de primeiro nível; 2 caracteres para os menus de 2º nível).
Código sobre 2 de 3 caracteres para as linhas (2 caracteres para os elementos de um menu de primeiro nível; 3 caracteres para os elementos de um menu de 2º nível).
Os caracteres autorizados para o específico são todas as letras minúsculas.
Os caracteres autorizados para o standard são as letras maiúsculas bem como os números. Atenção, é necessário ter em conta a restrição definida abaixo para as janelas ligadas um objecto ou uma consulta. Com efeito, não se pode utilizar os códigos já utilizados para os botões do supervisor.
Os códigos disponíveis para os botões das janelas objecto são:
BGOUVYZ0123456789
Os códigos disponíveis para os botões das janelas principais de consultas são:
ABHIJKMNOPQSTUVWXYZ12345678
Texto botão
Texto do botão ou o menu. Estes textos traduzíveis, são armazenados numa tabela dedicada.
É possível deixar o texto vazio a fim de definir um separador no menu associado.
Acção
O código acção faz referência dicionário das acções, recipiente à vez o código tratamento, e a lista dos parâmetros. Na gestão das janelas, o valor para estes parâmetros deve registar em do 2ºquadro, e, para cada acção.
Quando o tratamento desencadeado pelo botão, não abre janela, e apenas neste caso, ele é possível remeter STD ou SPE no código acção. Esta vez, é o subprograma EXEBOUT do tratamento SUBxxx ou SPExxx que executar-se-á (xxx o código objecto).
Código actividade
Se for informado, permite tornar activo ou inactivo um botão ou um menu. Um botão ou um menu inactivo não aparece mais sobre a janela. Se este código começa por uma das letras X, Y, ou Z, identifica o específico que não será actualizado aquando da instalação de uma próxima versão.
Quadro dos parâmetros
Quando é posicionado sobre uma linha do quadro das acções, os parâmetros desta acção (procedentes do dicionário das acções) são apresentados a fim de lhes registar uma expressão que dá o valor do parâmetro aquando da chamada. Esta expressão pode fazer intervir constantes, funções e variáveis em linha aquando da chamada.
Fechar
Campos
Os seguintes campos estão presentes neste separador :
Quadro Tipo
| Menu local permitindo distinguir o botão, do menu, ou da linha de menu. O botão se posiciona automaticamente em baixo da janela ; o menu está colocado ao alto da janela seguinte ao Ficheiro / Edição / ... |
| Trata-se do código do botão utilizável em programação nas ações AVANT_BOUT, EXEBOUT, etc.. Da mesma maneira, identifica-se os menus, podendo ser definido sobre 2 níveis, mais as linhas de menus O código do nível inferior retoma em primeiro(s) caracter(es) aquele do nível superior. Exemplo, o menu A está cortado em menus AB e AC, eles mesmo respectivamente cortados em AB1 e AB2, depois AC3 e AC4. Os caracteres autorizados pelo específico são todas as letras minúsculas. Os caracteres autorizados para o standard são as letras maiúsculas assim que os números. Atenção, falta ter en conta da restrição definida a seguir para as janelas ligadas a um objeto ou a uma consulta. Com efeito, não se pode utilizar os códigos já utilizados para os botões do supervisor. Os códigos disponíveis pelos botões das janelas objeto são : BGOUVYZ0123456789 Os códigos disponíveis pelos botões das janelas principais de consulta são : ABHIJKMNOPQSTUVWXYZ12345678 |
|
|
|
|
| O código ação faz referência ao dicionário das ações, contendo à vez o código tratameto, e a lista dos parâmetros. Na gestão das janelas, o valor para estes parâmetros está a prencher no 2º quadro, e, para cada ação. Quando o tratamrto deencadeado pelo botão ou o menu, não abre a janela, e apenas neste caso, é possível de referenciar STD, SPE ou SPV no código ação. Para uma janela objeto, por exemplo, o sub-programa EXEBOUT ou STATUT do tratamento SUBxxx, SPExxx ou SPVxxx se ewxecutará então ( xxx sendo o código objeto). |
| Un code activité vous permet de :
Si le code activité est désactivé :
|
Quadro Parâmetros
|
|
| Quando se está posicionado sobre uma linha do quadro das ações, os parãmetros desta ação (emitidas do dicionário das ações) são afixadas afim do seu registo uma expressão dando o valor do parãmetro ao momento de chamada. Esta expressão pode fazer intervir as constantes, das funções e de variáveis em linha no momento de chamada. |
Fechar
Separador Botões pré-definidos
Apresentação
Encontra-se, o conjunto dos botões banalizados, num quadro que desenrola.
É uma lista bloqueada de botões, à qual se pode trazer as informações seguintes:
Sim / Não
Permite de tornar presente ou não um botão banalizado.
Acção
Para um botão tornado activo, é possível informar um código acção. O código acção faz referência dicionário das acções, recipiente à vez o código tratamento, e a lista dos parâmetros. Na gestão das janelas, o valor para estes parâmetros deve se preencher do 2º quadro, e, para cada acção.
Quando o tratamento desencadeado pelo botão, não abre janela, e apenas neste caso, ele puder informar nada neste código acção mas utilizar as acções adequadas do objecto.
Quadro dos parâmetros
Quando é posicionado sobre uma linha do quadro das acções, os parâmetros desta acção (procedentes do dicionário das acções) são apresentados a fim de lhes registar uma expressão que dá o valor do parâmetro aquando da chamada. Esta expressão pode fazer intervir constantes, funções e variáveis em linha aquando da chamada.
Fechar
Campos
Os seguintes campos estão presentes neste separador :
Quadro Botões
|
|
|
|
|
|
| Permite tornar presente ou não um botão banalizado. |
| O código ação faz referência ao dicionário das ações, contendo à vez o código tratameto, e a lista dos parâmetros. Na gestão das janelas, o valor para estes parâmetros está a prencher no 2º quadro, e, para cada ação. Quando o tratamrto deencadeado pelo botão ou o menu, não abre a janela, e apenas neste caso, é possível de referenciar STD, SPE ou SPV no código ação. Para uma janela objeto, por exemplo, o sub-programa EXEBOUT ou STATUT do tratamento SUBxxx, SPExxx ou SPVxxx se ewxecutará então ( xxx sendo o código objeto). |
Quadro Parâmetros
|
|
| Quando se está posicionado sobre uma linha do quadro das ações, os parãmetros desta ação (emitidas do dicionário das ações) são afixadas afim do seu registo uma expressão dando o valor do parãmetro ao momento de chamada. Esta expressão pode fazer intervir as constantes, das funções e de variáveis em linha no momento de chamada. |
Fechar
Separador Browser
Apresentação
Encontram-se informações sobre o motor de pesquisa dos últimos lidos.
Afixação
Indica-se por esta check box, se deseja ter uma lista dos últimos sobre esta janela.
Em primeira posição
Indica-se por esta check box a assinalar, que se coloca a lista dos últimos lidos em primeira posição. Aquilo pode ser interessante, se o motor de pesquisa principal é longo a afixar.
Afixação browser
Permite indicar a amplitude que a lista de esquerda tomará quando se passa de baixo em elevada resolução e, em modo C/S. Aquilo permite indicar janela por janela se usa antes o motor de pesquisa ou antes o separador ou um misto do 2. A escolha será a seguinte:
Mínima: Comprimento do browser resta constante. É o separador que se estira.
Média: mista das 2
Larga: amplitude do motor de pesquisa estira-se. A amplitude do separador continua a ser constante.
Se encontra, o conjunto dos motores de pesquisa, num quadro que desenrola. É limitado a 9 motores de pesquisa: 6 são reservados ao standard, 3 ao específico. Cada motor de pesquisa é definido pelas informações seguintes:
Objecto
É o identificador do motor de pesquisa. Trata-se bem de um código objecto, dado que cada motor de pesquisa deve definir-se no dicionário dos objectos. Para o motor de pesquisa principal do objecto, o seu código é o código do objecto ele mesmo, dado que este motor de pesquisa é definido directamente no objecto.
Index, sentido
É o índice e sentidos de percursos da tabela principal.
Tipo lista
Permite de definir o tipo do browser: Simples, hierarquizado, picking simples, picking (hierarquizado) recursivo.
Browser
Se este campo for posicionado a SIM, ao duplo - clique nesta lista de esquerda, o supervisor alimenta directamente as informações do registo seleccionado na parte direita do ecrã.
Pré-carregamento
Gestão pré-carregamento da lista de esquerda, à afixação da janela. Possibilidade de carregar parcial ou totalmente os registos pelo supervisor, ou não carregar nada.
Abreviação
Abreviatura da tabela explorada pelo motor de pesquisa. Tem-se a possibilidade de ter 2 motores de pesquisa que se apoiam sobre uma mesma tabela. Atenção, é necessário indicar neste motor de pesquisa (dicionário objecto/separador de selecção) a abreviatura seguida do campo nas expressões dos elementos listados. Exemplo: objecto ORD.
Filas
Ordem de colocação dos motores de pesquisa. É um número inicializado com um passo de 5. Permite a inserção de motores de pesquisa específicos.
Flechas
Se sim (opção por defeito), as flechas aparecem nas rubricas de lista de esquerda e permitem a paginação. Tem-se a possibilidade de proibir a paginação, por exemplo para paginações complexas não desenvolvidas ou que pede demasiado recursos sistemas.
Expressão de relação
Expressão necessária para uma lista recorrente a fim de fazer a relação entre o registo mãe e filho.
Fechar
Campos
Os seguintes campos estão presentes neste separador :
Última leitura
| Esta check box permite de activar/desactivar a lista de esquerda Últimos lidos. |
| Este campo permite colocar em primeira posição a lista de esquerda "Últimos lidos". |
Quadro Objectos
| Este campo corresponde a um objeto Este objeto pode ser um objeto do tipo "Browser", especialemnte dedicado a uma lista de esquerda. |
|
|
| Esta zona permite definir um índice de percurso do ficheiro principal para a afixação na lista de esquerda e das janelas de selecção. Se a zona está vazia, é o primeiro índice da tabela que foi utilizada. |
| Esta zona permite definir um índice de percurso da tabela principal para a afixação na lista de esquerda e das janelas de selecção do objecto. |
|
|
| Se esta zona está a sim, o duplo clique nesta lista de esquerda permitirá afixar o registo seleccionado, na parte direita do ecrã.
|
| Esta zona permite gerir o pré-carregameto da lista de esquerda ao arranque.
|
| Abreviação da tabela explorada pela lista esquerda. Temos a possibilidade de ter 2 browsers se apoiando sobre uma mesma tabela. Atenção, falta indicar neste browser (dicionário objecto / separador selecção) a abreviação seguida do campo nas expressões dos elementos listados. Exemplo: objecto ORD. |
| A fila permite de ordenar as listas esquerdas na janela. É inicializada de 5 em 5. O acréscimo lista esquerda específica deve se fazer ao fim do quadro; é a fila que permite de a colocar no local pretendido na janela. |
| Un code activité vous permet de :
Si le code activité est désactivé :
|
| Posicionado a sim por defeito. neste caso, as setas aparecem no cabeçalho da lista esquerda e permitem a paginação. Tem-se a possibilidade de interdir a paginação, por exemplo, para as paginações complexas não desenvolvidas ou pedindo muitos recursos do sistema. |
| Expressão necessária para as listas recursivas afim de fazer a ligação entre o registo mãe e filho. |
Fechar
Listagens
Por defeito, os seguintes listagens estão associados à função :
AWINDOW : Dicionário das janelas
Mas pode ser alterado por parametrização.
Barra de menu
A validação permite gerir o tratamento automático ligado à janela (WGxxxx, ou xxxx é o código janela) |
Este botão permite recopiar a definição da janela para um outro dossier. Atenção, será necessário validar a janela no dossier de destino. |
Este botão permite visualizar o resultado. O ecrã deve ter sido validado. |
Este botão permite visualizar o resultado em modo Web. O ecrã deve ter sido validado. |
Barra de menu
Validação / Validação global
Esta validação global executa a validação do conjunto de ecrãs, a validação do objecto se for informado, e a validação da janela.
Mensagens de erro
Para além das mensagens genéricas, as seguintes mensagens de erro podem aparecer durante o reg. :
Máscara remetida nos separadores
O ecrã que se tenta registar em cabeçalho está já presente na lista dos separadores.
Não é um ecrã de cabeçalho
O ecrã remetido no cabeçalho não é de tipo cabeçalho.
Ecrã modelo \ os ecrãs exemplares podem ser definidos apenas sobre as janelas exemplares
Um ecrã exemplar pode ser executado, por conseguinte senão pode lista unida apenas uma janela exemplar.
Máscara referência em cabeçalho
O ecrã que se tenta registar num separador está já presente em cabeçalho.
Zona obrigatória
Se a janela é de tipo objecto, o código objecto é obrigatório.
Se a janela é de tipo consulta ou critérios de consulta, o código consulta é obrigatório.
“ ” ”Caracter interdito
Por razões técnicas, o carácter “ “ ” é proibido nos títulos: títulos da transacção.
Código já registado em linha nn
Os códigos botão, e linhas de menu devem ser únicos para a janela.
Menu inexistente
O código de uma linha de menu é constituído de um carácter para identificar um menu e o seu próprio carácter de identificação. O carácter de identificação do menu não é conhecido.
Código incorrecto
Os códigos autorizados para os botões e linhas de menu são as letras maiúsculas e minúsculas bem como os números. Os caracteres de acordo com são autorizados igualmente para as linhas de menu:
" , “ , < , >.
Código reservado
Para os botões das janelas objectos e consulta, não tomar os códigos reservados aos botões do supervisor. Os códigos reservados para uma janela objecto são os seguintes: ACDEFHJKLMRTW09@+=<>
Os códigos reservados para uma janela consulta são os seguintes: CDEFGLR09<>=+ -
Lista de esquerda impossível com este objecto
Não é possível inserir a lista esquerda definida sobre um objecto de tipo quadro.
O número de zonas de selecção é nulo
Tenta-se reacrescentar um browser que não tem nenhuma zona definida para a lista de esquerda.
Campos de selecção incompatíveis com o índice
Sobre uma lista hierarquizada (simples ou picking), o número de elementos declarados para a lista de esquerda deve ser superior ou igual ao número de elementos do índice utilizado.
Existe um ecrã de cabeçalho
Quando vários separadores são definidos, deve-se informar um ecrã de rubrica.
Deve existir um separador
Deve-se informar pelo menos um separador, quando um ecrã de rubrica é definido para esta janela.