Project 2010 SDK のドキュメント

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

適用対象: Office 2010 | Project 2010 | Project Server 2010 | SharePoint Server 2010

このリファレンスの発行日: 2011 年 3 月 (Project 2010 SDK の 3 月更新向け)

Microsoft Project 2010 ソフトウェア開発キット (SDK) へようこそ。この SDK には、Project 2010 クライアントおよび Microsoft Project Server 2010 をカスタマイズし、エンタープライズプロジェクトマネジメント用の他のさまざまなデスクトップアプリケーションやビジネスアプリケーションと統合するときに役立つドキュメント、コードサンプル、操作方法に関する記事、およびプログラミングリファレンスが含まれています。

この記事は次のセクションで構成されます。

Project SDK の概要
- ダウンロード
- Project SDK の新機能
- 将来の SDK リリース
Project SDK のセクション

重要

カスタムソリューションはテスト環境で開発することをお勧めします。現在インストールされているバージョンよりも前のバージョンの Project Server 2010 用に開発されたソリューションは、更新されたリファレンスを使用して再コンパイルする必要があり、さらに変更が必要になることもあります。

Project SDK の概要

Project Server 2010 は、エンタープライズプロジェクトマネジメントソリューションを作成するためのプラットフォームです。Project Server 2010 のアーキテクチャは、Microsoft Office Project Server 2007 で導入されたプラットフォームを基礎にして、数多くの追加や改善が加えられています。Project Server 2010 開発プラットフォームの概要については、MSDN の「Getting Started with Development for Project 2010」を参照してください。

Project Server は、Microsoft .NET Framework 3.5 および Microsoft SharePoint Server 2010 Enterprise 版に基づいて構築されています。この SDK に含まれる記事とサンプルは、カスタムソリューションを開発するための開始点を提供するものであり、Project Server や Project Professional のすべてのプログラム機能が説明されているわけではありません。「Project Developer Center」に、Project に関する記事、ブログ、ビデオ、Web キャスト、操作方法に関するビジュアルな記事、およびその他のリソースへのリンクが含まれています。

Project 2010 SDK には、Project Server 2010、Project Web App、Microsoft Project Professional 2010、および Microsoft Project Standard 2010 の開発者向け情報が含まれています。SDK の記事は、Project 2010 の開発者や管理者が Project Server を評価して、カスタムソリューションの拡張および計画を実行できるようにすることを目的としています。

注意

Project Web App は Project Server 2010 の Web クライアントの名前です。Office Project Server 2007 および以前のバージョンでは、Web クライアントは Project Web Access と呼ばれています。

ご意見をお待ちしております。ご意見がある場合、または Project 2010 SDK 内のいずれかの記事についてのバグレポートがある場合は、SDK ダウンロードに含まれる PJ14SDK.chm ファイルの各ページの下部にあるリンクを使用して、電子メールメッセージを SDK チームに送信してください。また、MSDN オンラインライブラリの各ページでご意見を投稿することもできます。

ダウンロード

Project 2010 SDK のダウンロードを入手するには、「Project 2010 Reference: Software Development Kit (英語)」を参照してください。このダウンロードには、Project 2010 SDK の 2010 年 9 月の更新が含まれています。

Project 2010 SDK ダウンロードは、既定では [Program Files (x86)]\Microsoft SDKs\Project 2010 にインストールされます。コードアクセスセキュリティの問題を避け、Samples\Samples.exe 自己解凍型ファイル内の Visual Studio プロジェクトを直接使用できるようにするには、サンプルを別のディレクトリにコピーするか、Project 2010 SDK を別のディレクトリ (たとえば、C:\Project_SDK) にインストールしてください。インストールした SDK ダウンロードには、次のコンポーネントが含まれています。

Documentation サブディレクトリには、pj14SDK.chm ファイルと、MSDN 上でオンライン公開されている Project 2010 SDK トピックの 2010 年 9 月の更新が含まれています。

注意

