高度なカスタマイズ > Info*Engine ユーザーガイド > Task Webject リファレンス > Group Webject > Union-Groups
  
Union-Groups
説明
2 つのグループの和集合 (Union) を識別し、新しいグループに結果を配置します。たとえば、グループ A には要素 u、v、および x が含まれ、グループ B には要素 x、y、および z が含まれます。Union-Groups Webject はグループ A とグループ B のいずれかまたは両方の要素を識別し、結果を使用してグループ C を形成します。この例では、グループ C には要素 u、v、x、y、および z が含まれます。
構文
<ie:webject name="Union-Groups" 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="UNIONBY" data="attribute"/>
</ie:webject>
パラメータ
必須
選択
オプション
GROUP_IN
CASE_IGNORE
GROUP_OUT
CLASS
UNIONBY
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
和集合 (Union) を計算するときに使用する 2 つのグループの名前を指定します。
2 つのグループ名を指定すると、GROUP_IN パラメータの値が異なる 2 行を含めることができます。例:
<ie:param name="GROUP_IN" data="group1"/>
<ie:param name="GROUP_IN" data="group2"/>
このパラメータは必須です。
GROUP_OUT
2 つのグループの和集合 (Union) を計算した結果の名前を指定します。このパラメータは必須です。
SORTBY
並べ替えを実行する属性の名前を指定します。このパラメータを指定していない場合は、結果は並べ替えられません。このパラメータはオプションです。
SORTED
結果グループ内の値を並べ替える方法を決定します。SORTBY パラメータで指定した属性によって、並べ替える値が決定します。ASC を指定して昇順で並べ替えるか、または DESC を指定して降順で並べ替えます。このパラメータのデフォルトは ASC です。このパラメータはオプションです。
UNIONBY
比較に使用するフィールドまたは列名を識別します。このパラメータは必須です。
以下の例は、NAME 属性によって 2 つの指定された入力グループの和集合 (Union) を特定し、アルファベット順に比較して、"results" という名前の出力グループに配置します。
<%@page language="java" session="false"%>
<%@taglib uri="http://www.ptc.com/infoengine/taglib/core"
                                               prefix="ie"%>
<!-- Form a new group from the Union of multiple groups -->
<ie:task uri="com/company/CreateGroup.xml"/>
<ie:task uri="com/company/CreateGroupA.xml"/>
<ie:webject name="Union-Groups" type="GRP">
  <ie:param name="GROUP_IN" data="createdgroup"/>
  <ie:param name="GROUP_IN" data="createdgroupa"/>
  <ie:param name="UNIONBY" data="NAME"/>
  <ie:param name="COMPARISON" data="ALPHA"/>
  <ie:param name="GROUP_OUT" data="results"/>
  <ie:param name="CLASS" data="ALLEMPLOYEES"/>
</ie:webject>