Data

配列・変数などのデータを取り扱うアクション一覧です。

CreateList

概要

CreateListは、リストを作成するアクションです。

パラメーター

*は、必須パラメーター

リストビルダーを使ってリストを作成する

複数のアウトプットをリストに追加したい場合は、パラメーター右のメニューから「アウトプットからリストを作成する」を選択すると、簡単にリストを作成することもできます。

アウトプット

使用例

+create_list_1:
  action>: CreateList
  items: ["夏目漱石","太宰治","三島由紀夫","川端康成"]
# => ["夏目漱石","太宰治","三島由紀夫","川端康成"]

CreateObject

概要

CreateObjectは、オブジェクトを作成するアクションです。keysパラメータを設定すると、各キーの型を指定することができます。

パラメーター

*は、必須パラメーター

アウトプット

使用例

+create_object_1:
  action>: CreateObject
  object:
    id: 123
    name: taro
    mail: 'taro@co.jp'
  keys: [["id","integer"],["name","string"]]
# => {
#  "id": 123,
#  "name": "taro",
#  "mail": "taro@co.jp"
#}

GetItemFromList

概要

GetItemFromListは、リストから要素の場所を指定して値を取得するアクションです。

パラメーター

*は、必須パラメーター

アクションのアウトプットを list に指定し、ピッカーで index を選択する

アクションのアウトプットを list に指定し、ピッカーで index を選択する場合、入力するアクションが実行済みである必要があります。

アウトプット

使用例

+get_item_from_list_1:
  action>: GetItemFromList
  list: ["夏目漱石","太宰治","三島由紀夫","川端康成"]
  index: 1
# => "太宰治"

GetValueWithKey

概要

GetValueWithKeyは、オブジェクトからキーを指定して値を取得するアクションです。

パラメーター

*は、必須パラメーター

アクションのアウトプットを object に指定し、ピッカーで key を選択する

アクションのアウトプットを object に指定し、ピッカーで key を選択する場合、入力するアクションが実行済みである必要があります。

アウトプット

使用例

+get_value_with_key_1:
  action>: GetValueWithKey
  object:
    author: '夏目漱石'
    title: '我輩は猫である'
  key: author
# => "夏目漱石"

JoinList

概要

JoinListは、リストの要素を文字列として結合するアクションです。

パラメーター

*は、必須パラメーター

list についての補足

多次元配列（配列内の配列）の場合は、入れ子になってる配列をフラットにしてから結合します。

+join_list_1:
  action>: JoinList
  list: [["夏目漱石","太宰治"],["三島由紀夫","川端康成"]]
  separator: '/'
# => "夏目漱石/太宰治/三島由紀夫/川端康成"

アウトプット

使用例

+join_list_1:
  action>: JoinList
  list: ["夏目漱石","太宰治","三島由紀夫","川端康成"]
  separator: ','
# => "夏目漱石,太宰治,三島由紀夫,川端康成"

SearchItemFromList

概要

SearchItemFromListは、リスト内を文字列で検索するアクションです。この検索にはワイルドカードが利用できます。

パラメーター

*は、必須パラメーター

アウトプット

使用例

+search_item_from_list_1:
  action>: SearchItemFromList
  list: ["夏目漱石","太宰治","三島由紀夫","川端康成"]
  query: '太宰*'
# => ["太宰治"]

StoreValue

概要

StoreValueは、変数に値を保存するアクションです。変数は、 ${...} により呼び出しが可能になります。また、同じ変数名に値を保存することで変数の値を更新することができます。nullの値が定義された場合、空の文字列として登録されます。

パラメーター

*は、必須パラメーター

アウトプット

使用例

ScrapePageアクションで取得した情報をStoreValueアクションで変数に保存する。

+store_value_1:
  action>: StoreValue
  key: titles
  value: +scrape_page_1
