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