Interopérabilité et communication entre applications 4D grâce aux Web Services

Il existe plusieurs solutions pour faire communiquer des bases 4D entre elles en fonction des besoins de chacune des applications. La première consiste à mettre en œuvre une solution d'import-export en utilisant des transferts de fichiers par E-mail ou par FTP.

La deuxième solution repose sur l'utilisation du plugin 4D Open pour 4D. Il s'agit d'un fonctionnement en mode connecté donc seule la connexion à un 4D Server est possible. Chaque connexion se comporte comme une connexion d'un 4D Client et utilise ainsi une licence 4D Client.

Une autre solution consiste à concevoir des méthodes SOAP appelées aussi Web Services à laquelle on passe les paramètres adéquats et on récupère un éventuel résultat. Un serveur SOAP permet de recevoir des paramètres et de retourner des résultats à un client SOAP. Avec cette solution, l'exécution de code s'effectue côté serveur, contrairement à l'implémentation avec 4D Open. L'avantage majeur de cette solution est de ne pas avoir à dialoguer uniquement avec un 4D Server mais à tout autre moteur 4D ayant son serveur Web actif. La seule contrainte de cette solution c'est qu'elle nécessite une licence 4D Web Services pour l'application serveur des Web Services.

En revanche, la solution 4D Open pour 4D présente l'avantage de disposer d'un contexte sur le serveur, dans lequel une connexion reste active, et conserve ainsi une sélection courante, un enregistrement courant et des variables. En revanche, avec une requête SOAP une fois que le serveur a renvoyé sa réponse, le contexte est perdu.

Les services Web fournissent un lien entre applications, services et machines. Des applications utilisant des technologies différentes peuvent ainsi envoyer et recevoir des données au travers d'un protocole compréhensible par tout le monde. Les services Web sont normalisés, car ils utilisent XML et HTTP pour transférer des données et ils sont compatibles avec de nombreux autres environnements de développement. Ils sont donc indépendants de plateforme. Ils peuvent être publiés et utilisés depuis n'importe quelle plateforme. L'information qui est envoyée et reçue par l'application est structurée et transmise sous forme de document XML. Les services web représentent donc la façon la plus efficace de partager des méthodes et des fonctionnalités. De plus, ils réduisent le temps de réalisation en permettant de tirer directement parti de services existants.

Les méthodes publiées comme Services Web présentent beaucoup de souplesse et flexibilité dans leur retour d'arguments. En effet, 4D propose deux manières de spécifier les données retournées par une réponse SOAP. D'abord, les variables et tableaux peuvent être liés aux paramètres de sortie en utilisant la commande DECLARATION SOAP. Un nombre indéfini de valeurs peuvent être incluses dans la requête ou une réponse SOAP bien sûr dans la limite des ressources disponibles. Ensuite, le paramètre $0 de n'importe quelle méthode offerte comme Web service peut être inclus automatiquement comme sortie. Dans ce dernier cas, aucune programmation spécifique n'est nécessaire.

Dans cette note technique, nous vous proposons des méthodes alternatives très simples qui reproduisent les fonctionnalités les plus basiques de 4D Open pour 4D au travers du protocole SOAP qui sont l'ajout, la modification, la suppression et la recherche des enregistrements dans une base 4D distante. Le client envoie les informations nécessaires pour exécuter une action particulière et le serveur, après avoir traité l'action demandée, retourne un code d'erreur  (un code égal à 0 si l'opération s'est bien déroulée ou un code d'erreur différent de 0 en cas de problème) et éventuellement des résultats. Tous ces aspects seront détaillés plus tard dans la partie consacrée à la base exemple.

Afin de publier des méthodes comme Services Web, il faut d'abord que le serveur Web de l'application serveur soit démarré et accessible. L'application 4D cliente n'a pas besoin d'avoir un serveur web actif. Ensuite, la préférence suivante de la base de données doit être activée  (Préférences -> Web ->Web Services -> Autoriser requêtes Web Services). Enfin, la propriété de méthode suivante doit être activée pour chaque méthode publiée  (Propriétés de la méthode -> Offert comme Web Service).

Pour avoir un environnement de déploiement de Service Web typique et par souci de clarté, les méthodes Client et les méthodes de Service web sont fournies dans deux bases distinctes accompagnant cette note : « Serveur » et « Client ». Les méthodes Clientes sont exécutées dans une copie de 4D ou 4D Server et les méthodes de Service Web dans une autre copie (également 4D ou 4D Server).

La base « Serveur » est configurée par défaut pour écouter les requêtes Web ainsi que les requêtes Web service sur le port 8080. Vous pouvez fixer ce numéro de port sur n'importe quel port disponible et autorisé par votre OS.

Les méthodes proxy SOAP de l'application cliente « Client ». précisent directement l'URL d'appel du Web service par l'intermédiaire de la variable <>SoapURL. Dans le cas de cet exemple, les méthodes font des appels à la machine en local c'est-à-dire à l'adresse http://127.0.0.1/. Pour indiquer aux méthodes Clientes d'utiliser une adresse différente de serveur, il suffit de modifier la méthode projet PROXY_INITIALISATION et de mettre l'adresse IP de la machine hébergeant l'application serveur. En pratique, l'URL du serveur SOAP pourrait être stockée dans un enregistrement ou une ressource de la base afin de faciliter la maintenance.

