高度なカスタマイズ > Info*Engine ユーザーガイド > Task Webject リファレンス > Management Webject > Dispatch-Tasks
  
Dispatch-Tasks
説明
指定された場所に常駐する指定されたタイプのオブジェクトに対して、指定された操作を実行できるタスクを選択します。この Webject を使用すると、複数のホストに分散された情報、または複数のオブジェクトタイプで構成される情報を操作するアプリケーションを簡単に開発できます。
構文
<ie:webject name="Dispatch-Tasks" type="MGT">
<ie:param name="ACCESS" data="http|soap|internal"/>
  <ie:param name="ACTION" data="action_name"/>
  <ie:param name="CLIMBER" data="class_name"/>
  <ie:param name="DEFAULT_DOMAIN" data="domain_name"/>
  <ie:param name="DEFAULT_TYPE" data="type_name"/>
  <ie:param name="GROUP_IN" data="group_name"/>
  <ie:param name="GROUP_VDB" data="group_name"/>
  <ie:param name="ID_ATTRIBUTE" data="attr_name"/>
  <ie:param name="ID_META_ATTRIBUTE" data="meta_name"/>
  <ie:param name="MAX_CONCURRENT" data="integer"/>
  <ie:param name="PARAM" data="name=value"/>
  <ie:param name="TASKS" data="group_name_or_url"/>
  <ie:param name="TYPE_ATTRIBUTE" data="attr_name"/>
  <ie:param name="TYPE_META_ATTRIBUTE" data="meta_name"/>