MSDN ライブラリを調べて、各トピックの最下部にあるコミュニティコンテンツセクションで SDK の更新と追加を確認してください。オンラインバージョンの Project 2010 SDK は、SDK ダウンロードよりも頻繁に更新されます。
Documentation\Schemas サブディレクトリには、レポートデータベーススキーマリファレンス (pj14_ReportingDB.chm)、OLAP キューブスキーマ (OLAPCubeSchemas2010.xlsx)、Microsoft Project 2010 XML データ交換スキーマ (mspdi_pj14.xsd)、および PSI の Statusing メソッドのスキーマ (ChangeList.xsd および SetAssignmentWorkData.xsd) が含まれています。
Documentation\Intellisense サブディレクトリには、ドキュメント化された Project Server ライブラリおよび PSI サービスの Visual Studio IntelliSense 記述を提供する XML ファイルが含まれています。WCF サブディレクトリと WSDL サブディレクトリには、PSI の Windows Communication Foundation (WCF) サービスおよび ASMX サービスへの参照を設定するためのプロキシファイルが含まれています。また、プロキシアセンブリの更新を作成するためのスクリプトもあります。詳細については、ダウンロードに含まれている [ReadMe_Intellisense].htm ドキュメントを参照するか、または「WCF ベースのコードサンプルの前提条件」および「ASMX ベースのコードサンプルの前提条件」を参照してください。
Documentation\VBA Help サブディレクトリには、Project 2010 にある Visual Basic for Applications オブジェクトモデルのヘルプファイルの更新が含まれています。[ReadMe_VBAHelp].rtf ファイルには、2010 年 7 月および 9 月の更新での変更点が記述されています。
Documentation\REDIST.TXT サブディレクトリには、Microsoft.Office.Project.Server.Library.dll アセンブリをソリューションと一緒に再配布するためのライセンスが含まれています。
Samples\Samples.exe ファイルを実行して、以下のサブディレクトリとサンプルコードをインストールします。
- Samples\CustomizeProjectCenter には、「チュートリアル : PWA リボンのカスタマイズと JS グリッドのアクセス」に記載されている Microsoft Visual Studio 2010 ソリューションが含まれています。
- Samples\EventHandlers には、「[方法] Project Server のイベントハンドラーを作成し、イベントをログに記録する」に記載されている TestCreatingProject ソリューションが含まれています。
- Samples\Impersonation には、「[方法] WCF による偽装を使用する」に記載されているソリューションが含まれています。
- Samples\ManagedCodeReference には、次のメソッドのマネージコードリファレンスのコードサンプル用に WCF ベースのソリューションが含まれています。QueueCreateProject、CreateResources、ReadCustomFields2、ReadLookupTables、ReadProjectStatus、および QueueUpdateResourcePlan。これらのソリューションでは、「Project Server エラーコード」の「WCF のコード例」に記載されているエラーをリストするために WriteFaultOutput メソッドも使用しています。
- Samples\MultiAuthentication には、複数認証のための ASMX ベースと WCF ベースのソリューションが含まれています。これらは「ASMX ベースのコードサンプルの前提条件」および「WCF ベースのコードサンプルの前提条件」に記載されています。
- Samples\OLPSample には、Project Server の Object Link Provider を使用して、タスクを 1 つ以上の SharePoint リストアイテムにリンクする方法が示されています。
- Samples\ProjectGuide には、Project 2010 との互換性のために変更された、Office Project 2007 からの既定のプロジェクトガイドファイルが含まれています。
  
  Samples\ProjectGuide\ProjectGuideAddIn サブディレクトリには、Project 2010 においてカスタムのリボンタブでプロジェクトガイドファイルの使用方法を示すサンプルコードが含まれています。このサンプルコードでは Visual Studio 2010 の Office 開発ツールを使用しています。
