18
アドイン設置手順書 サイトコレクション編 第七版 2020 年 9 月 28 日

アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

  • Upload
    others

  • View
    1

  • Download
    0

Embed Size (px)

Citation preview

Page 1: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

アドイン設置手順書

サイトコレクション編

第七版 2020 年 9 月 28 日

Page 2: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

目次

1. 事前準備 ................................................................................................................................................................................................. 1

作業端末のシステム要件 ............................................................................................................................................................ 1

アカウント要件 ................................................................................................................................................................................ 1

ConnectionID の用意 ................................................................................................................................................................ 1

2. 実施手順 ................................................................................................................................................................................................. 2

サイトコレクション(サイト)にアプリを追加する ............................................................................................................................. 2

アプリケーションインストール ........................................................................................................................................................... 5

ConnectionID を設定する ......................................................................................................................................................... 6

トップレベルサイトに新 UI 版アプリを追加する ......................................................................................................................... 7

サブサイトに新 UI 版アプリを追加する ....................................................................................................................................... 9

3. Appendix .............................................................................................................................................................................................. 11

サブサイトのアクセスログ取得を停止する ................................................................................................................................ 11

トップレベルサイトのアクセスログ取得を停止する ................................................................................................................... 11

アプリのアンインストール手順 ..................................................................................................................................................... 13

インテリレポートアプリの有効期限を更新する......................................................................................................................... 15

4. 補足......................................................................................................................................................................................................... 16

Page 3: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 1/16

1. 事前準備

本書の実施前に、別紙「01_Add-ins_InstallationManual_SP.pdf:IntelliReport アドイン設置手順書(SharePoint 管理

センター編)」の手順を完了している必要があります。

作業端末のシステム要件

SharePoint Online のシステム要件に準拠します。

アカウント要件

本書の手順を実施するには、アクセスログ取得対象とするサイトコレクション(サイト)の管理者権限が必要です。

ConnectionID の用意

取得したアクセスログを管理する【データ保存区分】単位に、ConnectionID を発行します。

ConnectionID は、インテリレポートのお申し込みから 3 営業日以内に、弊社サポートデスクよりメールでご連絡します。

お客様のすべての ConnectionID を管理できる【全体管理者】アカウントは、初回のみ弊社が作成し、アカウント情報をサポー

トデスクよりメールでご連絡します。

各 ConnectionID のデータを管理できるアカウント(これを【インテリレポート管理者】と呼びます。)は、全体管理者アカウントを使

用してお客様が作成してください。

詳細については、別紙「04_UserManual.pdf:インテリレポートユーザーマニュアル」をご参照ください。

※ユーザーマニュアルは、インテリレポートサイト<https://intelli.report>の左下メニュー「マニュアル」からダウンロードすることが可

能です。

Page 4: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 2/16

2. 実施手順

本章では、インテリレポートアプリの設置手順について説明します。

サイトコレクション(サイト)にアプリを追加する

アクセスログ取得対象となるサイトコレクション(サイト)にインテリレポートアプリを追加します。

1. アクセスログ取得対象となるサイトコレクション(サイト)にアクセスし、接続先 URL が、以下のようになっていることを確認しま

す。

https://<お客様のテナント名>.sharepoint.com/sites/<アプリを配置したいサイト名>/

(例) https://discoveries.sharepoint.com/sites/AccessLogSite/

※アプリカタログサイト(/sites/AppCatalog/等)には、インテリレポートアプリを追加しないでください。

2. 右上の歯車マークより[サイトコンテンツ]を開きます。

※[サイトコンテンツ]メニューが表示されない場合、作業者アカウントに権限が不足しています。

3. サイトコンテンツ画面の左下に「従来の SharePoint 表示に戻す」が表示される場合、クリックします。

※モダン UI をご利用の場合、本書の画像と一部メニュー表示が異なりますのでご注意ください。

Page 5: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 3/16

4. [アプリの追加]をクリックします。

