Data

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

CreateList

概要

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

パラメーター

*は、必須パラメーター

名前	型	概要	例
items*	配列	作成するリスト	["夏目漱石","太宰治","三島由紀夫","川端康成"]

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

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

アウトプット

タイプ	型	概要	例
List	配列	作成したリスト	["夏目漱石","太宰治","三島由紀夫","川端康成"]

使用例

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

CreateObject

概要

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

パラメーター

*は、必須パラメーター

名前	型	概要	例
object*	オブジェクト	作成するオブジェクト	{ id: 123, name: 'taro', mail: 'taro@co.jp' }
keys	配列	各キーの型を指定する場合は、配列で記載	[["id","integer"],["name","string"]]

アウトプット

タイプ	型	概要	例
JSON	JSON形式	作成したオブジェクト	{ id: 123, name: 'taro', mail: 'taro@co.jp' }

使用例

+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*	数値	取り出したい要素のインデックス（0から始まる）	1

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

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

アウトプット

タイプ	型	概要	例
Anything	返却された値による	取り出した要素	"太宰治"

使用例

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

GetValueWithKey

概要

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

パラメーター

*は、必須パラメーター

名前	型	概要	例
object*	オブジェクト	対象のオブジェクト	{"author":"夏目漱石","title":"我輩は猫である"}
key*	文字列	キー	author

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

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

アウトプット

タイプ	型	概要	例
Anything	返却された値による	キーの値	"夏目漱石"

使用例

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

JoinList

概要

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

パラメーター

*は、必須パラメーター

名前	型	概要	例
list*	配列	結合するリスト	["夏目漱石","太宰治","三島由紀夫","川端康成"]
separator*	文字列	結合区切り文字	","

list についての補足

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

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

アウトプット

タイプ	型	概要	例
Text	文字列	作成されたテキスト	"夏目漱石,太宰治,三島由紀夫,川端康成"

使用例

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

SearchItemFromList

概要

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

パラメーター

*は、必須パラメーター

名前	型	概要	例
list*	配列	対象のリスト	["夏目漱石","太宰治","三島由紀夫","川端康成"]
query*	文字列	検索クエリ	太宰*

アウトプット

タイプ	型	概要	例
List	配列	検索にマッチしたもののリスト	["太宰治"]

使用例

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

StoreValue

概要

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

パラメーター

*は、必須パラメーター

名前	型	概要	例
key*	文字列	変数名	time
value	格納する値による	保存する値	${moment().zone("Asia/Tokyo").format("YYYY年MM月DD日")}
setIfNotDefined	真理値	trueのとき、変数が未定義の場合のみ保存する。falseのとき、常に保存する。	false

アウトプット

タイプ	型	概要	例
Anything	返却された値による	keyとvalueがオブジェクト型で返却される	{"time":"2019年3月12日"}

使用例

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

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

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

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

GetState

概要

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

取得できる状態

名前	型	概要
downloads_count	整数値	ブラウザアクションのクリックでダウンロードされたファイルの総数
redirect_paths	オブジェクト	クリックやGoToで画面遷移した際に、リダイレクトされたり、途中に表示されたりしたURLの情報
dialog	オブジェクト	直前に表示されたアラート表示の対応状況を記録しています。

パラメーター

*は、必須パラメーター

名前	型	概要	例
key*	文字列	キー	redirect_paths

アウトプット

タイプ	型	概要	例
Anything	返却された値による	オブジェクト型で返却される	[{"status": 200, "url":"https://example.com"}]

使用例

例えば、ページ遷移時に、通常の遷移（クリックや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*	文字列	実行したいJavaScriptのコード	※code例参照

code例

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

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

アウトプット

タイプ	型	概要	例
Anything	返却された値による	RunScriptの結果	※使用例のアウトプット参照

使用例

+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は、二つの値を比較して真理値を返すアクションです。

パラメーター

*は、必須パラメーター

名前	型	概要	例
subject*	指定する値による	この値を主語にして比較	10
compare_with*	指定する値による	主語をこの値と比較	100
method*	セレクト	比較方法を指定	"より小さい"（"LESS_THAN"）
not*	真理値	反対の結果を返したい場合、trueに設定	false

アウトプット

タイプ	型	概要	例
Boolean	真理値	結果が正であれば true	true

使用例

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

ConvertTable

概要

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

パラメーター

*は、必須パラメーター

名前	型	概要	例
header*	真理値	変換元のテーブルデータにヘッダーが存在する場合は true	true
table*	配列	変換元のテーブルデータ	[['name', 'age'],['bob', 10], ['john', 30]]
transform*	配列	処理方式を指定	[{type: 'filter', column: 'age', operator: '>=', operand: 20, include_blank: true}]

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

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

