You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@uima.apache.org by al...@apache.org on 2007/01/22 17:17:38 UTC
svn commit: r498672 - in
/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook:
references/ref.xml.cpe_descriptor.xml
tutorials_and_users_guides/tug.multi_views.xml
Author: alally
Date: Mon Jan 22 08:17:37 2007
New Revision: 498672
URL: http://svn.apache.org/viewvc?view=rev&rev=498672
Log:
Documented that sofa mapping does not work for remote services.
Modified:
incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/references/ref.xml.cpe_descriptor.xml
incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.multi_views.xml
Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/references/ref.xml.cpe_descriptor.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/references/ref.xml.cpe_descriptor.xml?view=diff&rev=498672&r1=498671&r2=498672
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/references/ref.xml.cpe_descriptor.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/references/ref.xml.cpe_descriptor.xml Mon Jan 22 08:17:37 2007
@@ -432,13 +432,9 @@
CPM). Any UIMA SDK compliant pure Java CAS Processors may be safely deployed
this way.</para>
<para>The descriptor for an integrated deployment can, in fact, be a remote
- service descriptor. When used this way, with Vinci, the Sofa mapping
- needed for the remote is done before sending the CAS to the remote (see
- <olink targetdoc="&uima_docs_tutorial_guides;"
- targetptr="ugr.tug.mvs.name_mapping_remote_services"/>). When
- used this way, however, the CPM error recovery options (see below)
- operate in the integrated mode, which means that many of the retry options
- are not available.</para></listitem>
+ service descriptor. When used this way, however, the CPM error recovery
+ options (see below) operate in the integrated mode, which means that many
+ of the retry options are not available.</para></listitem>
</varlistentry>
<varlistentry>
<term>remote</term>
Modified: incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.multi_views.xml
URL: http://svn.apache.org/viewvc/incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.multi_views.xml?view=diff&rev=498672&r1=498671&r2=498672
==============================================================================
--- incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.multi_views.xml (original)
+++ incubator/uima/uimaj/trunk/uima-docbooks/src/docbook/tutorials_and_users_guides/tug.multi_views.xml Mon Jan 22 08:17:37 2007
@@ -228,10 +228,14 @@
declared Sofas as described in the following sections. An attempt to create a Sofa with a
SofaID already in use will throw an exception.</para>
- <para>Name mapping must not use the <quote>.</quote> (period) character. Runtime Sofa
+ <para>Sofa name mapping must not use the <quote>.</quote> (period) character. Runtime Sofa
mapping maps names up to the <quote>.</quote> and appends the period and the following
characters to the mapped name.</para>
+
+ <para>Sofa name mappings are not currently supported for remote Analysis Engines.
+ See <xref linkend="ugr.tug.mvs.name_mapping_remote_services"/>.</para>
+
<section id="ugr.tug.mvs.name_mapping_aggregate">
<title>Name Mapping in an Aggregate Descriptor</title>
@@ -280,8 +284,7 @@
<para>The Component Descriptor Editor supports Sofa name mapping in aggregates and
simplifies the task. See <olink targetdoc="&uima_docs_tools;"
- targetptr="ugr.tools.cde.capabilities.sofa_name_mapping"/> for details.</para>
-
+ targetptr="ugr.tools.cde.capabilities.sofa_name_mapping"/> for details.</para>
</section>
<section id="ugr.tug.mvs.name_mapping_cpe"><title>Name Mapping in a CPE
@@ -405,13 +408,12 @@
to a remote service. This can cause complications for UIMA services in a Multi-View
application.</para>
- <para>Remote services using the SOAP transport will work only if the service is
- Single-View, or if the Sofa names expected by the service match the Sofa names
- produced by the client.</para>
-
- <para>Sofa name mapping is supported when running in <quote>integrated</quote> CPM
- mode (or without the CPM) using Vinci, by renaming the Sofas specified by the service
- descriptor, if necessary.</para>
+ <para>Remote Multi-View services will work only if the service is Single-View, or if the
+ Sofa names expected by the service exactly match the Sofa names produced by the client.</para>
+
+ <para>If your application requires Sofa mappings for a remote Analysis Engine, you
+ can wrap your remotely deployed AE in an aggregate (on the remote side), and specify
+ the necessary Sofa mappings in the descriptor for that aggregate.</para>
</section>
</section>