Os componentes XSL

Planning mensal

Gráfico associado a um quadro X3, permitindo visualizar e modificar um planing apresentado mês por mês.

O componente apresenta:

• x grupos de n meses a partir de um quadro de dados.
• Uma palete permitindo fazer desfilar os grupos de meses.
• Um pavimento legenda compreendendo uma lista de actividades associadas a uma cor seleccionada. Ela permite afectar uma actividade a um período.

As possibilidades ligadas a este planning mensal:

• Corte do conjunto das jornadas em 1 a 4 limites
• Gestão de 12 meses máximo, eventualmente a cavalo sobre dois anos.
• Afixagem de 1 a 12 meses simultâneamente. Segundo esta parametrização, poder-se-á ter um ascensor vertical
• Selecção de limites, no limite de um mês, por afectação de uma actividade.
• Três tipos de dia obrigatóriamente (menu local 9836) : aberto, fim-de-semana, feriado
• Uma actividade não pode afectar que sobre os dias abertos.
• Interdir o registo de actividade sobre um período, em afectando pelo valor -1, sobre os limites a interdir.
• Reduzir o número de limites, antes a afixação do planning, em embraquecendo o literal da entidade de uma ou várias colunas tipificadas PLAGn.  
• Personalização das actividades e sua associação às cores por menus locais.

Utilização do componente

Clique direito sobre um período:

chamada do menu contextual da linha de quadro correspondente ao período.

Clique sobre o período ou selecçaõ período:

Com um tipo de actividade seleccionada, o período passa na nova cor.

Utilização da palete

É necessário seleccionar uma actividade. Seu intitulado passa em cinzento.
Pode-se então seleccionar os limites de dias onde esta actividade vai preencher a actividade actualmente em lugar. O componente XSL vai portanto contactar o servidor em utilizando o programa de interacção definida na parametrização de XSL. É o servidor que se carrega da actualização dos dados do quadro sub-jacente. Se o servidor reenvia um código retorno diferente de 1, a actualização local está anulada. O programa entregue em standard, não autoriza a afectação de uma actividade aos dias feriados e aos fins-de-semana.

Possibilidades de concepção

• Afectação de 1 a 8 actividades
• Corte do conjunto das jornadas em 1 a 4 limites
• Gestão de 12 meses máximo, eventualmente em cima sobre os dois anos.
• Afixação de 1 a 12 meses simultaneamente. Segundo a parametrização, poder-se-á ter um ascensor vertical.
• Selecção de limites, no limite de um mês, para a afectação de uma actividade.
• Três tipos de dia obrigatoriamente (menu local 9836) : aberto, fim-de-semana, feriado
• Uma actividade não pode afectar que sobre os dias abertos.

Para funcionar, o componente XSL planning tem necessidade das informações trazidas pelo quadro associado ao gráfico e pela parametrização de XSL

O ecrã

O quadro X3 compreende uma linha por dia, e representa no máximo 12 meses eventualmente sobre dois anos.
O componente XSL planning tem necessidade para funcionar de identificar as colunas do quadro X3; aqueles devem ser então tipificados pela rubrica "Parametrização" sobre o separador campo.

Tipificação das colunas:

O tipo indica ao processador XSL o modo de utilização da coluna. O quadro deve conter os campos tipificados seguintes :

Se se deseja funcionar com programa de interacção standard AMAJPLAN, os nomes de campos seguintes são impostos porque eles são em "duro" no programa. É possível chamar os campos de outra forma em definindo um outro programa de interacção.

As opções do componnete XSL

O componnete XSL planning mensal APLANM propõe as opções seguintes :

• NBMONT : Número de mês afixado simultaneamente (valor de 1 a 12).
• MENACT : Menu local tipo de actividade (por defeito, 9837 com 5 valores em standard). Os elementos deste menu local são modificáveis. Este parâmetro, dá a possibilidade de fazer chamada a um outro menu local. 25 actividades são autorizados se se personaliza a sua cor pelo parâmetro MENCOL.
• MENCOL : Menu local cor de actividade. Facultativo. Este menu local deve estar em concordância com o menu local dos tipos de actividade.
• SDATA : Reactualização do gráfico seguinte à devolução de interacção. Valor 1 ou 2. Deixar o valor por defeito Não (1), porque este XSL toma em carga a actualização do gráfico.
• PINTER : Programa de interacção. Por defeito, chama-se o programa AMAJPLAN, no entanto, é possível de chamar um outro, que permite nomear os campos de outra forma e de intervir sobre as regras de aceitação, de interacção ou de acumulado.