La base exemple contient une série de méthodes simples illustrant la manière d'exécuter une action sur l'application serveur distante ainsi que la façon de recevoir le code d'erreur retournée et des résultats éventuels. Tous les services Web sont fournis avec leurs méthodes SOAP clientes dites aussi méthodes proxy. Ces méthodes proxy sont des méthodes génériques qui vous faciliteront l'appel des services Web. Le tableau suivant présente la liste des noms de méthodes de Service Web qui exécutent une action et retournent des données et les noms des méthodes proxy correspondantes qui récupèrent ces données.

L'application serveur contient une seule table et dispose d'un jeu de données indispensable pour le bon déroulement du scénario des exemples, détaillé plus bas. Ce jeu de données est constitué de 5 enregistrements créés à l'ouverture de la base par la méthode projet CREATION_5_Enregistrements.

Si vous voulez recommencer le scénario, vous devez réinitialiser ce jeu de données, et ceci en lançant de nouveau cette méthode projet en mode Utilisation ou bien en redémarrant l'application. La table 4D utilisée dans ce scénario contient tous les types de champs disponibles dans 4D, comme le montre la copie d'écran ci-dessous.

Voici la liste de tous les services Web disponibles dans cette application serveur :

SOAP_RECHERCHER▲

SOAP_AJOUTER_ENREG▲

SOAP_MODIFIER_ENREG▲

SOAP_SUPPRIMER_ENREG▲

SOAP_SUPPRIMER_SELECTION▲

L'objectif de l'interface proposée dans la base 4D Cliente est d'illustrer les principes utilisés pour faire communiquer deux bases 4D via les Services Web. À l'ouverture de la base cliente, un dialogue constitué de sept pages est affiché. Chaque page correspondant à un seul exemple. Les sept exemples constituent un scénario complet de test et doivent donc être exécutés dans l'ordre. Des explications techniques des exemples sont rapportées sur leur page respective du formulaire.

Voici la liste de tous les exemples disponibles dans l'application cliente...

Exemple 1 : Recherche▲

CHERCHER([Table 1];[Table 1]Champ_Entier>2)

Exemple 2 : Recherche▲

CHERCHER([Table 1];[Table 1]Champ_Entier>=2;*)
CHERCHER([Table 1]; & ;[Table 1]Champ_Date>20/7/2006)

Exemple 3 : Recherche▲

CHERCHER([Table 1];[Table 1]Champ_Booleen=Vrai;*)
CHERCHER([Table 1]; | ;[Table 1]Champ_Heure<=?02:00:00?)

Exemple 4 : Ajouter_Enreg▲

[Table 1]Champ_Alpha80_ID:="W"*80
[Table 1]Champ_Texte:=512*"W"
[Table 1]Champ_Numerique:=88888
[Table 1]Champ_Entier:=-20
[Table 1]Champ_EntierLong:=1000000
[Table 1]Champ_Date:=Date du jour
[Table 1]Champ_Heure:=Heure courante
[Table 1]Champ_Booleen:=Vrai
LIRE IMAGE DANS BIBLIOTHEQUE(2026;[Table 1]Champ_Image)
FIXER TAILLE BLOB([Table 1]Champ_Blob;1024;Code ascii("W"))

Exemple 5 : Modifier_Enreg▲

[Table 1]Champ_Alpha80_ID:="Q"*80
[Table 1]Champ_Texte:=512*"Q"
[Table 1]Champ_Numerique:=-5
[Table 1]Champ_Entier:=-99
[Table 1]Champ_EntierLong:=-3
[Table 1]Champ_Date:=!10/10/10!
[Table 1]Champ_Heure:=?20:20:20?
[Table 1]Champ_Booleen:=Vrai
LIRE IMAGE DANS BIBLIOTHEQUE(2025;[Table 1]Champ_Image)
FIXER TAILLE BLOB([Table 1]Champ_Blob;68;Code ascii("Q"))

Exemple 6 : supprimer_Enreg▲

CHERCHER([Table 1];[Table 1]Champ_EntierLong=-3)
SUPPRIMER ENREGISTREMENT([Table 1])

Exemple 7 : supprimer_Selection▲

CHERCHER([Table 1];[Table 1]Champ_Numerique<=10,04)
SUPPRIMER SELECTION([Table 1])

Voici quelques méthodes génériques que vous trouverez également dans la base cliente...

Gen_util_QueryBuildLine et Gen_util_QueryDefineValue▲

Gen_Gestion_Erreurs▲

Gen_TableNom_Vers_TableID▲

Les communications entre applications sont souvent des accès aux données, vous trouverez ici des méthodes 4D basées sur les services web permettant à des différentes applications 4D de communiquer entre elles. Toutefois, chaque environnement possède ses propres spécificités et ces méthodes pourront être ajustées aux différents contraintes ou contextes, notamment dans des environnements existants auxquels il faudra bien sûr s'adapter.

Télécharger la base exemple.