CSV SFTPプッシュコネクター

​

はじめに

• DomoのCSV SFTPプルコネクター（旧称は「CSV-SFTP」コネクター）を使用すると、専用のSFTPサーバーにアップロードしたCSVファイルにアクセスできます。
• Domo CSV SFTPプッシュ Connectorを使うと、Domo自体のSFTPにアップロード済みのCSVファイルを取得し、処理できます。このコネクターを使うと、Domoにより認証情報が発行され、データをDomoに送信できるようになります。

​

必要条件

​

CSVファイルをSFTPサーバーに送信する

1. > ［Data Center］ の順に選択します。
2. ウィンドウ上部のタブ行にある ［ファイル］ をクリックします。
3. コネクターリストで ［CSV SFTP］ を探し、クリックします。
4. ［アカウントに名前を付ける］ フィールドに新しいアカウントの名前を入力します。 このアカウントは、 コネクターの［アカウント］ページ でこの名前によって特定されます。
5. 以下のいずれかを行います。
   • キーを生成する場合
     1. ［キーを生成してください］ を選択します。
     2. キーファイルは1回しかダウンロードできないことを確認するチェックボックスをオンにします。
     3. ［キーを作成］ をクリックします。 キーが.pem形式でダウンロードされます。
   • 自分のキーを入力する場合
     1. ［自分のキーを使う］ を選択します。
     2. RSAパブリックキーを空白のボックスに貼り付けます。
     3. ［キーを保存］ をクリックします。
6. （条件付き）CSVファイルの最初の行が見出し行となっていない場合、ヘッダー行番号を ［ヘッダー行］ フィールドに入力します。見出し行となっている場合は、このフィールドを空白のままにします。
7. ［区切り文字］ メニューのCSVファイルで、使う区切り文字を選択します（これを自動的に判断させる場合は、 ［区切り文字を検出］ の設定をこのままにしておきます）。
8. （条件付き）インポートから除外する行がファイルの終わりに1つまたは複数ある場合は、［フッター行をスキップ］ に、スキップする行数を入力します。以上に該当しない場合、このフィールドは空白のままにします。
9. （条件付き）CSVファイル内のデータが、ヘッダー行の次の行以外の行から開始している場合、［開始データ行］ フィールドに行番号を入力します。以上に該当しない場合、このフィールドは空白のままにします。
10. エスケープ文字を ［エスケープ文字］ メニューから選択します。
11. 引用文字を ［引用文字］ メニューから選択します。
12. （条件付き）Domoを使ってエンコーディングタイプを自動検出する場合は ［エンコードを検出］ チェックボックスをオンのままにしておきます。自動検出が不要な場合はこのチェックボックスをオフにし、 ［エンコード］ メニューで目的のエンコーディングを選択します。
13. （条件付き）「0123」のように数値の先頭に0（ゼロ）を表示する場合は、このチェックボックスを選択します。 注記： これにより、値がテキストとして解析されます。
14. ［日付形式］ フィールドで日付形式を選択します。
15. ［次］ をクリックします。

​

SFTPクライアントを使用してCSVファイルをアップロードする

1. 「 CSVファイルをSFTPサーバーに送信する 」の説明に従って、CSVコネクターをDomoで設定します。 2..pemファイルをご使用のマシンのディレクトリに移動します。 この例では、/sftpディレクトリを使用しています。
2. 新しいDataSetのID（DataSetの［詳細］ビューの ［アップロード方法］ タブ内に表示）と同じ名前のCSVファイルを/sftpディレクトリ下に作成します。 例えば、DataSetのIDがcb4ba6a0-0934-440f-8572-1253b9f7525aの場合、CSVファイルの名前はcb4ba6a0-0934-440f-8572-1253b9f7525a.csvとなります。
3. FileZillaのサイトマネージャーで新規サイトを作成します。
   
4. ［General］ タブで次のように設定します。

   設定	手順
   Host	DataSetの［詳細］ビューの ［アップロード方法］ タブに表示される ホスト名 のURLを入力します。
   Port	「22」と入力します。
   Protocol	［SFTP］ を選択します。
   Logon Type	［Key file］ を選択します。
   User	DataSetの［詳細］ビューの ［アップロード方法］ タブにある ［ユーザー名］ の隣に表示される値を入力します。
   Key file	ファイルブラウザで.pemキーを探します。

   