O parâmetro XSL

Estes três menus locais são entregues em standard, e associados a um código na parametrização de XSL :

• 9001 : MÊS - Literal dos meses
• 9833 : DIA - Literal dos dias
• 9834 : ABRDAY - Literal afectado dos dias

Eventualmente a possibilidade de afectar outros menus locais a estes códigos que eles são fixos.

Interacções

Elas são definidas e modelizadas via um sub-programa standard MAJPLAN de AMAJPLAN ao qual se passa em parâmetro :

O componnete espera 365 ou 366 linhas no quadro, representando 12 meses sucessivos que podem se estender sobre 2 anos.

Planning anual

Gráfico associado a um quadro X3, permitindo visualizar e modificar um planing em apresentação anual. O contexto é idêntico ao planning mensal.

Utilização do componente

Idem planning mensal

Utilização da palete

Idem planning mensal

Possibilidades de concepção

• Afectação de 1 a 8 actividades
• Corte do conjunto das jornadas em 1 a 4 limites
• Gestão de 12 meses máximo, eventualmente em cima sobre os dois anos.
• Selecção de limites, no limite de um mês, para a afectação de uma actividade.
• Três tipos de dia obrigatoriamente (menu local 9836) : aberto, fim-de-semana, feriado
• Uma actividade não pode afectar que sobre os dias abertos.

O componentes XSL planning tem necessidade para funcionar de identificar as informações seguintes, que são portados pelo quadro associado e pela parametrização de XSL.

O ecrã

Idem planning mensal

As opções do componnete XSL

O componente XSL planning anual APLANY propõe as opções seguintes : 

• MENACT : Menu local tipo de actividade (por defeito, 9837 com 5 valores em standard). Os elementos deste menu local são modificáveis. Este parâmetro, dá a possibilidade de fazer chamada a um outro menu local. 25 actividades são autorizados se não se personaliza a sua cor pelo parâmetro MENCOL.
• MENCOL : Menu local cor de actividade. Facultativo. Este menu local deve estar em concordância com o menu local dos tipos de actividade.
• SDATA : Reactualização do gráfico seguinte à devolução de interacção. Valor 1 ou 2. Deixar o valor por defeito Não (1), porque este XSL toma em carga a actualização do gráfico.
• PINTER : Programa de interacção. Por defeito, chama-se o programa AMAJPLAN, no entanto, é possível de chamar um outro, que permite nomear os campos de outra forma e de intervir sobre as regras de aceitação, de interacção ou de acumulado.

O parâmetro XSL

Idem planning mensal

Radar

Visualização de um quadro com uma representação gráfica sob a forma de radar sobre o qual :

• cada cor representa uma linha do quadro.
• Cada eixo representa uma coluna de valor do quadro.

As possibilidades ligadas a este radar:

• Gráfico em visualização unicamente
• Botão possível sobre variável de baixo de quadro acessível, sobre o gráfico, por clique direito sobre cada cor.
• Possibilidade de afixar um sinal de valor máximo.
• Possibilidade de afixar uma escala
• Vários elementos visualizados (linha quadro). se limitar a um número razoável, para a claridade do gráfico.
• Vários eixos visualizados (coluna quadro). 3 no mínimo e se limitar a um número razoável, para a claridade do gráfico.

Utilização do componente

Sobrevôo de uma zona:

• Aumento da opacidade da zona
• Info bolha literal

Clique sobre zona:

• Pedido de posicionamento ao servidor (linha de quadro correspondente)

Clique sobre zona:

• Pedido de posicionamento (linha de quadro correspondente)
• Botão do Menu contextual (linha de quadro correspondente)

Clique sobre cor legenda:

• Passa ao primeiro plano da zona correspondente
• Aumenta a opacidade

Clique sobre "olho" legenda:

• Máscara a zona correspondente

O componente XSL radar necesidade para funcionar de identificar as informações seguintes, que são trazidas para o quadro associado e pela parametrização de XSL

O ecrã

O componnete XSL planning tem necessidade para funcionar de um quadro X3. Cada linha de quadro permite calcular uma "superfície".

Definição das colunas:

• A primeira coluna visível do quadro deve ser um identificador.
• A segunda coluna visível do quadro deve ser o literal; este será axcessível na palete.
• Todas as outras colunas são consideradas como tanto de eixos de análises. Elas devem ser numéricas (inteiro/decimal), e ter um título. O quadro deve comportar pelo menos 3 eixos.

