[interchange-docs] [SCM] Interchange XML documentation branch, master, updated. 9307a2389f1a621ff699ab3d9a3246a8588c47f8

Stefan Hornburg interchange-cvs at icdevgroup.org
Wed Dec 23 12:59:40 UTC 2009


This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Interchange XML documentation".

The branch, master has been updated
       via  9307a2389f1a621ff699ab3d9a3246a8588c47f8 (commit)
       via  960567b4486738c7dfd283923e67d301e834dac1 (commit)
      from  c1c74268f18bfb040364b50a254ef0fa405ec93b (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 9307a2389f1a621ff699ab3d9a3246a8588c47f8
Author: Stefan Hornburg (Racke) <racke at linuxia.de>
Date:   Wed Dec 23 13:59:17 2009 +0100

    SOAP_Action stub added

commit 960567b4486738c7dfd283923e67d301e834dac1
Author: Stefan Hornburg (Racke) <racke at linuxia.de>
Date:   Wed Dec 23 13:54:24 2009 +0100

    explained SOAP configuration directives, basic setup and SOAP faults
    added pointer to SOAP::Lite homepage

-----------------------------------------------------------------------

Summary of changes and diff:
 glossary/SOAP-RPC             |   87 +++++++++++++++++++++++++++++++++++++++++
 refs/{TcpPort => SOAP_Action} |    6 +--
 2 files changed, 89 insertions(+), 4 deletions(-)
 copy refs/{TcpPort => SOAP_Action} (57%)

diff --git a/glossary/SOAP-RPC b/glossary/SOAP-RPC
index 5d225c7..2ec75fa 100644
--- a/glossary/SOAP-RPC
+++ b/glossary/SOAP-RPC
@@ -1 +1,88 @@
+</para>
+
+<section>
+<title>Basic setup</title>
+<para>
+To enable the Interchange SOAP server, set &conf-SOAP; to yes in the
+global configuration file. It is also important to allow SOAP actions
+with &conf-SOAP_Control; both in the global configuration and in
+the catalog configuration file in order to provide web services.
+</para>
+
+<programlisting>
+SOAP_Control Action always
+</programlisting>
+
+<para>
+After restart, the Interchange SOAP server
+will listen on port 7780 for requests.
+</para>
+
+<para>
+For all catalogs providing SOAP services, do the following steps:
+</para>
+<orderedlist>
+<listitem>
+<para>
+Enable &conf-SOAP; and allow SOAP actions in the catalog configuration file:
+<programlisting>
+SOAP Yes
+SOAP_Control Action always
+</programlisting>
+</para>
+</listitem>
+<listitem>
+<para>
+Add SOAP URL to &conf-Catalog; directive in the global configuration file:
+</para>
+<programlisting>
+Catalog wellwell /home/interchange/catalogs/wellwell /cgi-bin/wellwell /soap
+</programlisting>
+</listitem>
+<listitem>
+<para>
+Define SOAP actions with &conf-SOAP_Action;.
+</para>
+</listitem>
+</orderedlist>
+<para>
+Finally, restart your Interchange server.
+</para>
+</section>
+
+<section>
+<title>Advanced setup</title>
+<para>
+The port can be changed with the &conf-SOAP-Socket; configuration
+directive.
+</para>
+</section>
+
+<section>
+<title>Faults</title>
+<para>
+If Interchange cannot determine the catalog for the SOAP request,
+it will trigger the <literal>soap:Client.NotFound</literal> fault.
+</para>
+<para>
+If the catalog hasn't enabled &conf-SOAP;, Interchange will trigger
+the <literal>soap:Client.NotAvailable</literal> fault.
+</para>
+<para>
+If the called SOAP action dies, Interchange triggers a 
+<literal>soap:Server</literal> fault with the message
+<literal>Application error</literal>.
+</para>
+</section>
+
+<section>
+<title>SOAP references</title>
+<para>
 <ulink url='http://www.w3.org/TR/soap/'>SOAP</ulink> resource at W3C.
+</para>
+<para>
+<ulink url='http://www.soaplite.com/'>SOAP::Lite</ulink> homepage.
+</para>
+</section>
+
+<para>
diff --git a/refs/TcpPort b/refs/SOAP_Action
similarity index 57%
copy from refs/TcpPort
copy to refs/SOAP_Action
index 09a6629..fa3d6be 100644
--- a/refs/TcpPort
+++ b/refs/SOAP_Action
@@ -1,9 +1,7 @@
 __NAME__ purpose
-(obsolete)
+define SOAP actions
 __END__
 
-
 __NAME__ see also
-TcpHost, TcpMap
+SOAP, SOAP_Control
 __END__
-


hooks/post-receive
-- 
Interchange XML documentation



More information about the docs mailing list