Guide technique - Etat de Genève

En partenariat avec Useful Web Sàrl – [email protected]
Canal de livraison semi-automatique des Régies
Guide technique
Janvier 2013, version 1.2

REPUBLIQUE ET CANTON DE GENEVE
Département des constructions et des technologies de l'information
Programme de l'Administration en Ligne
Rue du Grand-Pré 64-66 ● Case postale 2285 ● 1211 Genève 2
Tél. [phone] ● [email protected] ● www.ge.ch/ael
Papier recyclé
Table des matières
1. I NTRODUCTION ............................................................................................................. 3
2. P REREQUIS ................................................................................................................. 3
3. D ESCRIPTION DU W EB S ERVICE .................................................................................... 3
3.1. Description fonctionnelle du service ...................................................................................... 3
3.2. Description WSDL WebService des régies ............................................................................ 3
3.3. Description JAVA du WebService des régies ........................................................................ 4
4. U TILISATION DU W EB S ERVICE EN J AVA ........................................................................ 6

REPUBLIQUE ET CANTON DE GENEVE
Département des constructions et des technologies de l'information
Programme de l'Administration en Ligne
Rue du Grand-Pré 64-66 ● Case postale 2285 ● 1211 Genève 2
Tél. [phone] ● [email protected] ● www.ge.ch/ael
Papier recyclé
1. INTRODUCTION
Afin d’assurer son accessibilité, le canal semi-automatique de livraison mis à disposition par l’Etat de
Genève est présenté sous la forme d’un web service permettant d'envoyer des données de manière
sécurisée.
Un WebService est une interface qui peut être interrogée en utilisant la plupart des technologies
actuelles. Pour plus d’information, http://en.wikipedia.org/wiki/Web_service .
Ce web service est sécurisé par certificat. Deux certificats seront donc nécessaires pour s’y
connecter :
• Un keystore : permettant votre identification. Vous pouvez obtenir ce certificat auprès de l’Etat
de Genève en suivant la procédure « Obtention d’un certificat au format .jks » présentée
en annexe de ce document.
• Un truststore : permettant de vérifier auprès d’une autorité de certification l’identité du serveur
de l’Etat de Genève avec lequel vous communiquerez.Le trustStore est disponible au
téléchargement avec ce document.
Pour plus d’information sur ces certificats, vous pouvez vous référer
à http://javarevisited.blogspot.ch/2012/09/difference-between-truststore-vs-keyStore-Java-SSL.html
2. PREREQUIS
Afin de pouvoir mener à bien cette installation, vous devez disposer d’un compte « AeL » actif pour
votre entreprise et avoir signé et envoyé la convention d’organisation et de confidentialité à
l’OCSTAT.
Ces points sont détaillés dans le « Manuel utilisateur pour les canaux de communication avec
les gérants d’immeubles ».
Un certificat au format .jks vous sera nécessaire lors de cette installation. Vous l’obtiendrez en
suivant la procédure « Obtention d’un certificat au format .jks » présentée en annexe de ce
document.
3. DESCRIPTION DU WEB SERVICE
3.1. D ESCRIPTION FONCTIONNELLE DU SERVICE
La fonctionnalité de livraison du canal semi-automatique permet de déposer un fichier eGE sur les
serveurs de l’Etat de Genève et de recevoir un accusé de réception en retour.
3.2. D ESCRIPTION WSDL W EB S ERVICE DES RÉGIES
Le WebService est défini par un fichier WSDL dont le contenu est le suivant. L’opération concernant
le canal semi-automatique a été mise en évidence.

REPUBLIQUE ET CANTON DE GENEVE
Département des constructions et des technologies de l'information
Programme de l'Administration en Ligne
Rue du Grand-Pré 64-66 ● Case postale 2285 ● 1211 Genève 2
Tél. [phone] ● [email protected] ● www.ge.ch/ael
Papier recyclé
<wsdl:definitions name="RegiesServiceImplService"
targetNamespace=" http://server.scm.usefulweb.ch/ ">
<wsdl:import
location="http://localhost:8080/scm%2Dserver%2D0.2.1/RegiesService?wsdl=RegiesService.wsdl"
namespace="http://ws.common.scm.usefulweb.ch/">
</wsdl:import><wsdl:binding name="RegiesServiceImplServiceSoapBinding"
type="ns1:RegiesService">
<soap:binding style="document" transport=" http://schemas.xmlsoap.org/soap/http "/>
<wsdl:operation name="checkVersion"><soap:operation soapAction="" style="document"/>
<wsdl:input name="checkVersion">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="checkVersionResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="getEGE">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="getEGE">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="getEGEResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="getClientURL">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="getClientURL">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="getClientURLResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="sendEGE">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="sendEGE">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="sendEGEResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="getEGEList">
<soap:operation soapAction="" style="document"/>
<wsdl:input name="getEGEList">
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output name="getEGEListResponse">
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="RegiesServiceImplService">
<wsdl:port binding="tns:RegiesServiceImplServiceSoapBinding"
name="RegiesServiceImplPort">
<soap:address location=" https://b2b.ge.ch/ctib2b/cible203/RegieUploadWS "/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
3.3. D ESCRIPTION JAVA DU W EB S ERVICE DES RÉGIES

REPUBLIQUE ET CANTON DE GENEVE
Département des constructions et des technologies de l'information
Programme de l'Administration en Ligne
Rue du Grand-Pré 64-66 ● Case postale 2285 ● 1211 Genève 2
Tél. [phone] ● [email protected] ● www.ge.ch/ael
Papier recyclé
Le WebService de l'Etat de Genève a été développé en JAVA. Cela n’est pas perceptible par votre
programme car il ne voit que l'interface WebService. L’interface JAVA décrivant ce web service peut
cependant vous apporter de précieuses informations. La méthode qui concerne le canal semi-
automatique a été mise en évidence.
/**
* Checks current version
*
* Checks the match between the client and server versions
*
* @param clientVersion exchange module client version
* @return Ok if if client and server versions are the same, otherwise the
server version
*/
@WebMethod
public String checkVersion(@WebParam(name="version") String clientVersion);
/**
* Gets the url for a client module update
*
* Gets the url where the client module can find a newer version in order to update its
binaries.
*
* @return url of the zip file containing a newer version of the client
*/
@WebMethod
public String getClientURL();
/**
* Gets the list of files ready to be downloaded by client
*
* Gets the list of files that are ready to be downloaded by a given client
* This method uses getPrincipal in order to authenticate the client (using the certificate
used for the SSL channel)
*
* @return an array of Strings which are the fileNames available
*/
@WebMethod
public String[] getEGEList();
/**
* Downloads an eGE-xxxx file for a given client
*
* Serializes an eGE-xxxx file that is to be downloaded for a given client.
* This method uses getPrincipal in order to authenticate the client (using the certificate
used for the SSL channel)
*
* @param file fileName that is to be downloaded
* @return serialized eGE-file
*/
@WebMethod
public EGESerializedContent getEGE(@WebParam(name="file") String file);
/**
* Receives serialized eGE-File and stores it
*
* Generates the eGE-xxxx file received as serialized content and writes it to the disk in
the inbox folder
*
* @param content serialized eGE file
* @return acknowledgement informing whether the eGE-xxxx file has been
received properly
*/
@WebMethod
public Acknowledge sendEGE(@WebParam(name="content") EGESerializedContent content);