Documentation Index
Fetch the complete documentation index at: https://domoinc-arun-raj-connectors-domo-480626-update-new-field-mi.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
注記：Domo Excelプラグインのサポートは終了しました。プラグインは、Domo for Officeアドインに置き換えられました。このプラグインに関するサポートが必要になった場合は、アドインにアップグレードすることを推奨します。
はじめに
DomoからDataSetをExcelにダウンロードするには、Domo Excelプラグインを使用します。ダウンロードしたデータは、ほかのExcelスプレッドシートと同様に編集することができます。「クエリ表」を使用してデータをDataSetに追加することもできます。クエリ表は、集計、フィルター、制限にもとづいてExcelに取り込んだDataSetのサブセットまたは単一の値です。ExcelでDataSetのデータを編集した後、ダウンロード元のDataSetへの編集済みデータのアップロードや、編集済みデータを使った新しいDomo DataSetの作成、別の既存DataSetへの編集済みデータのアップロードが可能です。注記：
- Domo Excelプラグインは、Windows版のExcelでのみ動作し、またOffice 2000以降でのみサポートされています。
- 多要素認証はExcelプラグインでは利用できません。
- 管理者レベルのユーザーとパワーユーザーレベルのユーザーは、このプラグインを使えます。
- 任意のDomoインスタンスのサーバーに接続する。
- 接続しているインスタンスから、あらゆるDataSetをExcelファイルとしてダウンロードする。
- ダウンロードしたDataSetのデータを編集する。
- フィルターされたデータまたは集計されたデータを、「クエリ表」を使ってDataSetに追加する。
- DataSetを更新する - このDataSetに変更があると、DataSetは「再ダウンロード」されます。
プラグインの設定
プラグインをダウンロードする
Excelプラグインをダウンロードするには、次の手順に従います。- ナビゲーションヘッダーで、［その他］>**［管理者］**を選択します。
- **［もっと見る］で［ツールダウンロード］**を選択します。
- ［ツールダウンロード］でDomo Excelプラグインのセクションを見つけます。
- **［EXCELプラグインを試す］**を選択します。
インストーラーファイルがダウンロードされます。
プラグインをインストールする
インストール後に表示されるウィザードまたはコマンドラインのいずれかにより、プラグインをインストールできます。ウィザードによるインストール
プラグインのダウンロードが終わったら、ウィザードに従ってコンピューターにインストールします。 これで、Excelを開くとプラグインが使用できるようになります。コマンドラインによるインストール
コマンドラインからプラグインをインストールする前に、Windowsマシンの管理者であることを確認してください。- **［スタート］**をクリックします。
- 検索バーに「cmd」と入力します。
- **［コマンドプロンプト］を右クリックし、［管理者として実行］**を選択します。デバイスに変更を加えることを確認するダイアログが表示されます。
- **［はい］を選択します。［管理者：コマンドプロンプト］**プログラムが開きます。
- 自分のマシンでDomo Excelプラグインインストーラファイルを見つけます。
- コマンドプロンプトで、Domo Excelプラグインのダウンロードファイルの保存先へのパスを、
C:\Windows\system32>\Users\user_account_name\Downloads\domoexcelsetup.msiのようなフォーマットで入力してコマンドラインを実行します。Domo Excelアドイン設定ウィザードが実行されます。 - 表示されるプロンプトに従って、Domo Excelプラグインをインストールします。
プラグインを使用する
プラグインを使用できるようにするには、次の手順に従います。- DataSetを取得したいDomoインスタンスがあるサーバーに接続します。
- 目的のDataSetをExcelにダウンロードします。
- ExcelでDataSetを編集します。
- DomoにDataSetをアップロードして戻します。
- すべてを最新状態に保つため、必要に応じてデータを更新します。
ExcelのDomoタブの各部分について
Domo Excelプラグインをインストールすると、Excelのメインタブの行の最後の方にDomoタブが表示されます。このタブは次のようになっています。
| コンポーネント | 説明 |
|---|---|
| Connect to Domo | 指定したDomoインスタンスに接続します。複数のインスタンスに同時に接続できます。既にインスタンスに接続済みの場合は、このボタンに**［Connected］**と表示されます。このようなケースでは、このオプションを使って新規接続を追加したり、接続を削除したりできます。 |
| Download | 接続されたDomoインスタンスからDataSetをダウンロードできます。複数のインスタンスに接続済みの場合は、どのインスタンスからダウンロードするか選択することができます。 |
| Upload | 編集したDataSetをDomoにアップロードして戻します。次のアップロードオプションからいずれかを選択できます。 - DataSetを、取得したときと同じDataSetにアップロードして戻す。 - DataSetを、新規DataSetとしてアップロードする。 **注記：**元のDataSetがExcelプラグインで作成、アップロードされている場合、上記2つのオプションはどちらも利用可能です。最初にダウンロードされたDataSetがExcel DataSetでない場合は、2つ目のオプションのみが利用できます。 |
| Refresh | このDataSetを更新します。Domo側でDataSetに変更があった場合は、その変更はExcel側のDataSetに反映されます。つまり、DataSetのデータを「再ダウンロード」していることになります。 |
| Linked/Not Linked | このDataSetが、Domo側の同じDataSetとリンクしているかを示します。DataSetのリンクを解除するには、**［Linked］をクリックして、［Unlink］のオプションを選択します。また、リンクされていないDataSetをDomoの元のDataSetとリンクさせるには、［Not Linked］をクリックし、［Link］**オプションを選択します。 |
| Query Tables | このExcelシートに「クエリ表」を追加することができます。「クエリ表」とは、DataSetのデータのサブセットで、オプションでフィルターや集計を追加できます。 |
| Help | このDomo Excelのバージョンを確認し、新しいバージョンがないかをチェックします。 |
Domoサーバーに接続する
アクセス権のあるDomoインスタンスのサーバーであれば、接続できます。複数のインスタンスに同時に接続できます。 サーバーに接続するには、デフォルトのセキュリティ権限が「管理者」または「パワーユーザー」である必要があります。また、「DomoAppを表示」、「DataSetを編集」、「Domoからエクスポート」、「全てのアクセストークンを管理」の許可が有効になっているカスタマイズされたセキュリティ権限を持っている場合も、接続することができます。 デフォルトのセキュリティ権限の詳細については、「ユーザーの権限と許可を管理する」を参照してください。 次の手順に従って、Domoサーバーに接続します。-
ExcelのDomoタブの左側にある**［Connect to Domo］を選択します（既にサーバーに接続中の場合は、このボタンに［Connected］**と表示されます）。接続を追加するよう促すダイアログが表示されます。
- **［Add］**を選択します。
-
フィールドにDomoサーバーのURLを入力し、**［Next］**を選択します。
-
Domoのメールアドレスとパスワードを入力し、［Next］を選択します。認証情報が正しく入力されると、手順が正常に完了したことを示すダイアログが表示されます。
- **［Finish］**を選択します。
サーバーへの接続を削除する
サーバー接続の削除は、サーバー接続の追加と同じダイアログで行います。 サーバーへの接続を削除するには：- ExcelのDomoタブ左側の**［Connected］**ボタンをクリックします。
- 切断するサーバーを選択します。
- **［Delete］**をクリックします。
- **［Yes］**をクリックして、削除を確認します。
DomoからExcelにDataSetをダウンロードする
Domoサーバーに接続すると、そのインスタンスからExcelにDataSetをダウンロードできます。DataSetをExcelにダウンロードするには、**［Download］**をクリックし、ウィザードのステップに従います。 Domo DataSetをExcelにダウンロードするには：- Domoツールバーで**［Download］**をクリックします。
- （条件付き）複数のDomoサーバーに接続している場合は、どのサーバーからデータを取得したいかを聞かれます。希望するサーバーを選択し、**［Next］**をクリックします。
- 各種フィルターオプションを使って、ダウンロードしたいDataSetを指定します。タイプ（「connector」）、所有者、またはDataSet名でフィルターできます。
- 目的のDataSetを選択し、**［Next］**をクリックします。
操作を続行すると、現在のシートにあるデータが置き換えられるという警告が表示されます。 - **［Next］**をクリックします。
- ダウンロードが終了したら**［Finish］**をクリックします。
クエリ表を作成する
ExcelのDataSetに「クエリ表」を追加することができます。「クエリ表」とは、DataSetのサブセットで、オプションでフィルターや集計を追加できます。ダウンロードされたDataSetで、クエリ表が表示される場所を指定することができます。追加したクエリ表はExcelに保存され、再利用や編集ができます。 ExcelのDataSetにクエリ表を追加するには：-
Domoツールバーで**［Query Tables］**をクリックします。
ペインが開き、追加したすべてのクエリ表がリストとして表示されます。クエリ表が追加されていない場合は、このペインは空白になります。 -
**［Add］**をクリックします。
接続されているDomoインスタンスのすべてのDataSetが、リスト表示されます。 -
クエリ表にして追加するDataSetを選択し、**［Next］**をクリックして、次の画面に進みます。
様々な検索またはフィルターオプションを使って、リストのDataSetを絞り込むことができます。
-
（条件付き）目的のオプションのラジオボタンを選択します。
- 指定した列をExcelのDataSetに取り込みたい場合は、**［Select a subset of columns from this DataSet］**を選択します。列のサブセットではなく、すべての列を取り込みたい場合は、このオプションを選択し、すべてのボックスにチェックマークを入れたままにします。
- 指定した値の列を集計する場合は、**［Create an aggregate from the DataSet］**を選択します。
-
（条件付き）手順4で列のサブセットを選択した場合は、クエリ表から除外するすべての列のボックスから、チェックを外します。集計を作成することにした場合は、最初のドロップダウンで集計する値の列を選択し、2番目のドロップダウンで希望の集計タイプを選択します。
- （オプション）必要に応じて**［Add an aggregation］**をクリックし、上記の集計に関する手順を繰り返して集計をさらに追加します。
- （オプション）このペインでオプションを選択したら、**［Refresh］**をクリックし、データのサブセットがどのように表示されるかを確認します。
- **［Next］**をクリックし、次の画面に進みます。
-
（オプション）次のようにフィルターを設定します。
- 最初のドロップダウンメニューでは、フィルターする列を選択します。
- 2番目のドロップダウンで、フィルターの条件を選択します。
-
最後のドロップダウンで、条件の値を入力します。
例えば、毎日の訪問者が20人未満の行のみをクエリ表に表示する場合は、最初のドロップダウンで［Daily Visitors］を選択し、2番目のドロップダウンで**［is less than］**を選択し、最後のボックスに「20」と入力します。
- （オプション）必要に応じて**［Add a filter］**をクリックし、上記の手順を繰り返してフィルターをさらに追加します。
- （オプション）このペインでオプションを選択したら、**［Refresh］**をクリックし、データのサブセットがどのように表示されるかを確認します。
- **［Next］**をクリックし、次の画面に進みます。
-
（オプション）クエリ表の行の順番を変更するには、最初のドロップダウンの［Order rows by］で順番を変更する列を選択し、次のドロップダウンで並べ方のタイプ（ascendingまたはdescending）を選択します。
-
（オプション）返すデータ行の数を制限するには、［Limit］の最初のドロップダウンにデータを返す最初の行番号を入力し、次のドロップダウンでデータの行数を指定します。
例えば、10行目から20行目までのデータだけを返すようにするには、両方のドロップダウンに「10」と入力します（最初の値は10行目からインポートを開始することを意味し、2番目の値はそこから10行分のデータをインポートすることを意味します）。
- （オプション）このペインでオプションを選択したら、**［Refresh］**をクリックし、データのサブセットがどのように表示されるかを確認します。
-
**［Next］**をクリックし、次の画面に進みます。
-
一番上のフィールドにクエリの名前を入力します。
表をインポートした後に**［Query Tables］**ウィザードに戻ると、表は入力した名前になっています。 -
「Insert into your spreadsheet at location」の2つのフィールドに、クエリ表を表示させたい列と行を入力します。
指定した領域にデータが既に存在する場合は、そのデータはクエリ表のデータで置き換えられることに注意が必要です。 - （条件付き）クエリ表にヘッダーを含めたくない場合、最初のボックスのチェックを外します。それ以外の場合は、チェックを入れたままにします。
- （条件付き）クエリ表の最初のセルをハイライトしたくない場合（それがクエリ表であることを示すため）、最初のボックスのチェックを外します。そうでない場合は、チェックを入れたままにします。
- **［Next］**をクリックし、クエリ表をExcelにダウンロードします。
ExcelからDomoにDataSetをアップロードする
Excelを使ってDomoのDataSetへの変更が完了したら、それをDomoにアップロードして戻します。これには、次の2通りの方法があります。- DataSetを、取得したときと同じDataSetにアップロードして戻す。
- DataSetを、新規DataSetとしてアップロードする。
DataSetを元のDataSetにアップロードして戻す
この方法でDataSetをDomoにアップロードすると、更新されたコンテンツは元のDataSetを置き換えます。 DataSetを元のDataSetにアップロードして戻すには：- Domoツールバーで**［Upload］**をクリックします。
- **［Upload data to currently linked DataSet “[your DataSet]“］を選択し、［Next］**をクリックします。
操作を続行すると、現在DomoのDataSetにあるデータが置き換えられるという警告が表示されます。 - **［Next］**をクリックします。
- アップロードが完了したら、**［Finish］**をクリックします。
新規DataSetを作成する
このオプションを選ぶと、現在開いているシートの内容を使って、Domoに新規のDataSetが作成されます。DataSet名とDomoインスタンス（複数のDomoサーバーに接続されている場合）を指定します。ヘッダーを最初の行に表示させるなど、いくつかのオプションを設定することもできます。 現在開いているシートの内容を使ってDomoに新しくDataSetを作成するには：- Domoツールバーで**［Upload］**をクリックします。
- **［Create a new DataSet in Domo］を選択し、［Next］**をクリックします。
-
**［Data Handling］**ダイアログで、オプションを次のように設定します。
- **［DataSet Name］**フィールドに、新しいDataSetの名前を入力する。
- （条件付き）複数のDomoサーバーに接続している場合は、**［Domo Instance］**メニューで、新しいDataSetの保存先となるインスタンスを選択する。
- （オプション）DataSetの最初の行をヘッダー行にする場合は、**［First row contains headers］**のボックスをチェックする。
- （オプション）除外する最初の行と最後の行を入力して、DataSetに取り込むデータ範囲を指定する。例えば、新規DataSetには2行目から最後の行までが含まれるようにするには（つまり、最初の行を除外するには）**［Ignore First Rows］**のボックスに「1」と入力する。
- すべてのオプションを指定したら、**［Next］**をクリックします。
- **［Next］**をクリックします。
- アップロードが終了したら**［Finish］**をクリックします。
シートのデータを更新する
現在開いているExcelのシートにDataSetからダウンロードされたデータが含まれている場合、そのDataSetのデータがDomo側で変更されると、シートのデータを更新するかを確認するダイアログが表示されます。［Yes］を選ぶと、現在開いているシートのデータが、DomoのDataSetデータに置き換えられます。このダイアログを手動で開くには、**［Refresh］**オプションを選択します。元のDataSetへのリンクが解除されている場合、このオプションは表示されません。 シートのデータを更新するには：- Domoタブの**［Refresh］をクリックし、Domoデータソースダウンロードウィザードを開きます（リンクされたDataSetがDomo側で変更されるとダイアログが表示されるので、データを更新するか否かを選択します。［Yes］**をクリックすると、ウィザードに進みます）。
- **［Next］**をクリックします。
- ダウンロードが終了したら**［Finish］**をクリックします。
DataSetのリンクを解除、または再リンクする
DomoからDataSetをダウンロードすると、デフォルトではダウンロードされたデータは元のDataSetとリンクされた状態を維持しています。これを避けたい場合は、アップロードの準備ができるまで、ダウンロードしたデータとDomoのDataSetとのリンクを解除しておくことができます。これにより、どちらかのバージョンで変更があっても、もう片方のデータが同時に変更されるのを防ぐことができます。 ダウンロードされたデータと元のDataSetとのリンクを解除するには：- Domoツールバーの**［Linked］**ボタンをクリックします。
- **［Unlink from “[DataSet Name]”］**をクリックします。
- Domoツールバーの**［Not Linked］**ボタンをクリックします。
- **［Link to “[DataSet Name]”］**をクリックします。
トラブルシューティング
クラッシュ後にマイクロソフトがプラグインを無効にしてしまう問題が複数のお客様から報告されています。無効になったあともプラグインはインストールされていますが、Domoタブは表示されなくなります。プラグインを再インストールしても、無効の状態のままです。この場合、プラグインを再度有効にする方法は次の通りです。 Excelプラグインを再度有効にするには、次の手順に従います。- Excelを開きます。
- ［ファイル］>**［オプション］**の順に選択します。
- **［アドイン］**を選択します。
-
**［管理］ドロップダウンメニューで、［COMアドイン］を選択し、［設定］**をクリックします。
-
**［DomoExcel］の横のボックスにチェックマークを入れ、［OK］**をクリックします。
- Windowsのコントロールパネルで、**［プログラムの追加と削除］**に進みます。
- 「Domo Excel」のインスタンスをすべて削除します。
- プラグインを再インストールします。
- Chromeがデフォルトのブラウザーに設定されていない場合は、認証ウィンドウを表示させるためにChromeをデフォルトブラウザーに設定します。
- Excelプラグインでの認証の前に、Domoからサインアウトしてください。
- ご自身のマシンで管理者権限でプラグインをアンインストールして、再インストールします。
- （推奨）次の手順に進む前に、システムバックアップを実行します。
- Windowsの実行ウィンドウを開きます（WIN+R）。
- 「Regedit」と入力します。
- **［レジストリエディター］**でHKEY_CURRENT_USER\SOFTWARE\Domo\Office\Connectionに移動します。
- 右クリックして**［Delete Registries］**を選択します。
- HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\ClickToRun\REGISTRY\MACHINE\Software\Wow6432Node\Domo\Office\Connectionに移動します。
- 右クリックして**［Delete Registries］**を選択します。
- Excelプラグインを再インストールします。