構成要素: ソリューション

[アーティクル]
06/15/2015

最終更新日: 2011年4月22日

適用対象: SharePoint Foundation 2010

この記事の内容
ソリューションのオブジェクトモデル
ソリューションに使用される XML
ソリューション関連のトピック
ソリューションの詳細情報

Microsoft SharePoint Foundation ソリューションフレームワークには、SharePoint Foundation への拡張をソリューションパッケージ (.wsp ファイル) にバンドルする手段が用意されています。ソリューションパッケージは, .wsp 拡張子付きの CAB ファイルに格納されます。このパッケージには、フィーチャー、サイト定義、Web パーツ、およびアセンブリを含めることができます。ソリューションフレームワークは、ソリューションを展開するための統合インフラストラクチャになります。ソリューションフレームワークをフィーチャーと組み合わせて使用すると、指定した範囲で機能を有効または無効にすることができます。フレームワークには、既存のソリューションをサーバーファーム内の別のサーバーに展開およびアップグレードするためのメカニズムもあります。より広範囲なユーザーをサポートするためにソリューションをローカライズすることもできます。

ソリューションには、サンドボックスとファームの 2 つの種類があります。

サンドボックスソリューションは、サイトコレクション管理者がサイトコレクションのソリューションギャラリーに展開できます。これらの種類のソリューションでは、サーバーオブジェクトモデルのサブセットにアクセスすることができ、ソリューションはセキュリティで制限されたコンテキストで実行されるので、ソリューションのコードを分離して監視することができます。サンドボックスソリューションは、ソリューションの検証機能を使用して検証できます。ファーム管理者は、サンドボックスソリューションを有効または無効にすることに加えて、使用量の制限を設定し、悪意のあるコードからファーム内のサーバーを保護することができます。

注意

"サンドボックス" の代わりに、"ユーザー" という表現が使用されることがあります。特に、サンドボックスソリューションシステムのオブジェクトモデルについてはそうです。たとえば、システムの主要な API の名前空間は Microsoft.SharePoint.UserCode であり、サンドボックスソリューションの実行を管理するサービスは、フロントエンド Web サーバーの Windows [サービス] ダイアログで [SharePoint 2010 ユーザーコードホスト] と呼ばれます。これは、"サンドボックスソリューション" と呼ばれるようになる前の名前を反映しています。
ファームソリューションは、ファーム管理者によってフロントエンド Web サーバーに展開されます。これらのソリューションでは、サーバーオブジェクトモデルに無制限でアクセスできます。このソリューションには、使用量の制限は適用されません。

ソリューションのオブジェクトモデル

ソリューションは SharePoint Foundation のオブジェクトモデルを使用して管理できます。これにはアップグレード、取り消し、および展開の操作が含まれます。オブジェクトモデルを使用して、プログラムによって使用量の制限を設定することや、サンドボックスソリューションの検証機能を定義することもできます。

すべてのソリューションのオブジェクトモデル

SPSolution – サーバーファーム上のソリューションを表します。
SPSolutionCollection – SPSolution オブジェクトのコレクションを表します。
SPSolutionLanguagePack – ソリューションの言語パックを表します。
SPSolutionLanguagePackCollection – SPSolutionLanguagePack オブジェクトのコレクションを表します。

サンドボックスソリューションのオブジェクトモデル

SPUserSolution – サンドボックスソリューションを表します。
SPUserSolutionCollection – SPUserSolution オブジェクトのコレクションを表します。
SPBlockedSolution – ブロックされたサンドボックスソリューションを表します。
SPSolutionValidator – サンドボックスソリューションの検証機能の作成に使用される基本クラスを表します。

ソリューションに使用される XML

ソリューションの構成には、manifest.xml というファイル名のソリューションマニフェストを使用します。ソリューションマニフェストは、ソリューションパッケージのルートに格納されています。このファイルで、ソリューションパッケージに含めるフィーチャー、サイト定義、リソース、およびアセンブリを定義します。ソリューションマニフェストに含まれていないファイルは一切処理されません。次にソリューションマニフェストの例を示します。

<Solution SolutionId="SolutionGuid" xmlns="https://schemas.microsoft.com/sharepoint/">
  <FeatureManifests>
    <FeatureManifest Location="FeatureLibrary\feature.xml"/>
  </FeatureManifests>
  <TemplateFiles>
    <TemplateFile Location="ControlTemplates\Template.ascx"/>
  </TemplateFiles>
  <RootFiles> 
    <RootFile Location="ISAPI\MyWebService.asmx">
  </RootFiles>
  <Assemblies>
    <Assembly DeploymentTarget="GlobalAssemblyCache" Location="ms.samples.sharepoint.myFeature.dll"/>
  </Assemblies>
</Solution>

ソリューションパッケージを作成するときに、ディスク上のファイルの場所とソリューションパッケージのファイルをマップする DDF ファイルも作成できます。SharePoint Foundation ソリューションの作成には、Microsoft Visual Studio 2010 の SharePoint 開発者ツールを使用することをお勧めします。次に DDF ファイルの例を示します。

;
.OPTION EXPLICIT     ; Generate errors 
.Set CabinetNameTemplate=MySolutionFile.wsp 
.set DiskDirectoryTemplate=CDROM ; All cabinets go in a single directory
.Set CompressionType=MSZIP;** All files are compressed in cabinet files
.Set UniqueFiles="ON"
.Set Cabinet=on
.Set DiskDirectory1=Package
build\manifest.xml manifest.xml
build\MySolutionFile\feature.xml MySolutionFile\feature.xml
...