ワークフロー テンプレートを展開する
最終更新日: 2010年4月16日
適用対象: SharePoint Foundation 2010
ワークフロー テンプレートや必要なワークフロー フォームを作成したら、ワークフローをコンパイルおよびインストールして稼働できるようにしなければ、Microsoft SharePoint Foundation 2010 で実際に運用することはできません。
その基本的な手順を以下に示します。
ワークフロー テンプレートをコンパイルして、厳密に名前付けしたアセンブリにします。
具体的な手順については、Visual Studio オンライン ヘルプを参照してください。
フィーチャー定義ファイルに、所定の範囲にワークフローを展開するために必要な事項を記述します。SharePoint Foundation 2010 はこれを参照して必要な処理を行います。
ワークフロー定義ファイルに、テンプレートからワークフローを生成し、実行するために必要な事項を記述します。SharePoint Foundation はこれを参照して必要な処理を行います。
展開に関するプロパティを設定します。これにより、ソリューションを構築すると、ワークフロー ファイルが適切な場所に、ワークフロー アセンブリがグローバル アセンブリ キャッシュ (GAC) にコピーされ、SharePoint Foundation 上でワークフロー機能が動作するようになります。
注意
以下の手順では、ワークフロー テンプレートが、SharePoint Foundation ワークフロー プロジェクト テンプレートを使って作成したものであると想定します。このプロジェクト テンプレートは Workflow Starter Kit に入っているもので、ワークフローを作成、展開して SharePoint Foundation 上で動くようにする、開発者向けの支援機能が組み込まれています。Workflow Starter Kit は Microsoft Download Center から入手できます。
SharePoint Foundation ワークフロー プロジェクトでフィーチャー定義ファイルを作成するには
Microsoft Visual Studio を起動して SharePoint Foundation ワークフロー プロジェクトを開き、[ソリューション エクスプローラー] ウィンドウで feature.xml ファイルをダブルクリックします。
feature.xml ファイルで任意の場所を右クリックし、[スニペットの挿入]、[SharePoint Foundation ワークフロー] の順に選択し、[Feature.xml コード] をクリックします。
反転表示になっている箇所を、実際のワークフロー プロジェクトに合わせて書き換えます。該当箇所はすべて大文字になっています。次の情報が含まれます。
機能 ID の役割を果たす GUID。ワークフロー定義ファイルに記述した、ワークフロー ID と同じものは指定できません。
ワークフロー テンプレートの題名。
ワークフロー テンプレートの説明文。
ワークフロー定義ファイルの場所。feature.xml ファイルを基準とした相対パスで指定します。既定値は 'workflow.xml' となっています。
フィーチャー定義 XML ファイルの詳細については、「Feature.XML Files」を参照してください。SharePoint Foundation 機能の作成の詳細については、「フィーチャーの使用」を参照してください。
ファイルを保存します。
SharePoint Foundation ワークフロー プロジェクトでワークフロー定義ファイルを作成するには
Microsoft Visual Studio を起動して SharePoint Foundation ワークフロー プロジェクトを開き、[ソリューション エクスプローラー] ウィンドウで workflow.xml ファイルをダブルクリックします。
workflow.xml ファイルで任意の場所を右クリックし、[スニペットの挿入]、[SharePoint Foundation ワークフロー] の順に選択し、[workflow.xml コード] をクリックします。
反転表示になっている箇所を、実際のワークフロー プロジェクトに合わせて書き換えます。書き換えた内容は XML 全体に反映されます。次の情報が含まれます。
ワークフロー名、説明文、一意の識別子。識別子はワークフロー自身を表すものであって、これが属するフィーチャーを表すものではありません。
アセンブリに添えるコードと、ワークフロー アセンブリのクラス名。
ワークフローおよびこれが使うタスク フォームの場所。
ワークフロー定義 XML ファイルの作成方法については、「ワークフロー定義」を参照してください。
ファイルを保存します。
PostBuildActions.bat を使用してワークフロー テンプレートをインストールし、実際に使えるようにするには
Microsoft Visual Studio で、SharePoint Foundation ワークフロー プロジェクトを開きます。
[Solution Explorer] ウィンドウで、プロジェクトの題名部分を右クリックし、[プロパティ] を実行します。
[ビルド イベント] タブをクリックし、ビルド後のコマンド ラインの文字列を、ワークフロー ソリューションを展開するコマンドに書き換えてください。既定では 'NODEPLOY' となっています。
ワークフロー ソリューションを展開する場合、たとえば次のようなコマンドを記述することになるでしょう。
call "$(ProjectDir)\Deployment Files\PostBuildActions.bat" "$(ConfigurationName)" "$(ProjectDir)" "$(TargetDir)" "$(TargetName)"
DEPLOY > BuildActions.log
注意
NODEPLOY というパラメータが指定してあれば、コンパイルだけで展開はされません。
[ビルド] メニューの [ソリューションのビルド] をクリックします。
ワークフロー ソリューションのビルド後、Visual Studio は PostBuildActions バッチ ファイルを起動します。これは、ワークフロー ソリューション ファイルを SharePoint Foundation が稼働する適切な場所に移動し、ワークフロー機能が動作するようにする処理を自動化するものです。
デバッグ モードでビルドした場合、このバッチ ファイルは次のような処理を行います。
フィーチャー ディレクトリをサーバー上の適切な場所に作成します。
フィーチャー XML ファイルとワークフロー定義 XML ファイルを、フィーチャー ディレクトリにコピーします。
コンパイル済みのワークフロー アセンブリをグローバル アセンブリ キャッシュ (GAC) にコピーします。
フィーチャーが SharePoint Foundation で動作するようにします。
リリース モードでビルドした場合、このバッチ ファイルは .wsp ソリューション ファイルを作成、展開します。これは実稼働サーバーへの展開処理に使うもので、具体的には次のような処理を行います。
manifest.xml および wsp_structure.ddf のプレイスホルダ部分に、ワークフロー プロジェクトに応じて、次の情報が含まれます。
フィーチャー ディレクトリ名。
フィーチャー XML ファイル名。
ワークフロー定義 XML ファイル名。
コンパイル済みワークフロー アセンブリの名前と相対パス。
ワークフロー テンプレートを有効にすると、管理者はそのサイト上のリストやドキュメント ライブラリと関連付けることができるようになります。
また、ワークフローを特定のリストやドキュメント ライブラリと関連付けると、ワークフローをデバッグできます。