5. 「追加できるアプリ」の一覧から、「IntelliReport」のアイコンを選択します。

※ここでは、まだ「IntelliReportForModernUI」は選択しません。

Page 6: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 4/16

6. プルダウンリストから「サイトのページ」を選択し、[信頼する]をクリックします。

※「サイトのページ」は、アクセスログデータの収集および送信を行います。ここでインテリレポートアプリを信頼することにより、

「サイトのページ」が保管されている「サイトのページライブラリ」への権限を付与します。

7. 「IntelliReport」アプリが正常に追加されると、下図のように製品のロゴマークが表示されます。

Page 7: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 5/16

アプリケーションインストール

インテリレポートアプリ設定画面(ConfigForm)から、SharePoint サイトの各ページに対し、アプリケーションをインストールします。

1. 前節で追加した「IntelliReport」アプリをクリックします。

2. インテリレポートアプリ設定画面(ConfigForm)が開きます。

※「この操作の実行権限またはこのリソースのアクセス権がありません。」というメッセージが表示された場合、作業アカウン

トの権限が不足しています。

3. 「アプリケーションのインストール」項目にある「適用」をクリックします。

※インテリレポートアプリをインストールすると、「Intellireport2.0.js」というファイルが、SharePoint サイトに埋め込まれます。

このプログラムによって、各サイトのページから、アクセスログデータの収集と送信を行います。

4. 「インストールが成功しました」というメッセージが表示されることを確認します。

5. 画面左上の[Back to Site]をクリックし、サイトのトップ画面に戻ります。

Page 8: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 6/16

6. 右上の歯車マークより[サイトコンテンツ]を開き、[IntelliReport]アプリをクリックします。

7. ConfigForm 画面を開き、最上段のメニューが[アプリケーションの削除]項目に変更されたことを確認します。

※再度[アプリケーションのインストール]メニューが表示された場合は、お客様テナント環境の【カスタムスクリプト設定】が完

了していません。お客様の SharePoint Online 管理者までご確認ください。

ConnectionID を設定する

インテリレポートアプリの設定画面(ConfigForm)に、取得したアクセスログの保存先となる【データ保存区分】の ConnectionID

を設定します。

※事前に、弊社サポートデスクよりご連絡する ConnectionID をご用意ください。

1. ConfigForm 画面を開きます。

2. [ConnectionID の登録]項目の[ConnectionID]を入力し、[適用]をクリックします。

※ConnectionID は、「ITR」から始まる 35 文字の英数字です。

3. 「成功しました。」というメッセージが表示されることを確認します。

※存在しない ConnectionID を入力した場合、エラーメッセージが表示されます。

※異なる ConnectionID を使用したい場合は、[編集]をクリックすると、変更が可能です。

Page 9: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 7/16

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 をご利用の場合、本書の画像と一部メニュー表示が異なりますのでご注意ください。

Page 10: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 8/16

4. [アプリの追加]をクリックします。

5. [追加できるアプリ]の一覧から、[IntelliReportForModernUI]のアイコンを選択します。

6. [IntelliReportForModernUI]アプリが正常に追加されると、下図のように製品のロゴマークが表示されます。

※[IntelliReportForModernUI]をクリックしても、アプリ設定画面(ConfigForm)は開きません。アプリ設定を変更する場

合は、[IntelliReport]を開きます。

Page 11: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 9/16

サブサイトに新 UI 版アプリを追加する

アプリを追加したサイトコレクション(サイト)にサブサイトが存在する場合、アクセスログ取得対象とするサブサイトすべてに新 UI 対

応版インテリレポートアプリを追加します。

※アクセスログ取得対象とするサブサイトは、ConfigForm 画面の[ログ保存中のサブサイト一覧]に含まれている必要がありま

す。

1. 前節でアプリを追加したサイトコレクション(サイト)にアクセスし、右上の歯車マークより[サイトコンテンツ]を開きます。

2. [サブサイト]から、アクセスログ取得対象とするサブサイト名をクリックします。

