Campos

Tomado em mão

Tipos de campos

Tipos simples

tratam-se dos campos de tipo : texto, inteiro, decimal, divisa, data.

Tipos URL

tratam-se dos campos utilizados como "tokens" no tag <img> ou <a> para gerar as URL's de acesso a recursos de tipo imagem ou ficheiro (text, pdf, word..).

"Acesso à imagem"

Um campo de tipo acesso imagem é utilizado nos "tag" HTML <img>.

Este campo está criado por "mapping" (numa acção ou "acesso de dados") com um parâmetro de "web services" que contêm:

• seja um dado de tipo texto,
• seja um dado de tipo BLOB.

"Mapping" com um parâmetro de type BLOB X3

O servidor efectua o tratamento seguinte para o "mapping" :

• ele lê o mesmo tempo dos parâmetros blob X3 que é calculado pelo servidor de "web service X3",
• se se trata de um tipo-mímico de tiop "imagem", guarda o dado binário em memória na "cache" dos dados X3.
• se se trata de um tipo-mímico de "tipo texto-plano", ver mapping com parâmetro de tipo "Car".
• calcula uma URL que permite reencontrar a imagem em memória e de a renviar versus o navegador,
• valoriza o campo com o valor desta URL (texto).

Exemplo :

O URL a seguir está gerado no momento do tratamento do resultado da chamada de um "web service" "Acesso aos dados" para ler uma tabela que contém um campo BLOB.

<img src="http://host:port/xtend/x3rsrc/X3SOLUTION/X3FOLDER/XTENDSITE/FRA/ITEMPCT30-112.gif">

O nome de recurso que permite reencontrar o dado em memória está constituido de :

• CodeEntité + CodeChamp + ValeurDuChampClé + Extension,
• ValeurDuChampClé é o valor do campo chave (Campo selecção) definido na entidade XTEND.

No nosso exemplo, nós temos definido para a entidade ITEM um campo chave ITMREF.

O URL obtido é aquele de um artigo (entité ITEM) emitido do parâmetro BLOB (PCT) cuja chave (campo chave ITMREF) é 30-112.

A extenção está dada :

• seja pela ficha do campo,
• seja pela ficha estabelecimento (defeito).

Os parâmetros "Directório raíz" e "Caminho relativo" não são tomados em conta este tipo de "mapping".

Apenas o parâmetro Extensão está tomado em conta.

"Mapping" com um parâmetro de tipo Car ou Clob

Quando o servidor XTEND deve criar um campo "Acesso imagem" a partir de um parâmetro "web service" de tipo texto supõe que o texto contém o nome do recurso.

O servidor gera então um URL versus este recurso em tomando em conta os parâmetros "Directório raíz", "Caminho relativo" e Extenção para calcular o caminho de acesso.

Directórios XTEND

Nós temos definido quatro directórios raíz para guardar os ficheiros XTEND. Os recursos (ficheiros, imagens...) destes directórios sao acessíveis pelo navegador via os "tokens" "imagem" ou "documentos juntos".

• Design HTML : Directório do projecto HTML que tem em conta da língua utilizador

• X_FILES :Directório que está próprio ao dossier X3 e que está localizado sob X3_PUB/X3FOLDER/X_TEND/X_FILES

• X_FILEAPP : Directório que está próprio ao dossier X3 e que está localizado sob
  X3_PUB/X3FOLDER/X_TEND/X_FILAPP.
  É utilizado para guardar os ficheiros emitidos de tratamentos batch como relatórios gerados pelo servidor de impressão.

• X_TEND : Directório utilizado para guardar os ficheiros comuns a todos os dossiers.
  Por exemplo imagens produzidas, documentos comerciais...
  É localizado sob X3_PUB/X_TEND/.

Design HTML e X_FILES podem ser localizados sobre o servidor X3 (defeito) ou sobre o servidor de "web services".

X_FILEAPP e X_TEND estão sempre localizados sobre o servidor X3.

"Acesso documento junto"