- Samples\ProjTool_P14 には、ProjTool のソースコードが含まれています。ProjTool をコンパイルして使用するには、「Project Server 2010 での ProjTool テストアプリケーションの使用」を参照してください。
- Samples\PSIExtensions には、「Project Server 2010 の PSI 拡張機能を作成する」に記載されている Hello ソリューションおよび「[方法] RDB のユーザー設定フィールドを読み取る PSI 拡張を作成する方法」に記載されている ListProjects ソリューションが含まれています。
- Samples\RibbonCustomization には、「[方法] PWA のリボンを変更する」に記載されているソリューションが含まれています。
- Samples\VSTO には、「[方法] マネージコードを使用してカスタムコマンドをリボンに追加する」に記載されている、Project 2010 リボンを変更するための RibbonAddIn および RibbonAddIn_VB という Microsoft Visual Studio 2010 の Microsoft Office 開発ツールソリューションが含まれています。
  
  Samples\VSTO には、「[ウォークスルー] PWA 互換性を確認するマネージコードアドインを作成する」に記載されている Project2010EditableAddIn プロジェクトおよび IValidationRules プロジェクトも含まれています。
- Samples\WCFHelloProject には、「[ウォークスルー] WCF を使用して PSI アプリケーションを開発する」に記載されている Visual Studio ソリューションの 2 つの変化形が含まれています。
- Samples\WebParts には、「チュートリアル: JS グリッドを使用して Project Server Web パーツを作成する」に記載されている ListProjects Web パーツソリューションが含まれています。
  
  Samples\WebParts\ListProjects_Sorting には、JS グリッドコントロールで列の並べ替えを実装する ListProjects ソリューションが含まれています。
- Samples\Workflow\BranchingWorkflow には、「Project Server ワークフローを開発する」に記載されている BranchingWorkflow ソリューションが含まれています。
  
  Samples\Workflow\SampleProposal2 には、Project Server 2010 と一緒にインストールされるサンプル提案ワークフローの Visual Studio 2010 ソリューションが含まれています。
  
  Samples\Workflow\CustomActivity には、カスタムワークフローアクティビティを作成および使用するためのソリューションが含まれています。

Project SDK の新機能

Project 2010 SDK の主な目的は、PSI サービスのプログラム機能の概要とドキュメント、および Project クライアント (Project Standard 2010、Project Professional 2010、および Project Web App) と Project Server 2010 のカスタマイズに関する重要な部分の段階的な例を提供することです。ドキュメントの一部は完全ではなく、今後のリリースでコンテンツが追加される予定です。

重要

