README.md in embulk-output-kintone-0.4.1 vs README.md in embulk-output-kintone-1.0.0
- old
+ new
@@ -6,23 +6,26 @@
kintone output plugin for Embulk stores app records from kintone.
## Configuration
-- **domain**: kintone domain(FQDN) e.g. devfoo.cybozu.com (string, required)
+- **domain**: kintone domain (FQDN) e.g. devfoo.cybozu.com (string, required)
- **username**: kintone username (string, optional)
- **password**: kintone password (string, optional)
- **token**: kintone app token. Username and password or token must be configured. If all of them are provided, this plugin uses username and password (string, optional)
- **app_id**: kintone app id (integer, required)
-- **basic_auth_username**: kintone basic auth username Please see kintone basic auth [here](https://jp.cybozu.help/general/en/admin/list_security/list_ip_basic/basic_auth.html) (string, optional)
-- **basic_auth_password**: kintone basic auth password (string, optional)
+- **basic_auth_username**: kintone basic auth username Please see kintone basic auth [here](https://jp.cybozu.help/general/en/admin/list_security/list_ip_basic/basic_auth.html) (string, optional)
+- **basic_auth_password**: kintone basic auth password (string, optional)
- **guest_space_id**: kintone app belongs to guest space, guest space id is required. (integer, optional)
- **mode**: kintone mode (string, required)
-- **update_key**: column name to set update key (string, required if mode is update or upsert)
+- **update_key**: Column name to set update key (string, required if mode is update or upsert)
+- **prefer_nulls**: Whether to set fields to null instead of default value of type when column is null (boolean, default is `false`)
+- **ignore_nulls**: Whether to completely ignore fields when column is null (boolean, default is `false`)
- **column_options** advanced: a key-value pairs where key is a column name and value is options for the column.
- **field_code**: field code (string, required)
- - **type**: field type (string, required)
+ - **type**: field type (string, required). See [this page](https://cybozu.dev/ja/kintone/docs/overview/field-types/#field-type-update) for list of available types. However, following types are not yet supported
+ - `USER_SELECT`, `ORGANIZATION_SELECT`, `GROUP_SELECT`, `FILE`, `SUBTABLE`
- **timezone**: timezone to convert into `date` (string, default is `UTC`)
- **val_sep**: Used to specify multiple checkbox values (string, default is `,`)
## Example
@@ -40,10 +43,9 @@
name: {field_code: "name", type: "SINGLE_LINE_TEXT"}
number: {field_code: "num", type: "NUMBER"}
date: {field_code: "date", type: "DATE"}
date_time: {field_code: "datetime", type: "DATETIME"}
```
-
## Build
```
$ ./gradlew gem # -t to watch change of files and rebuild continuously