SharePoint ホスト型の SharePoint アドインを展開してインストールするDeploy and install a SharePoint-hosted SharePoint Add-in

これは、SharePoint ホスト型の SharePoint アドインの開発の基本に関する記事のシリーズの 2 番目です。トピック「SharePoint アドイン」と、このシリーズの概要記事をよく理解しておいてください。This is the second in a series of articles about the basics of developing SharePoint-hosted SharePoint Add-ins. You should first be familiar with the topic SharePoint Add-ins and the overview article in this series:


SharePoint ホスト型アドインに関するこのシリーズを続けて学習してきた方は、このトピックでも引き続き使用できる Visual Studio ソリューションをお持ちです。If you have been working through this series about SharePoint-hosted add-ins, you have a Visual Studio solution that you can use to continue with this topic. また、SharePoint_SP-hosted_Add-Ins_Tutorials でリポジトリをダウンロードし、BeforeColumns.sln ファイルを開くこともできます。You can also download the repository at SharePoint_SP-hosted_Add-Ins_Tutorials and open the BeforeColumns.sln file.

ユーザーがアドインを展開してインストールする方法を理解していると、SharePoint ホスト型 SharePoint アドインの開発が容易になります。このため、この記事では、コーディングを中断して、アドイン カタログの作成と使用方法を確認し、次に作業中のアドインをインストールする方法を確認します。You'll find it a lot easier to develop SharePoint-hosted SharePoint Add-ins if you are familiar with how users deploy and install your add-ins. So, in this article, we'll take a brief break from coding to create and use an add-in catalog, and then install the add-in you've been working on.