5. 先ほど設定したサイトへの接続を開きます。
6. ローカルファイルウィンドウからリモートサイトウィンドウに、アップロードするCSVファイルをドラッグします。
   
7. 接続を切るか、FileZillaを終了します。

​

コマンドラインを使ってCSVファイルをアップロードする

1. 「 CSVファイルをSFTPサーバーに送信する 」の説明に従って、CSVコネクターをDomoで設定します。 2..pemファイルをご使用のマシンのディレクトリに移動します。 この例では、/sftpディレクトリを使用しています。
2. 新しいDataSetのID（DataSetの［詳細］ビューの ［アップロード方法］ タブ内に表示）と同じ名前のCSVファイルを/sftpディレクトリ下に作成します。 例えば、DataSetのIDがcb4ba6a0-0934-440f-8572-1253b9f7525aの場合、CSVファイルの名前はcb4ba6a0-0934-440f-8572-1253b9f7525a.csvとなります。
3. /sftpディレクトリで次のコマンドを使い、SFTPサーバーに接続します。 `sftp –i domosftpkey. pem username @ mycompany. import.domo.com` ここで username は ［アップロード方法］ タブの ［ユーザー名］ に対応する値、 domosftpkey.pem はお使いのキー名、 mycompany はお使いのDomoドメイン（お使いのDomoインスタンスのURLで「 http:// 」> のすぐ後に続く部分）です。
4. CSVファイルをアップロードするときは次のコマンドを使います。 put cb4ba6a0-0934-440f-8572-1253b9f7525a.csv
5. サーバーを終了するには「quit」と入力します。 サーバーを終了すると、ファイルがDomoで処理中になることがわかります。

​

サードパーティのサービスを使用してCSVファイルをアップロードする

1. 「 CSVファイルをSFTPサーバーに送信する 」の説明に従って、CSVコネクターをDomoで設定します。以下のオプションが設定されていることを確認します。
   • ［キーを生成または選択］ で ［自分のキーを使う］ オプションを選択します。ここでAdobeから受け取ったRSAパブリックキーをテキストフィールドに貼り付けます。
   • ［解析オプション］ で、以下のように設定します。
     • 区切り文字を ［カンマ］ に設定します。
     • Adobeでヘッダー行を除外するよう設定してある場合を除き、［ヘッダー行を含む］ チェックボックスをオンのままにします。
2. Adobe Analyticsに切り替え、アカウントにログインします。
3. ［Tools］、［Data Warehouse］ の順に進みます。
   
4. ［Data Warehouse Request］ タブで、Domoに送信するレポートを定義するとき必要なパラメータをすべて入力します。これに該当するパラメータには、 Request Name 、 Reporting Date 、 Segments 、 Items 、 Breakdowns 、 Metrics などがあります。
   
5. ページ下部にある ［Schedule Delivery］ セクションで ［Advanced Delivery Options］ をクリックします。
   
6. 次のように配信オプションを設定します。

   設定	手順
   Report file name	［Custom］ を選択し、Domo DataSet IDに拡張子「.csv」を付けてテキストフィールドに入力します。
   Report Format	［CSV］ を選択します。
   Report Destination	［FTP］ を選択します。ここでフィールドに以下の情報を入力します。 Host sftp:// hostname （Domoの ［アップロード方法］ タブに記載。例：s ftp://modocorp.import.domo.comな ど） Port 22 Directory Domoの ［アップロード方法］ タブにある ［ユーザー名］ の値を入力します。 Username Domoの ［アップロード方法］ タブにある ［ユーザー名］ の値を入力します。 Password 空白のままにします。Adobeは先ほどのステップ1で入力したRSAパブリックキーを使用します。 適宜、 ［Scheduling Options］ タブをクリックし、1回のみ有効の即時配信にするか、定期スケジュールにするかを指定することもできます。

   
7. アドバンス配信オプションをすべて指定したら、［Send］ をクリックします。 ［Data Warehouse Request］ ページに戻ります。
8. ［Request this Report］ をクリックして、設定をすべて保存します。