高度なカスタマイズ > Info*Engine ユーザーガイド > Task Webject リファレンス > Group Webject > XOR-Groups
  
XOR-Groups
説明
2 つのグループの対称差 (排他的論理和) を識別します。たとえば、グループ A には要素 u、v、および x が含まれ、グループ B には要素 x、y、および z が含まれます。XOR-Groups Webject はグループ A およびグループ B に一意な要素を識別し、結果を使用してグループ C を形成します。グループ A またはグループ B のいずれかには含まれるが両方のグループには含まれないすべての要素が返されます。この例では、グループ C には要素 u、v、y、および z が含まれます。
構文
<ie:webject name="XOR-Group" type="GRP">
  <ie:param name="CASE_IGNORE" data="[TRUE | FALSE]"/>
  <ie:param name="CLASS" data="class"/>
  <ie:param name="COMPARISON" data="[ALPHA | NUMERIC]"/>
  <ie:param name="GROUP_IN" data="input_groups"/>
  <ie:param name="GROUP_OUT" data="output_group_name"/>
  <ie:param name="SORTBY" data="attribute"/>
  <ie:param name="SORTED" data="[ASC | DESC]"/>
  <ie:param name="XORBY" data="attribute"/>
</ie:webject>
パラメータ
必須
選択
オプション
GROUP_IN
CASE_IGNORE
GROUP_OUT
CLASS
XORBY
COMPARISON
SORTBY
SORTED
CASE_IGNORE
大文字と小文字のフラグとして機能します。TRUE を指定すると、大文字と小文字は無視されます。FALSE を指定すると、大文字と小文字は区別されます。このパラメータのデフォルトは FALSE です。このパラメータはオプションです。
CLASS
GROUP_OUT パラメータによって指定された出力グループに含まれているオブジェクトのタイプを指定します。たとえば、Webject が CLASS=MyClassNameGROUP_OUT=data_1 を指定する場合、出力グループの XML 表現には以下のタグが含まれます。
<MyClassName NAME="data_1" TYPE="Object" STATUS="0">
</MyClassName>
このパラメータのデフォルトは Unknown-Class-Name です。これはオプションのパラメータです。
COMPARISON
2 つのグループの比較方法を説明します。英数字を比較する ALPHA と数字を厳密に比較する NUMERIC があります。このパラメータのデフォルトは ALPHA です。このパラメータはオプションです。
GROUP_IN
対称差を計算するときに使用する 2 つのグループの名前を指定します。
2 つのグループ名を指定すると、GROUP_IN パラメータの値が異なる 2 行を含めることができます。例:
<ie:param name="GROUP_IN" data="group1"/>
<ie:param name="GROUP_IN" data="group2"/>
このパラメータは必須です。
GROUP_OUT
対称差を計算した結果の名前を指定します。このパラメータは必須です。
SORTBY
並べ替えを実行する属性の名前を指定します。このパラメータを指定していない場合は、結果は並べ替えられません。このパラメータはオプションです。
SORTED
結果グループ内の値を並べ替える方法を決定します。SORTBY パラメータで指定した属性によって、並べ替える値が決定します。ASC を指定して昇順で並べ替えるか、または DESC を指定して降順で並べ替えます。このパラメータのデフォルトは ASC です。このパラメータはオプションです。
XORBY
比較に使用する属性の名前を識別します。比較されるグループに同名の属性を持つ要素が含まれている場合、1 つの XORBY 値が指定されます。それ以外の場合は、2 つの XORBY パラメータを指定して、比較されるそれぞれのグループから属性名を指定します。
出力グループに配置する属性名は、使用された最初の XORBY パラメータの属性名です。
このパラメータは必須です。
以下の例は、2 つの指定された入力グループの exclusive or を特定し、結果として生成されたデータを "results" という名前の出力グループに配置します。
<%@page language="java" session="false"%>
<%@taglib uri="http://www.ptc.com/infoengine/taglib/core"
                                               prefix="ie"%>
<!-- Form a new group from the "exclusive or" of
                                              two groups -->
<ie:task uri="examples/CreateGroup.xml"/>
<ie:task uri="examples/CreateGroupA.xml"/>
<ie:webject name="XOR-Groups" type="GRP">
  <ie:param name="GROUP_IN" data="createdgroup"/>
  <ie:param name="GROUP_IN" data="createdgroupa"/>
  <ie:param name="XORBY" data="NAME"/>
  <ie:param name="GROUP_OUT" data="results"/>
  <ie:param name="CLASS" data="partial"/>
</ie:webject>