# => {
#  "titles": [
#    "決定版猫と一緒に生き残る防災BOOK",
#    "牝の猫と女のネコ",
#    "通い猫アルフィーの奇跡",
#    "猫をよろこばせる本",
#    "猫の困った行動解決ハンドブック"
#  ]
#}

StoreValueアクションで保存した変数titlesを他アクションで呼び出す

+text_1:
  action>: Text
  text: ${titles[0]} # 変数を呼び出す際は、${変数名}の形式で記載
# => "決定版猫と一緒に生き残る防災BOOK"

GetState

概要

GetState は、ロボットの動作中の状態を取得することができるアクションです。 取得できる状態の種類は、限られています。また、取得されるのは、直前に残っているステートです。新たにステートを変更するアクションがあった場合は、上書きされます。

取得できる状態

パラメーター

*は、必須パラメーター

アウトプット

使用例

例えば、ページ遷移時に、通常の遷移（クリックやJavaScriptでの遷移）の場合は、200ステータス、サーバー側でリダイレクトされた時は、302など、次のように返却されます。

+get_state_1:
  action>: GetState
  key: redirect_paths
# これは例えばこのように表示されます
# [
#   {
#     "status": 200, # ページ自体の遷移
#     "url": "https://javascript.redirect.path.example.com/1"
#   },
#   {
#     "status": 302, # サーバー側でリダイレクトされた時
#     "url": "https://redirected.path.example.com/1"
#   },
#   {
#     "status": 200,
#     "url": "https://javascript.redirect.path.example.com/2"
#   }
# ]

+get_state_2:
  action>: GetState
  key: dialog.message
# これは例えばこのように表示されます
# "使えない文字列が入力されました。"

RunScript

概要

アクション内で、JavaScriptを実行することができます。StoreValueで保存された変数は、同名の変数名でコード内で使用できます。コードはSandbox環境で実行され、利用できるコードは、JavaScriptにBuilt-inされたオブジェクトのみになります。30秒後にTimeoutします。

パラメーター

*は、必須パラメーター

code例

ScrapePageアクションで情報を取得し、StoreValueアクションで変数booksに格納した後、RunScriptアクションでbooksの値を整える。

var element = books;
var newBook = [];
for ( let book of element ) {
　newBook.push(book.split("\n"));
}
return newBook;

アウトプット

使用例

+run_script_1:
  action>: RunScript
  code: 'var element = books;  var newBook = [];  for ( let book of element ) {   newBook.push(book.split("\n")); }   return newBook;'
# => [
#  [
#    "決定版猫と一緒に生き残る防災BOOK",
#    "猫びより編集部",
#    "http://books.google.co.jp/books?id=a5JSvwEACAAJ&dq=%E7%8C%AB&hl=&source=gbs_api",
#    ""
#  ],
#  [
#    "牝の猫と女のネコ",
#    "岩井志麻子",
#    "https://play.google.com/store/books/details?id=VFgVDgAAQBAJ&source=gbs_api",
v    ""
#  ],
#  [
#    "通い猫アルフィーの奇跡",
#    "レイチェル・ウェルズ 中西和美",
#    "https://play.google.com/store/books/details?id=WhkVDQAAQBAJ&source=gbs_api",
#    ""
#  ],
#  [
#   "猫をよろこばせる本",
#    "沼田朗",
#    "https://play.google.com/store/books/details?id=kcgMBvj8pzgC&source=gbs_api",
#    ""
#  ],
#  [
#    "猫の困った行動解決ハンドブック",
#    "高崎一哉",
#    "http://books.google.co.jp/books?id=Szcc61SiSHYC&dq=%E7%8C%AB&hl=&source=gbs_api",
#    ""
#  ]
#]

Compare

概要

Compareは、二つの値を比較して真理値を返すアクションです。

パラメーター

*は、必須パラメーター

アウトプット

使用例

+compare_1:
  action>: Compare
  subject: 10
  compare_with: 100
  method: LESS_THAN
  not: false
