[jbpm-commits] JBoss JBPM SVN: r5047 - jbpm4/trunk/modules/devguide/src/main/docbook/en/modules.

[do-not-reply at jboss.org]

Author: tom.baeyens at jboss.com
Date: 2009-06-17 04:44:23 -0400 (Wed, 17 Jun 2009)
New Revision: 5047

Modified:
   jbpm4/trunk/modules/devguide/src/main/docbook/en/modules/ch03-Configuration.xml
Log:
added pointer on how to configure identity component

Modified: jbpm4/trunk/modules/devguide/src/main/docbook/en/modules/ch03-Configuration.xml
===================================================================
--- jbpm4/trunk/modules/devguide/src/main/docbook/en/modules/ch03-Configuration.xml	2009-06-17 07:48:06 UTC (rev 5046)
+++ jbpm4/trunk/modules/devguide/src/main/docbook/en/modules/ch03-Configuration.xml	2009-06-17 08:44:23 UTC (rev 5047)
@@ -69,5 +69,31 @@
     <listitem>resource modules/pvm/src/main/resources/jbpm.wire.bindings.xml</listitem>
     <listitem>package modules/pvm/src/main/java/org/jbpm/pvm/internal/wire/binding</listitem>
   </itemizedlist>
+  
+  <section>
+    <title>Customizing the identity component</title>
+    <para>There are 2 identity components that we support out of the box:
+    </para>
+    <itemizedlist>
+      <listitem>jBPM's built-in identity component: ships with the jBPM project distro</listitem>
+      <listitem>JBoss IDM: ships in the JBoss product platforms</listitem>
+    </itemizedlist>
+    <para>The <literal>jboss/build.xml</literal> installation scripts can be used 
+    to install jBPM in JBoss using the JBoss IDM component.   There is some 
+    property in that build file to overwrite the default built-in identity component
+    with the value for the JBoss IDM component.
+    </para>
+    <para>If you want to plug in your own identity component, remove the 
+    following line in the <literal>jbpm.cfg.xml</literal>:
+    </para>
+    <programlisting>&lt;import resource=&quot;jbpm.identity.cfg.xml&quot; /&gt;</programlisting>
+    <para>And in the same file, add following section</para>
+    <programlisting>&lt;transaction-context&gt;
+  &lt;object class=&quot;your.package.YourIdentitySessionImpl&quot; /&gt;
+&lt;/transaction-context&gt;</programlisting>
+    <para>YourIdentitySessionImpl should implement <literal>org.jbpm.pvm.internal.identity.spi.IdentitySession</literal>
+    Making this identity pluggable is not our first target, but it was taken into the design. Let us know how it goes.
+    </para>
+  </section>
 
 </chapter>
\ No newline at end of file