Antes de começar XTEND 

Introdução

O que é XTEND ?

XTEND é um ofício de desenvolvimento de aplicações web integrada na plataforma tecnológica SAFE X3. É fortemente acoplado às soluções SAFE X3 (aplicações Sage X3, Sage GEODE, Sage RH).

Foi concebido para permitir aos programadores X3 :

  • De realizar as aplicações web com um mínimo de competências no domínio das tecnologias Internet
  • De matrizar o conjunto dos processos de aplicação (administração, tratamentos, acesso aos dados...) via as funções X3

Permite realizar novas interfaces web substituindo os interfaces standardizados das soluções SAFE X3.

Permite também de realizar todo o tipo de aplicação web cross-browsers :

  • Estabelecimentos web institucionais
  • Estaeblecimentos de "e-commerce" em B to B e em B to C
  • Estabelecimentos para o registo ou a consulta de dados de ERP.

O conceito

O conceito utilizado por XTEND para "dinamizar" as páginas HTML é a inserção de tokens no código fonte HTML que permitem modificar dinamicamente as propriedades dos tags HTML (a, input,span, td, div...).

Todos os elementos que intervêm na construção de um estabelecimento (tokens, páginas, bloco de iteração, acesso aos dados, ação utilizadores...) são modelizados sob a forma de objectos X3 e parametrizáveis via um conjunto de funções X3. Estes elemetos constituem um referencial chamado dicionário ou "repository" sobre o qual se apoia o motor XTEND para "dinamizar" as páginas HTML.

Um estaebelecimeto XTEND está anexado a um dossier X3 É constituido dos elemntos seguintes :

  • um dicionário ou referencial
  • um conjunto de páginas html e recursos gráficos.
  • um conjunto de web services para o acesso aos dados e o tratamento das ações utilizadores.

SEEINFOBem que estão definidos ao nível de um dossier X3, um estabelecimento XTEND pode aceder aos dados e tratametos de outras soluções/dossiers X3 via a chamada de web services.

Pré-requisitos

Para desenvolver os estabelecimetos web standards com XTEND é necessário de dispor das competências seguintes :

  • Desenvolvimeto X3 (indispensável)
  • Parametrização XTEND (indispensável)
  • Web services X3
    • Arquitetura e publicação (indispensável)
    • Nenhuma competência em programação
  • Design HTML :
    • HTML (standard)
    • Software de criação web tipo Dreamweaver (básico)
    • O dominio destes "styles css" é um ativo
  • JavaScript (básicos)
    • Utilizado para os controlos de registos

Arquitetura funcional

O design das páginas HTML

XTEND é independente do software de criação das páginas HTML que está deixada à escolha do programador.

Geralmente o design do estabeleicmento é realizado por uma agência especializada que entrega um projeto HTML composto de um conjunto de páginas (estáticas) e de componentes gráficos conformes à carta gráfica

A dinamização das páginas HTML

O interesse e o sucesso de um estabelecimento web é fortemente ligada à sua capacidade a publicar as infromações pesonalizadas e refrescadas em tempo real.

Com os eventos de desenvolvimento web clássicos (PHP, ASP.NET, JSP...), acesso e afixaação dos dados "dinâmicos" assim que os tratamentos das ações utilizador sºao efetuados por programação sobre o servidor web e pedir os limites de competências nestas tecnologias.

XTEND propõe um modo de desenvolviemnto web por parametrização e inserção de tokens,fácil de acesso e acessível aos programadores não especialistas.

Exemplos:

<table>
<tr><td>Ref</td><td>Price</td><td>Stock</td></tr>
<!adx='blocIteration'>
   
<tr>
         
<td><aadx="gotoDetail"><spanadx'REFNUM'></span></a></td>
         
<tdadx="PRICE"></td>
         
<tdadx="STOCK"></td>
   
</tr>
<!adx='blocIteration'>
</table>

Ref

Price

Stock

 PUZ001

13.78

10

 PUZ002

2.30

5

PUZ003

6.52

0

Os tratamentos e o acesso aos dados

