<?xml version="1.0" encoding='ISO-8859-1'?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" 
  "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % cartoweb SYSTEM "../cartoweb.ent" >
  %cartoweb;
  ]>
<chapter id="dev.soapcalls">
  <title>Calling Plugins</title>
  <para>This chapter describes the structure of SOAP calls to &cartoweb; server 
    methods in order to obtain cartographic data.</para>
  <warning>
   <para>Due to some &cartoweb; evolutions, please note that some parts of the current chapter may need some updates!</para>
  </warning>
  <para>Global WSDL code can be found in file 
    <filename>CARTOWEB_HOME/server/cartoserver.wsdl</filename>. WSDL code 
    specific to plugins are located in 
    <filename>PLUGIN_HOME/common/plugin_name.wsdl.inc</filename>. Interesting 
    parts from these files are copied in the following sections.</para>
  <para>Complete WSDL code dynamically generated for a map ID is accessible at 
    the URL 
    <filename>CARTOWEB_URL/cartoserver.wsdl.php?mapId=project_name.mapfile_name</filename>. 
    </para>
  <para>SOAP method getMapInfo is used to retrieve server configuration 
    information, such as available layers, initial state, etc.. It shouldn't be 
    called each time a map is requested. A mechanism based on a timestamp is 
    available to be sure configuration is up-to-date (see <xref 
    linkend="dev.soapcalls.getmapinfo" />).</para>
  <para>SOAP method getMap is used each time a new map or related information 
    are needed.</para>
  <xi:include href="soapcalls/structures.xml" 
    xmlns:xi="http://www.w3.org/2001/XInclude" />
  <xi:include href="soapcalls/getmapinfo.xml" 
    xmlns:xi="http://www.w3.org/2001/XInclude" />
  <xi:include href="soapcalls/getmap.xml" 
    xmlns:xi="http://www.w3.org/2001/XInclude" />
  <xi:include href="soapcalls/examples.xml" 
    xmlns:xi="http://www.w3.org/2001/XInclude" />
</chapter>