# => true

ConvertTable

概要

ConvertTableは、テーブルデータ（二次元配列）を変換して返すアクションです。

パラメーター

*は、必須パラメーター

アクションのアウトプットを table に指定し、ピッカーで transform を選択する

アクションのアウトプットを table に指定し、ピッカーで transform を選択する場合、入力するアクションが実行済みである必要があります。

transform についての補足

type は、filter, column, sortColumn から選択します。

● フィルタ指定の場合のトランスフォームオブジェクトの説明

operator についての補足

● カラム指定の場合のトランスフォームオブジェクトの説明

● ソートカラム指定の場合のトランスフォームオブジェクトの説明

アウトプット

使用例

age 列の値が20以上の行を出力する。

+convert_table_1:
  action>: ConvertTable
  header: true
  table: [['name', 'age'],['bob', 10], ['john', 30]]
  transform: [
    {
      type: 'filter',
      column: 'age',
      operator: '>=',
      operand: 20,
      include_blank: true,
    }
  ]
# => [['name', 'age'], ['john', 30]]

ヘッダーを['name', 'age'] から ['名前', '年齢']へ変更する。

+convert_table_1:
  action>: ConvertTable
  header: true
  table: [['name', 'age'], ['bob', 10], ['john', 30]]
  transform: [
     {
      type: 'column',
      columns: {
        name: '名前',
        age: '年齢'
      }
    }
  ]
# => [['名前', '年齢'],['bob', 10],['john', 30]]

['名前', '年齢']というヘッダー行をテーブルデータに追加する。

+convert_table_1:
  action>: ConvertTable
  header: false
  table: [['bob', 10], ['john', 30]]
  transform: [
     {
      type: 'column',
      columns: {
        0: '名前',
        1: '年齢'
      }
    }
  ]
# => [['名前', '年齢'],['bob', 10],['john', 30]]

name 列のみ抽出する。

+convert_table_1:
  action>: ConvertTable
  header: true
  table: [['name', 'age'],['bob', 10],['john', 30]]
  transform: [
     {
      type: 'column',
      columns: {
        name: 'name'
      }
    }
  ]
# => [['name'],['bob'],['john']]

['name', 'age'] の列を移動し ['age', 'name'] にする。

+convert_table_1:
  action>: ConvertTable
  header: true
  table: [['name', 'age'], ['bob', 10], ['john', 30]]
  transform: [
    {
      type: "sortColumn",
      map: {
        "0": 1,
        "1": 0
      }
    }
  ]
# => [['age', 'name'],[10, 'bob'],[30, 'john']]

ConvertJSONToArray

概要

ConvertJSONToArray は、JSON をテーブルデータ（二次元配列）に変換して返すアクションです。

パラメーター

*は、必須パラメーター

アクションのアウトプットを json に指定し、ピッカーで header や他パラメータを選択する

アクションのアウトプットを json に指定し、ピッカーで header を選択する場合、入力するアクションが実行済みである必要があります。 またピッカーで配列が value の key を header に選択すると、カラム名の横にメニューボタンが現れ、メニューから配列の処理方法を選択できます。

アウトプット

使用例

サンプル JSON

{
  "data": [
    {
      "name": "プロモーションA",
      "id": "abcde",
      "id_data": [
        {
          "impressions": [10, 20, 30],
          "installs": 1,
          "date": "2021-01-01"
        },
        {
          "impressions": [40, 50, 60],
          "installs": 2,
          "date": "2021-01-02"
        }
      ]
    },
    {
      "name": "プロモーションB",
      "id": "fghij",
      "id_data": [
        {
          "impressions": [100, 200, 300],
          "installs": 10,
          "date": "2021-01-01"
        },
        {
          "impressions": [150, 250, 350],
          "installs": 15,
          "date": "2021-01-02"
        }
      ]
    }
  ]
}