transform についての補足

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

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

名前	型	概要	例
type	文字列	テーブルデータに対するフィルタリング処理を行う。	"filter"
column	指定する値による	headerが存在する場合はヘッダー名、存在しない場合は列番号	"age"
operator	文字列	比較演算子。利用できるものは "==", "!=", "<", "<=", ">", ">=", "~", "!~" のみ。	">="
operand	指定する値による	比較対象の値	20
include_blank	真偽値	指定のcolumnが空だった場合の行の扱い方。trueの場合は空のcolumnを含む行を残し、falseの場合は省く。	true

operator についての補足

比較演算子	概要	例
==	operandと一致する	"bob" == "bob"
!=	operandと一致しない	"bob" != "john"
<	operandに指定した数値より小さい	20 < 30
<=	operandに指定した数値以下	20 <= 30
>	operandに指定した数値より大きい	40 > 30
>=	operandに指定した数値以上	40 >= 30
~	operandに指定した文字を含む	"Hello World" ~ "Hello"
!~	operandに指定した文字を含まない	"Hello World" !~ "Japan"

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

名前	型	概要	例
type	文字列	テーブルデータに対するヘッダー行の追加、ヘッダー名の変更、列の抽出を行う	"column"
columns	オブジェクト	keyは処理対象となるヘッダー名もしくは列番号。valueは新しいヘッダー名。ヘッダーが存在しない場合はヘッダー行が追加される。	{name: '名前',age: '年齢'}

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

名前	型	概要	例
type	文字列	テーブルデータの列の移動を行う。	"sortColumn"
map	オブジェクト	列の移動前後の位置を列番号でマッピングしたオブジェクト。{元の列番号:移動後の列番号}の形式	{"0":1,"1":0,"2":2,"3":3}

アウトプット

タイプ	型	概要	例
List	配列	変換後のテーブルデータ	[['name', 'age'], ['john', 30]]

使用例

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*	JSON または JSON 配列	変換元の JSON	※使用例のサンプル JSON 参照
header*	配列	出力する配列のヘッダーに指定したい json のキーを、配列で入力	※使用例の yaml 参照
unwind	配列	行に分割したい配列のキーをパス指定し、配列で入力	※使用例の yaml 参照
stringify	配列	文字列化したい配列のキーをパス指定し、配列で入力	※使用例の yaml 参照

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

アウトプット

タイプ	型	概要	例
Array	配列	ヘッダつきの二次元配列	※使用例のアウトプット参照

使用例

サンプル 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*	配列	比較元のテーブルデータ	[["name", "age"],["bob", 10], ["john", 30], ["ken", 40]]
rightTerm*	配列	比較先のテーブルデータ	[["name", "address"],["john", "Tokyo"], ["ken", "Saitama"]]
method*	文字列	演算方式を選択する。合成の場合はadd。差分を求める場合はsubtract	add
identifier	文字列	比較元のテーブルの同一性を確認する(keyとなる)列を指定する	A
header*	真偽値	テーブルにヘッダーが存在する場合はtrue、そうでない場合はfalse	true

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

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

アウトプット

タイプ	型	概要	例
Array	配列	二次元配列	[["name", "age", "address"],["bob", 10, ""],["john", 30, "Tokyo"],["ken", 40, "Saitama"]]

使用例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は、プロジェクト間で共有可能なデータストアに、データを保存するアクションです。

パラメーター

*は、必須パラメーター

名前	型	概要	例
key*	文字列	保存するデータの名前。同じキーのデータは上書きされます	last_id
value*	任意	保存するデータの中身。データの形式は文字列や配列など任意。	1

アウトプット

タイプ	型	概要	例
Anything	任意	保存したデータのvalue	[["name", "age"], ["bob", 10]]

使用例

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

DataStoreGet

概要

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

パラメーター

*は、必須パラメーター

名前	型	概要	例
key*	文字列	取得するデータの名前	last_id

アウトプット

タイプ	型	概要	例
Anything	任意	取得したデータのvalue。データが見つからない場合false	1

使用例

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

DataStoreDelete

概要

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

パラメーター

*は、必須パラメーター

名前	型	概要	例
key*	文字列	削除したいデータの名前	last_id

アウトプット

タイプ	型	概要	例
Boolean	真偽値	成功した場合はtrue、失敗した場合はエラーになる	true

使用例

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

AggregateData

概要

二次元配列形式の表データを集計するアクションです。合計、平均、件数、一意件数、標本分散、標本標準偏差、最大値、最小値　に対応しています。

※こちらはプレビューリリースのため、将来的に仕様が変更される可能性があります。また、デスクトップ版未対応です。

パラメーター

*は、必須パラメーター

