embulk-output-kintone 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 11c7f1cbe588863b206b1581bf2ec89adeafeea4
-  data.tar.gz: c17ae7651f3409a6e51999e65233a96da2d87bf4
+  metadata.gz: abd297c9f29bedc191c3abc3837ff3955fdde7df
+  data.tar.gz: 5be528c62b5f1985b756f311699f74370b05a52b
 SHA512:
-  metadata.gz: 4e1bc2fe10bc224c643d88c06a37a19bfe4849fb46318fede913ef3a3923e1315ce48b78aea8bbdcc5ea9a5b4760058776c569e8acedf8f02691b80b330c5657
-  data.tar.gz: 9261603e49b45d2c8b72bf013d2995057293dd7f98ae0588f4dfa2f7e962b0ba2eac70990cdd7658eedf72a5caabd9cbb8f3135bc80cb91a7d250706c06081b4
+  metadata.gz: 040f72edfe4cfe79b4bc0c303653efc6d1fb93b84db8d009df9bf845e6bd1e712d4c222412db5c22bf21a9b1315cf6029b30c359294c664972c0fe369ed50345
+  data.tar.gz: 808579e76d0a6d854583d0d834f487f9a102b7cb827030d5857f4f0268f310f5f854135790904b9551cca9b489c58311434b4117a53426581642c79acced3ff0

data/README.md

@@ -18,14 +18,32 @@ kintone output plugin for Embulk stores app records from kintone.
 - **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)
