Discoveries InSite IntelliReport...ConnectionIDの用意...
Transcript of Discoveries InSite IntelliReport...ConnectionIDの用意...
Discoveries InSite IntelliReport
アドイン設置手順書
サイトコレクション編
2018 年 1 月 22 日
ディスカバリーズ株式会社
IntelliReport アドイン設置手順書(サイトコレクション編)
Discoveries,Inc.
目次
1. 事前準備 ............................................................................................................... 1
作業端末のシステム要件 ......................................................................................... 1
アカウント要件 ..................................................................................................... 1
ConnectionID の用意 ......................................................................................... 1
2. 実施手順 ............................................................................................................... 2
サイトコレクション(サイト)にアプリを追加する ..................................................................... 2
アプリケーションインストール ........................................................................................ 5
ConnectionID を設定する ..................................................................................... 6
トップレベルサイトに新 UI 版アプリを追加する ................................................................... 7
サブサイトに新 UI 版アプリを追加する ........................................................................... 9
3. Appendix ............................................................................................................ 11
サブサイトのアクセスログ取得を停止する ....................................................................... 11
トップレベルサイトのアクセスログ取得を停止する ............................................................... 12
アプリのアンインストール手順 .................................................................................... 13
インテリレポートアプリの有効期限を更新する .................................................................. 15
4. 補足 ................................................................................................................... 16
IntelliReport アドイン設置手順書(サイトコレクション編)
1/16
Discoveries,Inc.
1. 事前準備
本書の実施前に、別紙「01_IntelliReport_Add-ins_InstallationManual_SP.pdf:IntelliReport アドイン設
置手順書(SharePoint 管理センター編)」の手順を完了している必要があります。
作業端末のシステム要件
SharePoint Online のシステム要件に準拠します。
アカウント要件
本書の手順を実施するには、アクセスログ取得対象とするサイトコレクション(サイト)の管理者権限が必要です。
ConnectionID の用意
取得したアクセスログを管理する【データ保存区分】単位に、ConnectionID を発行します。
ConnectionID は、インテリレポートのお申し込みから 3 営業日以内に、弊社サポートデスクよりメールでご連絡します。
お客様のすべての ConnectionID を管理できる【全体管理者】アカウントは、初回のみ弊社が作成し、アカウント情報
をサポートデスクよりメールでご連絡します。
各 ConnectionID のデータを管理できるアカウント(これを【インテリレポート管理者】と呼びます。)は、全体管理者アカ
ウントを使用してお客様が作成してください。
詳細については、別紙「04_UserManual.pdf:インテリレポートユーザーマニュアル」をご参照ください。
※ユーザーマニュアルは、インテリレポートサイト<https://intelli.report>の左下メニュー「マニュアル」からダウンロードす
ることが可能です。
IntelliReport アドイン設置手順書(サイトコレクション編)
2/16
Discoveries,Inc.
2. 実施手順
本章では、インテリレポートアプリの設置手順について説明します。
サイトコレクション(サイト)にアプリを追加する
アクセスログ取得対象となるサイトコレクション(サイト)にインテリレポートアプリを追加します。
1. アクセスログ取得対象となるサイトコレクション(サイト)にアクセスし、接続先 URL が、以下のようになっていることを確
認します。
https://<お客様のテナント名>.sharepoint.com/sites/<アプリを配置したいサイト名>/
(例) https://discoveries.sharepoint.com/sites/AccessLogSite/
※アプリカタログサイト(/sites/AppCatalog/等)には、インテリレポートアプリを追加しないでください。
2. 右上の歯車マークより[サイトコンテンツ]を開きます。
※[サイトコンテンツ]メニューが表示されない場合、作業者アカウントに権限が不足しています。
3. サイトコンテンツ画面の左下に「従来の SharePoint 表示に戻す」が表示される場合、クリックします。
※モダン UI をご利用の場合、本書の画像と一部メニュー表示が異なりますのでご注意ください。
IntelliReport アドイン設置手順書(サイトコレクション編)
3/16
Discoveries,Inc.
4. [アプリの追加]をクリックします。
5. 「追加できるアプリ」の一覧から、「IntelliReport」のアイコンを選択します。
※ここでは、まだ「IntelliReportForModernUI」は選択しません。
IntelliReport アドイン設置手順書(サイトコレクション編)
4/16
Discoveries,Inc.
6. プルダウンリストから「サイトのページ」を選択し、[信頼する]をクリックします。
※「サイトのページ」は、アクセスログデータの収集および送信を行います。ここでインテリレポートアプリを信頼すること
により、「サイトのページ」が保管されている「サイトのページライブラリ」への権限を付与します。
7. 「IntelliReport」アプリが正常に追加されると、下図のように製品のロゴマークが表示されます。
IntelliReport アドイン設置手順書(サイトコレクション編)
5/16
Discoveries,Inc.
アプリケーションインストール
インテリレポートアプリ設定画面(ConfigForm)から、SharePoint サイトの各ページに対し、アプリケーションをインストー
ルします。
1. 前節で追加した「IntelliReport」アプリをクリックします。
2. インテリレポートアプリ設定画面(ConfigForm)が開きます。
※「この操作の実行権限またはこのリソースのアクセス権がありません。」というメッセージが表示された場合、作業ア
カウントの権限が不足しています。
3. 「アプリケーションのインストール」項目にある「適用」をクリックします。
※インテリレポートアプリをインストールすると、「Intellireport2.0.js」というファイルが、SharePoint サイトに埋め込
まれます。このプログラムによって、各サイトのページから、アクセスログデータの収集と送信を行います。
4. 「インストールが成功しました」というメッセージが表示されることを確認します。
5. 画面左上の[Back to Site]をクリックし、サイトのトップ画面に戻ります。
IntelliReport アドイン設置手順書(サイトコレクション編)
6/16
Discoveries,Inc.
6. 右上の歯車マークより[サイトコンテンツ]を開き、[IntelliReport]アプリをクリックします。
7. ConfigForm 画面を開き、最上段のメニューが[アプリケーションの削除]項目に変更されたことを確認します。
※再度[アプリケーションのインストール]メニューが表示された場合は、お客様テナント環境の【カスタムスクリプト設定】
が完了していません。お客様の SharePoint Online 管理者までご確認ください。
ConnectionID を設定する
インテリレポートアプリの設定画面(ConfigForm)に、取得したアクセスログの保存先となる【データ保存区分】の
ConnectionID を設定します。
※事前に、弊社サポートデスクよりご連絡する ConnectionID をご用意ください。
1. ConfigForm 画面を開きます。
2. [ConnectionID の登録]項目の[ConnectionID]を入力し、[適用]をクリックします。
※ConnectionID は、「ITR」から始まる 35 文字の英数字です。
3. 「成功しました。」というメッセージが表示されることを確認します。
※存在しない ConnectionID を入力した場合、エラーメッセージが表示されます。
※異なる ConnectionID を使用したい場合は、[編集]をクリックすると、変更が可能です。
IntelliReport アドイン設置手順書(サイトコレクション編)
7/16
Discoveries,Inc.
4. 画面左上の[Back to Site]をクリックし、サイトのトップ画面に戻ります。
5. 右上の歯車マークより[サイトコンテンツ]を開き、[IntelliReport]アプリをクリックします。
6. ConfigForm 画面を開き、ConnectionID が正しく設定されたことを確認します。
7. 配下にサブサイトが存在する場合、[ログ保存中のサブサイト一覧]にサブサイト名と URL が表示されることを確認し
ます。
※トップレベルサイトがアクセスログ取得対象である場合、配下のサブサイトは自動的にアクセスログ取得対象として
登録されます。
※アクセスログ取得が不要なサブサイトは、チェックボックスを選択し、[保存中止]をクリックしてください。
トップレベルサイトに新 UI 版アプリを追加する
アクセスログ取得対象となるサイトコレクション(サイト)に対し、新 UI 対応版インテリレポートアプリを追加します。
1. アクセスログ取得対象となるサイトコレクション(サイト)にアクセスし、接続先 URL が、以下のようになっていることを確
認します。
https://<お客様のテナント名>.sharepoint.com/sites/<アプリを配置したいサイト名>/
(例) https://discoveries.sharepoint.com/sites/AccessLogSite/
※アプリカタログサイト(/sites/AppCatalog/等)には、インテリレポートアプリを追加しないでください。
2. 右上の歯車マークより[サイトコンテンツ]を開きます。
※[サイトコンテンツ]メニューが表示されない場合、作業者アカウントの権限が不足しています。
3. サイトコンテンツ画面の左下に「従来の SharePoint 表示に戻す」が表示される場合、クリックします。
※モダン UI をご利用の場合、本書の画像と一部メニュー表示が異なりますのでご注意ください。
IntelliReport アドイン設置手順書(サイトコレクション編)
8/16
Discoveries,Inc.
4. [アプリの追加]をクリックします。
5. [追加できるアプリ]の一覧から、[IntelliReportForModernUI]のアイコンを選択します。
6. [IntelliReportForModernUI]アプリが正常に追加されると、下図のように製品のロゴマークが表示されます。
※[IntelliReportForModernUI]をクリックしても、アプリ設定画面(ConfigForm)は開きません。アプリ設定を
変更する場合は、[IntelliReport]を開きます。
IntelliReport アドイン設置手順書(サイトコレクション編)
9/16
Discoveries,Inc.
サブサイトに新 UI 版アプリを追加する
アプリを追加したサイトコレクション(サイト)にサブサイトが存在する場合、アクセスログ取得対象とするサブサイトすべてに
新 UI 対応版インテリレポートアプリを追加します。
※アクセスログ取得対象とするサブサイトは、ConfigForm 画面の[ログ保存中のサブサイト一覧]に含まれている必要が
あります。
1. 前節でアプリを追加したサイトコレクション(サイト)にアクセスし、右上の歯車マークより[サイトコンテンツ]を開きます。
2. [サブサイト]から、アクセスログ取得対象とするサブサイト名をクリックします。
3. 右上の歯車マークより[サイトコンテンツ]を開きます。
※[サイトコンテンツ]メニューが表示されない場合、作業者アカウントに権限が不足しています。
4. [アプリの追加]をクリックします。
5. [追加できるアプリ]の一覧から、[IntelliReportForModernUI]のアイコンを選択します。
IntelliReport アドイン設置手順書(サイトコレクション編)
10/16
Discoveries,Inc.
6. [IntelliReportForModernUI]アプリが正常に追加されると、下図のように製品のロゴマークが表示されます。
7. 同様に、アクセスログ取得対象とするすべてのサブサイトに対し、[IntelliReportForModernUI]アプリの追加を実
施してください。
以降、アクセスログがインテリレポートサーバーに保存されるようになります。
※取得されたアクセスログは、翌日 0 時以降、インテリレポートサイト<https://intelli.report>上に反映されま
す。
※インテリレポートサイトには、弊社サポートデスクよりご連絡した【全体管理者】アカウント情報を利用し、サインイン
してください。詳細は、別紙「04_UserManual.pdf:インテリレポートユーザーマニュアル」をご参照ください。
IntelliReport アドイン設置手順書(サイトコレクション編)
11/16
Discoveries,Inc.
3. Appendix
サブサイトのアクセスログ取得を停止する
サブサイトのアクセスログ取得を停止する方法を説明します。
1. アクセスログの取得を停止するサブサイトにアクセスします。
2. 右上の歯車マークより[サイトコンテンツ]を開きます。
※[サイトコンテンツ]メニューが表示されない場合、作業者アカウントの権限が不足しています。
3. [IntelliReportForModernUI]アプリにポイントし、[…]をクリックし、[削除]をクリックします。
4. 削除確認メッセージが表示されるので、[OK]をクリックします。
※アクセスログ取得を再開する場合は、対象サブサイトに再度[IntelliReportForModernUI]アプリを追加してく
ださい。
5. トップレベルサイトにアクセスします。
6. 右上の歯車マークより[サイトコンテンツ]を開きます。
※[サイトコンテンツ]メニューが表示されない場合、作業者アカウントの権限が不足しています。
7. [IntelliReport]アプリをクリックし、ConfigForm 画面を開きます。
8. [ログ保存中のサブサイト一覧]から、アクセスログ取得を停止するサブサイト名を探します。
9. 対象サブサイト名のチェックボックスを選択し、[保存中止]をクリックします。
10. 対象サブサイト名が[ログ保存が未開始のサブサイト一覧]に移動されることを確認します。
※アクセスログ取得を再開する場合は、対象サブサイトのチェックボックスを選択し、[保存開始]をクリックしてください。
IntelliReport アドイン設置手順書(サイトコレクション編)
12/16
Discoveries,Inc.
トップレベルサイトのアクセスログ取得を停止する
トップレベルサイトのアクセスログ取得を停止する方法を説明します。
※すべてのアクセスログ取得を停止したい場合、配下のサブサイトに対し、事前に「3.1 サブサイトのアクセスログ取得を停
止する」を実施してください。
1. アクセスログの取得を停止するサイトコレクション(サイト)にアクセスします。
2. 右上の歯車マークより[サイトコンテンツ]を開きます。
※[サイトコンテンツ]メニューが表示されない場合、作業者アカウントの権限が不足しています。
3. [IntelliReportForModernUI]アプリにポイントし、[…]をクリックし、[削除]をクリックします。
4. 削除確認メッセージが表示されるので、[OK]をクリックします。
5. [IntelliReport]アプリをクリックし、ConfigForm 画面を開きます。
6. [アプリケーションの削除]から、[削除]をクリックします。
IntelliReport アドイン設置手順書(サイトコレクション編)
13/16
Discoveries,Inc.
7. 削除確認メッセージが表示されるので、[削除]をクリックします。
8. 削除完了メッセージが表示されるので、[戻る]をクリックします。
9. これにより、トップレベルサイトおよびすべてのサブサイトに対して、アクセスログ取得が停止されました。
※サブサイトのサイトコンテンツに[IntelliReportForModernUI]アプリが存在する場合は、削除してください。
アプリのアンインストール手順
アンインストール手順を実施する前に「3.2 トップレベルサイトのアクセスログ取得を停止する」を参照し、すべてのサイトの
アクセスログ取得を停止してください。
1. 対象のサイトコレクション(サイト)にアクセスします。
2. 右上の歯車マークより[サイトコンテンツ]を開きます。
※[サイトコンテンツ]メニューが表示されない場合、作業者アカウントの権限が不足しています。
3. [IntelliReport]アプリにポイントし、[…]をクリックし、[削除]をクリックします。
4. 削除確認メッセージが表示されるので、[OK]をクリックします。
サイトコンテンツから、アプリ[IntelliReport]が完全に削除されるまで待機します。
IntelliReport アドイン設置手順書(サイトコレクション編)
14/16
Discoveries,Inc.
5. 画面右上の歯車アイコンから[サイトの設定]を開きます。
6. [サイトコレクションの管理] - [ごみ箱]をクリックします。
7. [IntelliReport]および[IntelliReportForModernUI]にチェックし、[選択したアイテムの削除]を選択します。
8. 削除確認メッセージが表示されるので、[OK]をクリックします。
9. ごみ箱のアイテムの最下部に「お探しのものが見つからない場合は、サイトコレクションのごみ箱を確認してください。」
と表示されるので、リンク[サイトコレクションのごみ箱]をクリックします。
10. [IntelliReport]および[IntelliReportForModernUI]にチェックし、[選択したアイテムの削除]を選択します。
11. 削除確認メッセージが表示されるので、[OK]をクリックします。
以上で、サイトコレクション(サイト)からのインテリレポートアプリの削除は完了しました。
SharePoint Online から完全にアプリを削除する場合は、別紙「01_IntelliReport_Add-ins_Installation
Manual_SP.pdf:IntelliReport アドイン設置手順書(SharePoint 管理センター編)」の「3.2 アプリアンインストール
手順」をご参照ください。
IntelliReport アドイン設置手順書(サイトコレクション編)
15/16
Discoveries,Inc.
インテリレポートアプリの有効期限を更新する
インテリレポートアプリ設定画面(ConfigForm)に接続するためのクライアントシークレットは、一年間の有効期限がありま
す。そのため、有効期限を超過すると、アプリ設定画面(ConfigForm)にアクセスできなくなります。
有効期限が超過する前に、別紙「01_IntelliReport_Add-ins_InstallationManual_SP.pdf:IntelliReport
アドイン設置手順書(SharePoint 管理センター編)」の「3.1 クライアント ID シークレット情報の期限更新手順」を実施
してください。
IntelliReport アドイン設置手順書(サイトコレクション編)
16/16
Discoveries,Inc.
4. 補足
本マニュアルは 2018 年 1 月 22 日現在時点となります。バージョンアップや機能強化などにより、実際のご利用の製品
では内容が異なる場合がありますのでご注意ください。
著作権
このドキュメントに記載されている情報(URL 等のインターネット Web サイトに関する情報を含む)は、将来予告なしに変更することがありま
す。別途記載されていない場合、このソフトウェアおよび関連するドキュメントで使用している会社、組織、製品、ドメイン名、電子メール アドレ
ス、ロゴ、人物、場所、出来事などの名称は架空のものです。実在する名称とは一切関係ありません。お客様ご自身の責任において、適用さ
れるすべての著作権関連法規に従ったご使用を願います。ディスカバリーズは、このドキュメントに記載されている内容に関し、特許、特許申
請、商標、著作権、またはその他の無体財産権を有する場合があります。別途ディスカバリーズのライセンス契約上に明示の規定のない限
り、このドキュメントはこれらの特許、商標、著作権、またはその他の無体財産権に関する権利をお客様に許諾するものではありません。
©2018 Discoveries Inc. All rights reserved.
Discoveries InSite はディスカバリーズ株式会社の商標です。Microsoft、Office365、SharePoint は、米国
Microsoft Corporation の米国およびその他の国における登録商標または商標です。
以上