Retourner des données par Service Web (via SOAP)

Date de publication : Mars 2005

Par David Adams
 

I. Introduction

II. Rappel : Web Services, SOAP et XML

III. Rappel : Activer les Services Web

1. le serveur natif 4ème Dimension doit être démarré et accessible ;
   
   
2. 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 ;
   
   
3. 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

IV. Définir les données retournées

• Le paramètre $0 de n’importe quelle méthode offerte comme Web service peut être inclus automatiquement comme sortie. Aucune programmation spécifique n’est nécessaire.
  
  
• Les variables et tableaux process peuvent être liés aux paramètres de sortie en utilisant la commande DECLARATION SOAP.

V. Le paramètre de résultat $0

<?xml version="1.0" encoding="UTF-8" ?>								
<SOAP-ENV:Envelope

	SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
	xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
	
<SOAP-ENV:Body>
				
	<ns1:returnInputTextResponse
	xmlns:ns1="http://www.4d.com/namespace/default"
	SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
						
		<FourD_arg0 xsi:type="xsd:string">Hello world!</FourD_arg0>
							
	</ns1:returnInputTextResponse>
					
</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

<outEchoInputString xsi:type="xsd:string">Hello world!</outEchoInputString>

VI. DECLARATION SOAP et les sorties autres que $0

<?xml version="1.0" encoding="UTF-8" ?>
<SOAP-ENV:Envelope
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<SOAP-ENV:Body>
<ns1:returnThreeResultsResponse
xmlns:ns1="http://www.4d.com/namespace/default"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<outSecondsSinceMidnight xsi:type="xsd:float">40174</outSecondsSinceMidnight>
<outPi xsi:type="xsd:float">3,141592653589793116</outPi>
<outServerVersion xsi:type="xsd:string">Version #0703</outServerVersion>
</ns1:returnThreeResultsResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

VII. Types de données supportés et sources

Note 1 : les données de type image peuvent être envoyées après conversion en BLOB, comme le montre la base de démo accompagnant cette note. Cette technique est détaillée dans la Note Technique 4D-200503-09-FR "Retourner des images par Web Services (via SOAP)".

Note 2: 4ème Dimension n'a pas de type distinct pour les valeurs d’heure. A la place, il utilise un tableau d'entiers longs. C'est une caractéristique de longue date du langage de 4ème Dimension qui n'a pas changé pour les Services Web.

VIII. Base de démo

Requêtes et réponse

Configuration des méthodes proxy

Le client peut s'exécuter dans une copie distincte de 4D

Numéros de port

Note : Compiler_Web La méthode projet Compiler_Web peut être source de confusion pour les développeurs débutant dans l'emploi des fonctionnalités Web et Service Web de 4ème Dimension. La méthode Compiler_Web lie automatiquement les valeurs des formulaires Web et des requêtes SOAP aux variables et tableaux process. Les valeurs utilisées comme sortie n'ont pas besoin d’être déclarées dans la méthode Compiler_Web.

IX. Notes et rappels sur DECLARATION SOAP

• La commande DECLARATION SOAP doit s’appeler directement depuis la méthode appelée en tant que Service Web, et non dans une sous-routine.
  
  
• Les noms d'éléments XML sont soumis à des restrictions par rapport aux caractères spéciaux, tout particulièrement les espaces. Assurez-vous de fournir des noms XML corrects à la commande DECLARATION SOAP.
  
  
• La commande DECLARATION SOAP n'a pas de relation avec les déclarations de compilation Dimension. Les variables, paramètres et tableaux doivent être déclarés et initialisés normalement.
  
  
• La commande DECLARATION SOAP est ignorée si l'appel de la méthode courante ne provient pas d’un Service Web. Ce comportement permet d'appeler la même méthode localement depuis une autre méthode 4ème dimension.

X. Bases exemples

__________________________________________________
Copyright © 1985-2008 4D SA - Tous droits réservés
Tous les efforts ont été faits pour que le contenu de cette note technique présente le maximum de fiabilité possible.
Néanmoins, les différents éléments composant cette note technique, et le cas échéant, le code, sont fournis sans garantie d'aucune sorte. L'auteur et 4D S.A. déclinent donc toute responsabilité quant à l'utilisation qui pourrait être faite de ces éléments, tant à l'égard de leurs utilisateurs que des tiers.
Les informations contenues dans ce document peuvent faire l'objet de modifications sans préavis et ne sauraient en aucune manière engager 4D SA. La fourniture du logiciel décrit dans ce document est régie par un octroi de licence dont les termes sont précisés par ailleurs dans la licence électronique figurant sur le support du Logiciel et de la Documentation afférente. Le logiciel et sa documentation ne peuvent être utilisés, copiés ou reproduits sur quelque support que ce soit et de quelque manière que ce soit, que conformément aux termes de cette licence.
Aucune partie de ce document ne peut être reproduite ou recopiée de quelque manière que ce soit, électronique ou mécanique, y compris par photocopie, enregistrement, archivage ou tout autre procédé de stockage, de traitement et de récupération d'informations, pour d'autres buts que l'usage personnel de l'acheteur, et ce exclusivement aux conditions contractuelles, sans la permission explicite de 4D SA.
4D, 4D Calc, 4D Draw, 4D Write, 4D Insider, 4ème Dimension ®, 4D Server, 4D Compiler ainsi que les logos 4e Dimension, sont des marques enregistrées de 4D SA.
Windows,Windows NT,Win 32s et Microsoft sont des marques enregistrées de Microsoft Corporation.
Apple, Macintosh, Power Macintosh, LaserWriter, ImageWriter, QuickTime sont des marques enregistrées ou des noms commerciaux de Apple Computer,Inc.
Mac2Win Software Copyright © 1990-2002 est un produit de Altura Software,Inc.
4D Write contient des éléments de "MacLink Plus file translation", un produit de DataViz, Inc,55 Corporate drive,Trumbull,CT,USA.
XTND Copyright 1992-2002 © 4D SA. Tous droits réservés.
XTND Technology Copyright 1989-2002 © Claris Corporation.. Tous droits réservés ACROBAT © Copyright 1987-2002, Secret Commercial Adobe Systems Inc.Tous droits réservés. ACROBAT est une marque enregistrée d'Adobe Systems Inc.
Tous les autres noms de produits ou appellations sont des marques déposées ou des noms commerciaux appartenant à leurs propriétaires respectifs.
__________________________________________________