アドイン カタログの作成Create an add-in catalog

  1. Office 365 サブスクリプションに管理者としてサインインします。Sign in to your Office 365 subscription as an administrator. アドイン起動ツール アイコンを選択し、Admin タイルを選択します。Select the add-in launcher icon, and then select the Admin add-in.

    図1. Office 365 アドイン起動ツールFigure 1. Office 365 add-in launcher

    Office 365 アプリ起動ツール

  2. 管理センターで、[管理センター] ノードを作業ウィンドウで展開し、[SharePoint] を選択します。In the Admin Center, expand the Admin node in the task pane, and then select SharePoint.

  3. SharePoint 管理センターの作業ウィンドウで、[アプリ] を選択します。In the SharePoint Admin Center, select add-ins in the task pane.

  4. [アプリ] ページで、[アプリ カタログ] を選択します。On the apps page, select App Catalog. (既にサブスクリプションにアドイン カタログのサイト コレクションがある場合はそれが開き、作業は終了します。(If there is already an add-in catalog site collection in the subscription, it opens and you are finished. サブスクリプションに複数のアドイン カタログを作成することはできません。)You cannot create more than one add-in catalog in a subscription.)

  5. [アプリ カタログ サイト] ページで、[OK] を選択して既定のオプションを受け入れ、新しいアプリ カタログ サイトを作成します。On the App Catalog Site page, choose OK to accept the default option and create a new app catalog site.

  6. [アプリ カタログ サイト コレクションの作成] ダイアログで、アプリ カタログ サイトのタイトルと Web サイト アドレスを指定します。In the Create Add-in Catalog Site Collection dialog, specify the title and website address of your add-in catalog site. SharePoint 管理センターで、タイトルと URL に "catalog" を含めることで、覚えやすく見分けやすいものにすることをお勧めします。We recommend that you include "catalog" in the title and URL to make it memorable and distinguishable in the SharePoint Admin Center.

  7. [タイム ゾーン] を指定し、自分を [管理者] として設定します。Specify a Time Zone and set yourself as the Administrator.

  8. [記憶域のクォータ] を、指定可能な最小の値 (現在は 110 ですが、変更される可能性があります) に設定します。これは、このサイト コレクションにアップロードするパッケージがとても小さいためです。Set the Storage Quota to the lowest possible value (currently 110, but that can change), because the add-in packages you upload to this site collection are very small.

  9. [サーバー リソース クォータ] を 0 (ゼロ) に設定し、[OK] を選択します。Set the Server Resource Quota to 0 (zero), and then select OK. (サーバー リソース クォータは、パフォーマンスが低いサンドボックス ソリューションのスロットルに関連していますが、このアドインのカタログ サイトにはサンドボックス ソリューションをインストールしません。)(The server resource quota is related to throttling poorly performing sandboxed solutions, but you won't be installing any sandboxed solutions on your add-in catalog site.)

サイト コレクションの作成時に、SharePoint によって SharePoint 管理センターに戻されます。As the site collection is being created, SharePoint takes you back to the SharePoint Admin Center. 数分後、コレクションが作成されたことがわかります。After a few minutes, you'll see that the collection has been created.

アドインをパッケージ化し、カタログにアップロードするPackage the add-in and upload it to the catalog

  1. Visual Studio ソリューションを開き、ソリューション エクスプローラーでプロジェクト ノードを右クリックして [発行] を選択します。Open the Visual Studio solution, right-click the project node in Solution Explorer, and then select Publish.

  2. [発行] ウィンドウで [アドインをパッケージ化する] を選択します。In the Publish pane, select Package the add-in. アドインがパッケージ化され、ソリューションの \bin\debug\web.publish\ フォルダーに *.app ファイルとして保存されます。The add-in is packaged and saved as an *.app file in the solution's \bin\debug\web.publish\ folder.

  3. ブラウザーでアドイン カタログ サイトを開き、ナビゲーション バーの [SharePoint アドイン] を選択します。Open your add-in catalog site in a browser, and then select SharePoint Add-ins in the navigation bar.

  4. SharePoint アドイン カタログは、標準の SharePoint アセット ライブラリです。The SharePoint Add-ins catalog is a standard SharePoint asset library. ファイルを SharePoint ライブラリにアップロードする方法のいずれかを使用して、これにアドイン パッケージをアップロードします。Upload the add-in package to it using any of the methods of uploading files to SharePoint libraries.

エンド ユーザーとしてアドインをインストールするInstall the add-in as end users do

  1. SharePoint Online サブスクリプション内の任意の Web サイトに移動し、[サイト コンテンツ] ページを開きます。Navigate to any website in the SharePoint Online subscription and open the Site Contents page.

  2. [アドインの追加] を選択し、[使用できるアドイン] ページを開きます。Select add an add-in to open the Your Add-ins page.

  3. [追加できるアドイン] セクションで [社員オリエンテーション] アドインを見つけて、そのタイルを選択します。Find the Employee Orientation add-in in the Add-ins you can add section, and select its tile.

  4. 同意ダイアログで [信頼する] を選択します。Select Trust It in the consent dialog. [サイト コンテンツ] ページが自動的に開き、アドインがインストール中を示す表記とともに表示されます。The Site Contents page automatically opens and the add-in appears with a notation that it is installing. インストール後、ユーザーはアドインを実行するタイルを選択できます。After it installs, users can select the tile to run the add-in.

アドインを削除するRemove the add-in

Visual Studio で同じ SharePoint アドインを継続して補正するには (「次の手順」を参照してください)、次の手順でアドインを削除します。To continue enhancing the same SharePoint Add-in in Visual Studio (see Next steps), remove the add-in with these steps:

  1. [サイト コンテンツ] ページで、アドイン上にカーソルを移動すると、吹き出しボタン [...] が表示されます。In the Site Contents page, move the cursor over the add-in so that the callout button ... appears.

  2. 吹き出しボタンを選択し、吹き出しで [削除] を選択します。Select the callout button, and then select REMOVE on the callout.

  3. アドイン カタログ サイトに戻り、ナビゲーション バーの [SharePoint アドイン] を選択します。Navigate back to your add-in catalog site and select SharePoint Add-ins in the navigation bar.

  4. アドインを強調表示し、リストのすぐ上のタスク バーで [管理] を選択し、管理メニューの [削除] を選択します。Highlight the add-in and select manage on the task bar just above the list, and then select Delete on the manage menu.

次の手順Next steps

より高度なトピックに進む前に、SharePoint ホスト型アドインに関するこの一連の記事を読み続けることを強くお勧めします。We strongly recommend that you continue with this series about SharePoint-hosted add-ins before you go on to the more advanced topics. 次は、「SharePoint ホスト型の SharePoint アドインにカスタム列を追加する」のコーディングに戻りましょう。Next, we get back to coding in Add custom columns to a SharePoint-hosted SharePoint Add-in.