Workbench 5ユーザーインターフェースについて
はじめに
Workbenchアプリケーションでは、Domoサーバーに接続したり、DataSetジョブ作成のための設定をしたり、またジョブファイルをインポートやエクスポートしたりできるほか、ジョブのプレビュー、スケジュール設定、検証、実行を行うことができます。
このトピックでは、Workbenchのユーザーインターフェースコンポーネントについて説明します。
インターフェースの概要
Workbench 5のユーザーインターフェースはとてもシンプルです。画面の左側の垂直バーには、さまざまなアイコンが表示されます。各アイコンからは、ジョブの作成、ジョブステータスの表示、セキュリティオプションの設定などを行うためのさまざまなタブにアクセスできます。
これらのタブには、1つのペインで構成されるタブもあれば、(前のスクリーンショットに示す [詳細] タブのように)サブタブ間を移動するための追加のペインがあるタブもあります。この追加のペインを非表示にするには、アイコンバーの最上部にあるアイコンをクリックします。
アイコンバーにされるアイコンとその関連タブについては、次の表を参照してください。
アイコン |
名前 |
説明 |
---|---|---|
|
トグルメニュー |
特定のタブ([アカウント] タブや [詳細] タブなど)に表示される追加のナビゲーションペインを非表示/表示します。 |
|
ホーム |
[ホーム] タブを開きます。このタブには、実行されたジョブのステータスと成功率が表示されます。 |
|
アカウント |
[アカウント]] タブを開きます。このタブでは、新しいアカウントを追加したり、アカウントを再認証または削除したり、追加のアカウント設定オプションを指定したりできます。 |
|
ジョブ |
[ジョブ タブを開きます。このタブでは、DataSetジョブを追加および設定したり、追加したジョブに関する情報を表示したりできます。 |
|
詳細 |
[詳細] タブを開きます。このタブでは、セキュリティ設定、登録済みのプラグインのリスト、インポートおよびエクスポートオプション、ログビューアなど多数の追加オプションにアクセスできます。 |
|
プレビューウィンドウ |
[プレビューウィンドウ] タブを開きます。このタブでは、[ジョブ] タブからすでにプレビューしたジョブのプレビューを開くことができます。アイコンの横の数字は、この数のジョブのプレビューが利用可能であることを示します。 |
|
ヘルプ |
[ヘルプ] タブを開きます。このタブからは、ビデオやナレッジベース記事などのさまざまなDomoヘルプリソースにアクセスできます。 |
これらの各ペインについては、以下で詳しく説明します。
ホームタブ
[ホーム] タブにアクセスするには、アイコンバーのをクリックします。このタブでは、実行済みのすべてのDataSetジョブのステータスを表示できます。このタブには、合計実行数、Domoにアップロードされたデータの合計行数、アップロードされたデータの量、平均成功率が表示されます。
アカウントタブ
[アカウント] タブにアクセスするには、アイコンバーのをクリックします。
このタブでは、次のことがすべてできます。
-
アカウントリストの上にある+ボタンをクリックして必要な情報入力することで、アクセスできるDomoインスタンスのアカウントを追加する
-
左側のペインにあるリストで目的のアカウント名をクリックすることで、さまざまなアカウントの詳細を表示する
-
アカウントのジョブ確認間隔(Workbenchが、ジョブが実行中かどうかを確認する時間(分))を変更する
-
アカウントの証明書エラーを無視するかどうかを指定する
-
認証情報が変更された可能性があるアカウントを再認証する
-
アカウントを再認証した後、画面の最上部にある
アイコン(変更を保存する前にのみ利用可能)をクリックして前のアカウント設定に戻す
-
画面の最上部にある
アイコンをクリックして不要なアカウントを削除する
詳細は、「Workbench 5でアカウントを追加する」を参照してください。
ジョブタブ
[ジョブ] タブにアクセスするには、アイコンバーのをクリックします。
ジョブリスト
[ジョブ] タブを開くと、追加したすべてのDataSetジョブのリストが、実行済みかどうかに関係なく、ウィンドウの左側のペインに表示されます。リストの各ジョブには、ジョブのステータスを示すアイコンがあります。アイコンは次のとおりです。
アイコン |
説明 |
---|---|
|
ジョブ設定が変更されましたが、まだ保存されていません。 |
|
ジョブが保存されましたが、プレビューはまだ開かれていません。 |
|
ジョブが保存され、プレビューが実行されました。 |
リストで現在選択しているジョブの詳細が右側のペインに表示されます。
どのジョブについても、次のすべての情報を確認できます。
-
ジョブのステータス(「準備完了」、「実行中」、「無効」、「エラー)。
-
ジョブが関連付けられているDomoドメイン(アカウント)。ジョブが実行されると、生成されたDataSetがDomoドメインに送信されます。
-
ジョブの名前。ジョブの行をダブルクリックし、[概要] サブタブで新しい名前を入力することで、ジョブの名前を変更できます。
-
DataSetタイプ。このジョブが実行されたときにDomoにプッシュされるDataSetのタイプ(Excel、JIRAなど)。ジョブのDataSetタイプは、そのジョブを作成するときに指定します。ジョブを作成した後にDataSetタイプを変更することはできません。
-
このジョブが最後に実行された日時。
-
ジョブを最後に実行したときに生成された成功/不成功メッセージ。
-
次にスケジューリングされているジョブの実行(このジョブのスケジューリングを設定していない場合は表示されません。詳細は、「Workbench 5でジョブをスケジューリングする」を参照してください)。
新規ジョブペイン
[DataSetジョブ] ペインの「+」ボタンをクリックすると、[新規ジョブ] ペインが表示されます。
このペインでは、次のようなジョブの詳細を指定できます。
フィールド/メニュー |
説明 |
||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Domoドメイン |
ジョブに関連付けるDomoインスタンス。ジョブを実行すると、生成されたDataSetはこのドメインに表示されます。このメニューは、[アカウント] タブで追加したアカウントから自動入力されます。 |
||||||||||||||||||||||||
ジョブ名 |
Workbenchに表示されるこのジョブの名前(Domoで生成されるDataSetの名前は、 [DataSet名] フィールドで指定します)。 |
||||||||||||||||||||||||
トランスポートタイプ |
トランスポートのタイプ。これにより、このデータソースがWorkbenchにどのように転送されるかが決まります。オプションはトランスポートタイプによって異なります。追加のオプション(ローカルファイル、JIRAクエリなど)は、ジョブを作成した後まで指定しないことに注意してください。トランスポートタイプは次のとおりです。
|
||||||||||||||||||||||||
読み取りタイプ |
Domoに転送するデータの読み取り(データソース)タイプを指定します。使用可能な設定オプションは、選択した読み取りタイプによって異なります。使用可能な読み取りタイプは次のとおりです。
|
||||||||||||||||||||||||
DataSet名 |
Domoにインポートされた後のDataSetの名前。 |
||||||||||||||||||||||||
DataSetタイプ |
Domoにインポートされた後のこのデータを表すコネクター。 |
||||||||||||||||||||||||
DataSetの説明(オプション) |
Domoにインポートされた後のこのDataSetに付随する説明。 |
ジョブ設定ペイン
[ジョブリスト] ペインのジョブをダブルクリックすると、[概要]、[設定]、[スケジュール]、[スキーマ]、[お知らせ]、[履歴] の6つのサブタブがある設定画面が表示されます。これらのサブタブには、Domoに送信する前にデータを設定するためのさまざまなオプションがあります。
どのサブタブでも右上隅に次のアイコンが表示されます。
-
現在選択しているジョブのプレビューを開きます。ジョブのプレビューを開いたら、Workbenchの左側にあるアイコンバーの
をクリックし、左側のペインのリストで目的のジョブを選択することで、そのプレビューをすばやく表示できます。
-
選択したジョブの現在の設定を保存します。
-
現在選択されているジョブの、以前の設定に戻します。
-
現在選択されているジョブを実行します(データをDomoにプッシュします)。
-
現在選択されているジョブを削除します。
概要サブタブ
DataSetジョブの [概要] サブタブには、次のすべてのデータが表示されます。
-
最後のジョブの実行に関連する統計情報(日時、ステータス、更新された行の数など)。
-
ジョブが最初に作成されたときにジョブに指定された詳細(関連するドメイン、ジョブ名、トランスポートタイプと読み取りタイプ、DataSetの説明など)。これらの詳細のうち、この画面で変更できるのは、ジョブの名前、DataSetの説明、データをプッシュするDataSet(次のパラグラフで説明します)だけです。ドメイン、トランスポート/読み取りタイプ、DataSetタイプを変更する場合は、それらの変更を反映させた新しいジョブを作成する必要があります。
「DataSet名」では、データのプッシュ先のDomo DataSetを変更できます。デフォルトでは、Workbenchは、ユーザーがジョブの作成時に指定した名前をもつ新しいDataSetに、データをプッシュします。ただし、既存のDataSetにデータをプッシュする場合は、[参照] をクリックし、[DataSetを選択] ダイアログで目的のDataSetを選択できます。このダイアログには、以前にWorkbenchからプッシュされたことがある、ユーザーがアクセス可能なすべてのDataSetが表示されます。このリストでは、タイプや所有者でDataSetにフィルターをかけたり、名前で特定のDataSetを検索したりできます。
設定サブタブ
DataSetジョブの [設定] サブタブでは、ジョブのさまざまなオプションを設定できます。
各オプションの詳細は次の表で確認できます。
オプション |
説明 |
---|---|
ソース |
ジョブのデータソースを設定できます。オプションは、ジョブの作成時に選択したトランスポートタイプと読み取りタイプによって異なります。たとえば、ローカルに保存されているExcelファイルをデータソースとして指定した場合は、ここでお使いのマシンから目的のファイルを選択します。すべてのトランスポートタイプと読み取りタイプのオプションについては、「ソースと処理オプション」を参照してください。 |
処理 |
ジョブの処理オプションを設定できます。オプションは、ジョブの作成時に選択したトランスポートタイプと読み取りタイプによって異なります。たとえば、CSVファイルの場合は、デリミターを設定したり、見つからないフィールドの処理方法を指定したりできます。すべてのトランスポートタイプと読み取りタイプのオプションについては、「ソースと処理オプション」を参照してください。 |
更新方法 |
更新時に、新しいデータでDataSetの既存のデータを置き換えるか、新しいデータを既存のデータに追加するかを決定します。 |
変換を追加 |
データソースに変換を追加できます。変換を使用すると、データをDomoにアップロードする前にローカルで変更できます。さまざまな変換が利用可能です。データに計算フィールドを追加したり、列を結合したり、暗号化を設定したりできます。変換タイプに関する詳細は、「変換」を参照してください。 |
偽装が必要 |
このジョブを特定のActive Directoryユーザーとして実行できます。このボックスをオンにした場合、WorkbenchはすべてのDataSetジョブに対してデフォルト以外の認証情報を要求します(つまり、すべてのジョブで [偽装が必要] トグルがオフになり、オンに戻すことができなくなります)。このオプションは、管理者の権限を持っている場合にのみ有効です。 |
エラー処理 |
DataSetジョブでエラーが発生した場合の処理方法を指定します。オプションは次のとおりです。
|
長時間実行されているジョブを終了するタイミング |
長時間実行されているジョブを終了する時間枠(時間単位)を指定できます。オプションは次のとおりです。
|
スケジューリングサブタブ
DataSetジョブの [スケジューリング] サブタブでは、ジョブの実行頻度を選択できます。
使用できるオプションは次のとおりです。
-
手動で更新ジョブはスケジュールに従って実行されません。Workbenchから手動で実行する必要があります。
-
ファイルが変更されたときに更新DataSetジョブはファイル更新がされるたびに実行されます。データベースデータソースには使用できません。
-
スケジュールに従って更新ジョブは設定したスケジュールに従って実行されます。オプションには、[15分おき] から [毎月] まであります。
-
指定された期間中にのみ実行ジョブはスケジュールに従って実行されますが、そのスケジュール内の特定の期間中にのみ実行されます。たとえば、1時間に一度、ただし午前9:00時~午後5:00時の間だけ実行するようDataSetに指示できます。
DataSet の更新に関する詳細は、「KPIカードのDataSetを更新する」を参照してください。
スケジュール設定に関する詳細は、「Workbench 5でジョブをスケジューリングする」を参照してください。
スキーマサブタブ
DataSetジョブの [スキーマ] サブタブでは、データをDomoにアップロードする前にスキーマ設定を変更できます。たとえば、列名やデータタイプを変更したり、特定の列を含めたり、除外したりできます。
[Schema] インターフェースの各コンポーネントに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
ソース列 |
元のデータソースでのこの列の名前。ソース列とは、相互作用することはできません。すべての変更は、宛先列(つまり、このDataSetジョブを実行した後のDomoのDataSetの列)に適用されます。 |
宛先列 |
Domo DataSetでのこの列の名前。列に対して行った変更は、元のデータソースの列ではなく、この列に適用されます。宛先列の名前を変更するには、名前フィールドをクリックして目的の名前を入力します。 |
データタイプ |
特定の列のデータタイプを示します。データタイプを変更するには、フィールドをクリックし、新しいデータタイプをメニューから選択します。利用可能なデータタイプは次のとおりです。
|
含める |
この列のデータをDomoのDataSetに表示するかどうかを指定します。各列のヘッダーで [含める] をオンまたはオフにして、アップロードするデータの列を選択できます。 |
データタイプをロック |
列でこのボックスをオンにした場合、ユーザーはDomoでその列のデータタイプを変更できません。 |
通知サブタブ
DataSetジョブの [通知] サブタブでは、ジョブが正常に完了したとき、または失敗したときに通知するDomoインスタンス内のユーザーを指定できます。インスタンス内のどのユーザーについても、ジョブが成功したときに通知するか、失敗したときに通知するか、どちらの場合でも通知するかを指定できます。通知に関する詳細は、「Workbench 5で通知を設定する」を参照してください。
履歴サブタブ
DataSetジョブの [履歴] タブでは、[Webで開く] をクリックして、ジョブに関連付けられているDomoインスタンス内のDataSetの [履歴] タブを表示できます。Domoのこのタブに関する詳細は、「DataFlowの詳細を閲覧する」を参照してください。[ログビューアで開く] をクリックしてこのジョブのローカルログを表示することもできます。
詳細タブ
[詳細] タブにアクセスするには、アイコンバーのをクリックします。このタブは、次のようないくつかのサブタブで構成されています。
サブタブ名 |
説明 |
---|---|
プロキシ |
プロキシサーバーを使用してより安全にDomoに接続するための設定を指定できます。 |
設定 |
このマシンでジョブを実行および編集できるユーザーを管理したり、システムパフォーマンスを最適化したり、自動更新をインストールしたりするための設定を行うことができます。 |
プラグイン |
登録済みのプラグインのリストが表示されます。新しいプラグインを追加することもできます。 |
インポート |
以前にエクスポートしたDataSetジョブをインポートできます。 |
エクスポート |
DataSetジョブをバックアップおよびエクスポートできます。 |
ログビューア |
ログビューアを開き、ジョブの実行に関する詳細を確認できます。 |
レガシースケジュール |
古いバージョンのWorkbenchを使用して作成したジョブスケジュールの管理に関する情報が表示されます。 |
これらのサブタブについては、以下で詳しく説明します。
プロキシサブタブ
[プロキシ] サブタブでは、プロキシサーバーを使用してより安全にDomoに接続するための設定を指定できます。
このタブのコンポーネントに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
プロキシサーバーを使用しない |
接続にプロキシサーバーを使用しません。 |
プロキシ設定を自動検出する |
プロキシ設定を自動で決定します。 |
システムプロキシ設定を使用 |
システムのプロキシ設定に基づいてプロキシ設定を決定します。 |
プロキシを手動で設定する |
接続に使用するプロキシサーバー情報を手動で指定できます。これは、初めてWorkbench経由でDomoに接続した後でのみ行うことができます(最初に接続する際は、システムのプロキシ設定が使用されます)。 サーバーアドレスとポートを入力する必要があります。 プロキシサーバーに認証情報が必要な場合は、[認証が必要] を [オン] に設定し、ユーザー名とパスワードを指定します。 |
プロキシの認証情報を入力したら、テスト用Domo URLを入力し、[プロキシをテストする] をクリックして、接続をテストできます。ボタンの隣のアイコンの色は、プロキシ設定が検証されたかどうかを示します。
設定サブタブ
[設定] サブタブでは、このマシンでジョブを実行および編集できるユーザーを管理したり、システムパフォーマンスを最適化したり、自動更新をインストールしたりするための設定を行うことができます。
以下の表で、このタブのコンポーネントに関する詳細を確認できます。
オプション |
説明 |
---|---|
ローカルに管理されているジョブだけ実行する |
これをオンにすると、Workbenchはネットワークではなく、ローカルに管理されているDataSetジョブのみを実行します。 |
すべてのジョブに偽装の認証情報を必須とする |
これをオンにすると、WorkbenchはすべてのDataSetジョブに対してデフォルト以外の認証情報を要求します(つまり、すべてのジョブで [偽装が必要] トグルがオフになり、オンに戻すことができなくなります)。このオプションは、管理者の権限を持っている場合にのみ有効です。 |
ジョブプロセスを通常よりも低い優先度で実行 |
Windowsタスクマネージャーで、対象となるジョブの優先度を「通常よりも低い」に設定します。さまざまなプロセスが多く実行されている場合、処理速度を向上させるのに役立つことがあります。 |
同時実行ジョブを制限する |
同時に実行できるDataSetジョブ数を制限できます。 |
アップデートを自動的にインストールする |
オンにすると、Workbenchによってすべてのアップデートが自動的にインストールされます。 |
プラグインサブタブ
[プラグイン] タブには、Workbench 5のすべてのプラグインとその名前、パブリッシャー、バージョン番号、説明、アセンブリー名が表示されます。検索パスを入力して登録済みのプラグインリストにプラグインを追加することもできます。
Workbenchへのプラグインの追加に関する詳細は、「Workbench 5でプラグインを管理する」を参照してください。
インポートサブタブ
[インポート] タブでは、以前にWorkbenchの [エクスポート] タブからエクスポートしたジョブをインポートできます。上部のメニューで、インポートするジョブに関連付けるWorkbenchアカウントを選択します。その後、[参照] をクリックして目的のファイルに移動することで、使用マシン上でインポートするファイルを見つけることができます。選択したファイルは、ペインの下部にある [インポートするジョブ] リストに表示されます。リストの準備ができたら、[インポート] をクリックしてファイルをWorkbenchに取り込みます。
ジョブのインポートに関する詳細は、「Workbench 5のジョブをバックアップする」を参照してください。
エクスポートサブタブ
[エクスポート] タブでは、ジョブをJSON形式でエクスポートできます。まず、ジョブを保存するフォルダを選択します。アカウント(Domoインスタンス)ごとに別々の保存フォルダを作成する場合は、ここで指定できます。次に、エクスポートするすべてのファイルのボックスをオンにしてから、[ジョブをエクスポート] をクリックします。
ジョブのエクスポートに関する詳細は、「Workbench 5のジョブをバックアップする」を参照してください。
ログビューアサブタブ
[ログビューア] タブでは、[ログビューアを開く] をクリックしてDataSetのログを開くことができます。ログビューアが開いたら、Domoドメイン、ジョブID、開始/終了日を使ってログにフィルターをかけることができます。[サービスログを含める] ボックスをオンまたはオフにすることで、サービスログを含めるかどうかを選択できます。[Zipログ] をクリックしてログをzipファイルにパッケージ化することもできます。
レガシースケジュールサブタブ
Workbench 5ではレガシースケジュールはサポートされないため、レガシースケジュールを使用する場合は、スクリプトとスケジュールを管理する必要があります。これを行うには、Workbench CLIツールを使用します。このツールに関する情報は、[レガシースケジュール] タブに表示されています。
プレビューウィンドウタブ
[プレビューウィンドウ]] タブを開くには、アイコンバーのをクリックします。このタブでは、[ジョブ] タブからすでにプレビューしたジョブのプレビューを開くことができます。アイコンの横にある数字は、この数のジョブがプレビュー可能であることを示します(たとえば、アイコンが
と表示される場合は、[ジョブ] タブの2つの異なるジョブのプレビューが開いていることを示します)。
アイコンをクリックすると、2つのペインが表示されます。左側のリストペインでは、プレビューするジョブを選択できます。右側のペインは2つのセクションに分かれています。1つはプレビューのログデータを提供する [出力] セクションで、もう1つはデータソースの列を表示する [データプレビュー] セクションです。
ヘルプタブ
[ヘルプ] タブにアクセスするには、アイコンバーのをクリックします。[ヘルプ] タブを開きます。このタブからは、ビデオやナレッジベース記事などのさまざまなDomoヘルプリソースにアクセスできます。
ソースオプションと処理オプション
DataSetジョブの [設定] サブタブ([ジョブ] タブのリストにあるジョブをダブルクリックすると表示されます)では、データソース(ファイルが置かれている場所)と処理オプション(選択したデータソースのプロパティ)を設定します。
ソースオプション
DataSetジョブの [ソース] を設定し、そのジョブのデータが置かれている場所を指定します。
ジョブの作成時に([トランスポートタイプ] を選択して)ソースタイプを設定しますが、実際のデータソースは上記のジョブの [設定] サブタブで指定します。オプションはソース/トランスポートタイプによって異なります。
ローカルファイルプロバイダー
ローカルまたはネットワーク上の場所からExcel、CSV、QuickBooks、JSON、XMLデータソースをDomoに引き込むには、[ローカルファイルプロバイダー] トランスポートタイプを使用します。DataSetジョブの作成時にこのオプションを選択した場合は、[設定] サブタブ内の [ソース] ダイアログから、ローカルファイルのファイルパスを指定できます。
以下のスクリーンショットは、この方法を選択した場合のオプションを示したものです。
このオプションに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
ファイルパス |
Workbenchに取り込むローカルファイルのパスを指定します。 |
外部ネットワーク上のファイル | ファイルがネットワークパス(マップされたドライブまたは完全修飾パス)上にあるかどうかを指定します。 |
ネットワークユーザー名/パスワード(スクリーンショットには表示されていません) |
ファイルがあるネットワークのユーザー名とパスワードを指定します(存在する場合)。 |
SFTPファイルプロバイダー
FTP、SFTP(SSH-SFTP)、またはFTPS(FTP-SSL)を使用してExcel、CSV、QuickBooks、JSON、XMLデータソースをDomoに取り込むには、[SFTP] トランスポートタイプを使用します。DataSetジョブの作成時にこのオプションをトランスポートタイプとして選択した場合は、[設定] サブタブの [ソース] ダイアログにサーバーとSSL証明書の設定オプションが表示されます。
以下のスクリーンショットは、この方法を選択した場合のオプションを示したものです。
このオプションに関する詳細は次の表で確認できます
オプション |
説明 |
---|---|
サーバー |
FTPサーバーのサーバーURLを指定します。 |
ポート | FTPサーバーのポート番号を指定します。 |
ユーザー名 |
サーバーへの接続に使用するユーザー名を指定します。 |
パスワード |
サーバーへの接続に使用するパスワードを指定します。 |
プロトコル |
FTP、SFTP、FTPSのどれを使ってデータを取得するかを指定します。 |
ホスト鍵の指紋(SSL 証明書設定) |
SSL証明書のホスト鍵の指紋を指定します(必要な場合)。ホストの指紋は、SFTP サーバーが目的のものと同一であることを確認するために使用されます。 |
信頼できないサーバー証明書を許可する |
信頼の条件を満たさないSSL証明書をアップロードできるようにします。自己署名証明書を使用している場合は、このボックスにチェックを入れる必要があります。 |
PKCS#8ファイル(SSL証明書設定) |
SSL証明書のPKCS#8ファイルを指定します。これは、より安全な認証のために、ユーザー名とパスワードの認証情報と共に使用されます。 |
パスワード(SSL証明書設定) |
SSL証明書のパスワードを指定します。 |
リモートファイル |
接続するファイルのファイルパスを指定します。 |
外部プロセスファイルプロバイダー
サードパーティアプリケーションでスクリプトを使ってExcel、CSV、QuickBooks、JSON、XMLデータをDomoに引き込む場合は、外部プロセスファイルプロバイダートランスポートを使用します。DataSetジョブの作成時にこのオプションをトランスポートタイプとして選択した場合は、[設定] サブタブの [ソース] ダイアログでアプリケーションの実行可能ファイルを選択し、引数を指定して、出力のパスを入力できます。CSVファイルの場合は、[直接アップロード] オプションも設定できます。Workbenchでは、あらゆる種類の実行可能ファイルをデータソースに変換できます。たとえば、この方法を使ってMySQLデータベースファイルをExcelファイルに変換できます。その後、Excelファイルのオプションを設定して、Domoに送信できます。
以下のスクリーンショットは、この方法を選択した場合のオプションを示したものです。
これらのオプションに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
プログラムの実行ファイル |
Domoにデータを取り込むのに使うアプリケーション実行ファイルを選択できます。 |
引数 |
スクリプトの引数を指定します。 |
出力ファイルパス |
出力のファイルパスを指定します。ファイルタイプは、Workbench DataSetジョブ作成ウィザードで選択したデータソースタイプと同じである必要があります。 |
直接アップロード(CSVのみ)(スクリーンショットには表示されていません) | このジョブの直接アップロードをオンにできます。詳しくは、「Workbenchで直接アップロードを設定する」を参照してください。 |
OLEDB接続プロバイダー
OLEDB(OLAP)接続を使ってDomoにデータを送信する場合は、[OLEDB接続プロバイダー] トランスポートを使用します。DataSetジョブの作成時にこのオプションをトランスポートタイプとして選択した場合は、[設定] サブタブの [ソース] ダイアログにOLAPデータソースへの接続オプションが表示されます。
以下のスクリーンショットは、この方法を選択した場合のオプションを示したものです。
このオプションに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
OLAP接続 |
接続ビルダーが開き、OLAP接続の詳細を指定できます。 |
32b実行が必要(スクリーンショットには表示されていません) |
このファイルトランスポートに32ビット実行が必要かどうかを指定します。 |
データソース |
データベースが格納されているサーバーを指定します。 |
プロバイダー |
MSOLAPまたはEssbaseのどちらかのプロバイダーを選択します。 |
カタログ |
OLAP接続の初期カタログを指定します。 |
ユーザー名 |
このOLAP接続のユーザー名を指定します。 |
パスワード |
OLAP接続のパスワードを指定します。 |
OLAPデータに接続する方法の詳細は、「OLAPキューブに接続する」を参照してください。
ODBC接続プロバイダー
ODBC接続を使ってDomoにデータを送信する場合は、[ODBC接続プロバイダー] トランスポートを使用します。DataSetジョブの作成時にこのオプションをトランスポートタイプとして選択した場合は、[設定] サブタブの [ソース] ダイアログにODBCデータソースへの接続オプションが表示されます。
ODBCデータには、3つの異なる方法で接続できます。システムのDSNを選択するか、接続の詳細を入力するか、単一の接続文字列を入力することで接続できます。[接続タイプ] メニューで必要な接続オプションを選択します。
システムのDSN
[システムのDSN] オプションでは、システムで利用可能なすべてのDSNから、目的のDataSetに使用するDSNを指定します。認証が必要かどうかを指定できます。
注記:ODBC DataSetからデータをアップロードするには、既存のデータソース名(DSN)を指定する必要があります。DSNは、Windows ODBC データソースアドミニストレーターを使用して作成できます(Windows ODBC データソースアドミニストレーターにアクセスするには、スタートメニューの検索で「ODBC」と入力し、「データソース(ODBC)」を選択します)。DSNの作成に関する詳細は、Windows ODBCヘルプ(Windowsヘルプとサポートで「ODBC」を検索)を参照するか、Workbench 5にある以下のトレーニングビデオを参照してください。MySQL ドライバ設定の詳細は、「Workbench 5に関するよくある質問」を参照してください。
DataSet名(DSN)の定義方法、およびOpen Database Connectivity(ODBC)を使用したデータへのアクセスに関する情報は、ODBCの資料を参照してください。
以下のスクリーンショットは、[システムのDSN] を [接続タイプ] として選択した場合のオプションを示したものです。
このオプションに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
システムのDSN |
システムで利用可能なDSNから、目的のDataSetに使用するDSNを指定できます。 |
認証情報が必要 |
指定したDSNに認証が必要かどうかを指定します。 |
ユーザー名 |
データベースへの接続に使用するユーザー名を指定します。 |
パスワード |
データベースへの接続に使用するパスワードを指定します。 |
詳細は、「ODBCデータに接続する」を参照してください。
接続ビルダー
[接続ビルダー] オプションでは、ログイン認証情報、ドライバ、サーバーのURLなどのODBC接続の詳細を入力します。
以下のスクリーンショットは、[接続ビルダー] を [接続タイプ] として選択した場合のオプションを示したものです。
このオプションに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
ドライバ |
データベースへのアクセスに使用されるドライバの名前を指定します。 |
サーバー |
データベースのサーバー名またはURLを指定します。 |
ポート |
データベースのあるポート番号を指定します。デフォルトのポートは、MySQLのポートです。 |
データベース |
アクセスするデータベースの名前を指定します。 |
タイムアウト |
DataSetから更新が行うまで接続を継続するタイムアウト値を、秒数(60=1分)で指定できます。 |
ユーザー名 |
データベースへの接続に使用するユーザー名を指定します。 |
パスワード |
データベースへの接続に使用するパスワードを指定します。 |
接続パラメータ |
DataSetに接続するための追加パラメータを指定できます。 |
詳細は、「ODBCデータに接続する」を参照してください。
接続文字列
[接続文字列] オプションでは、ODBC接続用の単一の文字列を入力します。
以下のスクリーンショットは、[接続文字列] を [接続タイプ] として選択した場合のオプションを示したものです。
このオプションに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
接続文字列 |
DataSetに接続するための接続文字列を入力できます。 |
32ビット実行が必要 |
この接続に32ビット実行が必要かどうかを指定します。 |
詳細は、「ODBCデータに接続する」を参照してください。
JIRA接続プロバイダー
JIRAまたはJSONデータをDomoに送信する場合は、[JIRA接続プロバイダー] トランスポートを使用します。DataSetジョブの作成時にこのオプションをトランスポートタイプとして選択した場合は、[設定] サブタブの [ソース] ダイアログにJIRA認証情報とJQLクエリの入力オプションが表示されます。
以下のスクリーンショットは、この方法を選択した場合のオプションを示したものです。
このオプションに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
ユーザー名 |
JIRAインスタンスへの接続に使用するユーザー名を指定します。 |
パスワード |
JIRAインスタンスへの接続に使用するパスワードを入力します。 |
サーバーのURL |
会社のJIRAサーバーのURLを指定します。 |
JIRAクエリ |
Domoに送信するJIRAデータのクエリを指定します。 |
詳細は、「Workbench 5でJIRAデータに接続する 」と「Workbench 5でJSONデータに接続する」を参照してください。
処理オプション
DataSetジョブの [処理] オプションを設定し、Domoに送信する前にデータソースのプロパティを指定します。
[Edit] をクリックしたときに表示されるオプションは、DataSetジョブを追加したときに選択した読み込みタイプによって異なります。たとえば、読み込みタイプで [CSV] を選択した場合は、区切り文字を設定するオプションや開始行と終了行を指定するオプションなどが表示されます。一方、[OLAP] を選択した場合は、クエリの作成を中心としたオプションが表示されます。
CSV
DataSetジョブの作成時に [CSV] を読み込みタイプとして選択した場合は、[設定]サブタブの [処理] ダイアログに、区切り文字とエスケープシーケンス文字を指定するためのオプションと高度な設定を行うためのオプションが表示されます。
注記:
- Domo内のDataSetの名前や説明は、他のユーザーがDomoで編集した場合には、Workbenchでの名前や説明と異なるものになる場合があります(DataSetの名前や説明が一致していなくても、データのアップロードは正常に実行されます)。
- CSVファイルは、次の条件を満たしている必要があります 。
- テキストファイルであること
- データが単一の文字で区切られていること
以下のスクリーンショットは、この読み込みタイプを選択した場合のオプションを示したものです。
このコンポーネントに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
フィールド区切り文字 |
指定したCSVファイルで使用する区切り文字を指定します。 |
次の文字でフィールドをカプセル化する |
フィールドをカプセル化するために使用する文字を指定します。 |
エスケープシーケンス文字 |
エスケープに使用する文字を指定します。 |
コメント文字 |
コメントに使用する文字を指定します。 |
欠落しているフィールドの処理 |
フィールド値が欠落している場合にエラーを生成するか、フィールドを空の値に置き換えるかを指定します。 |
最初の行に列のヘッダーが含まれる |
最初の行で列のヘッダーを定義するかどうかを指定します。 ファイルに列のヘッダーがある場合は、最初の行でそれを定義する必要があります。 |
開始行を無視する |
データの冒頭でスキップする行数を指定し、特定の行からインポートできるようにします。 [開始行をスキップする] フィールドには、列の名前を含んだヘッダー行は含まれません。 |
終了行を無視する |
データの最後にスキップする行数を指定します。 |
テキストエンコード |
CSVファイルで使用される文字エンコーディングを指定します。 |
CSVファイルへの接続の詳細は、「CSVデータに接続する」を参照してください。
Excel
DataSetジョブの作成時に [Excel] を読み込みタイプとして選択した場合は、[設定] サブタブの [処理] ダイアログに、Domoに送信するデータの範囲を指定するオプションが表示されます。
選択したExcelファイルから目的の範囲を指定するには、3つの異なる方法として、特定のセル範囲、名前のついた範囲、動的範囲のいずれかを選択できます。[選択範囲] メニューで必要な接続オプションを選択します。
セル範囲
[選択範囲] メニューで [セル範囲] を選択した場合は、データを取り込むExcelシートと開始セル、終了行、終了列を指定できます。
以下のスクリーンショットは、この方法を選択した場合のオプションを示したものです。
これらのコンポーネントに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
Excelファイルのパスワード |
このExcelファイルのパスワードを入力できます(パスワードが指定されている場合)。 |
シート名 |
データを取り込むExcelシートを選択できます。 |
開始セル |
データを取り込むExcelシートの最初のセルを指定します。 |
次の行まで読み取る: |
データを取り込むセル範囲の終了行を指定します。 |
次の列まで読み取る: |
データを取り込むセル範囲の終了列を指定します。 |
最初の行に列のヘッダーが含まれる |
最初の行に列のヘッダーが含まれているかどうかを確認します。列ヘッダーは、その列のデータを参照するのに使用されるため、Domoでカードを作成する際、これは重要になります。詳細については、「DataSetの列をチャートに適用する」を参照してください。 |
ファイル名列を最後に追加する |
「ファイル名」列をデータソースの最後の列として挿入します。 |
名前のついた範囲
[選択範囲] メニューで [名前のついた範囲] を選択した場合は、リストから名前のついた範囲を選択できます。このExcelファイルで名前のついた範囲を作成していない場合は、このメニューにオプションは表示されません。
以下のスクリーンショットは、この方法を選択した場合のオプションを示したものです。
これらのコンポーネントに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
Excelファイルのパスワード |
このExcelファイルのパスワードを入力できます(パスワードが指定されている場合)。 |
名前のついた範囲 |
リストから名前のついた範囲を選択できます。 |
空の行まで続行 | オンにした場合、Workbenchは空の行が見つかるまでExcelシートのデータを処理します。 |
最初の行に列のヘッダーが含まれる |
最初の行に列のヘッダーが含まれているかどうかを確認します。列ヘッダーは、その列のデータを参照するのに使用されるため、Domoでカードを作成する際、これは重要になります。詳細については、「DataSetの列をチャートに適用する」を参照してください。 |
ファイル名列を最後に追加する |
「ファイル名」列をデータソースの最後の列として挿入します。 |
動的範囲
[選択範囲] メニューで [ダイナミック範囲] を選択した場合は、Excelシートの末尾の指定した数の行をスキップできます。
以下のスクリーンショットは、この方法を選択した場合のオプションを示したものです。
これらのコンポーネントに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
Excelファイルのパスワード | このExcelファイルのパスワードを入力できます(パスワードが指定されている場合)。 |
シート名 |
データを引き出すExcelシートを選択できます。 |
開始セル |
データを取り込むExcelシートの最初のセルを指定します。 |
終了行を無視する |
シートの末尾の無視する行の数を指定します。 |
最初の行に列のヘッダーが含まれる |
最初の行に列のヘッダーが含まれているかどうかを確認します。列ヘッダーは、その列のデータを参照するのに使用されるため、Domoでカードを作成する際、これは重要になります。詳細については、「DataSetの列をチャートに適用する」を参照してください。 |
ファイル名列を最後に追加する |
「ファイル名」列をデータソースの最後の列として挿入します。 |
Excelデータへの接続の詳細は、「Excelデータに接続する」を参照してください。
XML
DataSetジョブの作成時に [XML] を読み取りタイプとして選択した場合は、[設定] サブタブの [処理] ダイアログに、目的のデータノードと無視するデータノードを指定するオプションが表示されます。
以下のスクリーンショットは、この方法を選択した場合のオプションを示したものです。
これらのコンポーネントに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
データノード |
取得するデータノードを指定します。 |
スキーマ変更オプション |
XMLのスキーマ変更を処理する方法を指定できます。使用可能なオプションは次のとおりです。
|
無視するノード |
ジョブの実行時に無視するノードを入力します。 |
XML データに接続する方法の詳細については、「XMLデータに接続する」を参照してください。
JSON
DataSetジョブの作成時にJSONを読み取りタイプとして選択した場合は、目的のデータノード、デリミター、平坦化オプションを指定できます。
以下のスクリーンショットは、この方法を選択した場合のオプションを示したものです。
JSON データに接続する方法の詳細は、「Workbench 5でJSONデータに接続する」を参照してください。
データベースクエリ(OLAPおよびODBC)
DataSetジョブの作成時に [データベースクエリ] を読み取りタイプとして選択した場合は、[設定] サブタブの [処理] ダイアログにクエリと置換変数の設定オプションが表示されます。
以下のスクリーンショットは、この方法を選択した場合のオプションを示したものです。
このオプションに関する詳細は次の表で確認できます。
オプション |
説明 |
---|---|
クエリ実行タイムアウト | DataSetから更新されるまで接続を継続するタイムアウト値を秒数で指定します。 |
クエリ |
データを取得するために必要なクエリを入力できます。
|
置換変数/グローバル置換変数 |
クエリで使用する置換変数とグローバル置換変数を定義できます。
|
データベースに接続する方法の詳細は、「OLAPキューブに接続する」と「ODBCデータに接続する」を参照してください。
QuickBooks
DataSetジョブの作成時にQuickBooksを読み取りタイプとして選択した場合は、[設定] サブタブの [処理] ダイアログでさまざまなQuickBooksレポートを選択できます。また、接続エラーが発生したらQuickBooksを停止するようWorkbenchに指示をすることもできます。
このコンポーネントに関する詳細は次の表で確認できます。
オプション |
説明 |
||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
許可 | QuickBooksへの接続をWorkbenchに許可します。アクセスを付与する会社ファイルを選択する必要があります。 | ||||||||||
接続エラー発生時にQuickBooksを停止させることをWorkbenchに許可する |
オンにした場合、DataSetジョブの実行中にエラーが発生すると、WorkbenchはQuickbooksを終了します。 |
||||||||||
レポートタイプ |
プライマリレポートタイプを選択できます。どのレポートタイプでも選択可能なサブレポートがいくつかあります。 プライマリレポートタイプは次のとおりです。
|
||||||||||
レポート日付範囲(一般詳細レポートと一般サマリレポート) |
レポートの開始日と終了日を日付選択ツールで選択できます。 |
||||||||||
1回の結果で返す最大日数(一般詳細レポートのみ) |
QuickBooksレポートで返す最大日数を指定します。 |
||||||||||
列(一般詳細レポートのみ) |
QuickBooks レポートで表示する列を指定できます。 |
||||||||||
レポート列をまとめる(一般サマリレポートのみ) |
QuickBooksレポートの日付の単位を選択できます。たとえば、[月] を選んだ場合、レポートのデータは月別に分類されます。 |
||||||||||
会計年度(予算サマリレポートのみ) |
レポートの会計年度を選択できます。 |
QuickBooks データに接続する方法の詳細については、「QuickBooksデータに接続する」を参照してください。
JIRA
DataSetジョブの作成時に [QuickBooks] を読み取りタイプとして選択した場合、[設定] サブタブの [処理] ダイアログで、DataSetに含めないデータソースの属性を選択解除できます。また、新しい属性を追加することもできます。
以下のスクリーンショットは、この方法を選択した場合のオプションを示したものです。
JIRA に接続する方法の詳細に関しては、「JIRAデータに接続する」を参照してください。
変換
WorkbenchのDataSetジョブには、さまざまな変換を追加できます。変換を使用すると、Domoにアップロードする前にデータをWorkbenchでローカルに変更できます。計算に基づいて新しい列を作成する変換、列を結合する変換、データを暗号化する変換など、さまざまな変換を使用できます。変換を追加するには、DataSetジョブの [設定] サブタブ([ジョブ] タブのリストにあるジョブをダブルクリックすると表示されます)で [変換を追加] をクリックし、必要な情報を指定します。
変換を追加すると、[設定] サブタブの [変換] エリアに、追加した順番通りに変換が表示されます。また、変換を1つ以上追加すると、変換リストの上に複数のアイコンが表示されます。次のスクリーンショットには、これらのアイコンがすべて表示されています。
アイコンとその機能は次のとおりです。
選択した変換を編集できます。
選択した変換をリストの下に移動します。
選択した変換をリストの上に移動します。
選択した変換を削除します。
変換は、リストに表示される順番で適用されます。DataSetには、いくつ変換があっても問題ありません。
このセクションの残りの部分では、各変換の基本コンポーネントについて説明します。変換の追加に関する詳細は、次のトピックを参照してください。
計算フィールド変換
[計算フィールド] 変換では、ある列の値に基づいて新しい列の値を導き出すために使用する計算を指定できます。[設定] サブタブの [変換を追加] をクリックし、[計算フィールド変換] を選択してDataSetの計算ビルダーを開きます。計算ビルダーでは、計算の名前を指定し、必要に応じてデータソースの列に関数を適用することで、計算を作成できます。計算ビルダーには2つのタブが表示されます。1つは [使用可能な列] です。このタブでは、計算のもととなるデータソースの列を選択できます。もう1つは [使用可能な関数] です。このタブでは、5つの異なるカテゴリーの関数を選択できます。
計算の作成に関する詳細は、「Workbench 5で計算を使用して列を作成する」を参照してください。
カスタム日付形式
[カスタム日付形式] 変換を使用すると、特定の列の日付の形式を変更できます。[設定] サブタブの [変換を追加] をクリックし、[カスタム日付形式]変換を選択してDataSetの計算ビルダーを開きます。
詳細は、「Workbench 5で列にカスタム日付形式を設定する」を参照してください。
フィルター
[フィルター] 変換を使用すると、選択した列にフィルターを適用できます。指定したフィルタークエリに対して、Workbenchが一致を返すようにすることも、不一致を返すようにすることもできます。また、フィルターされたデータの空白セルを含めることも、除外することもできます。
[設定] サブタブの [変換を追加] をクリックし、[フィルター変換] を選択して、DataSetのこの変換のオプションダイアログを開きます。
詳細は、「Workbench 5で列にフィルターをかける」を参照してください。
ルックアップ表
ルックアップ表を使用してWorkbenchのデータソースを結合できます。「ルックアップ表」とは、プライマリDataSetと結合させるDataSetです。ルックアップ表DataSetとプライマリDataSetにはそれぞれ、固有の一致した値を持つ列(「キー列」)がひとつある必要があります。キー列を一致させたら、両方のDataSetのすべての列が結合され、新しいDataSetが作成されます。このようにしてDataSetを結合することは、SQLにおけるLEFT JOINと同じです。
[設定] サブタブの [変換を追加] をクリックし、[ルックアップ表変換] を選択して、DataSetのこの変換のオプションダイアログを開きます。
詳細は、「Workbench 5でDataSetを結合する」を参照してください。
日付タイムゾーンをシフト
[日付タイムゾーンをシフト]変換では、メニューから目的のタイムゾーンを選択することで、データソースにあるデータのタイムゾーンを設定できます。[設定] サブタブの [変換を追加] をクリックし、[日付タイムゾーンをシフト変換] を選択して、DataSetのこの変換のオプションダイアログを開きます。
詳細は、「Workbench 5ジョブのタイムゾーンを設定する」を参照してください。
暗号化
[暗号化] 変換を使用すると、データソースにある一列以上のデータを暗号化できます。DataSetがDomoに引き込まれた後は、WorkbenchでDataSetジョブの [ユーザーアクセス] リストで特別にアクセス権を与えられたユーザーによって、Sumo表でのみ復号できます。Sumoに関する詳細は、「Sumoカードについて」を参照してください。
[設定] サブタブの [変換を追加] をクリックし、[暗号化] 変換 を選択して、DataSetのこの変換のオプションダイアログを開きます。
暗号化と復号に関する詳細は、「Workbench 5データの暗号化、復号、ハッシングを行う」を参照してください。
検索と置換
[検索と置換] 変換を使用すると、列の指定した値を他の値に置き換えることができます。また、検索値が表示されないセルに表示するデフォルト値の指定をすることもできます。検索と置換値の場合は、さまざまなカテゴリーの正規表現コンストラクトを含む正規表現ビルダーを開くことができます。
[設定] サブタブの [変換を追加] をクリックし、[検索/置換変換] を選択して、DataSetのこの変換のオプションダイアログを開きます。
詳細は、「Workbench 5 で列の値を置き換える」を参照してください。
ハッシュ値
[ハッシュ値] 変換を使用すると、列のデータをハッシュ値で暗号化できます。4つの異なるハッシュアルゴリズムのいずれかを選択できます。[設定] サブタブの [変換を追加] をクリックし、[ハッシュ値変換] を選択して、DataSetのこの変換のオプションダイアログを開きます。
詳細は、「Workbench 5データの暗号化、復号、ハッシングを行う」を参照してください。