このチュートリアルでは、既存の SharePoint サイトから Visual Studio SharePoint プロジェクトに項目をインポートする方法について説明します。
このチュートリアルでは、次のタスクについて説明します。
カスタム サイト列 (フィールドとも呼ばれます) を追加して SharePoint をカスタマイズする。
SharePoint サイトを .wsp ファイルにエクスポートする。
.wsp のインポート プロジェクトを使用して、Visual Studio SharePoint に .wsp ファイルをインポートする。
-
注意
お使いのマシンで、Visual Studio ユーザー インターフェイスの一部の要素の名前や場所が、次の手順とは異なる場合があります。 これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。 詳細については、「Visual Studio の設定」を参照してください。
必須コンポーネント
このチュートリアルを実行するには、次のコンポーネントが必要です。
サポート対象エディションの Microsoft Windows および SharePoint。 詳細については、「SharePoint ソリューションの開発要件」を参照してください。
Visual Studio 2010.
SharePoint サイトのカスタマイズ
この例では、SharePoint サブサイトの作成とカスタマイズを行います。新しいサイト内の列を追加し、後で使用するためのサブサイトを別途作成します。 その後、1 つ目のサブサイトを .wsp ファイルにエクスポートした後、.wsp インポート プロジェクトを使用して、カスタム サイト内の列を 2 つ目のサブサイトにインポートします。
SharePoint サイトの作成とカスタマイズを行うには
Web ブラウザーで SharePoint サイトを開きます (http://<システム名>/SitePages/Home.aspx など)。
[サイトの操作] タブの [新しいサイト] をクリックして、メインの SharePoint サイトに対してサブサイトを作成します。
[サイトの作成] ダイアログ ボックスで、[空のサイト] をクリックします。
[タイトル] ボックスに「Site Column Test 1」と入力し、[URL 名] ボックスに「columntest1」と入力します。他の設定は既定値のままにして、[作成] をクリックします。
サイトが作成されたら、ブラウザーでメインのサイト (http://<システム名>/SitePages/Home.aspx) に戻ります。
再度 [サイトの操作] タブで [新しいサイト] をクリックし、[空のサイト] をクリックして、メインの SharePoint サイトに対して空のサブサイトを作成します。
[タイトル] ボックスに「Site Column Test 2」と入力し、[URL 名] ボックスに「columntest2」と入力します。他の設定は既定値のままにして、[作成] をクリックします。
再度 1 つ目のサブサイト (http://<システム名>/columntest1/SitePages/Home.aspx) に移動します。
[サイトの操作] タブの [サイトの設定] をクリックし、[サイトの設定] ページを表示します。
[ギャラリー] セクションの [サイト内の列] リンクをクリックします。
[サイト内の列ギャラリー] ページの一番上にある [作成] ボタンをクリックします。
[列名] ボックスに「Test Column」と入力します。 他の既定値はそのままにして、[OK] をクリックします。
[サイト内の列ギャラリー] の [ユーザー設定の列] という見出しの下に、[Test Column] 列が表示されます。
SharePoint サイトのエクスポート
次に、Visual Studio SharePoint プロジェクトにインポートする SharePoint アイテムや SharePoint 要素が含まれた SharePoint セットアップ (.wsp) ファイルを入手します。 まだ .wsp ファイルが手元にない場合は、既存の SharePoint サイトから作成する必要があります。 この例では、既定の SharePoint サイトを .wsp ファイルにエクスポートします。
重要
次の手順を実行する途中でランタイム エラーが発生する場合は、SharePoint サイトへのアクセス権があるシステム上で実行してください。
既存の SharePoint サイトをエクスポートするには
SharePoint で、[サイトの操作] タブの [サイトの設定] をクリックし、[サイトの設定] ページを表示します。
[サイトの設定] ページの [サイトの操作] セクションの [テンプレートとしてサイトを保存] リンクをクリックします。
[ファイル名] ボックスに「ExampleSite」と入力し、[テンプレート名] ボックスに「Example Site」と入力します。
この例では、[コンテンツを含む] チェック ボックスをオフのままにします。
このボックスをオンにした場合、Visual Studio によってすべてのリストおよびドキュメント ライブラリに加えて、その内容が .wsp ファイルに保存されます。 場合によっては便利な機能ですが、この例では必要ありません。
操作が正常に完了したら、[ユーザー ソリューション ギャラリー] リンクをクリックして .wsp ファイルを表示します。
[サイトの設定] タブの [サイトの操作] をクリックし、[サイト コレクションの管理] セクションの [トップ レベルのサイト設定に移動] をクリックして、[ギャラリー] セクションの [ソリューション] リンクをクリックすると、ソリューション ギャラリー ページはいつでも表示できます。
ソリューション ギャラリーで、[ExampleSite] リンクをクリックして、[ファイルのダウンロード] ダイアログ ボックスを表示します。
[ファイルのダウンロード] ダイアログ ボックスの [保存] ボタンをクリックして、システムにファイルを保存します。
.wsp ファイルのインポート
再利用する項目 (カスタム サイト内の Test Column 列) を含んだ .wsp ファイルが用意できたので、これをインポートして .wsp ファイルにアクセスします。
.wsp ファイルをインポートするには
Visual Studio で、[ファイル] メニューの [新規作成] をポイントし、[新しいプロジェクト] をクリックして、[新しいプロジェクト] ダイアログ ボックスを表示します。
[Visual C#] または [Visual Basic] の [SharePoint] ノードを展開して、[2010] をクリックします。
[テンプレート] ペインで、[SharePoint ソリューション パッケージのインポート] をクリックし、プロジェクト名を WspImportProject1 のままにして、[OK] をクリックします。
SharePoint カスタマイズ ウィザードが表示されます。
[デバッグのサイトとセキュリティ レベルの指定] ページで、先ほど作成した 2 つ目の SharePoint サブサイトの URL を入力します。そのサブサイトに、新しいカスタム フィールド項目 http://<システム名>/columntest2 が追加されます。
[この SharePoint ソリューションの信頼レベル] セクションの選択は [サンドボックス ソリューションとして配置する] のままにします。
[新しいプロジェクト ソースの指定] ページで、先ほど .wsp ファイルを保存したシステム上の場所に移動し、[次へ] をクリックします。
注意
このページで [完了] をクリックすると、.wsp ファイル内の使用できるすべての項目がインポートされます。
[インポートする項目の選択] ボックスで、[Test Column] を除くすべての項目を一覧から消去し、[完了] をクリックします。
多数の項目が一覧表示されるため、いったん Ctrl キーを押しながら A キーを押して一覧内のすべての項目を選択し、Space キーを押してすべての項目をオフにしてから、[Test Column] 項目のチェック ボックスをオンにするのが簡単です。
インポート操作が完了すると、"フィールド" という名前のフォルダーを含んだ WspImportProject1 という名前の新しいプロジェクトが作成されます。 このフォルダーには、カスタム サイト内の列 Test Column と、その定義ファイル Elements.xml が格納されます。
プロジェクトの配置
最後に、先ほど作成した 2 つ目の SharePoint サブサイトに WspImportProject1 を配置して、カスタム サイト内の列を表示します。
プロジェクトを配置するには
Visual Studio で F5 キーを押して、.wsp のインポート プロジェクトを実行し、配置します。
[サイトの操作] タブの [サイトの設定] をクリックし、[サイトの設定] ページを表示します。
[ギャラリー] セクションの [サイト内の列] リンクをクリックします。
下へスクロールして [Custom Columns] セクションを表示します。
1 つ目の SharePoint サイトからインポートしたカスタム サイト内の列が一覧に表示されます。
参照
概念
Web パーツまたはアプリケーション ページの再利用できるコントロールの作成