3. 右上の歯車マークより[サイトコンテンツ]を開きます。

※[サイトコンテンツ]メニューが表示されない場合、作業者アカウントに権限が不足しています。

4. [アプリの追加]をクリックします。

5. [追加できるアプリ]の一覧から、[IntelliReportForModernUI]のアイコンを選択します。

6. [IntelliReportForModernUI]アプリが正常に追加されると、下図のように製品のロゴマークが表示されます。

Page 12: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 10/16

7. 同様に、アクセスログ取得対象とするすべてのサブサイトに対し、[IntelliReportForModernUI]アプリの追加を実施してく

ださい。

以降、アクセスログがインテリレポートサーバーに保存されるようになります。

※取得されたアクセスログは、翌日 0 時以降、インテリレポートサイト<https://intelli.report>上に反映されます。

※インテリレポートサイトには、弊社サポートデスクよりご連絡した【全体管理者】アカウント情報を利用し、サインインしてくだ

さい。詳細は、別紙「04_UserManual.pdf:インテリレポートユーザーマニュアル」をご参照ください。

Page 13: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 11/16

3. Appendix

サブサイトのアクセスログ取得を停止する

サブサイトのアクセスログ取得を停止する方法を説明します。

1. アクセスログの取得を停止するサブサイトにアクセスします。

2. 右上の歯車マークより[サイトコンテンツ]を開きます。

※[サイトコンテンツ]メニューが表示されない場合、作業者アカウントの権限が不足しています。

3. [IntelliReportForModernUI]アプリにポイントし、[…]をクリックし、[削除]をクリックします。

4. 削除確認メッセージが表示されるので、[OK]をクリックします。

※アクセスログ取得を再開する場合は、対象サブサイトに再度[IntelliReportForModernUI]アプリを追加してください。

5. トップレベルサイトにアクセスします。

6. 右上の歯車マークより[サイトコンテンツ]を開きます。

※[サイトコンテンツ]メニューが表示されない場合、作業者アカウントの権限が不足しています。

7. [IntelliReport]アプリをクリックし、ConfigForm 画面を開きます。

8. [ログ保存中のサブサイト一覧]から、アクセスログ取得を停止するサブサイト名を探します。

9. 対象サブサイト名のチェックボックスを選択し、[保存中止]をクリックします。

10. 対象サブサイト名が[ログ保存が未開始のサブサイト一覧]に移動されることを確認します。

※アクセスログ取得を再開する場合は、対象サブサイトのチェックボックスを選択し、[保存開始]をクリックしてください。

トップレベルサイトのアクセスログ取得を停止する

トップレベルサイトのアクセスログ取得を停止する方法を説明します。

※すべてのアクセスログ取得を停止したい場合、配下のサブサイトに対し、事前に「3.1 サブサイトのアクセスログ取得を停止する」

を実施してください。

Page 14: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 12/16

1. アクセスログの取得を停止するサイトコレクション(サイト)にアクセスします。

2. 右上の歯車マークより[サイトコンテンツ]を開きます。

※[サイトコンテンツ]メニューが表示されない場合、作業者アカウントの権限が不足しています。

3. [IntelliReportForModernUI]アプリにポイントし、[…]をクリックし、[削除]をクリックします。

4. 削除確認メッセージが表示されるので、[OK]をクリックします。

5. [IntelliReport]アプリをクリックし、ConfigForm 画面を開きます。

6. [アプリケーションの削除]から、[削除]をクリックします。

7. 削除確認メッセージが表示されるので、[削除]をクリックします。

8. 削除完了メッセージが表示されるので、[戻る]をクリックします。

9. これにより、トップレベルサイトおよびすべてのサブサイトに対して、アクセスログ取得が停止されました。

※サブサイトのサイトコンテンツに[IntelliReportForModernUI]アプリが存在する場合は、削除してください。

Page 15: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 13/16

アプリのアンインストール手順

アンインストール手順を実施する前に「3.2 トップレベルサイトのアクセスログ取得を停止する」を参照し、すべてのサイトのアクセス

