既定のワークフロー アクション (WorkflowActions)
最終更新日: 2015年3月9日
適用対象: SharePoint Foundation 2010
アクションは、Windows Workflow Foundation アクティビティの Microsoft SharePoint Foundation 2010 実装を示しています。またアクションは、ワークフローにおいて最も基本な作業単位となります。アクションでは、アイテムがドキュメント ライブラリに追加された際に電子メールで通知したり、アイテムに関連づけられているタスクが完了した際にリスト アイテムのステータスを更新するなどのワークフロー アクティビティを定義します。SharePoint Foundation 2010 には、既定または事前定義の使用可能なワークフロー アクションが用意されているため、共通のビジネス シナリオを処理するワークフローを作成することができます。
既定のワークフロー アクションの場所
既定のワークフロー アクションは、WSS.ACTIONS ファイルに登録されています。なおこのファイルは、ワークフロー エディターを使用できる既定のすべての条件およびアクションを一覧表示する XML ファイルとなっています (WSS.ACTIONS ファイルに登録されている既定のワークフロー条件については、「既定のワークフロー条件」を参照してください)。なお WSS.ACTIONS ファイルは、以下に示す SharePoint Foundation 2010 内に既定でインストールされています。
%WSSRoot%\Program Files\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\1033\Workflow
注意
WSS.ACTIONS ファイルを直接変更することは、推奨またはサポートされていません。ただし、同一ディレクトリにさらにカスタムの .ACTIONS ファイルを新規作成または追加することで、コードを使用しないワークフロー エディターを使用できるアクションを展開することができます。SharePoint Foundation により、ファイル拡張子 .ACTIONS のすべてのファイルを解析し、宣言型のコードを使用しないワークフロー エディターに表示する複合リストを作成します。
既定のアクション
次の表には、SharePoint Foundation と共に含まれている既定のワークフロー アクションを示しています。また、この表には、コードを使用しないワークフロー エディターにルールを表示させる方法の例も含まれています。以下に示す既定のアクションでは、それぞれルールを表示するための XML の記述方法についても表示します。
アクション |
説明 |
|---|---|
日付に時刻を追加する |
日付フィールドに時間間隔を追加します。これは、分、時、日、月、年単位で指定できます。 ルール文: 指定した単位を日付に追加します ([変数: 日付] への出力) XML: %1 %2 を %3 に追加します (%4 への出力) |
フォームをグループに割り当てる |
アンケート用のフォームをユーザーのグループに割り当てます。 グループ内の個々のユーザーから送信された値は、タスク リストに格納されています。 すべてのアンケート用のフォームの処理が完了するまでワークフローの処理は一時停止の状態となります。 ルール文: カスタム フォームをこれらのユーザーに割り当てます。 XML: %1 を %2 に割り当てます |
タスク アイテムを割り当てる |
指定のユーザーについてタスク リスト内のタスクを割り当てます。すべてのアイテムの処理が完了するまでワークフロー処理は一時停止の状態となります。 ルール文: タスク アイテムをこれらのユーザーに割り当てます XML: %1 を %2 に割り当てます |
動的な文字列を構築する |
指定のワークフロー変数に格納される動的な文字列の作成を許可します。 ルール文: 変数: 変数に動的な文字列を格納します XML: %2 に %1 を格納します |
アイテムをチェックインする |
指定のリストやドキュメント ライブラリのアイテムをチェックインし、ワークフロー処理中にコメントが自動的に追加されるのを許可します。 ルール文: コメント: コメントが付加されたこのリスト内のアイテムをチェックインします XML: コメント: %2 が付加された %1 内のアイテムをチェックインします |
アイテムをチェックアウトする |
指定のリストやドキュメント ライブラリのアイテムをチェックアウトします。 ルール文: このリスト内のアイテムをチェックアウトします XML: %1 内のアイテムをチェックアウトします |
データをユーザーから収集する |
データ コレクションに使用するカスタム フォーム フィールドを含むユーザーにタスクを割り当てます。 ルール文: このユーザーからデータを収集します (変数:収集への出力) XML: %2 から %1 を収集します (%3 への出力) |
リストのアイテムをコピーする |
指定のリストのアイテムをあるリストからその他のリストにコピーするようにワークフローに対して指示します。 ルール文: このリスト内のアイテムをこのリストにコピーします XML: %1 内のアイテムを % にコピーします |
リスト アイテムを作成する |
指定のリストにおいてリスト アイテムを作成するようにワークフローに指示します。 ルール文: このリストにアイテムを作成します (変数: 作成への出力) XML: %1 にアイテムを作成します (%2 への出力) |
アイテムを削除する |
指定のリスト アイテムを削除します。 ルール文: このリストのアイテムを削除します XML: %1 のアイテムを削除します |
アイテムのチェックアウトを取り消す |
チェックアウトを取り消すようにワークフローに指示します。 この指示が発生した場合にアイテムが既にチェックアウトされていると、変更はすべて失われます。 ルール文: このリスト内のアイテムのチェックアウトを破棄します XML: %1 内のアイテムのチェックアウトを破棄します |
計算する |
2 つの値を計算し、その結果をワークフロー変数に格納します。 ルール文: 値＋値を計算します (変数: 計算への出力) XML: %1 %2 %3 を計算します (%4 への出力) |
履歴リストに記録する |
履歴リストにおいてメッセージ付きのエントリを作成します。このメッセージは、静的なテキストか、ルックアップ コントロールから動的に生成されたテキストで作成することができます。 ルール文: このメッセージをワークフローの履歴リストに記録します XML: %1 をワークフローの履歴リストに記録します |
一定の時間間隔で一時停止する |
指定された時間間隔でワークフローを一時停止します。指定の時間が経過すると、ワークフローが再開します。 ルール文: 指定した日、時間、分の間、一時停止します XML: %1 日、%2 時間、%3 分の間、一時停止します) |
ある時点まで一時停止する |
指定の日付および時刻までワークフローを一時停止し、その時点でワークフローを再開させます。 ルール文: この時刻まで一時停止します XML: この時刻まで一時停止します |
電子メールを送信する |
電子メールを指定のユーザーまたはグループに送信します。電子メールのメッセージには、宛先、CC、件名、本文 の各フィールドを含めることができます。[本文] フィールドには、静的なテキストと、ルックアップ テーブルから動的に生成したテキストの両方を含めることができます。 ルール文: このメッセージを電子メールで送信します XML: %1 を電子メールで送信します |
コンテンツの承認の状態を設定する |
アイテムのコンテンツの承認の状態を Approved、Rejected、Pending のいずれかに設定します。またこのアクションではコメントを追加します。 ルール文: コンテンツの承認の状態をこのステータスに設定し、コメント: コメントを追加します XML: コンテンツの承認の状態を %1 に設定し、%2 を追加します |
現在のアイテムのフィールドを設定する |
現在のアイテムのフィールドを指定の値またはルックアップの値に設定します。 ルール文: フィールドを値に設定します XML: %1 を %2 に設定します |
日付/時刻フィールドの時刻部分を設定する |
指定された日付の時刻を特定の値に設定するようにワークフローに指示します。この情報は、今後の使用のためにワークフロー変数に格納されます。 ルール文: 日付の時刻を時:分に設定します (変数: 日付への出力) XML: %3 の時刻を %1:%2 に設定します (%4 への出力) |
ワークフロー変数を設定する |
指定のワークフロー変数の値を設定するようにワークフローに指示します。 ルール文: ワークフロー変数を値に設定します XML: %1 を %2 に設定します |
ワークフローを停止する |
ワークフローを停止し、そのワークフローの履歴ログで指定のメッセージ付きのエントリを作成します。 ルール文: ワークフローを停止し、このメッセージを記録します XML: ワークフローを停止し、%1 を記録します |
リスト アイテムを更新する |
指定された値でリスト アイテムのフィールドを更新するようにワークフローに指示します。 ルール文: このリストのアイテムを更新します XML: %1 のアイテムを更新します |
現在のアイテムのフィールドが変更されるのを待機する |
特定の値でフィールドが更新されるまでワークフローを一時停止します。 ルール文: フィールドがこの値と等しくなるまで待機します XML: %1 %2 %3 を待機します |