Quando não se preenche o título de uma coluna numérica, isso permite fazer desaparecer o eixo correspondente.

Estas colunas devem ser então tipificadas pela rubrica "Parametrizaação" sobre o separador campo.

Tipificação das colunas:

O tipo indica ao processador XSL o modo de utilização da coluna. O quadro deve conter os campos tipificados seguintes :

Tipo	Descrição
	Obrigatório. Variável de baixo de quadro
Chave...	Obrigatória. deve conter um identificador único.
Descrição	Obrigatório. Deve conter o intitulado do identificador.
Valor	Um campo por eixo de análise cujo título está indicado no intitulado. Estes campos devem ser de tipo inteiro ou decimal.

As opções do componnete XSL

O componente XSL planning radar ARADAR propõe 3 opções :

• SCALE : Permite de fixar uma escala de representação (por defeito 0). Se esta escala é a 0, o componente adapta a sua escala ao maior valor a representar encontrado, senão os valores são reportados à escala.
• MENSCA : Menu escala. Permite de definir uma legenda para os diferentes valores da escala. Este informação deve ser um número de menu local. Se o valor está a 0 (defeito), não existe escala afixada.
• SDATA : Reinicialização do gráfico seguinte à devolução de interacção depois o gráfico. Valor 1 ou 2. Nenhuma incidência, pois que este gráfico está em leitura unicamente.

Nomenclatura horizontal

Visualização de um quadro com uma representação gráfica sob a forma de organigrama sobre o qual :

• cada elemento representa uma linha do quadro.

As possibilidades ligadas à nomenclatura horizontal :

• possibilidade de deslocar um elemento e todo o que lhe está reafixado (submetido a parametrização)
• possibilidade de afixar uma imagem ou diferentes linhas de texto nos quadros (submetidos a parametrização)
• possibilidade de afectar um estilo para colocação em páginas dos textos (submetidos a parametrização)
• possibilidade de ter um menu contextual para cada elemento (supressão elemento para acção botão)
• Possibilidade de executar um tratamento associado ao duplo clique (submetidos a parametrização)

Utilização do componente

Sobrevôo de uma zona:

• Info bolha literal longo

Clique sobre zona:

• Pedido de posicionamento ao servidor (linha de quadro correspondente)

Clique direito sobre zona:

• Pedido de posicionamento (linha de quadro correspondente)
• Pedido de posicionamento ao servidor (linha de quadro correspondente)

O ecrã

Campos do quadro

O quadro X3 deve ser constituido de uma linha por elemento da nomenclatura.

O componente XSL nomenclatura tem necessidade para funcionar de identificar as colunas do quadro X3; estas devem ser tipificadas pela rubrica "parametrização" sobre separador campo.

Tipificação das colunas:

O tipo indica ao processador XSL o modo de utilização da coluna. O quadro deve conter os campos tipificados seguintes :

Se se deseja funcionar com programa de interacção standard AMAJPLAN, os nomes de campos seguintes são impostos porque eles estão em "duro" no programa. É possível chamar os campos de outra forma em definindo um outro programa de interacção.

As opções do componnete XSL

O componente XSL nomenclatura horizontal ANOMH propõe 5 opções : 

• MODHIE : Autorizar o deslocamento de um elemento e todo o que lhe está reafixado. Valor : 1 não / 2 sim. Por defeito Sim(2).
• SIZEB: Tamanho do quadro de cada elemento em pixeis exprimido em altura, largura da caixa, altura do texto nesta caixa. (tamanho por defeito : 100,100). Se o tamanho texto não foi indicado, 20px são reservados.
• SDATA : Desconto do gráfico seguinte à devolução de interação. Valor : 1 não / 2 sim. Por defeito SIM (2). O gráfico foi recalculado, cada vez que os dados são modificados qualquer que seja a origem (quadro ou gráfico). Posicionado a NÃO, o gráfico não foi recalculado, seguinte a uma interação do utilizador sobre o gráfico ele mesmo (por contra, recalculado seguinte a uma actualização do quadro).
• PINTER : Programa de interacção. Por defeito chama-se o programa AMAJHIER, é possível de chamar um outro, o que permite de chamar os campos de outra forma e de intervir sobre as regras de aceite de interação.
• EXECFL : Autorizar a chamada de um sub-programa sobre duplo-clique sobre o elemento do último nível.

O parâmetro XSL

Interacções