+- **reduce_key**: Key column name to reduce expanded SUBTABLE (string, optional)
+- **sort_columns**: List of columns for sorting input records (array of objects, optional)
+    - **name**: Column name (string, required)
+    - **order**: Sort order (string `asc` or `desc`, required)
+- **max_sort_tmp_files**: Maximum number of temporary files for sorting input records (integer, default is `1024`)
+- **max_sort_memory**: Maximum memory usage for sorting input records (bytes in long, default is the estimated available memory, which is the approximate value of the JVM's current free memory)
 - **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`)
+- **skip_if_non_existing_id_or_update_key**: The skip policy if the record corresponding to the id or update key does not exist (string `auto`, `never` or `always`, default is `auto`). No effect for insert mode.
+    - **auto**:
+        - **update mode**: Skip the record if no id or update key value is specified.
+        - **upsert mode**: Skip the record if corresponds to the id does not exist or no update key value is specified.
+    - **never**: Never skip the record even if corresponds to the id or update key does not exist.
+        - **update mode**: Throw exception if no id or update key value is specified.
+        - **upsert mode**: Insert the record if corresponds to the id or update key does not exist (also, if no id or update key value is specified).
+    - **always**: Always skip the record if corresponds to the id or update key does not exist (also, if no id or update key value is specified). update mode and upsert mode will the same behavior (only updated, never inserted).
 - **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). 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`
+        - `USER_SELECT`, `ORGANIZATION_SELECT`, `GROUP_SELECT`, `FILE`
     - **timezone**: timezone to convert into `date` (string, default is `UTC`)
     - **val_sep**: Used to specify multiple checkbox values (string, default is `,`)
+    - **sort_columns**: List of columns for sorting rows in SUBTABLE. Available only if type is `SUBTABLE` (array of objects, optional)
+        - **name**: Column name (string, required)
+        - **order**: Sort order (string `asc` or `desc`, required)
+- **chunk_size**: Maximum number of records to request at once (integer, default is `100`)
 
 ## Example
 
@@ -46,6 +64,52 @@ out:
     date_time: {field_code: "datetime", type: "DATETIME"}
 ```
 
+### For reduce expanded SUBTABLE
+
+```yaml
+out:
+  ...
+  reduce_key: id
+  column_options:
+    id: {field_code: "id", type: "NUMBER"}
+    ...
+    table: {field_code: "table", type: "SUBTABLE", sort_columns: [{name: number, order: asc}, {name: text, order: desc}]}
+    table.number: {field_code: "number_in_table", type: "NUMBER"}
+    table.text: {field_code: "text_in_table", type: "SINGLE_LINE_TEXT"}
+```
+
+#### KINTONE
+
+| Form                      | Field Code      |
+| ------------------------- | --------------- |
+| Table's own               | table           |
+| NUMBER In Table           | number_in_table |
+| SINGLE_LINE_TEXT In Table | text_in_table   |
+
+#### INPUT CSV
+
+```csv
+id,table.number,table.text
+1,0,test0
+1,1,test1
+2,0,test0
+```
+
+#### RESULT
+
+ID:1
+
+| NUMBER        | SINGLE_LINE_TEXT |
+| ------------- | ---------------- |
+| 0             | test0            |
+| 1             | test1            |
+
+ID:2
+
+| NUMBER        | SINGLE_LINE_TEXT |
+| ------------- | ---------------- |
+| 0             | test0            |
+
 ## Build
 
 ```

data/build.gradle

@@ -28,6 +28,7 @@ targetCompatibility = 1.8
 
 dependencies {
     compileOnly "org.embulk:embulk-core:0.9.23"
+    implementation "com.google.code.externalsortinginjava:externalsortinginjava:0.6.2"
     implementation project(path: ":shadow-kintone-java-client", configuration: "shadow")
 
     testImplementation "junit:junit:4.+"

data/src/main/java/org/embulk/output/kintone/KintoneClient.java

@@ -0,0 +1,117 @@
+package org.embulk.output.kintone;
+
+import com.kintone.client.KintoneClientBuilder;
+import com.kintone.client.RecordClient;
+import com.kintone.client.model.app.field.FieldProperty;
+import com.kintone.client.model.record.FieldType;
+import java.io.IOException;
+import java.util.Map;
+import java.util.function.Supplier;
+import org.embulk.config.ConfigException;
+import org.embulk.output.kintone.record.Id;
+import org.embulk.output.kintone.util.Lazy;
+import org.embulk.spi.Column;
+import org.embulk.spi.Schema;
+import org.embulk.spi.type.Type;
+import org.embulk.spi.type.Types;
+
+public class KintoneClient implements AutoCloseable {
+  private final PluginTask task;
+  private final Schema schema;
+  private final com.kintone.client.KintoneClient client;
+  private final Map<String, FieldProperty> fields;
+
+  public static Lazy<KintoneClient> lazy(Supplier<PluginTask> task, Schema schema) {
+    return new Lazy<KintoneClient>() {
+      @Override
+      protected KintoneClient initialValue() {
+        return new KintoneClient(task.get(), schema);
+      }
+    };
+  }
+
+  private KintoneClient(PluginTask task, Schema schema) {
+    this.task = task;
+    this.schema = schema;
+    KintoneClientBuilder builder = KintoneClientBuilder.create("https://" + task.getDomain());
+    if (task.getGuestSpaceId().isPresent()) {
+      builder.setGuestSpaceId(task.getGuestSpaceId().get());
+    }
+    if (task.getBasicAuthUsername().isPresent() && task.getBasicAuthPassword().isPresent()) {
+      builder.withBasicAuth(task.getBasicAuthUsername().get(), task.getBasicAuthPassword().get());
+    }
+    if (task.getUsername().isPresent() && task.getPassword().isPresent()) {
+      builder.authByPassword(task.getUsername().get(), task.getPassword().get());
+    } else if (task.getToken().isPresent()) {
+      builder.authByApiToken(task.getToken().get());
+    } else {
+      throw new ConfigException("Username and password or token must be configured.");
+    }
+    client = builder.build();
+    fields = client.app().getFormFields(task.getAppId());
+    KintoneMode.of(task).validate(task, this);
+  }
+
+  public void validateIdOrUpdateKey(String columnName) {
+    Column column = getColumn(columnName);
+    if (column == null) {
+      throw new ConfigException("The column '" + columnName + "' for update does not exist.");
+    }
+    validateId(column);
+    validateUpdateKey(column);
+  }
+
+  public Column getColumn(String columnName) {
+    return schema.getColumns().stream()
+        .filter(column -> column.getName().equals(columnName))
+        .findFirst()
+        .orElse(null);
+  }
+
+  public FieldType getFieldType(String fieldCode) {
+    FieldProperty field = fields.get(fieldCode);
+    return field == null ? null : field.getType();
+  }
+
+  public RecordClient record() {
+    return client.record();
+  }
+
+  @Override
+  public void close() {
+    try {
+      client.close();
+    } catch (IOException e) {
+      throw new RuntimeException("kintone throw exception", e);
+    }
+  }
+
+  private void validateId(Column column) {
+    if (!column.getName().equals(Id.FIELD)) {
+      return;
+    }
+    Type type = column.getType();
+    if (!type.equals(Types.LONG)) {
+      throw new ConfigException("The id column must be 'long'.");
+    }
+  }
+
+  private void validateUpdateKey(Column column) {
+    if (column.getName().equals(Id.FIELD)) {
+      return;
+    }
+    String fieldCode = getFieldCode(column);
+    FieldType fieldType = getFieldType(fieldCode);
+    if (fieldType == null) {
+      throw new ConfigException("The field '" + fieldCode + "' for update does not exist.");
+    }
+    if (fieldType != FieldType.SINGLE_LINE_TEXT && fieldType != FieldType.NUMBER) {
+      throw new ConfigException("The update_key must be 'SINGLE_LINE_TEXT' or 'NUMBER'.");
+    }
+  }
+
+  private String getFieldCode(Column column) {
+    KintoneColumnOption option = task.getColumnOptions().get(column.getName());
+    return option != null ? option.getFieldCode() : column.getName();
+  }
+}

data/src/main/java/org/embulk/output/kintone/KintoneColumnOption.java

@@ -1,5 +1,6 @@
 package org.embulk.output.kintone;
 
+import java.util.List;
 import org.embulk.config.Config;
 import org.embulk.config.ConfigDefault;
 import org.embulk.config.Task;
@@ -18,4 +19,8 @@ public interface KintoneColumnOption extends Task {
   @Config("val_sep")
   @ConfigDefault("\",\"")
   String getValueSeparator();
+
+  @Config("sort_columns")
+  @ConfigDefault("[]")
+  List<KintoneSortColumn> getSortColumns();
 }

data/src/main/java/org/embulk/output/kintone/KintoneColumnType.java

@@ -13,6 +13,7 @@ import com.kintone.client.model.record.MultiSelectFieldValue;
 import com.kintone.client.model.record.NumberFieldValue;
 import com.kintone.client.model.record.OrganizationSelectFieldValue;
 import com.kintone.client.model.record.RadioButtonFieldValue;
+import com.kintone.client.model.record.Record;
 import com.kintone.client.model.record.RichTextFieldValue;
 import com.kintone.client.model.record.SingleLineTextFieldValue;
 import com.kintone.client.model.record.SubtableFieldValue;
@@ -29,8 +30,15 @@ import java.time.ZonedDateTime;
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.List;
+import java.util.stream.Collectors;
+import org.embulk.output.kintone.deserializer.Deserializer;
 import org.embulk.spi.time.Timestamp;
+import org.embulk.spi.type.Type;
+import org.embulk.spi.type.Types;
+import org.msgpack.value.ArrayValue;
+import org.msgpack.value.StringValue;
 import org.msgpack.value.Value;
+import org.msgpack.value.ValueFactory;
 
 public enum KintoneColumnType {
   SINGLE_LINE_TEXT {
@@ -44,6 +52,11 @@ public enum KintoneColumnType {
       return new SingleLineTextFieldValue(value);
     }
 
+    @Override
+    public String getValue(Record record, String fieldCode) {
+      return record.getSingleLineTextFieldValue(fieldCode);
+    }
+
     @Override
     public void setUpdateKey(UpdateKey updateKey, String field) {
       updateKey.setField(field);
@@ -53,6 +66,16 @@ public enum KintoneColumnType {
     public void setUpdateKey(UpdateKey updateKey, String field, FieldValue value) {
       updateKey.setField(field).setValue(((SingleLineTextFieldValue) value).getValue());
     }
+
+    @Override
+    public StringValue asValue(FieldValue value) {
+      return ValueFactory.newString(((SingleLineTextFieldValue) value).getValue());
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Arrays.asList(Types.BOOLEAN, Types.LONG, Types.DOUBLE, Types.TIMESTAMP, Types.JSON);
+    }
   },
   MULTI_LINE_TEXT {
     @Override
@@ -64,6 +87,16 @@ public enum KintoneColumnType {
     public MultiLineTextFieldValue getFieldValue(String value, KintoneColumnOption option) {
       return new MultiLineTextFieldValue(value);
     }
+
+    @Override
+    public StringValue asValue(FieldValue value) {
+      return ValueFactory.newString(((MultiLineTextFieldValue) value).getValue());
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Arrays.asList(Types.BOOLEAN, Types.LONG, Types.DOUBLE, Types.TIMESTAMP, Types.JSON);
+    }
   },
   RICH_TEXT {
     @Override
@@ -75,6 +108,16 @@ public enum KintoneColumnType {
     public RichTextFieldValue getFieldValue(String value, KintoneColumnOption option) {
       return new RichTextFieldValue(value);
     }
+
+    @Override
+    public StringValue asValue(FieldValue value) {
+      return ValueFactory.newString(((RichTextFieldValue) value).getValue());
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Arrays.asList(Types.BOOLEAN, Types.LONG, Types.DOUBLE, Types.TIMESTAMP, Types.JSON);
+    }
   },
   NUMBER {
     @Override
@@ -97,6 +140,11 @@ public enum KintoneColumnType {
       return (NumberFieldValue) getFieldValue(value.getEpochSecond(), option);
     }
 
+    @Override
+    public BigDecimal getValue(Record record, String fieldCode) {
+      return record.getNumberFieldValue(fieldCode);
+    }
+
     @Override
     public void setUpdateKey(UpdateKey updateKey, String field) {
       updateKey.setField(field);
@@ -106,6 +154,16 @@ public enum KintoneColumnType {
     public void setUpdateKey(UpdateKey updateKey, String field, FieldValue value) {
       updateKey.setField(field).setValue(((NumberFieldValue) value).getValue());
     }
+
+    @Override
+    public StringValue asValue(FieldValue value) {
+      return ValueFactory.newString(((NumberFieldValue) value).getValue().toPlainString());
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Arrays.asList(Types.BOOLEAN, Types.LONG, Types.DOUBLE, Types.TIMESTAMP);
+    }
   },
   CHECK_BOX {
     @Override
@@ -117,6 +175,18 @@ public enum KintoneColumnType {
     public CheckBoxFieldValue getFieldValue(String value, KintoneColumnOption option) {
       return new CheckBoxFieldValue(asList(value, option));
     }
+
+    @Override
+    public ArrayValue asValue(FieldValue value) {
+      return ValueFactory.newArray(
+          ((CheckBoxFieldValue) value)
+              .getValues().stream().map(ValueFactory::newString).collect(Collectors.toList()));
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Collections.emptyList();
+    }
   },
   RADIO_BUTTON {
     @Override
@@ -128,6 +198,16 @@ public enum KintoneColumnType {
     public RadioButtonFieldValue getFieldValue(String value, KintoneColumnOption option) {
       return new RadioButtonFieldValue(value);
     }
+
+    @Override
+    public StringValue asValue(FieldValue value) {
+      return ValueFactory.newString(((RadioButtonFieldValue) value).getValue());
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Collections.emptyList();
+    }
   },
   MULTI_SELECT {
     @Override
@@ -139,6 +219,18 @@ public enum KintoneColumnType {
     public MultiSelectFieldValue getFieldValue(String value, KintoneColumnOption option) {
       return new MultiSelectFieldValue(asList(value, option));
     }
+
+    @Override
+    public ArrayValue asValue(FieldValue value) {
+      return ValueFactory.newArray(
+          ((MultiSelectFieldValue) value)
+              .getValues().stream().map(ValueFactory::newString).collect(Collectors.toList()));
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Collections.emptyList();
+    }
   },
   DROP_DOWN {
     @Override
@@ -150,6 +242,16 @@ public enum KintoneColumnType {
     public DropDownFieldValue getFieldValue(String value, KintoneColumnOption option) {
       return new DropDownFieldValue(value);
     }
+
+    @Override
+    public StringValue asValue(FieldValue value) {
+      return ValueFactory.newString(((DropDownFieldValue) value).getValue());
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Collections.emptyList();
+    }
   },
   USER_SELECT {
     @Override
@@ -161,6 +263,16 @@ public enum KintoneColumnType {
     public UserSelectFieldValue getFieldValue(String value, KintoneColumnOption option) {
       throw new UnsupportedOperationException();
     }
+
+    @Override
+    public Value asValue(FieldValue value) {
+      throw new UnsupportedOperationException();
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Collections.emptyList();
+    }
   },
   ORGANIZATION_SELECT {
     @Override
@@ -172,6 +284,16 @@ public enum KintoneColumnType {
     public OrganizationSelectFieldValue getFieldValue(String value, KintoneColumnOption option) {
       throw new UnsupportedOperationException();
     }
+
+    @Override
+    public Value asValue(FieldValue value) {
+      throw new UnsupportedOperationException();
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Collections.emptyList();
+    }
   },
   GROUP_SELECT {
     @Override
@@ -183,6 +305,16 @@ public enum KintoneColumnType {
     public GroupSelectFieldValue getFieldValue(String value, KintoneColumnOption option) {
       throw new UnsupportedOperationException();
     }
+
+    @Override
+    public Value asValue(FieldValue value) {
+      throw new UnsupportedOperationException();
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Collections.emptyList();
+    }
   },
   DATE {
     @Override
@@ -215,6 +347,16 @@ public enum KintoneColumnType {
     public DateFieldValue getFieldValue(Timestamp value, KintoneColumnOption option) {
       return new DateFieldValue(value.getInstant().atZone(getZoneId(option)).toLocalDate());
     }
+
+    @Override
+    public StringValue asValue(FieldValue value) {
+      return ValueFactory.newString(((DateFieldValue) value).getValue().toString());
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Arrays.asList(Types.LONG, Types.DOUBLE, Types.TIMESTAMP);
+    }
   },
   TIME {
     @Override
@@ -247,6 +389,16 @@ public enum KintoneColumnType {
     public TimeFieldValue getFieldValue(Timestamp value, KintoneColumnOption option) {
       return new TimeFieldValue(value.getInstant().atZone(getZoneId(option)).toLocalTime());
     }
+
+    @Override
+    public StringValue asValue(FieldValue value) {
+      return ValueFactory.newString(((TimeFieldValue) value).getValue().toString());
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Arrays.asList(Types.LONG, Types.DOUBLE, Types.TIMESTAMP);
+    }
   },
   DATETIME {
     @Override
@@ -275,6 +427,16 @@ public enum KintoneColumnType {
     public DateTimeFieldValue getFieldValue(Timestamp value, KintoneColumnOption option) {
       return new DateTimeFieldValue(value.getInstant().atZone(ZoneOffset.UTC));
     }
+
+    @Override
+    public StringValue asValue(FieldValue value) {
+      return ValueFactory.newString(((DateTimeFieldValue) value).getValue().toString());
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Arrays.asList(Types.LONG, Types.DOUBLE, Types.TIMESTAMP);
+    }
   },
   LINK {
     @Override
@@ -286,6 +448,16 @@ public enum KintoneColumnType {
     public LinkFieldValue getFieldValue(String value, KintoneColumnOption option) {
       return new LinkFieldValue(value);
     }
+
+    @Override
+    public StringValue asValue(FieldValue value) {
+      return ValueFactory.newString(((LinkFieldValue) value).getValue());
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Collections.emptyList();
+    }
   },
   FILE {
     @Override
@@ -297,6 +469,16 @@ public enum KintoneColumnType {
     public FileFieldValue getFieldValue(String value, KintoneColumnOption option) {
       throw new UnsupportedOperationException();
     }
+
+    @Override
+    public Value asValue(FieldValue value) {
+      throw new UnsupportedOperationException();
+    }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Collections.emptyList();
+    }
   },
   SUBTABLE {
     @Override
@@ -306,9 +488,20 @@ public enum KintoneColumnType {
 
     @Override
     public SubtableFieldValue getFieldValue(String value, KintoneColumnOption option) {
+      return DESERIALIZER.deserialize(value.isEmpty() ? "[]" : value, SubtableFieldValue.class);
+    }
+
+    @Override
+    public Value asValue(FieldValue value) {
       throw new UnsupportedOperationException();
     }
+
+    @Override
+    protected List<Type> getSupportedTypes() {
+      return Collections.singletonList(Types.JSON);
+    }
   };
+  private static final Deserializer DESERIALIZER = new Deserializer();
   private static final Timestamp EPOCH = Timestamp.ofInstant(Instant.EPOCH);
 
   public static KintoneColumnType getType(
@@ -319,25 +512,49 @@ public enum KintoneColumnType {
   public abstract FieldValue getFieldValue();
 
   public FieldValue getFieldValue(boolean value, KintoneColumnOption option) {
-    return getFieldValue(String.valueOf(value), option);
+    if (getSupportedTypes().contains(Types.BOOLEAN)) {
+      return getFieldValue(String.valueOf(value), option);
+    } else {
+      throw new UnsupportedOperationException();
+    }
   }
 
   public FieldValue getFieldValue(long value, KintoneColumnOption option) {
-    return getFieldValue(String.valueOf(value), option);
+    if (getSupportedTypes().contains(Types.LONG)) {
+      return getFieldValue(String.valueOf(value), option);
+    } else {
+      throw new UnsupportedOperationException();
+    }
   }
 
   public FieldValue getFieldValue(double value, KintoneColumnOption option) {
-    return getFieldValue(String.valueOf(value), option);
+    if (getSupportedTypes().contains(Types.DOUBLE)) {
+      return getFieldValue(String.valueOf(value), option);
+    } else {
+      throw new UnsupportedOperationException();
+    }
   }
 
   public abstract FieldValue getFieldValue(String value, KintoneColumnOption option);
 
   public FieldValue getFieldValue(Timestamp value, KintoneColumnOption option) {
-    return getFieldValue(value.getInstant().toString(), option);
+    if (getSupportedTypes().contains(Types.TIMESTAMP)) {
+      return getFieldValue(value.getInstant().toString(), option);
+    } else {
+      throw new UnsupportedOperationException();
+    }
   }
 
   public FieldValue getFieldValue(Value value, KintoneColumnOption option) {
-    return getFieldValue(value.toJson(), option);
+    if (getSupportedTypes().contains(Types.JSON)) {
+      return getFieldValue(value.toJson(), option);
+    } else {
+      throw new UnsupportedOperationException();
+    }
+  }
+
+  public Object getValue(Record Record, String fieldCode) {
+    throw new UnsupportedOperationException();
   }
 
   public void setUpdateKey(UpdateKey updateKey, String field) {
@@ -348,6 +565,10 @@ public enum KintoneColumnType {
     throw new UnsupportedOperationException();
   }
 
+  public abstract Value asValue(FieldValue value);
+
+  protected abstract List<Type> getSupportedTypes();
+
   private static List<String> asList(String value, KintoneColumnOption option) {
     return value.isEmpty()
         ? Collections.emptyList()