Merge-Groups
説明
2 つのグループを 1 つに併合し、両方またはいずれかのグループに含まれている情報の重複を可能にします。
|
Join-Groups Webject と Merge‑Groups Webject は、重複情報の処理方法が異なります。結合 (Join) されたグループの結果では、重複情報は削除されます。データの併合 (Merge) されたグループでは重複情報を保存します。
|
構文
<ie:webject name="Merge-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:webject>
パラメータ
必須
|
選択
|
オプション
|
GROUP_IN
|
|
CASE_IGNORE
|
GROUP_OUT
|
|
CLASS
|
|
|
COMPARISON
|
|
|
SORTBY
|
|
|
SORTED
|
CASE_IGNORE
大文字と小文字のフラグとして機能します。TRUE を指定すると、大文字と小文字は無視されます。FALSE を指定すると、大文字と小文字は区別されます。このパラメータのデフォルトは FALSE です。このパラメータはオプションです。
CLASS
GROUP_OUT パラメータによって指定された出力グループに含まれているオブジェクトのタイプを指定します。たとえば、Webject が CLASS=MyClassName と GROUP_OUT=data_1 を指定する場合、出力グループの XML 表現には以下のタグが含まれます。
<MyClassName NAME="data_1" TYPE="Object" STATUS="0">
</MyClassName>
このパラメータのデフォルトは Unknown-Class-Name です。これはオプションのパラメータです。
COMPARISON
2 つのグループの比較方法を説明します。英数字を比較する ALPHA と数字を厳密に比較する NUMERIC があります。このオプションのパラメータのデフォルトは ALPHA です。
GROUP_IN
併合 (Merge) を計算するときに使用する 2 つのグループの名前を指定します。2 つのグループ名を指定すると、GROUP_IN パラメータの値が異なる 2 行を含めることができます。以下に例を示します。
<ie:param name="GROUP_IN" data="group1"/>
<ie:param name="GROUP_IN" data="group2"/>
このパラメータは必須です。
GROUP_OUT
GROUP_IN および MERGEBY パラメータを使用して指定した 2 つのグループの併合 (Merge) 結果の名前を識別します。このパラメータは必須です。
SORTBY
並べ替えを実行する属性の名前を指定します。このパラメータを指定していない場合は、結果は並べ替えられません。このパラメータはオプションです。
SORTED
結果グループ内の値を並べ替える方法を決定します。SORTBY パラメータで指定した属性によって、並べ替える値が決定します。ASC を指定して昇順で並べ替えるか、または DESC を指定して降順で並べ替えます。このパラメータのデフォルトは ASC です。このパラメータはオプションです。
例
以下の例は、2 つの指定された GROUP_IN を結合し、データを NAME 属性によって昇順で並べ替え、結果としてマージされて並べ替えられたデータを "results" という名前の出力グループに配置します。
<%@page language="java" session="false"%>
<%@taglib uri="http://www.ptc.com/infoengine/taglib/core"
prefix="ie"%>
<!-- Form a group by merging two groups -->
<ie:task uri="com/company/CreateGroup.xml"/>
<ie:task uri="com/company/CreateGroupHr.xml"/>
<ie:webject name="Merge-Groups" type="GRP">
<ie:param name="GROUP_IN" data="createdgroup"/>
<ie:param name="GROUP_IN" data="createhrgroup"/>
<ie:param name="SORTBY" data="NAME"/>
<ie:param name="SORTED" data="ASC"/>
<ie:param name="GROUP_OUT" data="results"/>
</ie:webject>