Elas são definidas e modelizadas via um sub-programa standard MAJHIER de AMAJHIER ao qual está passado em parâmetro :

Para suprimir um elemento, utilizar-se-á uma acção botão sobre a variável de baixo de quadro, e escrever-se-á:

Local Char MESSAGE(100)
Local Integer CODRET
Call MAJHIER("D",nolign,"",0,MESSAGE,CODRET) From AMAJHIER
If CODRET<>1
   Call ERREUR(MESSAGE) From GESECRAN
Endif

Nomenclatura vertical

Visualização de um quadro com uma representação gráfica sob a forma de organigrama sobre o qual :

• cada elemento representa uma linha do quadro.

As possibilidades ligadas à nomenclatura horizontal :

• dobrar - desdobrar um elemento (clique)
• deslocar um elemento e todo o que lhe está reafixado (submetido a parametrização)
• suprimir um elemento e todo o que lhe está reafixado (clique direito)
• executar um tratamento sobre duplo clique sobre último elemento (submetido a parametrização)

Utilização do componente

Sobrevôo de uma zona:

• Info bolha literal curto
• Modificação da cor e sublinhamento do texto "sobrevoado"

Clique sobre zona:

• Pedido de posicionamento ao servidor (linha de quadro correspondente)
• Inverso vídeo sobre o texto

Clique direito sobre zona:

• Pedido de posicionamento (linha de quadro correspondente)
• Pedido de menu contextual ao servidor (linha de quadro correspondente)
• Inverso vídeo sobre o texto

O ecrã

O quadro X3 deve ser constituido de uma linha por elemento da nomenclatura.

O componente XSL nomenclatura vertical tem necessidade para funcionar de identificar as colunas do quadro X3; estas devem ser tipificadas pela rubrica "parametrização" sobre separador campo.

Tipificação das colunas:

O tipo indica ao processador XSL o modo de utilização da coluna. O quadro deve conter os campos tipificados seguintes :

O tipo indica ao processador XSL o modo de utilização da coluna. O quadro deve conter os campos tipificados seguintes :

Campo	Tipo	Descrição
NBCMP		Variável de baixo de quadro Obrigatório.
PARENT	Chave do pai	chave do pai do registo corrente. Vazio, se se trata do cabeçalho de nomenclatura, senão obrigatória.
KEYC	Chave...	chave do registo corrente. Obrigatório.
LIBL1	Literal longo	Literal do elemento Obrigatório.
INF	Informação	Vários campos podem ser deste tipo. Estas informações são afixadas na seguida do literal longo, na ordem de declaração dos campos no quadro.
LIBSHORT	Literal curto	Afixado em info bolha. Facultativo :
ICO	Îcone	Îcone afixado em início de linha. O Îcone deve ser localizado no directório dos recursos standard (/X3_PUB/X3_PUB/RESSTD/IMG). Facultativo :
EXP	dobrar/desdobrar	"flag" permitindo forçar o desdobramento de uma ligação. (menu local 1)

Se se deseja funcionar com o programa de interacção standard AMAJHIER, os nomes de campos seguintes são impostos porque eles estão em duro no programa. É possível chamar os campos de outra forma em definindo um outro programa de interacção.

As opções do componnete XSL

O componente XSL nomenclatura vertical ANOMH propõe 5 opções : 

• MODHIE : Autorizar o deslocamento de um elemento e todo o que lhe está reafixado. Valor : 1 não / 2 sim. Por defeito Sim (2).
• SDATA : Desconto ao dia do gráfico seguinte à devolução de interacção. Valor : 1 não / 2 sim. Por defeito SIM (2). O gráfico foi recalculado, cada vez que os dados são modificados qualquer que seja a origem (quadro ou gráfico). Posicionado a NÃO, o gráfico não foi recalculado, seguinte a uma interação do utilizador sobre o gráfico ele mesmo (por contra, recalculado seguinte a uma actualização do quadro).
• PINTER : Programa de interacção. Por defeito chama-se o programa AMAJHIER, é possível de chamar um outro, o que permite de chamar os campos de outra forma e de intervir sobre as regras de aceitação de interação.
• EXECFL : Autorizar a chamada de um sub-programa sobre duplo-clique sobre o elemento do último nível.
• TYPPRE : Tipo de apresentação. Valor
• 1 não colunado,
• 2 não colonizado novo design,
• 3 uma coluna por literal, uma outra para as informações complementares
• 4 uma coluna por literal, uma coluna para cada informação.

O parâmetro XSL

Idem nomenclatura horizontal