</ie:webject>
パラメータ
必須
選択
オプション
ACTION
ACCESS
CLIMBER
GROUP_IN
ID_ATTRIBUTE
GROUP_VDB
TASKS
ID_META_ATTRIBUTE
MAX_CONCURRENT
TYPE_ATTRIBUTE
PARAM
TYPE_META_ATTRIBUTE
ACCESS
この Dispatch-Tasks 呼び出しの結果として呼び出されるタスクの、必要なアクセス設定を指定します。このパラメータの値は、ACTION パラメータの値が外部クライアントから供給された場合にのみ、考慮されます。タスク page ディレクティブでの access 属性とまったく同じ働きをします。値 (アクセス値) はパイプ区切りリスト形式で指定できます。値を何も指定しない場合、システムのデフォルトのタスクアクセス値が使用されます。access 属性の詳細についてはpage ディレクティブを参照してください。
ACTION
選択して実行したタスクによって実行された論理操作の名前を指定します。ACTION は、実行するタスクの選択時に使用されるプライマリセレクタです。このパラメータは必須です。
CLIMBER
タスク代理のサーチ時にデータタイプ階層を上に移動する Java クラスの名前を識別します。このパラメータを指定すると、適切なタスク代理の検索に成功するか、または階層の頂点に到達するまで、Webject によって呼び出され続けます。タスク代理が見つからないまま階層の頂点に到達すると、例外が発生します。このパラメータはオプションです。
DEFAULT_DOMAIN
オブジェクトのドメインを識別する属性またはメタデータがない場合、ローカル仮想マシンの名前からドメインを導出せずに使用するデフォルトのドメインを指定します。
DEFAULT_TYPE
オブジェクトのタイプを識別する属性またはメタデータがない場合、com.ptc.object の代わりに使用するデフォルトのタイプ名を指定します。
GROUP_IN
ACTION によって指定した論理操作を実行するオブジェクトを含んでいるグループの名前を指定します。このパラメータには複数の値を指定でき、その結果、ACTION を適用するオブジェクトの 2 つ以上のグループが形成されます。このパラメータは必須です。
GROUP_VDB
呼び出し先タスクの VDB で各タスクに提供される 1 つ以上のグループ名を指定します。これらの名前は、各呼び出し先タスクの VDB に、GROUP_IN パラメータとして指定されたグループ以外の初期のグループセットを挿入します。
ID_ATTRIBUTE
入力グループの各要素に含まれていて、各要素の一意のオブジェクト ID を指定する属性の名前を指定します。たとえば、このパラメータの値が OBID の場合、入力グループの各要素には OBID という名前の属性が含まれ、このような各属性値はそれらを含んでいる要素の一意のオブジェクト ID を識別すると見なされます。
このパラメータを指定すると、ID_ATTRIBUTE は ID_META_ATTRIBUTE より優先されます。ID_ATTRIBUTE と ID_META_ATTRIBUTE のどちらも指定されていない場合は、内部 API が呼び出され、要素の一意のオブジェクト ID を取得します。要素が Windchill タイプのインスタンスである場合、API はオブジェクトの Windchill タイプ識別子を返します。
ID_ATTRIBUTE または ID_META_ATTRIBUTE のいずれかが指定されている場合に、要素の一意のオブジェクト ID が解決されないと、内部 API を使用して一意のオブジェクト ID を取得します。
ID_META_ATTRIBUTE
入力グループの各要素に含まれていて、各要素の一意のオブジェクト ID を指定するメタデータアイテムの名前を指定します。たとえば、このパラメータの値が com.infoengine.obid の場合、入力グループの各要素には com.infoengine.obid という名前のメタデータアイテムが含まれ、このような各属性値はそれに関連付けられている要素の一意のオブジェクト ID を識別すると見なされます。
ID_META_ATTRIBUTE および ID _ATTRIBUTE の両方を指定すると、ID_ATTRIBUTE は ID_META_ATTRIBUTE よりも優先されます。ID_ATTRIBUTE と ID_META_ATTRIBUTE のどちらも指定されていない場合は、内部 API が呼び出され、要素の一意のオブジェクト ID を取得します。要素が Windchill タイプのインスタンスである場合、API はオブジェクトの Windchill タイプ識別子を返します。
ID_ATTRIBUTE または ID_META_ATTRIBUTE のいずれかが指定されている場合に、要素の一意のオブジェクト ID が解決されないと、内部 API を使用して一意のオブジェクト ID を取得します。
MAX_CONCURRENT
Webject が同時に実行できる選択されたタスクの最大数を指定します。このパラメータを指定しないで複数のタスクを選択すると、これらのタスクは順番に実行されます。このパラメータのデフォルトは 1 です。このパラメータはオプションです。
PARAM
選択して実行するタスクに渡される追加パラメータを指定します。このパラメータの各値は name=value のペアとして指定します。ここで、name は選択した各タスクに渡す追加パラメータの名前で、value はパラメータの値です。
PARAM を指定しない場合、追加パラメータは選択したタスクに渡されません。このパラメータには複数の値を指定できます。このパラメータはオプションです。
TASKS
LDAP URL またはグループの名前のいずれかを指定します。
LDAP URL を指定すると、URL はディレクトリサーバー、およびタスク定義のツリーのルートを設定する関連付けられたディレクトリ内のノードを識別します。タスクは、操作名 (ACTION パラメータから取得)、オブジェクトタイプ (オブジェクトごとに TYPE_ATTRIBUTE または TYPE_META_ATTRIBUTE に基づいて取得)、およびオブジェクトの場所 (ID_ATTRIBUTE または ID_META_ATTRIBUTE に基づいて各オブジェクトのオブジェクト ID のドメインコンポーネントから取得) に基づいてツリーから選択します。
グループ名を指定すると、タスク定義テーブルに表示されます。グループの各要素によって 1 つのタスク定義が指定され、このような各定義は以下の名前の属性を含んでいると見なされます。
ACTION - この定義によってサポートされる操作の論理名を指定します。この属性は Webject の ACTION パラメータと比較されます。一致しない場合、定義は Webject のこの呼び出しに適用されません。
TYPE - この定義を適用するオブジェクトタイプを指定します。この属性は、入力グループの各要素から取得したオブジェクトタイプと比較されます。一致しない場合、定義は要素に適用されません。この属性の値がアスタリスク (*) の場合、定義はすべてのオブジェクトタイプに適用されます。
DOMAIN - この定義を適用する完全修飾ドメイン名を指定します。この属性は、入力グループの各要素の一意のオブジェクト ID から取得したドメインコンポーネントと比較されます。一致しない場合、定義は要素に適用されません。この属性の値がアスタリスク (*) の場合、定義はすべてのドメインに適用されます。
TASK - この定義に関連付けられた操作を実装する Info*Engine タスクの URL を指定します。
PROCESSOR - TASK 属性によって識別されるタスクを実行できる Info*Engine のタスクプロセッサの名前を指定します。この属性をタスク定義に指定していない場合、TASK 属性によって識別されるタスク実装は常にアクセスして実行できます。
このパラメータは必須です。
TYPE_ATTRIBUTE
入力グループの各要素に含まれていて、各要素のオブジェクトタイプを指定する属性の名前を指定します。たとえば、このパラメータの値が CLASS の場合、入力グループの各要素には CLASS という名前の属性が含まれ、このような各属性値はそれを含んでいる要素のオブジェクトタイプを識別すると見なされます。
TYPE_ATTRIBUTE および TYPE_META_ATTRIBUTE の両方を指定すると、TYPE_ATTRIBUTE は TYPE_META_ATTRIBUTE より優先されます。TYPE_ATTRIBUTE と TYPE_META_ATTRIBUTE の両方を指定しないと、内部 API が呼び出され、タイプ識別子が取得されます。要素が Windchill タイプのインスタンスである場合、この API はオブジェクトの Windchill タイプ識別子を返します。
TYPE_ATTRIBUTE または TYPE_META_ATTRIBUTE のいずれかが指定されている場合に、要素のタイプ識別子が解決されないと、内部 API を使用してタイプ識別子を取得します。
TYPE_META_ATTRIBUTE
入力グループのすべての要素に含まれ、各要素のオブジェクトタイプを指定するメタデータアイテムの名前を指定します。たとえば、このパラメータの値が com.infoengine.objectType の場合、入力グループのすべての要素には com.infoengine.objectType という名前の関連付けられたメタデータアイテムが含まれ、このような各メタデータオブジェクトの値はそれに関連付けられている要素のオブジェクトタイプを識別すると見なされます。
TYPE_META_ATTRIBUTE および TYPE _ATTRIBUTE の両方を指定すると、TYPE _ATTRIBUTE は TYPE_META_ATTRIBUTE より優先されます。TYPE_ATTRIBUTE と TYPE_META_ATTRIBUTE の両方を指定しないと、内部 API が呼び出され、タイプ識別子が取得されます。要素が Windchill タイプのインスタンスである場合、この API はオブジェクトの Windchill タイプ識別子を返します。
TYPE_ATTRIBUTE または TYPE_META_ATTRIBUTE のいずれかが指定されている場合に、要素のタイプ識別子が解決されないと、内部 API を使用してタイプ識別子を取得します。
<%@page language="java" session="true" errorPage="IEError.jsp" import="java.util.
Vector,java.util.Enumeration,com.infoengine.SAK.*" %>
<%@taglib uri="http://www.ptc.com/infoengine/taglib/core" prefix="ie" %>
<html>
<head>
<title>Dispatch Tasks</title>
</head>
<body bgcolor="#FFFFFF">
<ie:getService varName="ie"/>
<ie:webject name="Create-Group" type="GRP">
  <ie:param name="group_out" data="tasks"/>
  <ie:param name="delimiter" data=":"/>
  <ie:param name="element"
                 data="action=query:type=part:domain=s1.ptc.com:task=infoengine/
                                                     com/company/CreateGroup.xml"/>
  <ie:param name="element"
                 data="action=query:type=part:domain=s2.ptc.com:task=infoengine/
                                                   com/company/CreateGroupA.xml"/>
  <ie:param name="element"
                 data="action=query:type=part:domain=s3.ptc.com:task=infoengine/
                                                    com/company/JdbcQueryEmp.xml"/>