ログ取得を停止してください。

1. 対象のサイトコレクション(サイト)にアクセスします。

2. 右上の歯車マークより[サイトコンテンツ]を開きます。

※[サイトコンテンツ]メニューが表示されない場合、作業者アカウントの権限が不足しています。

3. [IntelliReport]アプリにポイントし、[…]をクリックし、[削除]をクリックします。

4. 削除確認メッセージが表示されるので、[OK]をクリックします。

サイトコンテンツから、アプリ[IntelliReport]が完全に削除されるまで待機します。

Page 16: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 14/16

5. 画面右上の歯車アイコンから[サイトの設定]を開きます。

6. [サイトコレクションの管理] - [ごみ箱]をクリックします。

7. [IntelliReport]および[IntelliReportForModernUI]にチェックし、[選択したアイテムの削除]を選択します。

8. 削除確認メッセージが表示されるので、[OK]をクリックします。

9. ごみ箱のアイテムの最下部に「お探しのものが見つからない場合は、サイトコレクションのごみ箱を確認してください。」と表

示されるので、リンク[サイトコレクションのごみ箱]をクリックします。

10. [IntelliReport]および[IntelliReportForModernUI]にチェックし、[選択したアイテムの削除]を選択します。

11. 削除確認メッセージが表示されるので、[OK]をクリックします。

以上で、サイトコレクション(サイト)からのインテリレポートアプリの削除は完了しました。

SharePoint Online から完全にアプリを削除する場合は、別紙「01_Add-ins_Installation

Manual_SP.pdf:IntelliReport アドイン設置手順書(SharePoint 管理センター編)」の「3.2 アプリアンインストール手順」をご参

照ください。

Page 17: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 15/16

インテリレポートアプリの有効期限を更新する

インテリレポートアプリ設定画面(ConfigForm)に接続するためのクライアントシークレットは、一年間の有効期限があります。その

ため、有効期限を超過すると、アプリ設定画面(ConfigForm)にアクセスできなくなります。

有 効 期 限 が 超 過 す る 前 に 、 別 紙 「 01_Add-ins_InstallationManual_SP.pdf : IntelliReport ア ド イ ン 設 置 手 順 書

(SharePoint 管理センター編)」の「3.1 クライアント ID シークレット情報の期限更新手順」を実施してください。

Page 18: アドイン設置手順書 サイトコレクション編discoveries.co.jp/download/IntelliReport/02_Add-ins...ConnectionIDの用意 取得したアクセスログを管理する【データ保存区分】単位に、ConnectionIDを発行します。

Copyright ©Discoveries Inc. All Rights Reserved. 16/16

4. 補足

本マニュアルは 2020 年 9 月 28 日現在時点となります。バージョンアップや機能強化などにより、実際のご利用の製品では内

容が異なる場合がありますのでご注意ください。

著作権

このドキュメントに記載されている情報(URL 等のインターネット Web サイトに関する情報を含む)は、将来予告なしに

変更することがあります。別途記載されていない場合、このソフトウェアおよび関連するドキュメントで使用している会社、組

織、製品、ドメイン名、電子メール アドレス、ロゴ、人物、場所、出来事などの名称は架空のものです。実在する名称とは

一切関係ありません。お客様ご自身の責任において、適用されるすべての著作権関連法規に従ったご使用を願います。デ

ィスカバリーズは、このドキュメントに記載されている内容に関し、特許、特許申請、商標、著作権、またはその他の無体財

産権を有する場合があります。別途ディスカバリーズのライセンス契約上に明示の規定のない限り、このドキュメントはこれら

の特許、商標、著作権、またはその他の無体財産権に関する権利をお客様に許諾するものではありません。

© Discoveries Inc. All rights reserved.

Discoveries InSite はディスカバリーズ株式会社の商標です。Microsoft、Office365、SharePoint は、米国 Microsoft

Corporation の米国およびその他の国における登録商標または商標です。

以上