メインコンテンツへスキップ

はじめに

Microsoft SharePoint Onlineを使用すると、組織は、チームとプロジェクトに焦点を合わせたカスタムのコラボレーションサイトを作成および管理できます。DomoのSharePoint Online Writebackコネクターを使用すると、DomoのDataSetからデータをSharePointにプッシュできます。SharePoint APIの詳細については、ウェブサイト( https://msdn.microsoft.com/en-us/lib…/jj860569.aspx )を参照してください。 Data CenterでDomo-SharePoint接続を設定します。このトピックでは、SharePoint Online Writebackコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「 コネクターを使用してDataSetを追加する 」を参照してください。
注記: writeback DataSetの所有者は、入力DataSetの所有者または共同所有者である必要があります。

必要条件

このコネクターを構成するには、以下の情報が必要です。
  • インストール済みのMicrosoft Azure App
  • Domoデベロッパーアカウントに関連付けられているクライアントIDとクライアントシークレット
  • Microsoft Azure Appに関連付けられているシークレットIDと値

DomoクライアントIDとクライアントシークレットを取得するには:

  1. Domoデベロッパーアカウント にログインします。
  2. 右上隅の [My Account] の下にある [New Client] をクリックします。
  3. アプリケーション名と説明を入力します。
  4. [Data][User] のチェックボックスを選択して、アプリケーションのスコープを指定します。
  5. [Create] をクリックします。クライアントを作成したら、[Manage Client] をクリックしてクライアントを管理できます。
  6. [Manage Client] セクションに表示されます。

SharePointシークレットIDを取得するには:

  1. https://portal.azure.com に移動します。
  2. [Azure Active Directory]>[App registrations] を選択します。
  3. ウェブAppを見つけて、クリックします。
  4. 「application ID」が シークレットID です。

SharePointの値を取得するには:

  1. https://portal.azure.com に移動します。
  2. [Azure Active Directory]>[App registrations] を選択します。
  3. ウェブAppを見つけて、クリックします。
  4. [Certificates and secrets] を開きます。
  5. [+New secret] をクリックします。
  6. 値の説明とシークレットの有効期限を入力します。[Add] をクリックします。
  7. 新しい値が表示されます。それをコピーして、DomoコネクターのSharePointクライアントシークレットフィールドに貼り付けます。

エンタープライズOAuth用Azure Appを作成する

Microsoft Azure Appを作成するには、以下の手順を実行します。
  1. https://portal.azure.com にログインします。
  2. [App registrations] をクリックします。
アプリケーションの登録
  1. [New registration] をクリックします。
  2. アプリケーション名を入力し、下記でサポートされているアカウントタイプを選択します。ウェブのリダイレクトURIを https://oauth.domo.com/api/data/v1/oauth/providers/sharepointonlinewriteback/exchange として入力します。
  3. [Register] をクリックします。
  4. ここに表示される [Application ID] が、Domoの [認証情報] ペインに入力する SharePoint クライアントID になります。 アプリケーションが登録されたら、必要なAPIの権限をアプリケーションに割り当てます。
  5. 次に、[API Permissions] をクリックします。
  6. [+Add Permissions] ボタンをクリックし、必要に応じて権限を選択します。
設定された権限
  1. 許可を追加した後、設定された権限は以下のように表示されます。
設定された権限
  1. [Manage]の下で [Certificates & Secrets] を選択します。証明書は、トークンを要求するときにアプリケーションの識別情報を証明するためのシークレットとして使用できます。これは、パブリックキーと呼ばれることもあります。
  2. [+New client secret] ボタンを選択します。
  3. [Description]に値を入力し、[Expires]に適したオプションを選択し、[Add] をクリックします。
重要: ページを終了する前に、クライアントのシークレット値(シークレットIDではありません)をコピーしてください。このページから離れると、再び表示されません。
Secret_Value_selection.png

接続を設定する

このセクションでは、SharePoint Onlineコネクターページの [認証情報] および [詳細] ペインのオプションについて説明します。このページのほかのペインの項目である [スケジュール設定][DataSetに名前を付け、説明を入力] に関しては、ほとんどのタイプのコネクターで共通しています。詳細については「 コネクターを使用してDataSetを追加する 」を参照してください。

[認証情報]ペイン

このペインには、SharePoint Onlineアカウントに接続する認証情報のフィールドが含まれています。下表では、各フィールドに必要な内容を説明しています。

フィールド

説明

SharePoint Secret ID

SharePointシークレットIDを入力します。

SharePoint Value

SharePointの値を入力します。

Domo Secret ID

DomoシークレットIDを入力します。

Domo Value

Domoの値を入力します。

有効な認証情報を一度入力しておくと、いつでも同じアカウントを使用して新しいSharePoint Online Writeback DataSetを作成できます。コネクターアカウントは、Data Centerの [アカウント] タブで管理できます。このタブの詳細については、「 コネクターのユーザーアカウントを管理する 」を参照してください。

[詳細]ペイン

このペインには接続を設定するオプションが含まれています。

メニュー

説明

Input DataSet ID

SharePoint OnlineにコピーするDataSetのDataSet ID(GUID)を入力します。Data CenterでDataSetの詳細ビューを開き、URLの datasources/ に続く箇所で、IDを見つけることができます。例えば、URLが https://mycompany.domo.com/datasources/845305d8-da3d-4107-a9d6-13ef3f86d4a4/details/overviewで あれば、DataSet IDは 845305d8-da3d-4107-a9d6-13ef3f86d4a4 になります。

Select Filename

データのコピー元となるファイルの指定方法を選択します。

  • [Use Input DataSet GUID] 。ファイル名は、 [Input DataSet ID] に入力した番号になります。

  • [Use Input DataSet Name] 。ファイル名は、入力DataSetの名前と同じになります。

  • [Enter File Name] [File Name] フィールドにファイルのカスタム名を入力します。

Filename

任意の出力ファイル名を入力します。

How would you like to select the Site? サイトを選択する適切な方法を選択します。
Sites Discovery 使用するサイトを選択します。
Sites Search 選択したサイトを検索します。
Select how would you like to choose the folder to store the file? ファイルを保存するフォルダーの選択方法を選択します。
Where to store the file? ファイルを保存するフォルダーの名前を選択します。ファイルを選択したサイトのルートレベルに保存する場合は [Root] を選択します。
Folder Path ファイルを保存するフォルダーのパスを区切り文字で区切って入力します。

Site and Group Site ID

データを送信するSharePointサイトを選択します。

Where to Store the File?

DataSetデータを保存するSharePointフォルダーを選択します。ファイルを選択したサイトのルートレベルに保存する場合は [Root] を選択してください。

Select Mode

同じ名前のファイルが見つかったときは、 [Rename] [Replace] を選択します。 [Rename] を選択すると、ファイル名が既に存在する場合、その名前は、 ファイル名1 ファイル名2 などの番号を付けて変更されます。

よくある質問

Domoデベロッパーアカウントの認証情報(クライアントIDとクライアントシークレット)とSharePointの認証情報(クライアントIDとクライアントシークレット)が必要です。
新規クライアントを作成するには:
  • Domoデベロッパーアカウント にログインします。
  • 右上隅の [My Account] の下にある [New Client] をクリックします。
  • アプリケーション名と説明を入力します。
  • [Data][User] のチェックボックスを選択して、アプリケーションのスコープを指定します。
  • [Create] をクリックします。
クライアントを作成したら、 [Manage Client] をクリックしてクライアントを管理できます。
  • SharePointクライアントIDを取得するには:
  • Azure Portal( https://protal.azure.com) にログインします。
  • [Azure Active Directory]>[App registrations] の順に進みます。
  • [Web App]>[Application ID] の順にクリックします。
  • アプリケーションIDがクライアントIDです。
クライアントシークレットを取得するには:
  • Azure Portal( https://protal.azure.com )にログインします。
  • [Azure Active Directory]>[App registrations] の順に進みます。
  • [Web App]>[Settings]>[Keys]>[Create New Key] の順にクリックします。
キー値をコピーします。キー値は一度だけ生成されることに注意してください。キー値を再度取得することはできません。
必要に応じて何回でも更新できます。
ありません。
はい。
DomoでSharePointデータベースに接続する前に、接続するポート上のデータベースサーバーにある多数のIPアドレスをホワイトリストに登録する必要があります。IPアドレスの詳細なリストは、「コネクターとフェデレーテッドアダプターのIPアドレスをホワイトリストに登録する」を参照してください。
Domoの入力DataSet IDは、データのエクスポート元となるDataSetのURLで見つけることができます。例: https://customer.domo.com/datasources/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/details/settings

その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。