VSTO みちしるべ ～道標～

今回は VSTO からのワークフローの開始について取り上げたいと思います。

VSTO を利用した Office ドキュメントをワークフローのフロントエンドとして利用する場合、リボンUIや操作ウィンドウからワークフローを操作するようなケースがあるとは思います。

今後、このようなネタは増えてくると思いますが、これもあまりにも情報が少なくいため、（日本語だけでなく、英語も少ないです。）一緒に仕事をされたパートナー様が非常に苦労されてました。

実はこのネタですが、既にテンプレートを作成している場合はゴッド松崎さんが公開されている以下のページがあります。

SharePoint の Workflow 用 Web Service を使ってシステム連携をおこなう

http://blogs.msdn.com/tsmatsuz/archive/2007/08/27/part-6-sharepoint-workflow-web-service.aspx

ここでは少し切り口を変えて、アイテム単位の既定の承認ワークフローを VSTO から利用したい場合についてご紹介したいと思います。

 そもそも、各ライブラリやリストにはいくつかの既定のワークフローが用意されています。

アイテム単位の既定の承認ワークフローのメリットですが、既定の承認ワークフローの利用は任意の承認者を順次処理したり、任意に承認者を追加/更新したい場合などがあげられると思います。

ここでは任意の承認者を順次承認者に登録する処理の手順をご紹介します。

手順としては以下のコードを VSTO のプロジェクトの任意の部分に貼り付けます。

※一応、該当ドキュメントをライブラリに保存した後の処理を想定しています。

private void button1_Click(object sender, EventArgs e)

   {

       //ワークフロー Web サービスの利用

       Workflow ws = new Workflow();

       ws.Url = "http://<SharePoint のサーバーとライブラリ名>/_vti_bin/Workflow.asmx";

       ws.Credentials = CredentialCache.DefaultCredentials;

       //ワークフローアイテムの選択

       XmlNode wfTemplatesXML = ws.GetTemplatesForItem("SharePoint のライブラリ上のファイル名");

       //ワークフローパラメーターの定義

       XmlNamespaceManager nsmgr =  new XmlNamespaceManager(wfTemplatesXML.OwnerDocument.NameTable);

       nsmgr.AddNamespace("wf","http://schemas.microsoft.com/sharepoint/soap/workflow/");

       nsmgr.AddNamespace("my", "http://schemas.microsoft.com/office/infopath/2003/myXSD");

       XmlNode dataNode = wfTemplatesXML.SelectSingleNode("//wf:AssociationData/wf:string", nsmgr);

       XmlDocument doc = new XmlDocument();

       doc.LoadXml(dataNode.InnerText);

       //承認者1の指定

       XmlNode nodeReviewers = doc.SelectSingleNode("//my:myFields/my:Reviewers", nsmgr);

       XmlElement nodeParson_01 = doc.CreateElement
("my:Person", "http://schemas.microsoft.com/office/infopath/2003/myXSD");

       XmlElement nodeDisplayName_01 = doc.CreateElement("my:DisplayName","http://schemas.microsoft.com/office/infopath/2003/myXSD");

       XmlElement nodeAccountId_01 = doc.CreateElement("my:AccountId", "http://schemas.microsoft.com/office/infopath/2003/myXSD");

       XmlElement nodeAccountType_01 = doc.CreateElement("my:AccountType", "http://schemas.microsoft.com/office/infopath/2003/myXSD");

       nodeDisplayName_01.InnerText = @"ドメイン名￥ユーザー名";

       nodeAccountId_01.InnerText = @"ドメイン名￥ユーザー名";

       nodeAccountType_01.InnerText = "User";

       nodeParson_01.AppendChild(nodeDisplayName_01);

       nodeParson_01.AppendChild(nodeAccountId_01);

       nodeParson_01.AppendChild(nodeAccountType_01);

       nodeReviewers.AppendChild(nodeParson_01);

       //承認者２の指定

       XmlElement nodeParson_02 = doc.CreateElement("my:Person", "http://schemas.microsoft.com/office/infopath/2003/myXSD");

       XmlElement nodeDisplayName_02 = doc.CreateElement("my:DisplayName","http://schemas.microsoft.com/office/infopath/2003/myXSD");

       XmlElement nodeAccountId_02 = doc.CreateElement("my:AccountId","http://schemas.microsoft.com/office/infopath/2003/myXSD");

       XmlElement nodeAccountType_02 = doc.CreateElement("my:AccountType","http://schemas.microsoft.com/office/infopath/2003/myXSD");

       nodeDisplayName_02.InnerText = @"<ドメイン名￥ユーザー名>";

       nodeAccountId_02.InnerText = @"ドメイン名￥ユーザー名";

       nodeAccountType_02.InnerText = "User";

       nodeParson_02.AppendChild(nodeDisplayName_02);

       nodeParson_02.AppendChild(nodeAccountId_02);

       nodeParson_02.AppendChild(nodeAccountType_02);

       nodeReviewers.AppendChild(nodeParson_02);

       XmlNode idNode = wfTemplatesXML.SelectSingleNode("//wf:WorkflowTemplateIdSet", nsmgr);

　　　//テンプレートの GUID を指定
　　//SharePoint Manager の利用により取得

      Guid templateID = new Guid("任意のGUID");

      //ワークフローの開始

      ws.StartWorkflow("SharePoint のライブラリ上のファイル名",templateID, doc.DocumentElement)

　　　}

コードの解説です。

 //ワークフローパラメーターの定義

ここではワークフローWebサービスに渡すパラメータの定義をおこないます。

ワークフローパラーメーターは StartWorkflow メソッドの第３引数になります。 

//承認者1の指定 と //承認者2の指定

StartWorkflow メソッドに渡す実際のパラメータになります。

他のパラメータも渡すことができますが、他のパラメータの確認は以下が参考になるかと思います。

Using Smart Clients to Communicate with Workflows in Windows SharePoint Services 3.0

http://msdn.microsoft.com/en-us/library/cc296356.aspx