SEEWARNING Avant de créer votre site , il préférable de lire la documentation :Avant de commencer.


La fonction principale de la fiche de paramétrage 'Interface' est d'identifier et de localiser un web service X3 en fournissant :

  • son nom de publication ou alias,
  • les coordonnées du serveur de web service qui délivre le service.

Les interactions entre une application web XTEND et le back-office X3 met en jeu deux catégories de services :

  • les services de type 'Accès' qui décrivent les accès aux données,
  • les services de type 'Action' qui décrivent les action utilisateurs.

SEEWARNING Le nombre de paramètres des web services de type Accès ou 'Action sous-programme' est limité à 50.

En mode web service, la variable globale X3 GUSER contient le code utilisateur X3 passé en paramètre au moment de l'appel du web service.

XTEND valorise le code utilisateur X3 en fonction du fait que l'utilisateur est signé ou non :

  • L'utilisateur XTEND non signé utilise le code utilisateur X3 défini par défaut dans le Pool web service,
  • L'utilisateur XTEND signé utilise le code utilisateur X3 qui est retourné par la fonction de login.

Interfaces de type 'Accès'

Le serveur XTEND n'accède pas directement à la base de données X3 via un connecteur de base de données, mais au travers d'appel de web services spécialisés de type sous-programme ou liste gauche.

Les interfaces de type 'Accès' permettent de définir ces web services qui fonctionnent comme des fournisseurs de données (data providers).

Ces web services sont appelés par les tokens de type bloc.

Accès généré table

Permet de générer automatiquement un web service pour accéder aux enregistrements d'une table de la base de données X3 :

1. Génération d'un traitement L4G,

2. Création d'une fiche dans la table des sous-programmes,

3. Publication du web service.

Le web service généré est immédiatement opérationnel sur tous les serveurs de web services qui publient le dossier.

Accès généré vue

Idem 'Accès généré table' mais pour les vues X3.

Accès liste gauche

Permet d'utiliser le web service 'liste gauche' d'un objet X3 comme source de données.

Accès 'sous-programme'

Le type Accès sous-programme' est généralement utilisé pour ajouter des champs calculés aux champs de la table/vue à laquelle on souhaite accéder.

Exemple : ajouter la disponibilité et le prix des articles dans un catalogue.

Pour calculer les valeurs des champs 'calculés' il faut pouvoir passer au traitement L4G des paramètres contextuels complémentaires à ceux qui sont passés en standard par le serveur XTEND via les paramètres AXPARCOD et AXPARVAL (voir les actions utilisateurs).

Exemple : un code client ou une quantité/date saisie par l'utilisateur.

Tableau de paramètres 'accès sous-programme'

Ce tableau permet de définir la liste des paramètres complémentaires.
La valeur des paramètres de type 'saisie' est renseignée dans la fiche token lien dynamique ou bloc.

SEEWARNING Contrairement aux actions utilisateur, l'accès sous-programme ne permet pas de saisir le mapping des paramètres.

Le tableau des paramètres peut être considéré comme un mapping sur la liste des paramètres AXPARCOD/AXPARVAL.

Optimisations

Comme pour l'accès généré table, il est parfois nécessaire d'optimiser l'appel des web services pour améliorer les temps de réponses.

  • Ce tableau permet au développeur de définir (saisir) ses propres types d'optimisations.

  • Le serveur XTEND valorisera le paramètre $OPTIMZE lors de l'appel du web service.

  • Le développeur L4G aura à charge de réaliser le traitement d'optimisation en fonction de la valeur du paramètre.

Interfaces de type 'Action'

Le interfaces de type 'Action utilisateur' permettent de définir des web services (traitements L4G) qui agissent sur les données du back-office X3.

L'interface 'Action' est associée à une fiche action web qui permet de décrire le mapping des paramètres.

Ces actions web sont associées aux tokens de type lien dynamique pour être insérés dans les élements d'interface graphique comme les boutons (<input type="button" onClick="">) ou les ancres(<a href="button" onClick="">).

Action utilisateur

Une action utilisateur XTEND se traduit toujours par l'appel d'un web service X3 qui peut être soit un sous-programme soit une action associée à un objet X3.

Une action XTEND attend des paramètres en entrée, effectue un traitement et valorise un certain nombre de paramètres en retour comme l'appel d'un sous-programme en L4G.

