Change-Group
説明
グループの 1 つまたは複数の属性の名前を変更します。結果として生成されるグループには、変更した属性と変更による影響を受けないすべての属性が含まれます。
構文
<ie:webject name="Change-Group" type="GRP">
<ie:param name="GROUP_IN" data="value"/>
<ie:param name="GROUP_OUT" data="group_out_name"/>
<ie:param name="RENAME" data="'old_name'='new_name'"/>
</ie:webject>
パラメータ
必須
|
選択
|
オプション
|
GROUP_IN
|
|
GROUP_OUT
|
RENAME
|
|
|
GROUP_IN
名前を変更すべき情報を持つグループの名前を指定します。このパラメータは必須です。
GROUP_OUT
名前を変更した情報を持つ結果グループの名前を指定します。GROUP_OUT が指定されると、元のグループは出力グループに置き換えられ、VDB では利用できません。このパラメータのデフォルトは、元のグループでの属性変更です。このパラメータはオプションです。
RENAME
変更する属性名を指定します。属性の名前を変更する場合は、特定の構文が必要です。たとえば、属性名 objectClass を XYZclass に変更するには、以下の RENAME パラメータを指定します。
<ie:param name="RENAME" data="'objectClass'='XYZclass'">
ここに示すように、RENAME パラメータの値を二重引用符で囲む必要があります。属性の古い名前と新しい名前は両方とも単一引用符で囲む必要があります。属性名は大文字と小文字を区別しません。したがって、パラメータが既存の属性名をサーチする場合、大文字と小文字の区別は無視されます。
このパラメータは必須です。
例
この Webject は "createdgroup" という名前の入力グループ内の属性名を変更し、ローカル出力グループのコレクションに results グループを追加します。
<%@page language="java" session="false"%>
<%@taglib uri="http://www.ptc.com/infoengine/taglib/core" prefix="ie"%>
<!-- Creates input group named createdgroup. -->
<ie:task uri="/com/company/CreateGroup.xml"/>
<!-- Renames attributes in a group. -->
<ie:webject name="Change-Group" type="GRP">
<ie:param name="GROUP_IN" data="createdgroup"/>
<ie:param name="RENAME" data="'ADDRESS'='HomeAddress'"/>
<ie:param name="RENAME" data="'NAME'='FullName'"/>
<ie:param name="RENAME" data="'EMAIL'='email'"/>
<ie:param name="GROUP_OUT" data="results"/>
</ie:webject>
この例を実行することにより生成される XML 出力は以下のとおりです。
<?xml version="1.0" encoding="UTF-8"?>
<wc:COLLECTION xmlns:wc="http://www.ptc.com/infoengine/1.0">
<EmployeeData NAME="results" TYPE="Object" STATUS="0">
<wc:INSTANCE>
<FullName>Sam Johnson</FullName>
<HomeAddress>1234 Main St.</HomeAddress>
<email>sjohnson@somewhere.com</email>
</wc:INSTANCE>
<wc:INSTANCE>
<FullName>Harvy Anderson</FullName>
<HomeAddress>1234 Amber St.</HomeAddress>
<email>handerson@somewhere.com</email>
</wc:INSTANCE>
<wc:INSTANCE>
<FullName>James O'Connor</FullName>
<HomeAddress>775 Main St.</HomeAddress>
<email></email>
</wc:INSTANCE>
<wc:INSTANCE>
<FullName>Harvey Hampton</FullName>
<HomeAddress>775 Main St.</HomeAddress>
<email>hhampton@somewhere.com</email>
</wc:INSTANCE>
</EmployeeData>
</wc:COLLECTION>