はじめに
Domo SharePointプラグインを使うと、Workbench 5にジョブを作成して、SharePointのデータをDomoに取り込むことができます。Domo Workbenchは、オンプレミスのデータをDomoにアップロードするための安全なクライアントサイドのソリューションを提供します。Domo SharePoint Data Providerは、Domo Workbenchを使用可能なSharePointデータに接続します。WorkbenchでSharePointデータからDataSetを構築し、DomoサービスでSharePointデータをリアルタイムで視覚化することができます。このチュートリアルでは、Domo SharePointプラグインを使用してSharePointデータに接続する方法を説明します。利用を開始する
- Windows 10 64ビットオペレーティングシステム
- Domo Workbench
- SharePointプラグイン： https://app.domo.com/workbench/plugins/stable/DomoSharePointDataProvider.dwp
Domo WorkbenchにSharePointプラグインをインストールする
Workbenchのプラグインは、すべてダイナミックリンクライブラリ（DLL）に格納されています。Workbenchには、自分のマシンまたはネットワークから目的のDLLを選択することで、プラグインを追加することができます。WorkbenchにSharePointプラグインを追加する
注記： SharePointプラグインは、選択するディレクトリのサブディレクトリに入れておく必要があります。
-
Domo Workbenchで、左側のアイコンバーにある
をクリックします。
-
［その他］ ペインで ［プラグイン］ をクリックします（このペインが表示されていない場合、
をクリックして展開します）。プラグインマネージャー が表示されます。
-
［新規プラグインを登録］ の下の ［検索パス］ フィールドの横にある省略記号（ … ）をクリックします。
- マシンまたはネットワーク上で、SharePointプラグインのすべてのDLLを含むフォルダーを探して開きます。
- DLLを選択したら、［追加］ をクリックします。
SharePointデータに接続する
Workbench 5でSharePoint DataSetジョブを作成する
-
左側のアイコンバーにある
アイコンをクリックします。
- ジョブリストペインの右上にある ［+］ ボタンをクリックします。
- 新規ジョブの ［概要］ タブが表示されます。
-
［ジョブの詳細］ セクションで以下の詳細を入力します。
フィールド 説明 Domoドメイン ［Domoドメイン］ ドロップダウンメニューで、必要なアカウント（Domoインスタンス）を選択します。
アカウントが1つしか設定されていない場合は、そのアカウントが既に選択されているため、メニューは使用できません。
ジョブ名 DataSetジョブ名を入力します。
これは、Workbenchで表示されるジョブ名です。DomoにアップロードされたDataSet名ではありません。
トランスポートタイプ ［Domo SharePoint Data Provider］ を選択します。 読み取りタイプ WorkbenchでSharePointから読み取るファイルの種類を選択します。 
-
［Domoの詳細］ セクションで、DataSetの情報を入力します。
フィールド 説明 DataSet名 DataSetの名前を入力します。これは、DomoにアップロードされたDataSet名です。 DataSetタイプ ドロップダウンからDataSetタイプを選択します。ここで選択または入力するDataSetのタイプは、ジョブ実行後のDomoのコネクタータイプに反映されます。 DataSetの説明 必要に応じてDataSetの説明を入力します。
Domoに表示されるDataSetの説明です。
-
［作成］ をクリックします。
現在認証されているアカウントのジョブリストに、新しいSharePoint DataSetジョブが作成され、追加されます。
注記： ジョブを作成した後は、DataSet名以外の設定は編集できません。ほかの設定を変更する場合は、新しいジョブを別途作成する必要があります。
ジョブを設定する
ジョブが作成されたら、そのジョブの設定に関する詳細を入力する必要があります。ソースを設定する
- ［ソース］ メニューでSharePointデータの詳細を入力します。
- ［編集］ をクリックします。
-
［Domo SharePoint Data Provider Editor］ ウィンドウが開きます。ここでは、SharePointデータに接続するために必要な認証情報とレポートの詳細を入力する必要があります。
フィールド
説明 接続タイプ 接続タイプを ［SharePoint On-Premise］ として選択します。 SharePoint URL SharePointサイトのURLを入力します。 ユーザー名 SharePointユーザー名を入力します。 パスワード SharePointパスワードを入力します。 ドメイン SharePoint Windowsドメイン名を入力します。
例えば、ご使用のSharePointサイトが https://sample.sharepoint.com にある場合、ドメイン名は「sample」です。
レポート ドロップダウンからレポートを選択します。 サーバー相対URL SharePointでこのDataSetに接続するデータファイルの名前を入力します。 -
［適用する］ をクリックします。
データ処理を設定する
- ［処理］ メニューで、SharePointデータのデータ処理に関する詳細を入力します。
- ［編集］ をクリックします。
- 選択した読み取りタイプの エディター ウィンドウが表示されます。ここで、データのプロパティと詳細を指定して、DataSetにおけるデータの処理方法を定義できます。
- ［適用する］ をクリックします。
データ更新方法を設定する
- 新たにアップロードしたデータでDataSet内の既存のデータを置き換える場合は、［置き換え］ を選択します。
- 新たに追加したデータを既存のデータに付け加える（追加する）場合は、［追加］ を選択します。
- データにパーティションを適用する場合は、［パーティション］ を選択します。パーティション分割では、粒度（日や週など）を使用してデータにグループを作成します。データはグループとして処理され、変更に応じて追加されるか置き換えられます。
- データのそれぞれのドロップダウンで ［パーティション列］ と ［日付単位］ を選択します。
データに変換を適用する
変換を使用すると、Domoにアップロードする前に、データをローカルで変更できます。データはコンピューターまたはサーバー上で高速に処理されます。キューに待機することはありません。データの変換には様々なオプションが選択でき、いつでもDomoで処理できるように準備できます。- ドロップダウンから目的の変換を選択し、その横にある ［+］ ボタンをクリックします。
- 選択した変換のプロパティをメンションし、［適用する］ をクリックします。
- データには複数の変換を追加できます。
- 特定の変換のプロパティを更新するには、
をクリックします。 - 特定の変換を削除するには、
をクリックします。 - 変換の位置を交換するには、
（上・下向きの矢印）をクリックします。
ジョブを偽装する
偽装を使用すると、Domo Workbenchで特定のActive Directoryユーザーとしてジョブを実行できます。注： ジョブ偽装のユーザープロファイルは、ジョブの実行に必要なソースデータにアクセスできる権限を持っている必要があります。
- ［偽装が必要］ チェックボックスを選択します。
- Active Directoryのドメイン名とユーザー名が表示されます。
- Active Directoryのパスワードを入力し、［検証］ をクリックします。
ジョブに関する追加設定
［追加設定］ で、ジョブからDomoへのデータのアップロード方法に関する高度なオプションを設定できます。ここでは、エラーの処理方法、ジョブの実行時間と実行条件を指定できます。ジョブをスケジュールする
DataSetジョブでは、定期的に外部DataSetからDomoへデータをアップロードするなどのスケジュールを設定することができます。この頻度については、［スケジュール］タブで指定します。基本スケジュール
［基本スケジュール］ セクションでは、データの手動更新、ファイルの変更時の更新、スケジュールに従った更新ができます。 スケジュールに従った更新を選択する場合は、時間間隔や特定の時間枠を指定してジョブを実行できます。スケジュールの詳細設定
［スケジュールの詳細設定］ セクションでは、ジョブの実行頻度を、1日1回、1日複数回、毎日、特定の曜日/月、毎月、複数月から選択できます。 変更を保存するには
（ 保存 ）ボタンをクリックします。
ジョブのスキーマ保護
Domo Workbench 5は、3つの異なるスキーマ保護タイプを提供します。スキーマの変更を安全に許可するか、保護されていないスキーマの変更を許可するか、あるいはすべてのスキーマの変更を完全にブロックすることにより、スキーマの変更を制御できます。Domo Workbenchでは、これらのスキーマの変更を任意の方法で制御できる保護機能がサポートされています。この機能は、［安全なスキーマの変更を許可］ビューおよび［保護されていないスキーマの変更を許可］ビューで利用できます。列の保護
列の保護は、スキーマの変更をジョブに適用する際に列（データフィールド）が保護されているかどうかを示します。-
［保護］ チェックボックスが選択されている場合、列は保護され、スキーマの変更はできません。安全なスキーマの変更または保護されていないスキーマの変更のいずれかを許可しているときに、任意の列の保護を解除しようとすると（チェックを外すと）Domo Workbenchでは次の警告が表示されます。
警告： 保護されていない列は変更や削除をすることができますが、Domoのコンテンツが破損する可能性があります。
-
列の保護では、すべての列をシングルクリックで保護または保護解除することができます。列ヘッダー（保護）の横のチェックボックスを選択して、すべての列を一度に保護します。同様に、このチェックボックスの選択を解除すると、同時に列の保護を解除できます。
-
列ヘッダーをシングルクリックすると、保護されているエントリー、保護されていないエントリー、またはそれら両方のエントリーを、フィルタリングして表示できます。
- 通常の選択ビューを選択してクリックすると
、保護されているすべてのエントリーが列の保護に表示されます。 - チェックされていないビューを選択してクリックすると
、保護されていないすべてのエントリーが列の保護に表示されます。 - 混合ビューを選択してクリックすると
、保護されているエントリーと保護されていないエントリーが一緒に列の保護に表示されます。
- 通常の選択ビューを選択してクリックすると
-
保護されたソース列の名前を変更することはできません。Domo Workbenchでは、保護されたソース列の名前は編集できない仕様になっています。ただし、ほかの列の名前またはプロパティは変更できます。
- 同様に、保護された列は削除できません。
- スキーマの変更を許可する場合は、列のチェックを外してジョブを再実行します。
安全なスキーマの変更を許可
このオプションを選択すると、保護されていない列は次回の実行時に変更を受け入れ、その後自動的に保護されます。新しい列が追加され、今後の実行で自動的に保護されます。新しいジョブでは、 ［安全なスキーマの変更を許可］ オプションがデフォルトで有効になります。保護されていないスキーマの変更を許可
保護されていないスキーマの変更の許可を選択した場合は、保護されていない列の変更や削除ができます。列は保護されていない状態のままになります。全てのスキーマの変更をブロック
すべてのスキーマ変更をブロックすると、列の保護オプションが表示されません。任意の列に変更を加えてジョブを実行すると、強制的な変更に関するエラーメッセージが発生します。ジョブに通知を設定する
各列の下の名前の前にあるそれぞれのチェックボックスを選択するだけで、ジョブの成功または失敗時にほかのユーザーに通知するように設定できます。- ジョブの仕様設定が完了したら、 （ 保存 ）ボタンをクリックして変更を保存します。
（ 実行 ）ボタンをクリックして、ジョブを実行します。