ワークフロー内の関連付けと開始のフォームデータにアクセスする

[アーティクル]
09/18/2014

最終更新日: 2010年5月7日

適用対象: SharePoint Server 2010

ワークフローインスタンスが開始されると、ユーザーから収集された関連付けと開始のデータはすべて、SPWorkflowActivationProperties オブジェクトに格納されます。このオブジェクトには、OnWorkflowActivated アクティビティの WorkflowProperties プロパティによってアクセスできます。このオブジェクトには、すべてのワークフローの標準的な情報に加え、ワークフロー定義 XML や、ワークフローの関連付けフォームおよび開始フォームからのカスタムデータが格納されます。WorkflowProperties プロパティに指定する SPWorkflowActivationProperties オブジェクト変数にアクセスすることで、ワークフローに渡される情報を使用できます。

SPWorkflowActivationProperties オブジェクトには、HistoryListId、ItemId、TaskListId、WorkflowId などの、SharePoint Foundation のすべてのワークフローインスタンスにおいて標準であるプロパティのセットが格納されます。

さらに、このオブジェクトには AssociationData プロパティと InitiationData プロパティによって表現される文字列も含まれます。これらのプロパティはそれぞれ、ワークフローの関連付けと開始のカスタムプロパティを格納します。

Microsoft Office InfoPath フォームの場合、これらのプロパティは、データの収集に使用されたフォームのスキーマに準拠する XML 文字列を返します。これらのカスタムプロパティにアクセスするには、XML 文字列を解析するコードを記述する必要があります。

ワークフロー開発者は、XML 文字列を解析してそこに含まれるカスタムプロパティを識別するために使用するメソッドを決定できます。この手順のためには、Visual Studio のコマンドラインツールである xsd.exe を使用して、ワークフローフォームのスキーマに基づいたクラスを生成します。次に、SPWorkflowActivationProperties オブジェクトの InitiationData プロパティによって返された XML 文字列を逆シリアル化することで、その型のオブジェクト内に、受け取ったフォームデータを格納します。

For more information about setting activity properties, see the Windows Workflow Foundation SDK.

ワークフロー内の関連付けまたは開始のフォームデータにアクセスするには

InfoPath の関連付けフォームまたは開始フォームのスキーマを抽出します。
1. InfoPath で、保存して発行したワークフローフォームを開きます。
2. フォームをソースファイルとして保存するため、[ファイル] メニューの [ソースファイルとして保存] をクリックします。フォームソースファイルを保存する場所に移動し、[OK] をクリックします。
  
  InfoPath はスキーマファイルなどのフォームソースファイルのコレクションを、指定された場所に保存します。フォームスキーマファイルの名前は常に myschema.xsd になります。
コマンドラインツールの xsd.exe を使用して、フォームスキーマファイル (.xsd) に基づいた新しいクラスファイルを生成します。
1. Visual Studio コマンドプロンプトを開きます。[スタート] ボタンをクリックし、[すべてのプログラム]、[Microsoft Visual Studio 2010]、[Visual Studio Tools] の順にポイントし、[Visual Studio 2010 コマンドプロンプト (2010)] をクリックします。
  
  注意
  
  既定では、Visual Studio 2010 は xsd.exe コマンドラインツールを次の場所にインストールします。C: は、Visual Studio 2010 をインストールしたドライブを表します。C:\Program Files\Microsoft Visual Studio 10\SDK\v2.0\Bin
2. フォームスキーマ (.xsd) ファイルの場所に移動し、次のコマンドを実行します : xsd myschema.xsd /c /o:output_directory
  
  xsd.exe ツールは、フォームスキーマに基づいて新しいクラスファイルを生成します。このファイルにはスキーマファイルと同じ、myschema.cs という名前が付けられます。ファイル内のクラスにはスキーマのルート要素と同じ名前が付けられます (これはフォームフィールドコレクションと同じ名前です)。
  
  注意
  
  既定の名前の myfields を使用するのではなく、フォームフィールドコレクションに一意の名前を指定すると、フォームスキーマファイルから生成されるクラスにも一意の名前が付けられるようにするのに有用です。これは特に、複数のフォームを使用するワークフローのプログラミングを行っている場合に重要です。
Visual Studio で、作業対象のワークフロープロジェクトを開き、そこに新しいクラスファイルを追加します。
ワークフローの関連付けまたは開始のデータを使用して、新しいクラスの新しいインスタンスをシリアル化するコードをワークフローに追加します。

たとえば次のコードは、workflowProps という名前の SPWorkflowActivationProperties オブジェクト変数の InitiationData プロパティにある、InitForm 型の新しいオブジェクトをシリアル化します。この例は、開始データの収集に使用される InfoPath フォームのスキーマと一致するスキーマを持つ、InitForms というクラスを、開発者が作成済みであることを前提にしています。
```
using System.Xml.Serialization;
using System.Xml;
…
  XmlSerializer serializer = new 
     XmlSerializer(typeof(InitForm));
   XmlTextReader reader = new XmlTextReader(new 
     System.IO.StringReader(workflowProps.InitiationData));
   InitForm initform = (InitForm) serializer.Deserialize(reader);
```
```
Imports System.Xml.Serialization
Imports System.Xml
…
  Dim serializer As New XmlSerializer(GetType(InitForm))
  Dim reader As New XmlTextReader(New System.IO.StringReader(workflowProps.InitiationData))
  Dim initform As InitForm = CType(serializer.Deserialize(reader), InitForm)
```
フォームスキーマに基づいて、クラスのプロパティとしてカスタムプロパティにアクセスするコードをワークフローに追加します。

次のコードは、前の例に基づいて構築されています。このコードは、InitForm オブジェクトの 3 つのカスタムプロパティにアクセスし、それらを文字列変数に代入しています。
```
  assignee = initform.assignee;
  instructions = initform.instructions;
  comments = initform.comments;
```
```
assignee = initform.assignee
instructions = initform.instructions
comments = initform.comments
```

次の方法で共有

ワークフロー内の関連付けと開始のフォームデータにアクセスする

ワークフロー内の関連付けまたは開始のフォームデータにアクセスするには

関連項目

タスク

概念

その他のリソース

次の方法で共有

ワークフロー内の関連付けと開始のフォーム データにアクセスする

ワークフロー内の関連付けまたは開始のフォーム データにアクセスするには

関連項目

タスク

概念

その他のリソース

ワークフロー内の関連付けと開始のフォームデータにアクセスする

ワークフロー内の関連付けまたは開始のフォームデータにアクセスするには