Action 要素 (WorkflowInfo)
適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
ワークフロー エンジンがワークフロー アクティビティを処理するために必要な情報を含みます。これは、Microsoft SharePoint Foundation 2010のアクションと呼ばれます。 ワークフロー アクション 要素は、電子メール通知の送信、SharePoint Foundation 2010 リスト アイテムの更新、タスクの作成と割り当て、その他多くのアクティビティなどのワークフロー アクティビティを表します。
既定では、SharePoint Foundation 2010 には 23 個の組み込みワークフロー アクションが用意されています。 これらのアクションは、WSS.ACTIONS ファイルに定義されています。
定義
<Actions>
<Action>
<Parameters>
</Parameters>
<RuleDesigner>
</RuleDesigner>
<DataSources>
</DataSources>
<Modifications>
<Modification>
</Modification>
</Modifications>
<ActionVariables>
</ActionVariables>
<ActionBody>
</ActionBody>
<ActionConditions>
</ActionConditions>
</Action>
</Actions>
要素と属性
以下のセクションで、属性、子要素、親要素について説明します。
属性
属性 |
説明 |
---|---|
**名前** |
必須 **text**。 ワークフロー エディタに表示される、ワークフロー アクションの説明を表します。 |
**Classname** |
必須 **text**。 ワークフロー アクションを実装するクラスの完全修飾名。たとえば、**Microsoft.SharePoint.WorkflowActions.EmailActivity** です。 |
**アセンブリ** |
必須 **text**。 **Action** 要素を実装する手順を含む Microsoft .NET アセンブリ名。 テキストには、PublicKeyToken、バージョン、カルチャを含める必要があります。 |
**FunctionName** |
省略可能 **text**。 サンドボックス ソリューションの場合は、呼び出す関数の名前を指定します。 |
**カテゴリ** |
省略可能 **text**。 ワークフロー アクションのカテゴリを提供します。 この **text** は、使用可能なアクションの一覧をフィルター処理するために使用されます。 |
**CreatesTask** |
省略可能 **Boolean**。 **true**に設定すると、タスクリストアイテムがワークフローに作成されます。 空白のままにした場合、前提は **false**であり、タスク リスト項目は作成されません。 |
**CreatesInList** |
省略可能 **text**。 この属性に値を設定すると、ワークフローによってリストに項目が作成されます。 値は、リストまたはドキュメント ライブラリの **ID** を含むパラメーター名にマップする必要があります。 |
**Appliesto** |
必須 **text**。 このワークフロー アクションがリストとドキュメント ライブラリのどちらか、またはその両方で使用できるかを示します。 有効な値には、**list**、**doclib**、**all** があります。 |
**IsError** |
省略可能 **Boolean**。 **true** に設定すると、この **Action** 要素のインスタンスは、クライアント アプリケーションによってエラーと見なされます。 |
**ListModeration** |
省略可能 **Boolean**。 **true** に設定されている場合、この **Action** 要素は、コンテンツの承認が有効になっているリストまたはドキュメント ライブラリに適用されます。 空白のままにした場合、想定は **false** です。 |
**UsesCurrentItem** |
省略可能 **Boolean**。 **true** に設定されている場合は、現在の項目を使用または変更する必要があることを示します。 **false** または空白のままにした場合、この **Action** 要素は、指定された SharePoint リストまたはドキュメント ライブラリ項目のみを使用します。 |
**CreatedTaskFormType** |
省略可能 **text**。 作成されたタスクの種類を指定します。**DataCollectTask** を使用して、1 人のユーザーからデータを収集するタスクを作成します。**GroupAssignedTask** を使用して、1 人以上のユーザーからデータを収集するタスクを作成します。**TodoItemTask** ユーザーからデータを収集しないが、ユーザーが何かを行ったことを検証するためにのみ存在するタスクを作成します。または **TaskProcess** を使用して、アドホック コラボレーションを可能にし、1 人以上のユーザーからデータを収集できるフォームを持つタスクを作成します。 |
**__SolutionId** |
省略可能 **text**。 クライアント アプリケーションが実装固有のアクションに書き込む GUID を指定します。 サーバーは GUID を使用して、ワークフローの実行時にアセンブリを見つけるのに役立ちます。 |
**SandboxedFunction** |
省略可能 **Boolean**。 **true**に設定すると、クライアント アプリケーションは、このアクションが選択されたときに実装固有のアクションを挿入します。 アクションは、**AssemblyName**、**ClassName**、および **FunctionName** の組み合わせで定義された関数を呼び出すように構成する必要があります。 設定する場合は、**AssemblyName**、**ClassName**、**FunctionName**、**__SolutionId** も設定する必要があります。 |
子要素
親要素
例
次のコード例は、ワークフロー エディターに表示されるように Action 要素を構築する方法を示しています。 この XML は、読みやすさを考慮して変更されています。
<WorkflowInfo>
<Conditions>…</Conditions>
<Actions Sequential="then" Parallel="and">
<Action Name="Update my custom SharePoint list"
ClassName="CustomActivities.OrderListFunctions"
Assembly="CustomActivities,
PublicKeyToken=b03f5f7f11d50a3a,
Version=1.0.0.0,
Culture=neutral"
Category="My Custom Actions"
CreatesTask="true"
CreatesInList="UpdateList"
AppliesTo="all"
ListModeration="false"
UsesCurrentItem="true">
<RuleDesigner Sentence="Update %1">
<FieldBind Field="UpdateList"
Function="UpdateOrderList"
DesignerType="ChooseListItem"
ID="1"
Text="My Custom List">
</FieldBind>
</RuleDesigner>
<Parameters>
<Parameter Type="System.String, mscorlib"
Direction="In"
Name="UpdateList"
</Parameters>
</Action>
</Actions>
</WorkflowInfo>