Dans le cas d'une application XTEND, les paramètres en entrée sont généralement saisis par l'utilisateur dans un formulaire HTML et les valeurs renvoyées par le sous-programmes sont stockées en mémoire dans la session utilisateur (mapping) dans le but d'être affichées dans une page HTML ou utilisées comme paramètres d'autres actions.

Action sous-programme

Au préalable il faut avoir programmé le traitement L4G et avoir créé la fiche sous-programme.

Une fois l'interface créée, le bouton "Générer l'acces' permet de publier le web service.

Action objet X3

Le code de l'action X3 (bouton d'action de l'objet) est renseigné dans la fiche action web.

Une fois l'interface créée, le bouton "Générer l'acces' permet de publier le web service.

Pré-requis

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

En-tête

Onglet Général

Paramètres généraux de l'interface.
Les paramètres à saisir dépendent du type d'interface sélectionné.

Onglet Avancé

Etats

Par défaut, les états suivants sont associés à la fonction :

  PRTSCR : Impression écran

Mais ceci peut être modifié par paramétrage.

Boutons spécifiques

Validation

Ce bouton permet de mettre à jour le dictionnaire XTEND au format XML.

Le serveur X3WEB prend en compte uniquement le dictionnaire sous ce format.

Il existe un fichier xml par dictionnaire.

Par exemple le fichier ACT.xml correspondant à l'ensemble des actions web pour le site Web courant.

Copie

Ce bouton permet de copier une interface.

Bloc numéro 1

  • Type de données (champ TYP)

Les interfaces de type 'accès aux données' :

  • Accès généré table : permet de générer automatiquement un web services pour accéder aux enregistrements d'une table de la base de données X3.

  • Accès généré vue : idem 'Accès généré table' mais pour les vues X3.

  • Accès liste gauche : permet d'utiliser le web service 'liste gauche' d'un objet X3 comme source de données.

  • Accès sous-programme : permet de personnaliser un sous programme d''Accès aux données' et d'y ajouter des champs calculés.

Les interfaces de type 'action' :

  • Action sous-programme : appel d'un web service de type sous-programme.

  • Action objet : appel d'un web service de type action d'un objet X3.
  • Code (champ OBJCOD)
  • champ ZDES
  • Nom de publication (champ WEBSRCCOD)
  • Nb max. de lignes (champ RESMAX)

Nombre maximum d'enregistrements renvoyés par le web service, modifiable via le bouton 'Générer l'accès'.

  • Traitement (champ PRG)

Nom du traitement L4G appelé par le web service.

  • Sous-programmes (champ SUBPRG)

Nom du sous-programme appelé par le web service.

  • Module (champ MODULE)
  • champ WA
  • champ WB
  • champ WC
  • Type (champ TYPASU)

Tableau Interface

  • champ WSEL
  • Code (champ CODXTD)
  • Groupe (champ GRP)
  • Dimension (champ DIME)
  • Intitulé (champ INTITCOURT)
  • Longueur (champ CODLNG)

'Cette documentation décrit le bouton-icone [Générer l'acces].

Ce bouton permet de générer automatiquement le web service dont le nom de publication est défini dans l'interface.

Le web service généré est immédiatement opérationnel sur tous les serveurs de web services qui publient le dossier. 

SEEINFO Ce bouton est actif après avoir créé la fiche.

Le bouton 'Générer l'accès' effectue les opérations suivantes :

  • Proposition de saisir le nombre maximum d'enregistrements lus à chaque appel du web service ('Nb max. de lignes'),
  • Code activité, module et type de Web service,
  • Demande de sélectionner les champs utiles,
  • Génèration du traitement L4G qui sera appelé par le web service avec pour nom 'W + nom de publication'
  • Publication du web service avec le nom de publication saisi précédemment.

Pour les interfaces de type :

Acces données table, Acces données vue

Le traitement et la fiche sous-programme sont générés automatiquement.

Acces données sous-programme, Action utilisateur sous-programme

Le traitement et la fiche sous-programme doivent être créés manuellement  avant de générer l'acces.

Action utilisateur objet, Acces données liste gauche

Il n'y a pas de traitement ni de fiche sous-programme à créer.

Barre de menus

Messages d'erreur

Il n'y a pas de message d'erreur autre que les messages d'erreur génériques.

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre