 |
|
         |
| |
|
Want to see how you can use <x:act> web services for converting business documents?
Visit the page!
Want to find out more about the fundamental functionality of our project?
Visit the page!
Want to know, what is planned for the future of the <x:act> project?
More information...
www.x-act.org provides web services for converting XML documents. The usage
of our web services is free of charge, but registration at our web site
is required.
Conversions are performed by applying XSLT stylesheets. www.x-act.org will
host a number of stylesheets, but any stylesheet that is accessible via
URL may be used. For certain application areas www.x-act.org will provide
a system for organizing formats and respective stylesheets. Communication
with the web services is done via SOAP. That means, one sends a SOAP request
containing conversion information and a source XML document as an attachment
to the web service. The web service will in turn perform the transformation
and return a SOAP response with the conversion result attached as an XML
file.
Our conversion web services are accessible via
https://www.x-act.org:8443/conversion/ (SSL)
or
http://www.x-act.org:8080/conversion/ (no SSL)
Currently, there are two usage scenarios for our web services
1. Basic
This scenario is for testing and for users who want to use the web service
rather seldom. All you need is a XSLT stylesheet accessible somewhere on
the web and of course the xml source document which is to be converted.
The web service will apply the specified XSLT stylesheet to your source
document and return the result of the conversion process. Any XSLT stylesheet
that is accessible via an URL can be used. In the future registered users
will be able to upload self-provided stylesheets or to use the <x:act>
mapper tool to create stylesheets.
How to use the basic scenario?
Send a SOAP message, which is conform to the operation "DoSimpleConversion"
of our WSDL-Document
to http://www.x-act.org:8080/conversion/ or to https://www.x-act.org:8443/conversion/
(SSL) and the web service will return the result of the conversion you requested.
2. Advanced
This scenario is for users, who want to use the web service frequently and
who do not want to specify an explicit stylesheet. You have to provide data
such as source format, target format, document type, application area etc.
The web service will try to find an appropriate XSLT stylesheet for fulfilling
your request. If no appropriate XSLT stylesheet is available, you can upload
one or you can use the <x:act> mapper tool to create a XSLT stylesheet
for your format combination.
If a compatible stylesheet was found, the conversion takes place and you
will get the result as an XML file attached to the SOAP response.
How to use the advanced scenario?
Send a SOAP message, which is conform to the operation "DoAdvancedConversion"
of our WSDL-Document
to http://www.x-act.org:8080/conversion/ or to https://www.x-act.org:8443/conversion/
(SSL) and the web service will return the result of the conversion you requested.
Example clients for both web services are available for downloading.
|
|
|

|
|