Oacesso aos dados assim que todos os tratamentos desencadeados pelas acções utilizadores são efetuados em X3 via chamada de web services.

Nenhum tratamento funcional não está efetuado sobre o servidor web que dá ao programador X3 um inteiro domínio sobre os programas actualizados.

A segurança

A autentificação dos utilizadores (login) está efectuada em X3 via a chamada de um sub-programa especializado.

O acesso aos recursos (páginas ou web services) assim que a encriptação dos dados (fomulários, consulta de dados confidenciais) está efetuado por parametrização X3

A administração

Os estabelecimentos desenvolvidos com XTEND são completamente integrados a uma solução SAFE X3, o que significa que os componentes do estabelecimento (design HTML, tratamentos, dados) fazem parte do dossier X3 aos quais estão anexados.

XTEND coloca à disposição de webmaster um conjunto de funções X3 para a administração, em particular uma função de cópia de um estabelecimento de dossier de desenvolvimento versus um dossier de produção.

Arquitetura técnica

XTEND se apoia sobre uma arquitetura multi-terceiros constituido de :

  • Um servidor HTTP fontal do servidor X3WEB (servidor HTTP front-office)
  • Um servidor XTEND do servidor X3WEB (motor de publicação das páginas HTML chamada também motor XTEND)
  • Um servidor de aplicação X3
  • Um (ou vários) servidor de web services

O servidor XTEND está albergado no servidor X3WEB sob a forma de uma nova aplicação web.

Como para as outras aplicações web (web services, VT...) a configuração do servidor XTEND está efectuada via a consola de administração X3.

A publicação de um estabelecimento XTEND sobre um servidor é automático Ela está efetuada via uma função X3 e não necessita nenhum arranque do servidor X3WEB

O servidor HTTP frontal

Trata-se do servidor HTTP Apache instalado com o servidor X3WEB. Está configurada para redirigir os pedidos XTEND versus o motor XTEND.

O servidor XTEND

O motor XTEND gera as sessões utilizadores, efetua o tratamemnto dos pedidos HTTP e entrega as páginas HTML :

  • gestão dos direitos de acesso
  • chamada dos web services para tratar as ações utilizadores
  • chamada das web services para o acesso aos dados
  • análise da página HTML e interpretaação dos tokens
  • construção dinâmica da página resultado
  • Um servidor de aplicação X3

    O servidor X3 está visto pelo motor XTEND na vez como um servidor de recursos e um servidor de tratamento.

    Servidor de recursos

    XTEND acede aos recursos ficheiros através do servidor HTTP do servidor X3 principal (diferentes do servidor HTTP frontal). Estes ficheiros são guardados por dossier X3 sob o directório X3_PUB da solução.

    Lista dos ficheiros utilizados por XTEND:

    • O dicionário do estaeblecimento
      • X3_PUB/NOMDOSSIER/X_TEND/X_GEN/NOMDOSSIER
      • o dicionário está constituido de ficheiros XML que são gerados no momento da validação dos parâmetros X3
    • os elemetos do design HTML
      • X3_PUB/NOMDOSSIER/X_TEND/X_HTML/NOMDOSSIER/LANG
      • este diretório contém geralmente a cópia (FTP) do projeto HTML
    • os menus locais X3
      • X3_PUB/NOMDOSSIER/GEN/LANG/MENL
    • os ficheiros de dados utilizador cujo acondicionamento está parametrizável.
      • /X3_PUB/NOMDOSSIER/X_TEND/X_FILAPP
      • /X3_PUB/NOMDOSSIER/X_TEND/X_FILES

    Servidores de tratamentos

    O conjunto dos tratamentos funcionais utilizados pelo servidor XTEND são sub-programas L4G ou objetos X3 que foram publicados sob a forma de web services.

    A chamada do tratamento X3 está efetuado via um ou vários servidores de web service que estão definidos por parametrização.

    SEEINFO Não existe nenhuma relação direta entre o motor XTEND e os servidores de tratamentos X3. Todas as chamadas de serviços (acesso aos dados e tratamento das ações utilizador) passsam por servidores de web services. XTEND não acede de nenhuma maneira à base de dados X3.

    Os web services

    Como nós temos vistos precedentemente, o motor XTEND comunica com o mundo X3 unicamente por chamadas de web services. Nenhum estabelecimento XTEND não pode funcionar sem utilização de web services.

    O interesse de XTEND que é mascarado completamente da complexidade de chamada de um web services como a utilização das classes stubs ou proxy (em JAVA, ASP.NET ou PHP) e a criação/tratamento dos parâmetros/dados XML.

    Todas as operações de publicação, de chamada, do tratamento do resultado XML e das mensagens aplicativas são efetuadas por parametrização X3.

    As funções de parametrização XTEND permitem

    • declarar as "pools de web services" utilizados pelos estabelecimentos
    • Endereço/Porte de um servidor de web service e alias do "pool de conexão"
    • definir uma "pool de web services" por defeito para cada estabelecimento
    • definir se necessário um "pool de web services" por ação utilizador

    Generalidades :

    Arranque

    Antes de tudo compreender, deve verificar que o servidor XTEND funciona correctamente

    Em seguida, pode-se apreender como criar rapidamente o seu estabeleicmento XTEND por duplicação do estabelecimento exemplo fornecido.

    Eis a página Arranque.

    Reparação

    No caso onde o servidor XTEND não funciona correctamente, eis algumas pistas para a sua reparação.

    Exemplo de estabelecimento ASAMPLE

    o estabelecimento,

    O estabelecimento ASAMPLE funciona sobre todas as aplicações SAFEX3. Não há nenhuma aderência às funções particulares das aplicações. Este estabelecimento se apoia sobre os dados unicamente supervisor.

    Este estabelecimento é um exemplo que permite testar o bom funcionamento do servidor XTEND num ambiente cliente e que dá algumas utilizações simples.

    Esta página descreve os diferentes elementos fornecidos por este estabelecimento.

    Gestão conteúdo

    Como pode ir procurar do conteúdo html parametrizado numa função XTEND? Eis a página explicando esta gestão do conteúdo.

    Login

    Como está gerado a gestão do login em XTEND para o estabelecimento ASAMPLE? Eis a explicação.

    Formulário

    Como pode colcar em obra o registo num formulário de contato ? eis a página de explicação.

    Lista dos países

    A página "lista dos países" do estabelecimento ASAMPLE ilustra o conceito de acesso aos dados proposto por XTEND.

    Como pode facilmente recuperar o resultado de uma tabela em X3. Eis a página de explicação.

    Conceitos

    Funcionamento

    Como funciona o servidor XTEND?

    Como são recuperados os parãmetros registados em X3?

    Como o servidor XTEND interpreta as páginas html ?

    Eis a descrição do funcionamento de XTEND.

    Os tokens

    Como inserir as páginas html os elementos do back office ? encomendas X3, ou todo o elemento funcional de uma aplicação SAFE X3.

    Como funcionam os tokens, os elementos html inseridos nestas páginas ?

    Ações

    Como está parametrizado uma ação utilizador sobre uma página de um estabelecimento ? Por exemplo um clique sobre um campo numa página html. Eis a explicação.

    Acesso aos dados

    Como recuperar numa página web os dados de uma aplicação SAFE X3 ?

    Eis a explicação.

    Utilitários

    Utilitários X3

    Eis algumas funções X3 que permitem personalizar o estabelecimento Web.

    Ajuda desenvolvimento

    Como utilizar os utilitários e as relações geradas na página web para ajudar ao desenvolvimento.

    Seguimento atividade

    Como utilizar os ficheiros logs que são gerados diretamente sobre o servidor XTEND?

    Avançado

    Livraria standard

    Eis a descrição da livraria javascript XTEND fornecido.

    Web services REST

    Como chamar um web service REST unicamente num estabelecimento XTEND?

    Livraria AJAX

    Como é constituir a livraria AJAX XTEND ?

    Scripting serveur

    Como fazer javascript lado servidor ?

    Configuração

    Eis algumas configuração em fora dos parãmetros em X3.