今回はバッチでTableau CRMのデータセットを操作できるツールをご紹介します!

##Tableau CRM
SalesforceのBI/AIツールである、Tableau CRMはそれ自体が高速なデータベースを持っており、
その上で動作するBIと誰でも使えるAIがあります。

それだけでなく様々なWebサービスへのコネクタや、Prepやデータフローといったデータを加工するツールも付いているので、分析に必要な環境がクラウド上に一通り揃う便利ツールです。

Tableau CRMの不満点

ただ、自分が最初Tableau　CRMを使っていてすごく不便に感じたのが
__「オンプレデータとの自動連携方法がない」__点でした。
ローカルDBからCSVファイルにExportしてきて、それをTableau　CRMに入れようとすると、手動でのアップデートが必要となり、バッチでの自動連携ができないんですよね。

###オンプレデータとの連携のために

オンプレミスデータとの連携のためには下記選択がよく選ばれます。

ETLツールを使う
外部データAPIを使う

ETLツールに関してはDataSpider　CloudやTalendなどを使って自動化することができます。
今回は外部データAPIに関して掘り下げてみたいと思います。

外部データAPIって？

Analytics 外部データ API 開発者ガイド

こちらの開発者ガイドでは外部データAPIを使う上での制限やサンプルコードなどを入手できます。
__外部データAPIを使うことでTableau　CRMのデータセットをAPI経由で作成、更新、追加、削除などデータセットの操作を自動化することが可能__です。

ただ、こちらはAPIですので、当然ながらAPIをコールする処理を記載する必要があります。
認証含め、それなりのコード量になります。

DatasetUtils

今回ご紹介するのは、コーディングをすることなく、バッチ処理化する方法です。
DatasetUtilsというツールを使用します。

__DatasetUtilsは外部データAPIをコーディングすることなく使用できる実行可能なプログラム__で、
環境もJavaを使えればOKなので、敷居がすごく低いのがメリットです。

ただし、Salesforceオフィシャルなツールではないので未サポートです。
ご利用はご自分の責任範囲でお願いします。

DatasetUtilsは、Einstein Analytics External Data APIのリファレンス実装です。このツールは無料で使用できますが、Salesforceの公式サポートは受けられません。これはコミュニティプロジェクトであり、正式なテストや文書化は行われていません。本アプリケーションをご利用の際は、Salesforceへのサポート依頼はご遠慮ください

###入手とダウンロード
DatasetUtilsのDownloading DatasetUtilsのrelasesをクリックします。

DatasetUtilsのバージョンとダウンロードできる一覧が表示されます。
今回はMacOS上でGuiモードとコマンドモードを試してみたいと思いますので下記の２つをダウンロードしました。

DatasetUtils.dmg
datasetutils-48.1.0.jar

####Javaのバージョン確認
実行に際して対応するJavaのバージョンを確認してください。
もし対応していない場合は、新しいバージョンをインストールして使えるようにします。

###DatasetUtils Guiモードでの実行
DatasetUtils.dmgを使ってアプリケーションを実行することができます。
DatasetUtils.dmgをダブルクリックして、DatasetUtils.appをアプリケーションに入れておきます。

####DatasetUtils.appの実行
実行するとブラウザ上からアプリケーションが立ち上がりますので認証情報を入力します。

####データセット一覧
ログイン後データセットの一覧が表示されます。

それぞれのデータセット名をクリックするとSAQLを実行できたりCSVファイルダウンロード！出来たりします。

####File　Upload
今回は手元のCSVファイルをアップロードしてみたいと思います。
「File Upload」を選択して

データセット名や保存するアプリケーション名、オペレーション（Overwrite,Append,Upsert,Delete)、CSVファイル名を指定します。

これでUpload CSVをクリックすると処理が走り

データセットが作成されたことが確認できたのでAnalytics Studioから確認してみました。問題なく実行されたようです。

GUIモードでの実行ですが、基本的にはAnalytics Studioでできることと同じです。ただ、こちらは外部データAPIを元に作成されているアプリケーションですので、外部データAPIを使うとどのような事が出来るのか、おおよそ理解出来るかと思います。

###コマンドモード
次は本筋のコマンドモードでの実行です。
ダウンロードしたdatasetutils-xx.x.x.jarをご準備ください。

ターミナルを開いて以下のコマンドで実行可能です。

java -jar datasetutil-.jar --action --u user@domain.com --dataset datasetnama --app appname --inputFile inputFilename --endpoint endPointname

###パラメータの設定
action:"load"、"downloadxmd"、"uploadxmd"、"detectEncoding"、"downloadErrorFile"のいずれか

load: CSVロード
downloadxmd: XMDファイルのダウンロード
uploadxmd: user.xmd.jsonのアップロード
detectEncoding:Inputファイルのエンコーディング検出
downloadErrorFile: CSVアップロード時のエラーファイルのダウンロード

--u : SalesforceのログインユーザーID
--p : (オプション) Salesforceのパスワード、省略時はプロンプト入力
--token : (オプション) Salesforceのトークン
--endpoint: (オプション)Salesforceのsoap api エンドポイント (test/prod) デフォルトは: https://login.salesforce.com
--dataset : (オプション) データセットAPI名、アクションがLoadの時は必須
--datasetLabel : (オプション) データセット表示名
--app : (オプション) データセットを作成するアプリケーション名
--operation : (オプション) Load時のオペレーション (Overwrite/Upsert/Append/Delete) デフォルトはOverwrite
--inputFile : (オプション) インプットCSVファイル、Load時は必須
--rootObject: (オプション) 抽出のルートSObject
--rowLimit: (オプション) 抽出時の行制限, -1=all, default=1000
--sessionId : (オプション) SalesforceのsessionId
--fileEncoding : (オプション) インプットファイルのエンコーディング、規定はUTF-8

###実行コマンドサンプル
Production領域にファイルをアップロードする
java -jar datasetutils-48.1.0.jar --action load --u pgupta@force.com --p @#@#@# --inputFile Opportunity.csv --dataset puntest

データセットにファイルを追加する。
java -jar datasetutils-48.1.0.jar --action load --operation append --u pgupta@force.com --p @#@#@# --inputFile Opportunity.csv --dataset puntest

Sandboxにデータをロードする
java -jar datasetutils-48.1.0.jar --action load --u pgupta@force.com --p @#@#@# --inputFile Opportunity.csv --dataset puntest --endpoint https://test.salesforce.com/services/Soap/u/48.0

####実行後の確認
コマンドプロンプトからメッセージが表示され、無事に実行完了しました。

Analytics　Studioからもデータセットを確認できます。

##まとめ
今回はCSVファイルをTableau CRMに自動連携できるツールをご紹介しました。
DatasetUtilsを使用する事でコネクタがないデータソースもどんどん連携できます！
データセットにしてしまえば、あとはTCRM上で加工、分析ができますので、こちらのツールを使ってデータの利活用、データを利用した意思決定を行える組織作りを目指してみてください！