はじめに
Microsoft SharePoint Onlineでは、組織のコラボレーション用のカスタムチーム専用サイトやプロジェクト専用サイトを簡単に作成、管理できます。DomoのMicrosoft SharePoint Online RESTコネクターを使用すれば、Domo内のサイトにもとづいた様々な側面に関して、組織全体のイントラネットポータルからデータを取得できます。そのためには、まずMicrosoft AzureでAppを作成する必要があります。Microsoft SharePoint Onlineについての詳細は、ウェブサイト（ https://products.office.com/ja-jp/sharepoint/sharepoint-online-collaboration-software ）を参照してください。 Microsoft SharePoint Onlineへの接続はData Centerで作成します。このトピックでは、Microsoft SharePoint Online RESTコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。必要条件
Microsoft SharePoint Onlineに接続して情報を取得するには、次のものが必要です。- Microsoft Azure Appのインストール。
-
クライアントIDとクライアントシークレット。Appを生成してこれらの認証情報を探す方法については、Microsoftのドキュメント を参照してください。Appを登録するには、以下の情報が必要になる場合があります。
- Azureポータル： https://portal.azure.com/
- 登録するSharePoint App： SharePoint Online Rest API
- DomoリダイレクトURL： https://oauth.domo.com/api/data/v1/oauth/providers/microsoft-sharepoint/exchange
エンタープライズOAuth用Azure Appを作成する
Microsoft Azure Appを作成するには、以下の手順を実行します。- https://portal.azure.com にログインします。
-
［App registrations］ をクリックします。
- ［New registration］ をクリックします。
- アプリケーション名を入力し、サポートされているアカウントのタイプを選択します。WebのリダイレクトURIを次のように入力します。 https://oauth.domo.com/api/data/v1/oauth/providers/microsoft-sharepoint/exchange
-
デフォルトのテナント選択をシングルテナントからマルチテナントに変更します。これはコネクターの必要条件です。
- ［Register］ をクリックします。
-
ここで、［API Permissions］ をクリックします。
-
［+Add Permissions］ ボタンをクリックします。
- ［Microsoft Graph］>［Delegated Permissions］ を選択します。
- 必要に応じて権限を選択してください。
-
権限を追加した後、すべての設定済みの権限が以下のように一覧表示されます。
SharePointクライアントIDを取得するには：
- https://portal.azure.com に移動します。
- ［Microsoft Entra ID］>［App registrations］ を選択します。
- 前の手順で作成されたWeb App名をクリックします。
- 「application ID」がクライアントIDです。
SharePointクライアントシークレットを取得するには：
- https://portal.azure.com に移動します。
- ［Microsoft Entra ID］>［App registrations］ を選択します。
- 前の手順で作成されたWeb App名をクリックします。
- ［Certificates and secrets］ を開きます。
- ［+New Value］ をクリックします。
- 値の説明とシークレットの有効期限を入力します。［Add］ をクリックします。
-
新しい値が表示されます。［Value］フィールドをコピーして、Domoコネクターの［Value］フィールドに貼り付けます。
Microsoft SharePoint Onlineに接続する
このセクションでは、Microsoft SharePoint Online RESTコネクターページの ［認証情報］ および ［詳細］ ペインのオプションについて説明します。このページのほかのペインの項目である ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。 注記： admin.microsoft.com でクラウドアプリケーション管理者権限を持つMicrosoftアカウントを使用してください。［認証情報］ペイン
このペインには、Azure経由でMicrosoft Dynamics CRMインストールに接続するための認証情報の入力フィールドがあります。下表では、各フィールドに必要な内容を説明しています。フィールド | 説明 |
|---|---|
CLIENT ID | portal.azure.com >［Azure Active Directory］>［App registrations］ の順に進みます。Web Appを検索して選択します。Web AppのアプリケーションIDがクライアントIDです。 |
CLIENT SECRET | portal.azure.com >［Azure Active Directory］>［App registrations］ の順に進みます。Web Appを検索して選択します。 ［settings］>［Keys］ の順に進み、クライアントシークレットを作成します。 |
［詳細］ペイン
このパネルには、SharePointレポートを選択したり、様々なオプションを設定したりするためのメニューがあります。メニュー | 説明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Report | 必要なSharePoint Onlineレポートを選択します。
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Group ID | 使用するグループを選択します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Site or Subsite? | 最上位サイトかサブサイトのどちらからデータを取得するかを選択します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Site ID | データの取得元になるサイトを選択します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Subsite ID | データの取得元になるサブサイトを選択します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
List ID | データの取得元になるリストを選択します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
List Item ID | 情報を取得するリストアイテムのIDを入力します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Drive ID | データの取得元になるドライブを選択します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
File ID | 情報を取得するファイルのIDを入力します。「Files」レポートを実行することにより、ファイルのリストを生成できます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Relative Path | 選択したドライブからフォルダの相対パスを入力します（例： /MyFolder/MySubfolder ）。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expand Fields | 展開するすべてのフィールドを選択します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
File Type | 取得するデータファイルのファイルタイプを選択します。ファイルのコンテンツをバイナリー列として表示するには、 ［Other］ を選択します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Sheet Name（オプション） | 指定したExcelスプレッドシートから取得するシートの名前を入力します。シート名に誤ってスペースが入力されていないか確認してください。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Add Phonetic Words（チェックボックス） | データに発音文字を追加する場合は、このチェックボックスをオンにします。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Data Tag（オプション） | XMLテキスト内のデータのある場所を示すタグを入力します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Do you require attributes in data? | データの一部として属性値を必要としている場合は、 ［Yes］ を選択します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Enter fields to exclude （オプション） | XMLデータから除外するフィールドを、カンマで区切ったリストとして指定します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Enter Xpath expression | ワールドワイド・ウェブ・コンソーシアムにより定義された標準XPath構文を使って、XPathクエリを入力します（ https://www.w3.org/TR/2017/REC-xpath-31-20170321/ ）。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Header Start Row（オプション） | ヘッダー行番号を入力します。番号を入力しない場合、最初の行がヘッダー行とみなされます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Data Start Row（オプション） | 開始データ行番号を入力します。番号を入力しない場合、ヘッダー行に続く最初の行が開始行とみなされます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Footer Rows to Skip（オプション） | インポートから除外する行がファイルの終わりに1つまたは複数ある場合は、スキップする行数を入力します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Does Your JSON Text Require a Line Reader? | 読み込む行がJSONテキストに複数ある場合は、 ［Yes］ を選択します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Header Tag （オプション） | JSONテキストのヘッダーのタグを入力します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Data Tag（オプション） | JSONテキストのデータのタグを入力します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Fields to Exclude（オプション） | JSONインポートから除外するフィールドを、カンマ区切りのリストとして指定します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Date Format | 日付列を変換するために使用する日付の形式を選択します。Excelファイルの場合、セルの日付の形式が優先されます。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Use Provided File Encoding | オンにした場合は、その下にある正確なファイルエンコーディングを選択します。オンにしない場合、コネクターはファイルエンコーディングを自動検出します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
File Encoding | ファイルエンコーディングを選択します。デフォルトはUTF-8です。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Delimiter | CSVファイルを解析するために使用する区切り文字を選択します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Custom Delimiter | 希望するカスタム区切り文字を入力します。タブには \t か、 \uxxxx 形式のUnicode文字を入力します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Quote Character | CSVファイルを解析するために使用する引用文字を選択します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Custom Quote Character | 希望するカスタム引用文字を入力します。タブには \t か、 \uxxxx 形式のUnicode文字を入力します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Escape Character | CSVファイルを解析するために使用するエスケープ文字を選択します。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Custom Escape Character | 希望するカスタムエスケープ文字を入力します。タブには \t か、 \uxxxx 形式のUnicode文字を入力します。 |
その他のペイン
スケジュール設定、再試行、更新オプションなど、その他のコネクターインターフェースのセクションの詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。よくある質問
フィールド名に発音文字が追加されるのはなぜですか？
フィールド名に発音文字が追加されるのはなぜですか？
このコネクターではどのバージョンのMicrosoft APIを使用しますか？
このコネクターではどのバージョンのMicrosoft APIを使用しますか？
各レポートコールによってこのコネクターで呼び出されるのはどのエンドポイントですか？
各レポートコールによってこのコネクターで呼び出されるのはどのエンドポイントですか？
| レポート名 | エンドポイントURL（1つまたは複数） |
All Sites | /sites/root/sites/%s/sites/groups/%s/sites/root |
| Download Item Contents | /sites//drive/items//content |
| Files | /sites//drives///children |
| File Download | /sites/%s/drives/%s/%s/content |
| File Permissions | /sites/%s/drives/%s/%s/permissions |
| Get Items | /sites//drive/root/children |
| Groups | /groups |
| Group Members | /groups/%s/%s |
| Group Members V2 (Group Filter Search) | /groups//transitiveMembers （または） /groups//members |
| Group Sites | /groups//sites/root |
| List | /sites//lists/listId?expand=columns,items(expand=fields) |
| List Item Column Values | /sites//lists//items/itemId?expand=fields |
| List Item Detailed | /sites//lists//items/ |
| List Items | /sites//lists//items?expand=fields |
| List Notebooks | /users//onenote/notebooks |
| List Onenote Sections | /users//onenote/sections |
| Root Sites | /sites/root |
| Sharepoint Activity User Detail | /reports/getSharePointActivityUserDetail(period=‘period_value’) |
| Sharepoint Activity File Counts | /reports/getSharePointActivityFileCounts(period=‘period_value’) |
| Sharepoint Activity User Counts | /reports/getSharePointActivityUserCounts(period=‘period_value’) |
| Sharepoint Site Usage Detail | /reports/getSharePointSiteUsageDetail(period=‘period_value’) |
| Sharepoint Site Usage File Counts | /reports/getSharePointSiteUsageFileCounts(period=‘period_value’) |
| Sharepoint Site Usage Site Counts | /reports/getSharePointSiteUsageSiteCounts(period=‘period_value’) |
| Sharepoint Site Usage Storage | /reports/getSharePointSiteUsageStorage(period=‘period_value’) |
| Sites Lists | /sites//lists |
Sites Search | /sites |
| Sites Subsites | /sites//sites |
| Users | /users |
| Users Drive | /users//drive |
このコネクターを使用するにはどのような認証情報が必要ですか？
このコネクターを使用するにはどのような認証情報が必要ですか？
クライアントIDとクライアントシークレットはどこにありますか？
クライアントIDとクライアントシークレットはどこにありますか？
- Microsoft Azure Portal にアクセスし、Microsoft認証情報を使用してサインインします。
- ［Azure Active Directory］>［App registrations］ を選択します。
- お使いのAppを探し、クリックします。
- ウェブAppの「Application ID」を確認します。Application IDがクライアントIDです。
- Microsoft Azure Portal にアクセスし、Microsoft認証情報を使用してサインインします。
- ［Azure Active Directory］>［App registrations］ を選択します。
- お使いのAppを探し、クリックします。
- ［Settings］>［Keys］ の順に開きます。
- クライアントのシークレットを作成します。
サイトのディスカバリー機能でタイムアウトエラーが発生した場合はどうなりますか。
サイトのディスカバリー機能でタイムアウトエラーが発生した場合はどうなりますか。
データはどのくらいの頻度で更新できますか？
データはどのくらいの頻度で更新できますか？
注意すべきAPI制限はありますか？
注意すべきAPI制限はありますか？
カードまたはダッシュボードをSharePointにプライベートエンベッドすることはできますか？
カードまたはダッシュボードをSharePointにプライベートエンベッドすることはできますか？