Project Server 2010 で、ネットワーク通信の基礎となるテクノロジが WCF に変更され、サービス参照 (.svc ファイル) および広範な機能向上を使用できるようになりました。ASMX Web サービス参照も WCF アーキテクチャに基づいています。Project Server 2010 で PSI Web サービス (ASMX ファイル) への参照を設定するには、?wsdl URL オプションをパスに追加する必要があります (たとえば、https://ServerName/ProjectServerName/_vti_bin/PSI/Resource.asmx?wsdl のようになります)。

Windows Vista または Windows 7 コンピューター上での開発は、フロントエンドの Project Server ASMX Web サービスを使用するか、または PSI プロキシアセンブリまたはプロキシファイルを介して WCF サービスを使用することによってサポートされます。Project Server のアプリケーションの開発の詳細については、「ASMX ベースのコードサンプルの前提条件」および「WCF ベースのコードサンプルの前提条件」を参照してください。

Visual Studio 2010 の使用による、Project Web App のワークフロー、Project Server Web パーツ、またはカスタマイズを含むソリューションの開発および展開は、Project Server コンピューター上でのみサポートされます。Project Server は、開発および展開に Windows Vista または Windows 7 からの別個のクライアントオブジェクトモデルを使用しません。

Project Server 2010 の新しいプログラム機能の概要については、「Project 2010 の開発者のための新機能」を参照してください。Project Server 2010 の主な新しい領域では、ワークフローおよびプロジェクト詳細ページ (PDP) を使用して、エンタープライズプロジェクトテンプレートに基づいてプロジェクト提案の作成および承認を管理します。詳細については、「ワークフローおよび需要管理」を参照してください。ワークフローと Web パーツの操作方法に関する一連の記事については、「Project Server ワークフローを開発する」および「チュートリアル: JS グリッドを使用して Project Server Web パーツを作成する」を参照してください。

Project 2010 SDK の 2010 年 5 月のリリース以降に追加された新しいトピックおよび大幅に更新されたトピックは、以下のとおりです。

「[方法] Project Server のイベントハンドラーを作成し、イベントをログに記録する」では、イベントハンドラーでの DataSet ともう 1 つの PSI サービスの使用方法、およびイベントログおよび ULS ログへの書き込み方法を示しています。
「[方法] PWA のリボンを変更する」には、Project Web App のプロジェクト詳細ページおよびタイムシートページのリボンのコントロールを追加、削除、変更、および無効化するコードの例が含まれています。
「Project Server 2010 での ProjTool テストアプリケーションの使用」では、Project Server 2010 のテストインストール上で、プロジェクトデータを表示、作成、および変更する方法と多言語の参照テーブルを作成する方法を示しています。
「Project Server のキャッシュ同期」では、Project Server におけるデータのキャッシュ、バージョンの追跡、およびプロジェクトなどのエンティティの削除の方法について説明します。
「ユーザー設定フィールドで式とマークを使用する」には、新しいセクション「リソースフィールド、プロジェクトフィールド、およびタスクフィールドへの式参照」と、マークが使用されている数式サンプルの変化形が含まれています。
「参照テーブルとエンタープライズユーザー設定フィールドを作成する」には、プロジェクトフラグユーザー設定フィールドおよび数値参照テーブルに関する新しいノートが含まれています。
「ユーザー設定フィールドとレポートデータベース」には、「ユーザー設定フィールドを使用する簡単なクエリ」という新しいセクションが含まれています。
「PSI 拡張機能の開発」には、以下のサブトピックが含まれています。
- 「Project Server 2010 の PSI 拡張機能を作成する」では、単純な Hello 拡張機能の作成方法を示しています。
- 「[方法] RDB のユーザー設定フィールドを読み取る PSI 拡張を作成する方法」では、レポートデータベースでカスタムストアドプロシージャを使用する ListProjects PSI 拡張機能の開発方法を示しています。また、この拡張機能をテストするための簡単な WCF ベースアプリケーションの作成方法も示しています。
「Project Server Web パーツの開発」では、Project Server 用の Web パーツを開発するときの推奨方法を説明してます。次のサブトピックが含まれています。
- 「チュートリアル: JS グリッドを使用して Project Server Web パーツを作成する」では、ListProjects PSI 拡張機能を使用し、JS グリッドコントロールでデータを表示しています。ListProjects Web パーツは、Project Web App ページ、PDP、またはプロジェクトサイトページにインストールできます。
「Project Server ワークフローを開発する」では、Project Server ワークフローの作成に Microsoft SharePoint Designer 2010 を使用できない理由を説明しています。また、次の 2 つのサブトピックが変更されています。
- 「[方法] Project Server ワークフローをインストールおよびテストする」には、「Project Server ワークフローのデバッグ」という新しいセクションが含まれています。
- 「[方法] Project Server ワークフローを展開する」には、「ファーム上のワークフローを構成する」という新しいセクションが含まれています。
「Project Server エラーコード」には、エラーのリストを取得するための WCF ベースのコード例が含まれています。
「Project Server Interface (PSI) の概要」には、更新されたトピック「WCF と PSI の概要」と、新しいトピック「[方法] WCF サービスのプロキシアセンブリを作成する」が含まれています。
「[方法] WCF による偽装を使用する」には、偽装を避けるために UpdateStatus を使用することについてのノートが含まれています。
「[ウォークスルー] WCF を使用して PSI アプリケーションを開発する」および「[方法] WCF による偽装を使用する」は両方とも更新されています。

注意

JS グリッドコントロールの大部分のドキュメントは Microsoft SharePoint 2010 Software Development Kit (SDK) に含まれています (ただし、JS グリッドコントロールのサンプルアプリケーションが記載されている Project 2010 SDK の 2 つのトピックは除きます)。SharePoint 2010 SDK では、JS グリッドコントロール機能の概要、基本グリッドとピボットグリッドの作成方法、および JS グリッドコントロール実装のヒントが説明されています。詳細については、「JS グリッドコントロール」を参照してください。マネージコードリファレンスについては、「Microsoft.SharePoint.JSGrid Namespace」を参照してください。

PSI サービスの DataSet トピックの一部、および Microsoft.Office.Project 名前空間のトピックには、最小限のドキュメントのみが用意されています。開発者に関連するドキュメントを見つける方法については、「PSI リファレンスの概要」の「PSI リファレンスの使用」を参照してください。

将来の SDK リリース

将来の Project 2010 SDK リリースには、Project Professional 2010 および Project Server 2010 開発向けの操作方法に関するトピックと、PSI サービスクラスおよび Project Server ライブラリの追加ドキュメントが組み込まれる予定です。

Project SDK のセクション

Project 2010 SDK には最上位のセクションが 2 つあります。

「全般的な参照情報」セクションには、概念に関する記事と操作方法に関する記事が含まれています。
「Project Server 2010 のクラスライブラリと Web サービス参照」セクションでは、パブリックアセンブリと PSI サービスのオブジェクトモデルが説明されています。

「全般的な参照情報」セクションの内容は、以下のとおりです。

「Project 2010 の開発者のための新機能」では、Project 2010 の主な新しいプログラム機能が説明されています。
「開発者向け Project 2010 の概要」には、Project Server アーキテクチャに関する記事、ワークフローと需要管理の概要、ユーザー設定フィールドに関する情報、Project Server 開発のシナリオ、および VBA と Visual Studio 2010 の Office 開発ツールの使用による Project クライアントのプログラミングに関する記事が含まれています。
「PSI の概要」には、PSI の ASMX インターフェイスおよび WCF インターフェイスの概要と、PSI 拡張機能の開発方法に関する記事が含まれています。また、WCF で PSI をプログラミングするためのプロキシアセンブリの作成方法を説明する記事も含まれています。リリースバージョンのプロキシアセンブリとソースは Project 2010 SDK ダウンロードに含まれています。
「Project Server 2010 のプログラミング作業」には、Project Server ワークローの開発と展開、WCF による開発、偽装アプリケーションの作成、Project Web App リボンのカスタマイズ、JS グリッドコントロールでのデータとイベントの使用、Project Server Web パーツの開発、およびイベントハンドラーの開発に関する操作方法の記事が含まれています。このセクションには、ProjTool テストアプリケーションの概要が含まれています。
「Project プログラミングリファレンス」には、Project Server 2010 の PSI リファレンスの概要、ASMX ベースおよび WCF ベースのコードサンプルの開発手順、Project Server エラーコードの表、Project 2010 の XML スキーマ、および VBA オブジェクトモデルの変更内容の表が含まれています。

注意

Project Server 2010 と統合するアプリケーションを開発および展開する場合の要件は、以下のとおりです。

開発用コンピューター、Project Server コンピューター、および展開用コンピューターに Microsoft .NET Framework 3.5 SP1 をインストールする必要があります。SP1 リリースがインストールされているかどうかを判断するには、Windows コントロールパネルの [プログラムと機能] を開きます。
Windows Workflow Foundation (WF) を使用するソリューションに Microsoft Visual Studio 2008 を使用することはできますが、サポートされていないため、現在はドキュメント化されていません。ワークフローソリューションの開発および展開には Visual Studio 2010 を使用することを強くお勧めします。
新しい開発プロジェクトの場合、Visual Studio 2010 は既定では .NET Framework 4.0 をインストールして使用します。SharePoint Foundation 2010、SharePoint Server 2010、Project Server 2010 の各ソリューション、および Project 2010 のアドインのソリューションには, .NET Framework 3.5 SP1 が必要です。.NET Framework 3.5 と .NET Framework 4.0 は同じコンピューター上にインストールできます。Visual Studio プロジェクトを作成する場合は、[新しいプロジェクト] ダイアログボックスのドロップダウンリストで [.NET Framework 3.5] を選択します。また、プロジェクトの [プロパティ] ウィンドウの [アプリケーション] タブで [対象のフレームワーク] を選択することもできます。

Share via