上記サンプル JSON をデータ行が1行のフラットな二次元配列に変換する。
value に配列がある場合は各要素を列に展開する。

+convert_json_to_array_1:
  action>: ConvertJSONToArray
  json: sampleJSON
  header: ["data.name","data.id","data.id_data.impressions","data.id_data.installs","data.id_data.date"]
  unwind: []
  stringify: []

# => [
#   [
#     "data.name",
#     "data.id",
#     "data.id_data.impressions.0",
#     "data.id_data.impressions.1",
#     "data.id_data.impressions.2",
#     "data.id_data.installs",
#     "data.id_data.date"
#   ],
#   [
#     "プロモーションA",
#     "abcde",
#     10,
#     20,
#     30,
#     1,
#     "2021-01-01"
#   ],
#   [
#     "プロモーションA",
#     "abcde",
#     40,
#     50,
#     60,
#     2,
#     "2021-01-02"
#   ],
#   [
#     "プロモーションB",
#     "fghij",
#     100,
#     200,
#     300,
#     10,
#     "2021-01-01"
#   ],
#   [
#     "プロモーションB",
#     "fghij",
#     150,
#     250,
#     350,
#     15,
#     "2021-01-02"
#   ]
# ]

上記サンプル JSON において配列の各要素を行に展開した二次元配列に変換する。
各要素を行に展開したい配列を value に持つ key を unwind に指定する。

+convert_json_to_array_1:
  action>: ConvertJSONToArray
  json: sampleJSON
  header: ["data.name","data.id","data.id_data.impressions","data.id_data.installs","data.id_data.date"]
  unwind: ["data.id_data.impressions"]
  stringify: []

# => [
#   [
#     "data.name",
#     "data.id",
#     "data.id_data.impressions",
#     "data.id_data.installs",
#     "data.id_data.date"
#   ],
#   [
#     "プロモーションA",
#     "abcde",
#     10,
#     1,
#     "2021-01-01"
#   ],
#   [
#     "プロモーションA",
#     "abcde",
#     20,
#     1,
#     "2021-01-01"
#   ],
#   [
#     "プロモーションA",
#     "abcde",
#     30,
#     1,
#     "2021-01-01"
#   ],
#   [
#     "プロモーションA",
#     "abcde",
#     40,
#     2,
#     "2021-01-02"
#   ],
#   [
#     "プロモーションA",
#     "abcde",
#     50,
#     2,
#     "2021-01-02"
#   ],
#   [
#     "プロモーションA",
#     "abcde",
#     60,
#     2,
#     "2021-01-02"
#   ],
#   [
#     "プロモーションB",
#     "fghij",
#     100,
#     10,
#     "2021-01-01"
#   ],
#   [
#     "プロモーションB",
#     "fghij",
#     200,
#     10,
#     "2021-01-01"
#   ],
#   [
#     "プロモーションB",
#     "fghij",
#     300,
#     10,
#     "2021-01-01"
#   ],
#   [
#     "プロモーションB",
#     "fghij",
#     150,
#     15,
#     "2021-01-02"
#   ],
#   [
#     "プロモーションB",
#     "fghij",
#     250,
#     15,
#     "2021-01-02"
#   ],
#   [
#     "プロモーションB",
#     "fghij",
#     350,
#     15,
#     "2021-01-02"
#   ]
# ]

上記サンプル JSON において配列を文字列化して二次元配列に変換する。
文字列化したい配列を value に持つ key を stringify に指定する。

+convert_json_to_array_1:
  action>: ConvertJSONToArray
  json: sampleJSON
  header: ["data.name","data.id","data.id_data.impressions","data.id_data.installs","data.id_data.date"]
  unwind: []
  stringify: ["data.id_data.impressions"]