名前	型	概要	例
table*	配列	集計したい表データ(二次元配列)	[["生年月", "名前", "性別", "国語", "数学"],["2012年02月", "佐藤一郎", "男性", "53", "10"], ["2012年12月", "鈴木絵里", "女性", "78", "2"]]
hasHeader*	真偽値	true にすると、一行目がヘッダーとして利用されます。テーブルにヘッダー行が存在しない場合は、false にすることで、ヘッダーを連番で作成します。	true
groupby	配列	グループ化したい列を指定します。指定がない場合は、すべてのデータを一つのグループにします。集計列（columns）と指定が被る場合は、groupbyが優先されます。	["生年月","性別"]
columns	配列	集計したい列を指定します。指定がない場合は、集計可能なすべての列を集計します。	["国語","数学"]
calculations	配列	集計方法を指定します。指定がない場合は、集計可能なすべての計算を実施します。	["mean","sum"]
skipna*	真偽値	欠損値や NaN（集計可能ではない値）をスキップするかどうかを指定します。false の場合は、NaNをスキップしないようにするため、集計結果は、NaN となります。データに欠損値や NaN が含まれていることを期待していない時は、false を指定すると安全です。	false
fillna	数値	欠損値や NaN（集計可能ではない値）を別の数値で埋めることができます。例えば、0 とするとすべての欠損値は 0 に置き換えられます。fillna を指定すると NaN が存在しなくなるため skipna は、無効になります。これは特に平均値の計算で重要になります。平均する分母に欠損値を含めたくない場合は、fillna の指定はせず、skipna を true としてください。	0
outputArray*	真偽値	true にすると配列形式、falseのときはJSONで出力されます。	true

ピッカーで集計する列を選択する

tableにデータがあるとき、goupby, columns, calculations はピッカーで集計する列を選択することができます。

アウトプット

タイプ	型	概要	例
Array	配列	集計した結果のテーブル(二次元配列)	[["Type", "生年月", "性別", "国語", "数学"], ["平均", "2012年02月", "男性", "53", "10"], ["平均", "2012年12月", "女性", "78", "2"]]

使用例

# データを集計する
+aggregate_data_1:
  action>: AggregateData
  table: [["生年月","名前","性別","国語","数学"],["2012年02月","佐藤 一郎","男性","53","10"],["2012年12月","鈴木 絵里","女性","78","2"],["2012年03月","高橋 翔太","男性","29","27"]]
  hasHeader: true
  groupby: ["生年月","性別"]
  columns: ["国語","数学"]
  calculations: ["mean","sum"]
  skipna: false
  fillna: '0'
  outputArray: true
  private: false
  meta:
    display:
      calculations:
        label: '平均, 合計'
        type: chip
        icon: calculate
      groupby:
        label: '生年月, 性別'
        type: chip
        icon: intentionaryBlank
      columns:
        label: '国語, 数学'
        type: chip
        icon: intentionaryBlank

# =>
# [
#   [
#     "Type",
#     "生年月",
#     "性別",
#     "国語",
#     "数学"
#   ],
#   [
#     "平均",
#     "2012年02月",
#     "男性",
#     "53",
#     "10"
#   ],
#   [
#     "平均",
#     "2012年12月",
#     "女性",
#     "78",
#     "2"
#   ],
#   [
#     "平均",
#     "2012年03月",
#     "男性",
#     "29",
#     "27"
#   ],
#   [
#     "合計",
#     "2012年02月",
#     "男性",
#     "53",
#     "10"
#   ],
#   [
#     "合計",
#     "2012年12月",
#     "女性",
#     "78",
#     "2"
#   ],
#   [
#     "合計",
#     "2012年03月",
#     "男性",
#     "29",
#     "27"
#   ]
# ]

Data

CreateList

概要

パラメーター

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

アウトプット

使用例

CreateObject

概要

パラメーター

アウトプット

使用例

GetItemFromList

概要

パラメーター

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

アウトプット

使用例

GetValueWithKey

概要

パラメーター

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

アウトプット

使用例

JoinList

概要

パラメーター

list についての補足

アウトプット

使用例

SearchItemFromList

概要

パラメーター

アウトプット

使用例

StoreValue

概要

パラメーター

アウトプット

使用例

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

GetState

概要

取得できる状態

パラメーター

アウトプット

使用例

RunScript

概要

パラメーター

code例

アウトプット

使用例

Compare

概要

パラメーター

アウトプット

使用例

ConvertTable

概要

パラメーター

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

transform についての補足

operator についての補足

アウトプット

使用例

ConvertJSONToArray

概要

パラメーター

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

アウトプット

使用例

CompareTable

概要

パラメーター

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

アウトプット

使用例1

leftTerm

rightTerm

ピッカーで集計する列を選択する