O tipo "acesso documento junto" funciona como o tipo "Acesso imagem" mas com recursos de todo o tipo ((ficheiro gif, jpg, pdf, word, Excel...).

Os tokens de tipo "Acesso documento junto" são geralmente utilizados nos tags HTML <a></a> para que o utilizador possa abrir o ficheiro se clique sobre a zona sensível.

<a src="http://host:port/xtend/data/remote/SOL/FLDR/X_TEND/X_HTML/SITE/FRA/FA.pdf">get Pdf</a>

Como para o tipo "Acesso imagem" XTEND trata o "mapping" entre o parâmetro X3 e o campo Xtend em funçõa do tipo do parâmetro X3.

"Mapping" com um parâmetro de type BLOB X3

O servidor guarda o dado binário em memória e cálculo URL da mesma maneira que para o "token" "Acesso imagem".

"Mapping" com um parâmetro de tipo Car ou Clob

O servidor supõe que o campo contém o nome do recurso e cálculo do URL da mesma meneira que para o "token" "Acesso imagem".

Tipos menu local

Um campo de tipo menu local está contido um valor de tipo inteiro.

Tipos FLASH

O campo de tipo flash está utilizado para inserir os componentes flash X3 nas pa´ginas HTML via o "tag" <object>.

O componente flash utiliza um pedido "Ajax" XTEND para comunicar com o servidor X3.

O pedido chama o sub-programa SUBAPSMON/MONITEUR com os parâmetros fornecidos pelo componente flash.

 Para poder fazer funcionar os componentes flash com XTEND falta, previamente, que o sub-programa SUBAPSMON/MONITEUR :

• seja publicado como um "web service"
• está declarado XTEND por uma ficha interface.

Caso do tipo de camop FLASH

Verifique se o tratamento SUBAPSMON/MONITEUR está bem publicado como "web service" com o nome de publicação AXTDFLASH.

Se o sub-programa não foi publicado :

• Crie a ficha sob programa em respeitando o nome dos parâmetros e grupos de publicação,
• Publique o sub-programa com o alias AXTDFLASH.

O sub-programa SUBAPSMON/MONITEUR utiliza a variável X3 GUSER, que deve estar correctamente posicionado.

Em modo "web service", a variável global X3 GUSER contém o código utilizador X3 pasado em parâmetro no momento da chamada do "web service".

XTEND valoriza o código utilizador X3 em função do facto que o utilizador esteja assinado ou não:

• O utilizador XTEND não assinada utiliza o código utilizador X3 definido por defeito na Pool "web service".
• O utilizador XTEND assinado utiliza o código utilizador X3 que é devolvido pela função de "login"

Criação do interface

Se o interface AXTDFLASH não existe : crie a ficha de tipo "Acção sub-programa" e AXTDFLASH como nome de publicação.

Se o componente flash afixa os dados de uam outra solução X3 :

• verifique que o "web service" SUBAPSMON/MONITEUR/AXTDFLASH está bem publicado nesta solução,
• e utilize (criar) um Pool "Web Service" específico que está conectado a esta solução.

criação dos campos Flash

• Crie um campo de tipo flash por "vista portal" a afixar em selecionando o interface AXTDFLASH.
• Insira o "token" campos numa "tag" HTML <object>.

Ver a nota técnica TN-12701 de Adobe sobre o significado dos parâmetros.

<div>
    <object adx="MYFLASHFIELD" width="400" height="300">
        <!--Parâmetros do "tag object" -->
        <param name="quality" value="high">
        <param name="scale" value="noscale">
        <param name="salign" value="lt">
        <param name="bgcolor" value="#FF0000">
    </object>
<div>

O "token" adx aceita o parâmetro HTML xcache (<object adx="MYFLASHFIELD:xcache">) se desejou que a resposta xml do web service seja guardado em memória do navegador.

Ligação detalhe

O ligação dinâmica associada ao campo flash permite redirigir o clique no menu contextual detalhe do componente flash versus uma página XTEND.

Os parâmetros da ligação são aqueles fornecidas pelo componente flash :

Utilização "Tokens Campos"

Fora tag html

Utilize a sintaxe seguinte para afixar o valor de um "token campo" sem passar por uma "tag" html.
A sintaxe seguinte está também utilizada para valorizar as variáveis JavaScript.

<body>
<script>
    // Valorização de uma variável JavaScript
    var myGlobal=<!adx="MyField"><!adx="MyField">;
</script>
    <form>
    <!adx="MyField">xxxx<!adx="MyField"><br>
equivale a
    <p adx="MyField">xxxx</p>
    <form>
<body>

Tag div,span,td,th,p,b,small,big,i,label,li,pre,tt

A utilização de um "token campo" nestas tags HTML substitui o conteúdo entre <tag> e </tag> pelo valor do campo.

A inserção de um "token" adx preserva os atributos existentes.

<div adx="MyField"></div>
<td adx="MyFieldDate:xempty=20090101&xfomat=Dz:DD[ ]MMMMMMMMMM[ ]YYYY></td>
<b adx="MyField"></b>

Parâmetros HTML

"Tag" select

A "tag" select permite registar um valor por entre N. O seu comportamento depende do tipo de "token".
Se o atributo "name" não está presente, XTEND gera este atributo com o nome do "token".

"Token" menu local ou lista de valores XTEND :

• acrescenta uma opção por elemento do menu local,
• e selecciona a opção que corresponde ao valor do campo.

Observação : chama-se o campo "lista dos valores XTEND", um campo de tiop texto com uma lista de valores prenchidos.

Exemplo 1

SELECTMENULOC aponta sobre o menu 7803 e tem por valor 4 :

<select adx="SELECTMENULOC" class="smallTxt">
    <option value="">Aucun</option>
 </select>

Código HTML gerado:

<select name="SELECTMENULOC"class="smallTxt">
<opção selecionadavalue="">Aucun</opção>
<opção value="1">ID du processus</opção>
 ...
<option selected="selected" value="4">Data de conexão</option>
...
<opção value="13">Phys IO</opção></select>"Token standard"

Exemplo 2

<select adx="SELECTMENULOC:xonchange=ADLKPOSTPAGE" class="smallTxt">
    <option value="">Aucun</option>
 </select>

Código HTML gerado:

XTEND selecciona a opção que corresponde ao valor do campo.
No exemplo a seguir "Alemanha" está seleccioanda se o valor de MYTOKENFIELD é DE :

<select name="MYTOKENFIELD">
    <option value="">Aucun</option>
    <option value="AT">Autriches</option>
    <option selected="selected" value="DE">Allemagne</option>
    <option value="ES">Danemark</option>
 </select>

Parâmetros HTML

O "tag" select aceita os parâmetros seguintes :

<select adx="MYFIELDMAIN:xonchange=MYDYNLINK&xfill=MYFIELDFILL&xrc">
 </select>

"Tag input texto ou escondifo

O "tag" input permite registar um valor.
O "token" campo actualiza o valor por defeito ao carregamento da página (atributo valor) com o valor do campo.

Se o atributo "name" não está presente, XTEND gera este atributo com o nome do "token".

<input type="text" SIZE="100" adx="MAICOD:xrc">

Parâmetros HTML

"Tag" textarea

O "tag" textarea permite registar um comentário.

<textarea cols="100" rows="5" adx="CMT:xrc">Commentaire...</textarea>

Parâmetros HTML

Idem tag <input>

Literal

Os campos com lista dos valores ou de tipo menu local podem ser utilizados como literal nas páginas HTML
Você pode também utilizar como literal um campo de tipo texto sem lista de valor em preenchendo o parâmetro valor.

A utilização de um "token" literal ao lugar de um texto na página HTML permite ao webmaster de modificar os literais em X3 sem ter de modificar o HTML

Os literais podem assim ser utilizados para gerar o multi-línguas numa mesma página HTML.

Selecção do valor

O facto de utilizar um menu local ou uma lista de valores permite de associar valores ao mesmo campo o que minimiza o número de "tokens" criados e facilita a gestão dos literais.

A selecção do valor no "token" é efectuado via o parâmetro HTML "xcaption".

O facto de escrever o campo como literal indica ao servidor XTEND que o valor é estático e permite de optimizar o tratamento de geração da página HTML

Literal menu local

<span adx="LIBMENULOCAL:xcaption=1" style="color:#FF0099"></span><br>
<span adx="LIBMENULOCAL:xcaption=1" style="color:#FF0099"></span><br>

Literal com lista de valores

<span adx="LIBMENUXTD:xcaption=DOC" style="color:#FF0099"></span><br>
<span adx="LIBMENUXTD:xcaption=NEW" style="color:#FF0099"></span><br>

Recuperar o literal de um menu local

Caso onde o campo ORDSTA está associado ao menu local 1 (Sim/Não). Seu valor é igual a 2

<td align="right" adx="ORDSTA_DESC">XXX</td>

Código HTML gerado:

<td align="right">Oui</td>

Como valorizar um atributo

A sintaxe a seguir permite valorizar o atributo monAttribut com o valor do "token" camp:

<div adx="MyField:xattr=monAttribut"></div>
Exemplo se o valor de Myfield é 'MyBeautifullClass'
<div adx="MyField:xattr=class"><div> Génère <div class="MyBeautifullClass"><div>
Para os IDs pode-se acrescentar um sufixo
<div adx="MyField:xattr=id&xnotempty=article"><div> Génère <div id="PUZ001article"><div>

Alternar o estilo das linhas nos quadros

O campo especial ALINESTYLE contém as classes das linhas pares e impares definidas no parâmetro "Estilo por linha" do bloco.

O código a seguir permite de alternar a classe css para linhas pares e impares.

<tabela>
<!adx="MonBloc">
    <tr adx="aLineStyle:xattr=Class"></tr>
<!adx="MonBloc">
</tabela>
Género
<tabela>
    <tr Class="ClasseLignePaire">...</tr>
    <tr Class="ClasseLigneImpaire">...</tr>
    <tr Class="ClasseLignePaire">...</tr>
</tabela>

Gerar um atributo ID automaticamente

Para desenvolver as interfaces utilizador complexos, você tem necessidade de endereçar os elementos do DOM HTML para o seu identificando (atributo ID).

XTEND propõe uma sintaxe para gerar o atributo ID particularmente útil nos blocos.

O "token" camop especial AAUTOID

Permite gerar as ID de tipo AAUTOID_X.
X é o índex da linha corrente se a "tag" foi colocada num bloco XTEN.

AAUTOID toma em conta múltiplos blocos imbricados AAUTOID_X_Y_Z.

O parâmetro HTML xautoid

Você pode também utilizar o parâmetro HTML se deseja utilizar já um token field para valorizar o conteúdo do "tag" HTML

• Se o "tag" HTML tem um atributo ID não vazio, o valor é utilizado como prefixo do ID.
• Senão XTEND escolhido o nome do "Token" como prefixo.

Exemplo :

<tabela>
<!adx="MonBloc">
    <tr adx="AUTOID">
        <td adx="ITMREF&xautoid"></td>
    </tr>
<!adx="MonBloc">
</tabela>
Género
<tabela>
    <tr id="AAUTOID_1">
        <td id="ITMREF_1">PUZOO1</td>
    </tr>
    <tr id="AAUTOID_2">
        <td id="ITMREF_2">PUZOO2</td>
    </tr>
</tabela>

"Token" Camops predefinidos

O quadro a seguir apresenta a lista dos "tokens" campo calculados por XTEND :

Pré-requisitos

Consulte a docuemntação de Implementação

Gestão do ecrã

Cabeçalho

Separador Geral

Separador Avançado

Listagens

Por defeito, os seguintes listagens estão associados à função :

 PRTSCR : Impressão ecran

Mas pode ser alterado por parametrização.

Botões específicos

Barra de menu

Utilitários / Ajuda à criação

Função

Esta função está acessível via o menu de utilitários das fichas de parametrização.

Acção

Ela permite criar os "tokens campos" a partir :

• da lista dos campos de uma tabela X3
• da lista dos campos de uma vista X3
• dos parâmetros do "web service" associado a um interface

Falta validar os Campos : após geração para que eles sejam tomados em conta pelo servidor XTEND.

A validação gera um novo dicionário XML dos parâmetros XTEND.

O novo dicionário não está tomado em conta automaticamente sobre "reload/F5" da página HTML no navegador que se a opção da ficha de parametrização do estabelecimento"Tecnica\Verificar actualizações\Dicionário web" está assinalado.

Senão falta forçar o recarregamento do dicionário com URL :
'http://hostname:port/xtend/svc/SolutionX3/DossierX3/SiteXtend/admin/reposit/reload'

Utilitários / Validação com verificação

Validação com uma verificação da coerência dos dados do dicionário XTEND.

Mensagens de erro

Não existe outra mensagem de erro, para além das mensagens genéricas.

Tabelas consideradas

Consulte a docuemntação de Implementação