# => [
#   [
#     "data.name",
#     "data.id",
#     "data.id_data.impressions",
#     "data.id_data.installs",
#     "data.id_data.date"
#   ],
#   [
#     "プロモーションA",
#     "abcde",
#     "[10,20,30]",
#     1,
#     "2021-01-01"
#   ],
#   [
#     "プロモーションA",
#     "abcde",
#     "[40,50,60]",
#     2,
#     "2021-01-02"
#   ],
#   [
#     "プロモーションB",
#     "fghij",
#     "[100,200,300]",
#     10,
#     "2021-01-01"
#   ],
#   [
#     "プロモーションB",
#     "fghij",
#     "[150,250,350]",
#     15,
#     "2021-01-02"
#   ]
# ]

CompareTable

概要

ComparaTableは、二つのテーブルデータ（二次元配列）を比較し、合成または差分を抽出するアクションです。

パラメーター

*は、必須パラメーター

アクションのアウトプットを leftTerm に指定し、ピッカーで identifier を選択する

アクションのアウトプットを leftTerm に指定し、ピッカーで identifier を選択する場合、入力するアクションが実行済みである必要があります。

アウトプット

使用例1

A列（"name"）をkeyとしてテーブルを合成（add）する。

+compare_table_1:
  action>: CompareTable
  leftTerm: [["name","age"],["bob",10],["jane",30],["adam",20]]
  rightTerm: [["name","addr"],["bob","saitama"],["jane","newyork"],["ken","yamaguchi"]]
  method: add
  identifier: A
  header: true

# => [["name","age","addr"],["bob",10,"saitama"],["jane",30,"newyork"],["adam",20,""],["ken","","yamaguchi"]]

leftTerm

rightTerm

アウトプット

使用例2

A列（"name"）とB列（"age"）をkeyとしてテーブルを合成（add）する。

+compare_table_1:
  action>: CompareTable
  leftTerm: [["name","age","addr"],["bob",10,"tokyo"],["jane",30,"saitama"],["adam",20,"newyork"]]
  rightTerm: [["name","age"],["bob",10],["jane",30],["ken",20]]
  method: add
  identifier: 'A&B'
  header: true

# => [["name","age","addr"],["bob",10,"tokyo"],["jane",30,"saitama"],["adam",20,"newyork"],["ken",20,""]]

leftTerm

rightTerm

アウトプット

使用例3

A列（"name"）、B列（"age"）、C列（"gender"）をkeyとしてテーブルの差分を抽出（subtract）する。

+compare_table_1:
  action>: CompareTable
  leftTerm: [["name","age","gender"],["bob",10,"male"],["jane",30,"female"],["adam",20,"male"],["ken",20,"male"],["bob",20,"male"]]
  rightTerm: [["name","age","gender"],["bob",10,"male"],["jane",30,"female"],["adam",20,"male"]]
  method: subtract
  identifier: 'A&B&C'
  header: true

# => [["name","age","gender"],["ken",20,"male"],["bob",20,"male"]]

leftTerm

rightTerm

アウトプット

DataStoreSave

概要

DataStoreSaveは、プロジェクト間で共有可能なデータストアに、データを保存するアクションです。

パラメーター

*は、必須パラメーター

アウトプット

使用例

# データを保存する
+data_store_save_1:
  action>: DataStoreSave
  key: last_id
  value: 1

DataStoreGet

概要

DataStoreGetは、プロジェクト間で共有可能なデータストアから、データを取得するアクションです。 指定したkeyのデータが見つからない場合はfalseが返り、実行中のワークフローは継続されます。

パラメーター

*は、必須パラメーター

アウトプット

使用例

# データを取得する
+data_store_get_1:
  action>: DataStoreGet
  key: last_id

DataStoreDelete

概要

DataStoreDeleteは、プロジェクト間で共有可能なデータストアから、データを削除するアクションです。 指定したkeyのデータが見つからない場合、エラーになります。

パラメーター

*は、必須パラメーター

アウトプット

使用例

# データを削除する
+data_store_delete_1:
  action>: DataStoreDelete
  key: last_id