Analytics Cloud ​

Analytics Cloud は、大量の企業データから強力な視覚化機能やダッシュボードを作成する、クラウドベースの分析ツールです。以前は Wave Analytics という名称でした。

Workato は標準の Salesforce コネクターを使用して、ERP システムやデータベースなどの外部ソースからデータをアップロードします。

コネクター情報 ​

コネクター情報については、Salesforce コネクターのページを参照してください。

使用方法 ​

Insights External Data と Insights External Data Part ​

InsightsExternalData オブジェクトにより、外部ソースからデータをアップロードできます。このオブジェクトは metadata を提供し、start、cancel、cleanup、check status などのアップロードプロセスのアクションを管理するために使用されます。

InsightsExternalData オブジェクトは InsightsExternalDataPart オブジェクト (アップロードするデータ全体の1つまたは複数のサブセットを含む) と一緒に使用されます。この2つのオブジェクトを使用して、プログラムにより大きなデータセットをいくつかに分けてアップロードできます。最後に、アップロードがトリガーされ、Analytics Cloud インスタンスでこれらのデータパーツがデータセットとしてまとめられます。

詳細については、『Analytics External Data API Developer Guide』を参照してください。

Insights External Data オブジェクト ​

データのアップロードには JSON メタデータ定義を付加し、Base64 でエンコードする必要があります。詳細については、『External Data Format Reference』を参照してください。

データ形式 ​

以下は CSV 形式のデータセットの例です。

Id,Email,Name
123,john@doe.com,John Doe
124,marry@poppins.com,Mary Poppins

CSV データのガイドラインについては、こちらを参照してください。

メタデータ JSON ​

以下は JSON 形式のメタデータの例です。

json
{
  "fileFormat": {
    "charsetName": "UTF-8",
    "fieldsEnclosedBy": "\"",
    "fieldsDelimitedBy": ",",
    "numberOfLinesToIgnore": 1
  },
  "objects": [
    {
      "connector": "Wave_Analytics_Sample",
      "description": "",
      "fullyQualifiedName": "Lead",
      "label": "Lead",
      "name": "Lead",
      "fields": [
        {
          "fullyQualifiedName": "Lead.Id",
          "label": "Lead ID",
          "name": "Id",
          "isSystemField": false,
          "isUniqueId": true,
          "isMultiValue": false,
          "type": "Text"
        },
        {
          "fullyQualifiedName": "Lead.Email",
          "label": "Lead Email",
          "name": "Email",
          "isSystemField": false,
          "isUniqueId": false,
          "isMultiValue": false,
          "type": "Text"
        },
        {
          "fullyQualifiedName": "Lead.Name",
          "label": "Lead Name",
          "name": "Name",
          "isSystemField": false,
          "isUniqueId": false,
          "type": "Text"
        }
      ]
    }
 ]
}

Insights External Data Part オブジェクト ​

要件 :

  • InsightsExternalDataPart オブジェクトが作成されていること (それぞれ10 MB 未満)
  • 外部データが CSV ファイル形式であり、Base64 でエンコードされていること。

データアップロードの開始 ​

必要なすべての Insights External Data Part を作成したら、InsightsExternalData レコードの Requested Action フィールドを「Process」に更新します。

アップロードプロセスの管理 ​

データアップロードプロセスを開始 (Requested Action フィールドを「Process」に更新) すると、キャンセルを要求する場合を除き、それ以降オブジェクトを編集することはできません。

サンプルレシピ ​

以下はすべての内容をレシピにまとめたものです。

Analytics Cloud サンプルレシピAnalytics Cloud レシピ。サンプルレシピ

このレシピは、SQL Server データベースから Analytics Cloud 内のデータセットへのアップロードを毎日実行します。このレシピは、以下のように、前述の各手順から構成されます。

  1. 外部データソースからデータを取得する
  2. メタデータ JSON を定義する
  3. 外部データソースからのデータを CSV 形式に変換する
  4. 外部データレコードを作成する
  5. Insights External Data Part をアップロードする
  6. 外部データレコードで Requested Action フィールドを「Process」に更新してアップロードプロセスを開始する

Last updated: