XML型のUDAを指定するときに、XML要素を追加できます。[XML UDAに要素を追加]Java Actionを使用します。
前提条件は以下です。
新しい要素を追加できるXML型のUDAが、プロセス定義に含まれている。
注意
このJava Actionは、プロセス定義とすべてのノードに割り当てることができます。
XML型のUDAに要素を追加するには
[プロパティ]ビューを表示するために、プロセス定義エディタ内の空のスペースをクリック、または、Java Actionを設定するノードを選択します。
[アクションセット]タブを選択します。Java Actionを追加する場所に対応する[追加]をクリックします。[アクションタイプリスト]ダイアログが表示されます。
[XMLアクション]を展開し、[XML UDAに要素を追加]をダブルクリックします。
[XML UDAに要素を追加]ダイアログが表示されます。プロセス定義またはノードに対して定義されている最初のXML型UDAの名前（この例では、UDA CustomerName）が自動的に表示され、デフォルトの説明が示されます。
図11.21 [XML UDAに要素を追加]ダイアログの表示
オプション: [アクション名]フィールドに名前を入力し、[ノート]フィールドでメモを編集します。
[ターゲットUDA]ドロップダウンリストから、新しいXML要素を追加するUDAを選択します。
[ターゲットUDA]ドロップダウンリストでは、XMLタイプのUDAのみを表示します。
[XPath]ドロップダウンリストには、選択されたUDAのすべてのXPathを表示します。
[XPath]コンボボックスから、ターゲットUDAのXPathを選択します。
XPathを編集する場合は、[編集]ボタンをクリックしてください。[XPath エディタ]ダイアログが表示されます。このダイアログでXPathを編集できます。
注意
[XPath]コンボボックスに、編集されたXPathが表示されます。
注意
[XPath]ドロップダウンリストには、選択されたXMLタイプのユーザ定義属性に関連するXPathのリストが表示されます。 選択されたユーザ定義属性でXMLスキーマが定義されている時、このXMLスキーマで使用できるXPathのリストを表示します。 選択されたユーザ定義属性でXML(初期)値が定義されている場合は、このXML(初期)値で使用できるXPathのリストを表示します。 両方定義されている場合は、XMLスキーマで使用できるXPathのリストを表示します。
注意
XPath エディタはXPathの構文のチェックを行うのみです。編集されたXPathが存在するかどうかチェックしません。
[値]フィールドで、XML要素の値を指定します。
UDA値を入力するときは、UDAにXML文字列を割り当てる場合と同じタグを使用します。詳細については、“11.3.3 XML文字列のユーザ定義属性への割り当て”を参照してください。以下の例は、UDA CustomerNameに“customer”要素を追加する[アクション編集]ダイアログを示しています。
図11.22 XML UDAでの要素の追加
[OK]をクリックします。
ダイアログを終了すると、Systemwalker Runbook Automation Studioにより、入力された値が整形式のXMLであるかどうかが自動的にチェックされます。整形式でない場合は、警告メッセージが表示されます。
注意
補償アクションを使用してこのアクションを補償する必要はありません。このアクションによって実行された変更は、Systemwalker Runbook Automation内に限定されており、プロセスインスタンスがエラー状態になった後ロールバックされるからです。補償アクションの詳細については、“11.1.7 Java Actionのエラー処理”を参照してください。
