シンプルアクション

シンプルアクションは、事前にプログラミングされたアクティビティを実行しますが、引数を使用して修正できます。シンプルアクションは、イベントハンドラに適用されます。シンプルアクションはグループ化できます。

シンプルアクションのリスト

シンプルアクションは、[基本]、[コンポーネント]、[文書] に分類されます。

以下のシンプルアクションは、サーバーのイベントハンドラに適用されます。

以下のシンプルアクションは、クライアントのイベントハンドラに適用されます。

詳しくは、シンプルアクションを参照してください。

シンプルアクションの使用例

以下のソース XML の例は、ボタンの onclick イベントに適用されます。設計モードの説明については、シンプルアクションの操作を参照してください。

1 つのサーバーサイドアクション
このイベントハンドラは、サーバーサイドの [ページを開く] シンプルアクションを実行します。設計モードのダイアログで、アクションとして [ページを開く]、最初の引数として xpage1、2 番目の引数として [新規の文書] を選択します。
```
<xp:button id="button1" value="Go back">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
		<xp:this.action>
			<xp:openPage name="/xpage1.xsp" target="newDocument"></xp:openPage>
		</xp:this.action>
	</xp:eventHandler>
</xp:button>
```
1 つのクライアントサイドシンプルアクションと 1 つのサーバーサイドシンプルアクション
このイベントハンドラには、クライアントとサーバーの両方のシンプルアクションがあります。このハンドラは、まず、クライアントサイドの [クライアントスクリプトの実行] アクションを実行します。クライアントスクリプトが true を返した場合、このハンドラは、サーバーサイドの [ページを開く] シンプルアクションを実行します。
```
<xp:button id="button1" value="Go to page 1">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
		<xp:this.action>
			<xp:openPage name="/xpage1.xsp" target="newDocument"></xp:openPage>
		</xp:this.action>
		<xp:this.script>
			<xp:executeClientScript>
				<xp:this.script>
					<![CDATA[return window.confirm("Do you really want to go to page 1?")]]>
				</xp:this.script>
			</xp:executeClientScript>
		</xp:this.script>
	</xp:eventHandler>
</xp:button>
```

シンプルアクショングループの使用例

シンプルアクションは、グループ内の複数の深さに配置できます。グループを使用すると、1 つのイベントに対して複数のクライアントアクションとサーバーアクションを実行することや、条件に基づいてアクションを実行することができます。スクリプトを実行するためのアクションが用意されているため、スクリプトをグループ化できます。

グループ内にある条件付きの 1 つのサーバーサイドアクション

このイベントハンドラは、サーバーサイドの [ページを開く] シンプルアクションをグループ内に配置することにより、このアクションを条件に基づいて実行します。

<xp:button id="button1" value="Go to page 1">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
		<xp:this.action>
			<xp:actionGroup>
				<xp:this.condition>
					<![CDATA[#{javascript:return session.getCommonUserName() != "Anonymous"}]]>
				</xp:this.condition>
			<xp:openPage name="/xpage1.xsp" target="newDocument"></xp:openPage>
		</xp:actionGroup>
	</xp:this.action>
</xp:eventHandler>
</xp:button>

グループ内にある 3 つのサーバーサイドアクション
このイベントハンドラは、サーバーサイドの [アクションの確認]、[文書の保存]、[ページを開く] シンプルアクションを 1 つのグループ内に配置することにより、これらのアクションを順次実行します。最初のアクションの戻り値が false である場合、残りのアクションは実行されません。
```
<xp:button id="button1" value="Go to page 1">
	<xp:eventHandler event="onclick" submit="true" refreshMode="complete">
		<xp:this.action>
			<xp:actionGroup>
				<xp:confirm message="Do you really want to go to page 1?"></xp:confirm>
				<xp:saveDocument></xp:saveDocument>
				<xp:openPage name="/xpage1.xsp" target="newDocument"></xp:openPage>
			</xp:actionGroup>
		</xp:this.action>
	</xp:eventHandler>
</xp:button>
```