<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="fr">
	<id>https://docs.mappingsuite.com/w/index.php?action=history&amp;feed=atom&amp;title=M-PS_Web_services_8.0_EN</id>
	<title>M-PS Web services 8.0 EN - Historique des versions</title>
	<link rel="self" type="application/atom+xml" href="https://docs.mappingsuite.com/w/index.php?action=history&amp;feed=atom&amp;title=M-PS_Web_services_8.0_EN"/>
	<link rel="alternate" type="text/html" href="https://docs.mappingsuite.com/w/index.php?title=M-PS_Web_services_8.0_EN&amp;action=history"/>
	<updated>2026-04-06T07:05:04Z</updated>
	<subtitle>Historique des versions pour cette page sur le wiki</subtitle>
	<generator>MediaWiki 1.32.1</generator>
	<entry>
		<id>https://docs.mappingsuite.com/w/index.php?title=M-PS_Web_services_8.0_EN&amp;diff=1354&amp;oldid=prev</id>
		<title>imported&gt;Admin : 1 révision importée</title>
		<link rel="alternate" type="text/html" href="https://docs.mappingsuite.com/w/index.php?title=M-PS_Web_services_8.0_EN&amp;diff=1354&amp;oldid=prev"/>
		<updated>2019-03-06T09:11:32Z</updated>

		<summary type="html">&lt;p&gt;1 révision importée&lt;/p&gt;
&lt;table class=&quot;diff diff-contentalign-left&quot; data-mw=&quot;interface&quot;&gt;
				&lt;tr class=&quot;diff-title&quot; lang=&quot;fr&quot;&gt;
				&lt;td colspan=&quot;1&quot; style=&quot;background-color: #fff; color: #222; text-align: center;&quot;&gt;← Version précédente&lt;/td&gt;
				&lt;td colspan=&quot;1&quot; style=&quot;background-color: #fff; color: #222; text-align: center;&quot;&gt;Version du 6 mars 2019 à 09:11&lt;/td&gt;
				&lt;/tr&gt;&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-notice&quot; lang=&quot;fr&quot;&gt;&lt;div class=&quot;mw-diff-empty&quot;&gt;(Aucune différence)&lt;/div&gt;
&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;</summary>
		<author><name>imported&gt;Admin</name></author>
		
	</entry>
	<entry>
		<id>https://docs.mappingsuite.com/w/index.php?title=M-PS_Web_services_8.0_EN&amp;diff=1353&amp;oldid=prev</id>
		<title>imported&gt;Bsteeland : Created page with &quot;==Presentation / Objectives == This document describes the configuration and use of Mapping web services.  ==Requirements== Knowledge of a development environment for web serv...&quot;</title>
		<link rel="alternate" type="text/html" href="https://docs.mappingsuite.com/w/index.php?title=M-PS_Web_services_8.0_EN&amp;diff=1353&amp;oldid=prev"/>
		<updated>2018-08-29T14:20:40Z</updated>

		<summary type="html">&lt;p&gt;Created page with &amp;quot;==Presentation / Objectives == This document describes the configuration and use of Mapping web services.  ==Requirements== Knowledge of a development environment for web serv...&amp;quot;&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Nouvelle page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;==Presentation / Objectives ==&lt;br /&gt;
This document describes the configuration and use of Mapping web services. &lt;br /&gt;
==Requirements==&lt;br /&gt;
Knowledge of a development environment for web services.&lt;br /&gt;
-	Microsoft Visual Studio&lt;br /&gt;
-	Server J2EE&lt;br /&gt;
==Related Documentation==&lt;br /&gt;
*Mapping Print Service Print over http/https&lt;br /&gt;
*Mapping Web Application BEA WebLogic (iPlanet)&lt;br /&gt;
*Mapping Web Application JBoss&lt;br /&gt;
*Mapping Web Application TomCat&lt;br /&gt;
*Mapping Web Application WebSphere&lt;br /&gt;
 &lt;br /&gt;
==Introduction to Web Services==&lt;br /&gt;
The web services enable you to run Mapping commands in your own application (javascript, c# or java) so you no longer need to use the Mapping web UI.&lt;br /&gt;
The web services enable you to perform the following basic actions available in the spooler:&lt;br /&gt;
•actions on a spooled file&lt;br /&gt;
release&lt;br /&gt;
hold&lt;br /&gt;
transfer&lt;br /&gt;
delete&lt;br /&gt;
view content &lt;br /&gt;
display log file&lt;br /&gt;
display information&lt;br /&gt;
&lt;br /&gt;
•actions on an output queue&lt;br /&gt;
start&lt;br /&gt;
stop&lt;br /&gt;
display log file&lt;br /&gt;
display information&lt;br /&gt;
In addition to the actions above, the web service handles spooled file sending, previewing and remapping.&lt;br /&gt;
The upload (send spooled file), preview (preview spooled file) and run (remap spooled file) methods offer two ways of sending a spooled file or view the result of the spooled file that was generated or sent. &lt;br /&gt;
For larger files, a URL version can be used for each method which saves the spooled file to the disk and transfers the URL so the client or server application may read the spooled file indirectly.&lt;br /&gt;
In the stream method, spooled file content is sent directly through the network. An exception is raised if the volume of data included in the spooled file is too large. &lt;br /&gt;
However, it is recommended to use the stream version as it is a lot faster. &lt;br /&gt;
&lt;br /&gt;
  &lt;br /&gt;
==Creating a Client==&lt;br /&gt;
The Web Services Description Language (wsdl) is a XML based language providing a web service description model.&lt;br /&gt;
The wsdl specifies:&lt;br /&gt;
Supported operations (method names)&lt;br /&gt;
Detailed data type information (number and type of method input and output parameters)&lt;br /&gt;
The protocol used: SOAP&lt;br /&gt;
The URL of the service to be used&lt;br /&gt;
On the client side, a stub and interfaces representing the objects to be processed are generated automatically when importing the wsdl.&lt;br /&gt;
The wsdl can be accessed by adding ?wsdl at the end of the address where the web service is found. For example: http://localhost:8080/MapSoapServer/MapSoapServer?wsdl&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 &lt;br /&gt;
==Installing the Web Services==&lt;br /&gt;
Follow these steps to install the Web services:&lt;br /&gt;
Check that the mapsoapserver file is in the cgi folder of the web server.&lt;br /&gt;
Test the connection locally:&lt;br /&gt;
http://localhos:t:8002/cgi-bin/mapsoapserver.exe&lt;br /&gt;
Then, remotely:&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe?wsdl&lt;br /&gt;
List of variables that need to be checked and configured in Mapping.conf: &lt;br /&gt;
SOAP_PATH_TEMP: temporary folder used by the SOAP server&lt;br /&gt;
SOAP_PATH_LOG: folder used to store the log only if folder SOAP_DEBUG=on or if an error occurs&lt;br /&gt;
SOAP_LOCATION: web service remote access URL&lt;br /&gt;
SOAP_LOCAL_URL: local folder corresponding to SOAP_DOCUMENT_URL enabling the SOAP client to retrieve larger files&lt;br /&gt;
SOAP_DOCUMENT_URL: remote access URL to the document produced by the SOAP server&lt;br /&gt;
SOAP_HOST_PROXY: proxy used to access the files specified by the SOAP client&lt;br /&gt;
SOAP_PORT_PROXY: proxy port&lt;br /&gt;
SOAP_DEBUG: SOAP debug mode&lt;br /&gt;
&lt;br /&gt;
#SOAP&lt;br /&gt;
[SOAP_PATH_TEMP]	C:\Program Files\MappingWindows\Temp\HTTPServer&lt;br /&gt;
[SOAP_PATH_LOG]	C:\Program Files\MappingWindows\Temp\HTTPServer&lt;br /&gt;
[SOAP_LOCATION]	http://localhost:8002/cgi-bin/mapsoapserver.exe&lt;br /&gt;
[SOAP_LOCAL_URL]	C:\Program Files\MappingWindows\MapHTTPServer\shareFolder&lt;br /&gt;
[SOAP_DOCUMENT_URL]	http://localhost:8002/shareFolder&lt;br /&gt;
[SOAP_HOST_PROXY]	0&lt;br /&gt;
[SOAP_PORT_PROXY]	0&lt;br /&gt;
[SOAP_DEBUG]	On&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
	&lt;br /&gt;
==Source Example==&lt;br /&gt;
===Microsoft Visual Studio : C#===&lt;br /&gt;
		To test the Mapping web services under VS, create a new project.&lt;br /&gt;
 &lt;br /&gt;
		Select project type, for example a console application.&lt;br /&gt;
 &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Add a web reference&lt;br /&gt;
 &lt;br /&gt;
		As web reference address, choose &lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe?wsdl&lt;br /&gt;
and give it a name e.g. MappingSuitePrintService&lt;br /&gt;
 &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Anwser security questions according to web server configuration.&lt;br /&gt;
 &lt;br /&gt;
 &lt;br /&gt;
	Enter the source code you wish to test.&lt;br /&gt;
using System;&lt;br /&gt;
using ConsoleApplication.MappingSuitePrintService;&lt;br /&gt;
namespace ConsoleApplication&lt;br /&gt;
{&lt;br /&gt;
	/// &amp;lt;summary&amp;gt;&lt;br /&gt;
	/// Summary description for Class1.&lt;br /&gt;
	/// &amp;lt;/summary&amp;gt;&lt;br /&gt;
	class Class1&lt;br /&gt;
	{&lt;br /&gt;
		/// &amp;lt;summary&amp;gt;&lt;br /&gt;
		/// The main entry point for the application.&lt;br /&gt;
		/// &amp;lt;/summary&amp;gt;&lt;br /&gt;
		[STAThread]&lt;br /&gt;
		static void Main(string[] args)&lt;br /&gt;
		{&lt;br /&gt;
			MapSoapServerService MappingSoapServer = new MapSoapServerService();&lt;br /&gt;
			stopQueue resultStop=MappingSoapServer.mapStopQueue(&amp;quot;PRT01&amp;quot;);&lt;br /&gt;
		}&lt;br /&gt;
	}&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 &lt;br /&gt;
===Java===&lt;br /&gt;
Creating the stub&lt;br /&gt;
		C:\jboss-4.2.1.GA\bin&amp;gt;&lt;br /&gt;
wsconsume.bat –k –p clientmapsoapsever.jboss.ejb &lt;br /&gt;
http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe?wsdl&lt;br /&gt;
 -o &amp;quot;C:\workspace\ClientMapSoapServer\src&amp;quot;&lt;br /&gt;
&lt;br /&gt;
Java source file&lt;br /&gt;
		    package clientmapsoapserver.ConsoleApplication.sw;&lt;br /&gt;
public class ConsoleApplication &lt;br /&gt;
{&lt;br /&gt;
	public static void main(String[] args) &lt;br /&gt;
	{&lt;br /&gt;
		clientmapsoapsever.jboss.ejb.MapSoapServerService service = &lt;br /&gt;
new clientmapsoapsever.jboss.ejb.MapSoapServerService();&lt;br /&gt;
		clientmapsoapsever.jboss.ejb.MapSoapServer MappingSoapServer = &lt;br /&gt;
service.getMapSoapServerPort();&lt;br /&gt;
		MappingSoapServer.mapStopQueue(&amp;quot;PRT01&amp;quot;);&lt;br /&gt;
	}	&lt;br /&gt;
}&lt;br /&gt;
 &lt;br /&gt;
===Javascript===&lt;br /&gt;
&amp;lt;html&amp;gt;	&lt;br /&gt;
&amp;lt;body&amp;gt;&lt;br /&gt;
&amp;lt;script type=&amp;quot;text/javascript&amp;quot;&amp;gt;&lt;br /&gt;
		var http_request = false;&lt;br /&gt;
		function makeRequest(url) &lt;br /&gt;
		{&lt;br /&gt;
			var xhr_object = null;&lt;br /&gt;
if ( window.XMLHttpRequest ) xhr_object = new XMLHttpRequest();&lt;br /&gt;
			else if(window.ActiveXObject)&lt;br /&gt;
			{&lt;br /&gt;
				try {&lt;br /&gt;
					xhr_object = new ActiveXObject(&amp;quot;Msxml2.XMLHTTP&amp;quot;);&lt;br /&gt;
				} catch(e) {&lt;br /&gt;
				try {&lt;br /&gt;
					xhr_object = new ActiveXObject(&amp;quot;Microsoft.XMLHTTP&amp;quot;);&lt;br /&gt;
				} catch(e) {&lt;br /&gt;
					xhr_object = null;&lt;br /&gt;
				}&lt;br /&gt;
}&lt;br /&gt;
			}&lt;br /&gt;
&lt;br /&gt;
			if (!xhr_object) {&lt;br /&gt;
			    alert('Cannot create XMLHTTP instance');&lt;br /&gt;
			    return false;&lt;br /&gt;
			}&lt;br /&gt;
			xhr_object.open('GET', url, false);&lt;br /&gt;
			xhr_object.send(parameter);&lt;br /&gt;
			return xhr_object.responseXML;&lt;br /&gt;
		}&lt;br /&gt;
		function stopQueue(qname)&lt;br /&gt;
		{&lt;br /&gt;
		 	currentresults=&amp;quot;&amp;quot;;&lt;br /&gt;
		   	parameter=&amp;quot;http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe/mapStopQueue?qname=&amp;quot;+qname;&lt;br /&gt;
		   	var xmldoc=makeRequest(parameter);&lt;br /&gt;
	        	var root=xmldoc.getElementsByTagName('stopQueue').item(0);&lt;br /&gt;
	        	var results=root.getElementsByTagName('infos').item(0);&lt;br /&gt;
	        	if (results.textContent)&lt;br /&gt;
			{&lt;br /&gt;
				currentresults=results.textContent;&lt;br /&gt;
			}&lt;br /&gt;
			else if (results.text)&lt;br /&gt;
			{&lt;br /&gt;
				currentresults=results.text;&lt;br /&gt;
}&lt;br /&gt;
			alert(currentresults);&lt;br /&gt;
        	}&lt;br /&gt;
	stopQueue(&amp;quot;MAPPING&amp;quot;);			   &lt;br /&gt;
	&amp;lt;/script&amp;gt;&lt;br /&gt;
	&amp;lt;/body&amp;gt;&lt;br /&gt;
&amp;lt;/html&amp;gt;&lt;br /&gt;
&lt;br /&gt;
 &lt;br /&gt;
==Enabling Anonymous Connections==&lt;br /&gt;
Editing the Apache configuration file.&lt;br /&gt;
To enable anonymous connections to another URL or port, all you need to is define a new AccessFileName.&lt;br /&gt;
 	 #BEGIN_MAPPING_1.00.30_12-6-2007&lt;br /&gt;
#LoadModule ldap_module modules/mod_ldap.so&lt;br /&gt;
#LoadModule authnz_ldap_module modules/mod_authnz_ldap.so&lt;br /&gt;
Listen 8002&lt;br /&gt;
NameVirtualHost *:8002&lt;br /&gt;
&amp;lt;VirtualHost *:8002&amp;gt;&lt;br /&gt;
	AccessFileName .htaccess&lt;br /&gt;
	ServerName SERVEURSAP&lt;br /&gt;
	DocumentRoot &amp;quot;C:/Program Files/MappingWindows/MapHTTPServer&amp;quot;&lt;br /&gt;
	&amp;lt;Directory &amp;quot;C:/Program Files/MappingWindows/MapHTTPServer/cgi-bin&amp;quot;&amp;gt;&lt;br /&gt;
		AllowOverride All&lt;br /&gt;
		Order allow,deny&lt;br /&gt;
		Allow from all&lt;br /&gt;
		Options None&lt;br /&gt;
	&amp;lt;/Directory&amp;gt;&lt;br /&gt;
&lt;br /&gt;
ScriptAlias /cgi-bin/ &amp;quot;C:/Program Files/MappingWindows/MapHTTPServer/cgi-bin/&amp;quot;&lt;br /&gt;
	&amp;lt;Directory &amp;quot;C:/Program Files/MappingWindows/MapHTTPServer&amp;quot;&amp;gt;&lt;br /&gt;
		AllowOverride All&lt;br /&gt;
		Order allow,deny&lt;br /&gt;
		Allow from all&lt;br /&gt;
		Options None&lt;br /&gt;
	&amp;lt;/Directory&amp;gt;&lt;br /&gt;
&amp;lt;/VirtualHost&amp;gt;&lt;br /&gt;
#END_MAPPING_1.00.30_12-6-2007&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&amp;lt;Directory &amp;quot;C:\Program Files\Apache Software Foundation\Apache2.2\htdocs\MapWebFiles&amp;quot;&amp;gt;&lt;br /&gt;
AllowOverride all&lt;br /&gt;
Order deny,allow&lt;br /&gt;
&amp;lt;/Directory&amp;gt;&lt;br /&gt;
&lt;br /&gt;
AccessFileName .config&lt;br /&gt;
ScriptAlias /MapHTTPServer &amp;quot;C:/Program Files/MappingWindows/MapHTTPServer/&amp;quot;&lt;br /&gt;
&amp;lt;Directory &amp;quot;C:/Program Files/MappingWindows/MapHTTPServer&amp;quot;&amp;gt;&lt;br /&gt;
	AllowOverride All&lt;br /&gt;
	Order allow,deny&lt;br /&gt;
	Allow from all&lt;br /&gt;
	Options None&lt;br /&gt;
&amp;lt;/Directory&amp;gt;&lt;br /&gt;
ScriptAlias /MapHTTPServer/cgi-bin &amp;quot;C:/Program Files/MappingWindows/MapHTTPServer/cgi-bin/&amp;quot;&lt;br /&gt;
&amp;lt;Directory &amp;quot;C:/Program Files/MappingWindows/MapHTTPServer/cgi-bin&amp;quot;&amp;gt;&lt;br /&gt;
&lt;br /&gt;
	AllowOverride All&lt;br /&gt;
	Order allow,deny&lt;br /&gt;
	Allow from all&lt;br /&gt;
	Options None&lt;br /&gt;
&amp;lt;/Directory&amp;gt;&lt;br /&gt;
 &lt;br /&gt;
==List of Existing Functions==&lt;br /&gt;
To learn about existing functions, you can use:&lt;br /&gt;
•	the WSDL: &lt;br /&gt;
http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe?wsdl&lt;br /&gt;
•	if you can access the localhost system, see here for an overview of HTML functions:&lt;br /&gt;
http://127.0.0.1:8002/cgi-bin/mapsoapserver.exe&lt;br /&gt;
&lt;br /&gt;
 	Note&lt;br /&gt;
On UNIX/Linux, delete .exe&lt;br /&gt;
All functions are described in the HTML function overview page.&lt;br /&gt;
The WSDL describes the expected input and output parameters.&lt;br /&gt;
key and value are specific parameters that are combined together to let you define an unlimited set of values so they can be used in the rules engine. For example, for insert spooled file commands, they become user data of the spooled files produced. For rules engine commands, they become rules engine parameters.&lt;br /&gt;
9.1.		Listing Functions&lt;br /&gt;
mapListSplf : List user spool files&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapListSplf?login=mapadmin&amp;amp;ownerName=*&amp;amp;site=*&amp;amp;qname=*&amp;amp;splf=*&amp;amp;state=*&lt;br /&gt;
&lt;br /&gt;
mapListSplfWithDate : List user spool files by date&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapListSplfWithDate?login=mapadmin&amp;amp;ownerName=*&amp;amp;site=*&amp;amp;qname=*&amp;amp;splf=*&amp;amp;state=*&amp;amp;fromDay=21&amp;amp;fromMonth=1&amp;amp;fromYear=2006&amp;amp;toDay=21&amp;amp;toMonth=1&amp;amp;toYear=2006&lt;br /&gt;
&lt;br /&gt;
mapListPrinter : List available printers&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapListPrinter?login=mapadmin&amp;amp;ownerName=*&amp;amp;site=*&amp;amp;qname=*&amp;amp;type=*&amp;amp;state=*&lt;br /&gt;
&lt;br /&gt;
mapListPrinterTransfer : List all printers available for transfer&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapListPrinterTransfer?login=mapadmin&lt;br /&gt;
 &lt;br /&gt;
===Functions on Individual Spooled Files===&lt;br /&gt;
mapRestartPrinting : Restart a print job at a given page&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapRestartPrinting?jobNum=000000000030072&amp;amp;startPage=1&amp;amp;stopPage=1&amp;amp;user=mapadmin&amp;amp;qname=PRT01&amp;amp;title=My Title&amp;amp;orignalQname=PRT01&lt;br /&gt;
 		mapMoveSplf : Move a spool file to another queue&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapMoveSplf?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;oldqname=PRT02&lt;br /&gt;
mapDelSplf : Delete a spool file&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapDelSplf?jobNum=000000000030072&amp;amp;qname=PRT01&lt;br /&gt;
mapReleaseSplf : Release a spool file&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapReleaseSplf?jobNum=000000000030072&amp;amp;qname=PRT01&lt;br /&gt;
mapHoldSplf : Hold a spool file&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapHoldSplf?jobNum=000000000030072&amp;amp;qname=PRT01&lt;br /&gt;
mapInfoSplf : Display spool file information&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapInfoSplf?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;user=mapadmin&lt;br /&gt;
&lt;br /&gt;
mapChangeSplfUserData : Change spool file User Data&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapChangeSplfUserData?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;key=MYUSERDATA&amp;amp;value=my value&lt;br /&gt;
mapChangeSplfGroupID : Change spool file Group ID&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapChangeSplfGroupID?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;value=my value&lt;br /&gt;
mapChangeSplfAccountancyCode : Change spool file Accountancy Code&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapChangeSplfAccountancyCode?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;value=0&lt;br /&gt;
mapChangeSplfStateAttribute : Change spool file State Attribute&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapChangeSplfStateAttribute?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;value=my value&lt;br /&gt;
mapChangeSplfRetentionTime : Change spool file Retention Time&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapChangeSplfRetentionTime?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;value=my value&lt;br /&gt;
mapChangeSplfPriority : Change spool file Priority&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapChangeSplfPriority?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;value=my value&lt;br /&gt;
mapChangeSplfStopPage : Change spool file Stop Page&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapChangeSplfStopPage?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;value=my value&lt;br /&gt;
mapChangeSplfStartPage : Change spool file Start Page&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapChangeSplfStartPage?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;value=my value&lt;br /&gt;
mapChangeSplfNbCopy : Change spool file Number of Copies&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapChangeSplfNbCopy?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;value=my value&lt;br /&gt;
mapChangeSplfTitle : Change spool file Title&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapChangeSplfTitle?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;value=my value&lt;br /&gt;
 			&lt;br /&gt;
 &lt;br /&gt;
mapChangeSplfUser : Change spool file User&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapChangeSplfUser?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;value=my value&lt;br /&gt;
mapChangeSplfSave : Change spool file Save&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapChangeSplfSave?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;value=my value&lt;br /&gt;
 			mapLogSplf : View spool file log &lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapLogSplf?qname=PRT01&amp;amp;jobNum=000000000030072&amp;amp;login=yourvalue&amp;amp;filter=yourvalue&amp;amp;dateFrom=yourvalue&amp;amp;dateTo=yourvalue&amp;amp;level=yourvalue&lt;br /&gt;
9.3.		Functions on Multiple Spooled Files&lt;br /&gt;
mapHoldMultiSplf : Hold multiple spool files&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapHoldMultiSplf?jobNum=000000000030072&amp;amp;qname=PRT01&lt;br /&gt;
mapReleaseMultiSplf : Release multiple spool files&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapReleaseMultiSplf?jobNum=000000000030072&amp;amp;qname=PRT01&lt;br /&gt;
mapDelMultiSplf : Delete multiple spool files&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapDelMultiSplf?jobNum=000000000030072&amp;amp;qname=PRT01&lt;br /&gt;
mapMoveMultiSplf : Move multiple spool files&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapMoveMultiSplf?jobNum=000000000030072&amp;amp;qname=PRT01&amp;amp;oldqname=PRT02&lt;br /&gt;
mapSplfPreviewURL : Download the spool file preview URL&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapSplfPreviewURL?qname=PRT01&amp;amp;jobNum=000000000030072&lt;br /&gt;
&lt;br /&gt;
mapSplfPreviewStream : Download spool file preview stream&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapSplfPreviewStream?qname=PRT01&amp;amp;jobNum=000000000030072&lt;br /&gt;
===Printer Functions===&lt;br /&gt;
mapRefreshStatus : Refresh printer status&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapRefreshStatus?qname=PRT01&lt;br /&gt;
mapRestartDevice : Restart a device&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapRestartDevice?deviceName=DEVPRT01&amp;amp;qname=PRT01&lt;br /&gt;
mapStartQueue : Start a queue&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapStartQueue?qname=PRT01&lt;br /&gt;
mapStopQueue : Stop a queue&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapStopQueue?qname=PRT01&lt;br /&gt;
mapInfoPrinter : Display printer information&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapInfoPrinter?qname=PRT01&amp;amp;user=mapadmin&lt;br /&gt;
mapLogQueue : View queue log&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapLogQueue?qname=PRT01&amp;amp;login=mapadmin&amp;amp;filter=yourvalue&amp;amp;dateFrom=yourvalue&amp;amp;dateTo=yourvalue&amp;amp;level=yourvalue&lt;br /&gt;
 &lt;br /&gt;
===Print Request Functions===&lt;br /&gt;
mapUploadMessage : Upload a message as a spool file&lt;br /&gt;
This function inserts a message in the spooler by sending the text message as a parameter. For instance, the method lets you start a process. This method is not suited for binary data or larger size data.&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapUploadMessage?qname=PRT01&amp;amp;title=yourvalue&amp;amp;user=yourvalue&amp;amp;stream=yourvalue&amp;amp;key=yourvalue&amp;amp;value=yourvalue&lt;br /&gt;
mapUploadFile : Upload a file as a spool file&lt;br /&gt;
This function inserts a file in the spooler by sending the file as a stream (base64 encoding). This method lets you transfer binary files but does not support larger size data.&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapUploadFile?qname=PRT01&amp;amp;title=yourvalue&amp;amp;user=yourvalue&amp;amp;stream=yourvalue&amp;amp;key=yourvalue&amp;amp;value=yourvalue&lt;br /&gt;
mapUploadURL : Upload a url as a spool file&lt;br /&gt;
This function inserts a file in the spooler by asking the Mapping web service to retrieve the file from a URL passed as a parameter.&lt;br /&gt;
This function supports binary files and larger files.&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapUploadURL?qname=PRT01&amp;amp;title=yourvalue&amp;amp;user=yourvalue&amp;amp;url=yourvalue&amp;amp;key=yourvalue&amp;amp;value=yourvalue&lt;br /&gt;
mapRunStream : Run Mapping engine data stream&lt;br /&gt;
This function submits a base 64 encoded file to the rules engine and receives a base 64 encoded document in return.&lt;br /&gt;
The rules engine has the value MAP_SOAP = On enabled automatically to support specific rules for SOAP accesses.&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapRunStream?stream=base 64 data&amp;amp;key=anyname&amp;amp;value=any value&lt;br /&gt;
&lt;br /&gt;
 &lt;br /&gt;
 	Note&lt;br /&gt;
For SOAP accesses with a GET request, if you add the parameter getobject=1 the response will be the document without base 64 encoding, which lets you use it in HTML pages to request a document preview for example.&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapRunStream?stream=base 64 data&amp;amp;key=anyname&amp;amp;value=any value&amp;amp;getobject=1&lt;br /&gt;
mapRunURL : Run the stream and get URL&lt;br /&gt;
This function submits a base 64 encoded file to the rules engine and receives the URL of the document produced in return, letting the web client delete the document through the mapRemoveTempURL request or any other script.&lt;br /&gt;
The rules engine has the value MAP_SOAP = On enabled automatically, which lets you set specific rules on SOAP accesses.&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapRunURL?stream=yourvalue&amp;amp;key=yourvalue&amp;amp;value=yourvalue&lt;br /&gt;
mapRemoveTempURL : Remove the temp URL built by SOAP server&lt;br /&gt;
This function deletes the file created by the mapRunURL or mapSplfPreviewURL method.&lt;br /&gt;
Sample GET&lt;br /&gt;
http://localhost:8002/cgi-bin/mapsoapserver.exe/mapRemoveTempURL?downloadurl=http://localhost/shareFolder/090432424242343243.tmp &lt;br /&gt;
 &lt;br /&gt;
===Detailed Upload Method Information===&lt;br /&gt;
The upload method sends a spooled file to a queue. &lt;br /&gt;
A temporary file is created on the server side containing the data that has been sent.&lt;br /&gt;
The temporary file is deleted when the map_lp command is run.&lt;br /&gt;
&lt;br /&gt;
For the URL version, the file must be copied to a site that can be accessed by the web service.&lt;br /&gt;
&lt;br /&gt;
Below is a diagram showing the architecture used during an upload.&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Legend&lt;br /&gt;
*0b Copy file to  remote URL (URL version)&lt;br /&gt;
*1  Launch client&lt;br /&gt;
*2  Call remote method&lt;br /&gt;
*3b Read file at specified URL (URL version)&lt;br /&gt;
*4  Create temporary file&lt;br /&gt;
*5  Launch map_lp&lt;br /&gt;
*6  Read temporary file data&lt;br /&gt;
*7  Create the spooled file in the queue&lt;br /&gt;
 &lt;br /&gt;
===Detailed Preview Method Information===&lt;br /&gt;
&lt;br /&gt;
The preview method returns the content of a spooled file that has been sent to a queue.&lt;br /&gt;
Below is a diagram showing the architecture used during an preview. &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Legend&lt;br /&gt;
	1  Launch client&lt;br /&gt;
	2  Call method remotely&lt;br /&gt;
	3  Launch map_view&lt;br /&gt;
	4  Communicate with the spooler&lt;br /&gt;
	5  Receive results through web service&lt;br /&gt;
	6a Send data streamed to client&lt;br /&gt;
	6b Write result to a file&lt;br /&gt;
	7a Return spooled file + headers to client&lt;br /&gt;
	7b Send URL to client&lt;br /&gt;
	8b Send URL to application&lt;br /&gt;
&lt;br /&gt;
 &lt;br /&gt;
 &lt;br /&gt;
9.8.	Detailed Run Method Information&lt;br /&gt;
The run method remaps the spooled file that was sent.&lt;br /&gt;
The run can be seen as 3 consecutive steps: upload, process, and preview generated file.&lt;br /&gt;
The difference with a usual upload is that the spooled file does not have to be sent to a queue for printing, it has to be sent to an entry. This way, the spooled file is processed by the rules engine. User data called SOAP_RUN_FILE is added automatically.&lt;br /&gt;
A rule testing whether the user data can be found is used to call a specific process: call mapcpysplf with different arguments (mapnam, mapseq, mapmod, inFile, outFile and lang) to remap the file. &lt;br /&gt;
Below is a diagram showing the architecture used during a run: &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
Legend&lt;br /&gt;
	0b  Copy file to remote URL (URL version)&lt;br /&gt;
	1   Launch client&lt;br /&gt;
	2   Call remote method&lt;br /&gt;
	3b  Read file at URL specified&lt;br /&gt;
	4   Create temporary file&lt;br /&gt;
	5   Launch map_lp&lt;br /&gt;
	6   Read temporary file data&lt;br /&gt;
	7   Create spooled file in the queue&lt;br /&gt;
	8   Process and create temporary file (remapped file)&lt;br /&gt;
	9   Read file through web service&lt;br /&gt;
	10a Send data streamed to client&lt;br /&gt;
	10b Write result to file&lt;br /&gt;
	11a Return remapped spooled file content to client&lt;br /&gt;
	11b Return remapped spooled file URL to client&lt;br /&gt;
9.9.	XML Data Diagram for Spooled File View&lt;br /&gt;
&lt;br /&gt;
 &lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
 &lt;br /&gt;
10.	Returning a File to the Web Service Client from the Rules Engine&lt;br /&gt;
To enable the rules engine to return responses to the web service client, the rules engine needs to be used.&lt;br /&gt;
&amp;quot;map_echo.exe&amp;quot; &amp;quot;Cache-Control: no-cache\nContent-type: application/pdf;\n\n&amp;quot; &lt;br /&gt;
&amp;quot;map_echo.exe&amp;quot; &amp;quot;-infile:C:\Program Files\MappingWindows\Temp\myfile.pdf&amp;quot;	&lt;br /&gt;
11.	Protocol Used&lt;br /&gt;
The protocol used is described in http://www.w3.org/TR/soap&lt;br /&gt;
11.1.	SOAP HTTP GET Usage&lt;br /&gt;
Question:&lt;br /&gt;
GET /travelcompany.example.org/reservations?code=FT35ZBQ  HTTP/1.1&lt;br /&gt;
Host: travelcompany.example.org&lt;br /&gt;
Accept: text/html;q=0.5, application/soap+xml&lt;br /&gt;
	Response:&lt;br /&gt;
HTTP/1.1 200 OK&lt;br /&gt;
Content-Type: application/xml; charset=&amp;quot;utf-8&amp;quot;&lt;br /&gt;
Content-Length: nnnn&lt;br /&gt;
&lt;br /&gt;
  &amp;lt;rdf:RDF xmlns:rdf=&amp;quot;http://www.w3.org/1999/02/22-rdf-syntax-ns#&amp;quot;&lt;br /&gt;
            xmlns:x=&amp;quot;http://travelcompany.example.org/vocab#&amp;quot;&lt;br /&gt;
     env:encodingStyle=&amp;quot;http://www.w3.org/1999/02/22-rdf-syntax-ns#&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;x:ReservationRequest &lt;br /&gt;
 rdf:about=&amp;quot;http://travelcompany.example.org/reservations?code=FT35ZBQ&amp;quot;&amp;gt;&lt;br /&gt;
      &amp;lt;x:passenger&amp;gt;Åke Jógvan Øyvind&amp;lt;/x:passenger&amp;gt;&lt;br /&gt;
      &amp;lt;x:outbound&amp;gt;&lt;br /&gt;
       &amp;lt;x:TravelRequest&amp;gt;&lt;br /&gt;
        &amp;lt;x:to&amp;gt;LAX&amp;lt;/x:to&amp;gt;&lt;br /&gt;
        &amp;lt;x:from&amp;gt;LGA&amp;lt;/x:from&amp;gt;&lt;br /&gt;
        &amp;lt;x:date&amp;gt;2001-12-14&amp;lt;/x:date&amp;gt;&lt;br /&gt;
       &amp;lt;/x:TravelRequest&amp;gt;&lt;br /&gt;
      &amp;lt;/x:outbound&amp;gt;&lt;br /&gt;
      &amp;lt;x:return&amp;gt;&lt;br /&gt;
       &amp;lt;x:TravelRequest&amp;gt;&lt;br /&gt;
        &amp;lt;x:to&amp;gt;JFK&amp;lt;/x:to&amp;gt;&lt;br /&gt;
        &amp;lt;x:from&amp;gt;LAX&amp;lt;/x:from&amp;gt;&lt;br /&gt;
        &amp;lt;x:date&amp;gt;2001-12-20&amp;lt;/x:date&amp;gt;&lt;br /&gt;
       &amp;lt;/x:TravelRequest&amp;gt;&lt;br /&gt;
      &amp;lt;/x:return&amp;gt;&lt;br /&gt;
    &amp;lt;/x:ReservationRequest&amp;gt;&lt;br /&gt;
	&lt;br /&gt;
11.2.	SOAP HTTP POST Usage&lt;br /&gt;
	Question:&lt;br /&gt;
POST /Reservations HTTP/1.1&lt;br /&gt;
Host: travelcompany.example.org&lt;br /&gt;
Content-Type: application/soap+xml; charset=&amp;quot;utf-8&amp;quot;&lt;br /&gt;
Content-Length: nnnn&lt;br /&gt;
&lt;br /&gt;
&amp;lt;?xml version='1.0' ?&amp;gt;&lt;br /&gt;
&amp;lt;env:Envelope xmlns:env=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot; &amp;gt;&lt;br /&gt;
 &amp;lt;env:Header&amp;gt;&lt;br /&gt;
   &amp;lt;t:transaction&lt;br /&gt;
           xmlns:t=&amp;quot;http://thirdparty.example.org/transaction&amp;quot;&lt;br /&gt;
           env:encodingStyle=&amp;quot;http://example.com/encoding&amp;quot;&lt;br /&gt;
           env:mustUnderstand=&amp;quot;true&amp;quot; &amp;gt;5&amp;lt;/t:transaction&amp;gt;&lt;br /&gt;
 &amp;lt;/env:Header&amp;gt;  &lt;br /&gt;
 &amp;lt;env:Body&amp;gt;&lt;br /&gt;
  &amp;lt;m:chargeReservation&lt;br /&gt;
     env:encodingStyle=&amp;quot;http://www.w3.org/2003/05/soap-encoding&amp;quot;&lt;br /&gt;
          xmlns:m=&amp;quot;http://travelcompany.example.org/&amp;quot;&amp;gt;&lt;br /&gt;
   &amp;lt;m:reservation xmlns:m=&amp;quot;http://travelcompany.example.org/reservation&amp;quot;&amp;gt;&lt;br /&gt;
    &amp;lt;m:code&amp;gt;FT35ZBQ&amp;lt;/m:code&amp;gt;&lt;br /&gt;
   &amp;lt;/m:reservation&amp;gt;&lt;br /&gt;
    &amp;lt;o:creditCard xmlns:o=&amp;quot;http://mycompany.example.com/financial&amp;quot;&amp;gt;&lt;br /&gt;
     &amp;lt;n:name xmlns:n=&amp;quot;http://mycompany.example.com/employees&amp;quot;&amp;gt;&lt;br /&gt;
           Åke Jógvan Øyvind&lt;br /&gt;
     &amp;lt;/n:name&amp;gt;&lt;br /&gt;
     &amp;lt;o:number&amp;gt;123456789099999&amp;lt;/o:number&amp;gt;&lt;br /&gt;
     &amp;lt;o:expiration&amp;gt;2005-02&amp;lt;/o:expiration&amp;gt;&lt;br /&gt;
    &amp;lt;/o:creditCard&amp;gt;&lt;br /&gt;
   &amp;lt;/m:chargeReservation&lt;br /&gt;
  &amp;lt;/env:Body&amp;gt;&lt;br /&gt;
&amp;lt;/env:Envelope&amp;gt;&lt;br /&gt;
	Response:&lt;br /&gt;
HTTP/1.1 200 OK&lt;br /&gt;
Content-Type: application/soap+xml; charset=&amp;quot;utf-8&amp;quot;&lt;br /&gt;
Content-Length: nnnn&lt;br /&gt;
&lt;br /&gt;
&amp;lt;?xml version='1.0' ?&amp;gt;&lt;br /&gt;
&amp;lt;env:Envelope xmlns:env=&amp;quot;http://www.w3.org/2003/05/soap-envelope&amp;quot; &amp;gt;&lt;br /&gt;
 &amp;lt;env:Header&amp;gt;&lt;br /&gt;
       ...&lt;br /&gt;
       ...&lt;br /&gt;
 &amp;lt;/env:Header&amp;gt;  &lt;br /&gt;
 &amp;lt;env:Body&amp;gt;&lt;br /&gt;
       ...&lt;br /&gt;
       ...&lt;br /&gt;
 &amp;lt;/env:Body&amp;gt;&lt;br /&gt;
&amp;lt;/env:Envelope&amp;gt;&lt;/div&gt;</summary>
		<author><name>imported&gt;Bsteeland</name></author>
		
	</entry>
</feed>