</ie:webject>
<ie:webject name="Create-Group" type="GRP">
  <ie:param name="group_out" data="parts"/>
  <ie:param name="delimiter" data=":"/>
  <ie:param name="element" data="ufid=part1@s1.ptc.com:class=part:number=1"/>
  <ie:param name="element" data="ufid=part2@s2.ptc.com:class=part:number=2"/>
  <ie:param name="element" data="ufid=part3@s3.ptc.com:class=part:number=3"/>
  <ie:param name="element" data="ufid=part4@s1.ptc.com:class=part:number=4"/>
  <ie:param name="element" data="ufid=part5@s2.ptc.com:class=part:number=5"/>
  <ie:param name="element" data="ufid=part6@s3.ptc.com:class=part:number=6"/>
  <ie:param name="element" data="ufid=part7@s1.ptc.com:class=part:number=7"/>
  <ie:param name="element" data="ufid=part8@s2.ptc.com:class=part:number=8"/>
  <ie:param name="element" data="ufid=part9@s3.ptc.com:class=part:number=9"/>
</ie:webject>
<% long start = System.currentTimeMillis (); %>
<ie:webject name="Dispatch-Tasks" type="MGT">
  <ie:param name="tasks" data="tasks"/>
  <ie:param name="group_in" data="parts"/>
  <ie:param name="max_concurrent" data="$(@FORM[]threads[])" default="10"/>
  <ie:param name="action" data="$(@FORM[]action[])" default="query"/>
  <ie:param name="type_attribute" data="class"/>
  <ie:param name="id_attribute" data="ufid"/>
  <ie:param name="param" data="group_out=results"/>
  <ie:param name="param" data="jdbcAdapter=$(@FORM[]jdbcAdapter[])"
default="jdbcAdapter"/>
</ie:webject>
<% long duration = System.currentTimeMillis () - start; %>
<h2>Execution time: <%= duration %> msec</h2><br>
<ie:webject name="Display-Object" type="DSP">
  <ie:param name="group_in" data="results"/>
  <ie:param name="border" data="1"/>
  <ie:param name="display_attribute_name" data="true"/>
</ie:webject>
</body>
</html>