&integrators;

<!ENTITY integrators SYSTEM "integrators.sgml">

<chapter id="integrators">

<title>Integrating with MantisBT</title>

<para>

The primary means of integrating with MantisBT is with the SOAP

API , bundled with MantisBT. The SOAP API is accessible at

<literal>http://server.com/mantis/api/soap/mantisconnect.php</literal>.

</para>

<sect1 id="integrators.java">

<title>Java integration</title>

<sect2 id="integrators.java.soap">

<title>Prebuilt SOAP stubs using Axis</title>

<para>

For ease of integration of the Java clients, SOAP stubs

are maintained and deployed in the Maven central repository.

To include them in your project, use the following coordinates:

</para>

<programlisting>

&lt;dependency&gt;

&lt;groupId&gt;biz.futureware.mantis&lt;/groupId&gt;

&lt;artifactId&gt;mantis-axis-soap-client&lt;/artifactId&gt;

&lt;version&gt;1.2.6&lt;/version&gt;

&lt;/dependency&gt;

</programlisting>

<para>Alternatively, download the latest available version from

<ulink url="http://search.maven.org/#search|gav|1|g%3A%22biz.futureware.mantis%22%20AND%20a%3A%22mantis-axis-soap-client%22">

http://search.maven.org/#search|gav|1|g%3A%22biz.futureware.mantis%22%20AND%20a%3A%22mantis-axis-soap-client%22</ulink>.

</para>

</sect2>

<sect2 id="integrators.java.osgi">

<title>Usage in OSGi environments</title>

<para>If you would like to use Axis in an OSGi environment, it is

recommended that you use a ready-made bundle, such as the Axis

bundle available from <ulink url="http://download.eclipse.org/tools/orbit/downloads/">

Eclipse Orbit</ulink>

</sect2>

</sect1>

<sect1 id="integrators.support">

<title>Support</title>

<para>The primary means of obtaining support is through the <ulink url="http://lists.sourceforge.net/mailman/listinfo/mantisbt-soap-dev">

mantisbt-soap-dev mailing list</ulink>.</para>

</sect1>

</chapter>