Merge pull request #53 from kintone/feat-support-new-properties-of-ap…

…p-settings-apis feat: Support new properties of app settings apis
kintone · Apr 30, 2024 · a4ad651 · a4ad651
2 parents 0425f42 + 97ac26d
commit a4ad651
Show file tree

Hide file tree

Showing 11 changed files with 232 additions and 11 deletions.
diff --git a/README.md b/README.md
@@ -8,7 +8,7 @@ API client library for Kintone REST APIs on Java.
     Add dependency declaration in `build.gradle` of your project.
     ```
     dependencies {
-        implementation 'com.kintone:kintone-java-client:2.1.0'
+        implementation 'com.kintone:kintone-java-client:2.2.0'
     }
     ```
 - For projects using Maven  
@@ -17,7 +17,7 @@ API client library for Kintone REST APIs on Java.
     <dependency>
         <groupId>com.kintone</groupId>
         <artifactId>kintone-java-client</artifactId>
-        <version>2.1.0</version>
+        <version>2.2.0</version>
     </dependency>
   ```
 

diff --git a/build.gradle b/build.gradle
@@ -6,7 +6,7 @@ plugins {
     id 'com.github.hierynomus.license' version '0.16.1'
 }
 
-version = '2.1.0'
+version = '2.2.0'
 sourceCompatibility = 1.8
 targetCompatibility = 1.8
 

diff --git a/docs/getting-started.md b/docs/getting-started.md
@@ -29,7 +29,7 @@ client.close();
 Add dependency declaration in `build.gradle` of your project.
 ```groovy
 dependencies {
-     implementation 'com.kintone:kintone-java-client:2.1.0'
+     implementation 'com.kintone:kintone-java-client:2.2.0'
 }
 ```
 
@@ -39,7 +39,7 @@ Add dependency declaration in `pom.xml` of your project.
 <dependency>
     <groupId>com.kintone</groupId>
     <artifactId>kintone-java-client</artifactId>
-    <version>2.1.0</version>
+    <version>2.2.0</version>
 </dependency>
 ```
 

diff --git a/src/main/java/com/kintone/client/api/app/GetAppSettingsPreviewResponseBody.java b/src/main/java/com/kintone/client/api/app/GetAppSettingsPreviewResponseBody.java
@@ -2,6 +2,8 @@
 
 import com.kintone.client.api.KintoneResponseBody;
 import com.kintone.client.model.app.AppIcon;
+import com.kintone.client.model.app.NumberPrecision;
+import com.kintone.client.model.app.TitleFiled;
 import lombok.Value;
 
 /** A response object for Get App Settings Preview API. */
@@ -20,6 +22,27 @@ public class GetAppSettingsPreviewResponseBody implements KintoneResponseBody {
     /** The color theme. */
     private final String theme;
 
+    /** An object containing settings of record title. */
+    private final TitleFiled titleField;
+
+    /** An object containing the precision settings of numbers and calculations. */
+    private final NumberPrecision numberPrecision;
+
+    /** The settings of first month of fiscal year */
+    private final int firstMonthOfFiscalYear;
+
+    /** Thumbnails of image files attached to the File fields are enabled. */
+    private final boolean enableThumbnails;
+
+    /** The bulk deletion of records is enabled. */
+    private final boolean enableBulkDeletion;
+
+    /** The record comments feature is enabled. */
+    private final boolean enableComments;
+
+    /** The "duplicate record" feature is enabled. */
+    private final boolean enableDuplicateRecord;
+
     /** The revision number of the App settings. */
     private final long revision;
 }
diff --git a/src/main/java/com/kintone/client/api/app/GetAppSettingsResponseBody.java b/src/main/java/com/kintone/client/api/app/GetAppSettingsResponseBody.java
@@ -2,6 +2,8 @@
 
 import com.kintone.client.api.KintoneResponseBody;
 import com.kintone.client.model.app.AppIcon;
+import com.kintone.client.model.app.NumberPrecision;
+import com.kintone.client.model.app.TitleFiled;
 import lombok.Value;
 
 /** A response object for Get App Settings API. */
@@ -20,6 +22,27 @@ public class GetAppSettingsResponseBody implements KintoneResponseBody {
     /** The color theme. */
     private final String theme;
 
+    /** An object containing settings of record title. */
+    private final TitleFiled titleField;
+
+    /** An object containing the precision settings of numbers and calculations. */
+    private final NumberPrecision numberPrecision;
+
+    /** The settings of first month of fiscal year */
+    private final int firstMonthOfFiscalYear;
+
+    /** Thumbnails of image files attached to the File fields are enabled. */
+    private final boolean enableThumbnails;
+
+    /** The bulk deletion of records is enabled. */
+    private final boolean enableBulkDeletion;
+
+    /** The record comments feature is enabled. */
+    private final boolean enableComments;
+
+    /** The "duplicate record" feature is enabled. */
+    private final boolean enableDuplicateRecord;
+
     /** The revision number of the App settings. */
     private final long revision;
 }
diff --git a/src/main/java/com/kintone/client/api/app/UpdateAppSettingsRequest.java b/src/main/java/com/kintone/client/api/app/UpdateAppSettingsRequest.java
@@ -2,6 +2,8 @@
 
 import com.kintone.client.api.KintoneRequest;
 import com.kintone.client.model.app.AppIcon;
+import com.kintone.client.model.app.NumberPrecision;
+import com.kintone.client.model.app.TitleFiled;
 import lombok.Data;
 
 /** A request object for Update App Settings API. */
@@ -26,6 +28,48 @@ public class UpdateAppSettingsRequest implements KintoneRequest {
     /** The color theme (optional). If set to null, leaves this setting unchanged. */
     private String theme;
 
+    /**
+     * An object containing settings of record title (optional). If set to null, leaves this setting
+     * unchanged.
+     */
+    private TitleFiled titleField;
+
+    /**
+     * An object containing the precision settings of numbers and calculations (optional). If set to
+     * null, leaves this setting unchanged.
+     */
+    private NumberPrecision numberPrecision;
+
+    /**
+     * The settings of first month of fiscal year (optional). If set to null, leaves this setting
+     * unchanged.
+     */
+    private Integer firstMonthOfFiscalYear;
+
+    /**
+     * The on/off settings to show thumbnails of image files attached to the File fields (optional).
+     * If set to null, leaves this setting unchanged.
+     */
+    private Boolean enableThumbnails;
+
+    /**
+     * The on/off settings of bulk deletion of records (optional). If set to null, leaves this setting
+     * unchanged.
+     */
+    private Boolean enableBulkDeletion;
+
+    /**
+     * The on/off settings of record comments feature (optional). If set to null, leaves this setting
+     * unchanged.
+     */
+    private Boolean enableComments;
+
+    /**
+     * The on/off settings to use the feature to "duplicate record" (optional). If set to null, leaves
+     * this setting unchanged.
+     */
+    private Boolean enableDuplicateRecord;
+
     /**
      * The expected revision number of the App settings (optional). The request will fail if the
      * revision number is not the latest revision. The revision will not be checked if this parameter

diff --git a/src/main/java/com/kintone/client/model/app/NumberPrecision.java b/src/main/java/com/kintone/client/model/app/NumberPrecision.java
@@ -0,0 +1,17 @@
+package com.kintone.client.model.app;
+
+import lombok.Data;
+
+/** An object containing the precision settings of numbers and calculations */
+@Data
+public class NumberPrecision {
+
+    /** The total number of digits. */
+    private Integer digits;
+
+    /** The number of decimal places to round. */
+    private Integer decimalPlaces;
+
+    /** The rounding mode of the Number and Calculated fields. */
+    private RoundingMode roundingMode;
+}
diff --git a/src/main/java/com/kintone/client/model/app/RoundingMode.java b/src/main/java/com/kintone/client/model/app/RoundingMode.java
@@ -0,0 +1,14 @@
+package com.kintone.client.model.app;
+
+/** The rounding mode of numbers. */
+public enum RoundingMode {
+
+    /** Round to nearest even number. */
+    HALF_EVEN,
+
+    /** Round up. */
+    UP,
+
+    /** Round down. */
+    DOWN
+}
diff --git a/src/main/java/com/kintone/client/model/app/TitleFieldSelectionMode.java b/src/main/java/com/kintone/client/model/app/TitleFieldSelectionMode.java
@@ -0,0 +1,10 @@
+package com.kintone.client.model.app;
+
+/** The selection mode of the title field. */
+public enum TitleFieldSelectionMode {
+    /** Automatically set the title field. */
+    AUTO,
+
+    /** Manually set a field as the record title. */
+    MANUAL;
+}
diff --git a/src/main/java/com/kintone/client/model/app/TitleFiled.java b/src/main/java/com/kintone/client/model/app/TitleFiled.java
@@ -0,0 +1,14 @@
+package com.kintone.client.model.app;
+
+import lombok.Data;
+
+/** An object containing settings of record title. */
+@Data
+public class TitleFiled {
+
+    /** The selection mode of the title field. */
+    private TitleFieldSelectionMode selectionMode;
+
+    /** The field to be used as the record title when the "selectionMode" is set to "MANUAL". */
+    private String code;
+}
diff --git a/src/test/java/com/kintone/client/AppClientTest.java b/src/test/java/com/kintone/client/AppClientTest.java
@@ -118,8 +118,11 @@
 import com.kintone.client.model.app.FieldAccessibility;
 import com.kintone.client.model.app.FieldRight;
 import com.kintone.client.model.app.FieldRightEntity;
+import com.kintone.client.model.app.NumberPrecision;
 import com.kintone.client.model.app.RecordRight;
 import com.kintone.client.model.app.RecordRightEntity;
+import com.kintone.client.model.app.TitleFieldSelectionMode;
+import com.kintone.client.model.app.TitleFiled;
 import com.kintone.client.model.app.View;
 import com.kintone.client.model.app.ViewId;
 import com.kintone.client.model.app.ViewType;
@@ -685,7 +688,19 @@ public void getAppsByIds_List() {
     @Test
     public void getAppSettings_long() {
         GetAppSettingsResponseBody resp =
-                new GetAppSettingsResponseBody("name", "desc", null, null, 10L);
+                new GetAppSettingsResponseBody(
+                        "name",
+                        "desc",
+                        null,
+                        null,
+                        new TitleFiled().setSelectionMode(TitleFieldSelectionMode.AUTO),
+                        new NumberPrecision().setDigits(40).setDecimalPlaces(10),
+                        4,
+                        true,
+                        true,
+                        true,
+                        true,
+                        10L);
         mockClient.setResponseBody(resp);
 
         assertThat(sut.getAppSettings(10L)).isEqualTo(resp);
@@ -697,7 +712,19 @@ public void getAppSettings_long() {
     @Test
     public void getAppSettings_long_String() {
         GetAppSettingsResponseBody resp =
-                new GetAppSettingsResponseBody("name", "desc", null, null, 10L);
+                new GetAppSettingsResponseBody(
+                        "name",
+                        "desc",
+                        null,
+                        null,
+                        new TitleFiled().setSelectionMode(TitleFieldSelectionMode.AUTO),
+                        new NumberPrecision().setDigits(40).setDecimalPlaces(10),
+                        4,
+                        true,
+                        true,
+                        true,
+                        true,
+                        10L);
         mockClient.setResponseBody(resp);
 
         assertThat(sut.getAppSettings(10L, "ja")).isEqualTo(resp);
@@ -709,7 +736,20 @@ public void getAppSettings_long_String() {
     @Test
     public void getAppSettings_GetAppSettingsRequest() {
         GetAppSettingsRequest req = new GetAppSettingsRequest();
-        GetAppSettingsResponseBody resp = new GetAppSettingsResponseBody("", "", null, "", 1);
+        GetAppSettingsResponseBody resp =
+                new GetAppSettingsResponseBody(
+                        "",
+                        "",
+                        null,
+                        "",
+                        new TitleFiled().setSelectionMode(TitleFieldSelectionMode.AUTO),
+                        new NumberPrecision().setDigits(40).setDecimalPlaces(10),
+                        4,
+                        true,
+                        true,
+                        true,
+                        true,
+                        1);
         mockClient.setResponseBody(resp);
 
         assertThat(sut.getAppSettings(req)).isEqualTo(resp);
@@ -720,7 +760,19 @@ public void getAppSettings_GetAppSettingsRequest() {
     @Test
     public void getAppSettingsPreview_long() {
         GetAppSettingsPreviewResponseBody resp =
-                new GetAppSettingsPreviewResponseBody("name", "desc", null, null, 10L);
+                new GetAppSettingsPreviewResponseBody(
+                        "name",
+                        "desc",
+                        null,
+                        null,
+                        new TitleFiled().setSelectionMode(TitleFieldSelectionMode.AUTO),
+                        new NumberPrecision().setDigits(40).setDecimalPlaces(10),
+                        4,
+                        true,
+                        true,
+                        true,
+                        true,
+                        10L);
         mockClient.setResponseBody(resp);
 
         assertThat(sut.getAppSettingsPreview(10L)).isEqualTo(resp);
@@ -732,7 +784,19 @@ public void getAppSettingsPreview_long() {
     @Test
     public void getAppSettingsPreview_long_String() {
         GetAppSettingsPreviewResponseBody resp =
-                new GetAppSettingsPreviewResponseBody("name", "desc", null, null, 10L);
+                new GetAppSettingsPreviewResponseBody(
+                        "name",
+                        "desc",
+                        null,
+                        null,
+                        new TitleFiled().setSelectionMode(TitleFieldSelectionMode.AUTO),
+                        new NumberPrecision().setDigits(40).setDecimalPlaces(10),
+                        4,
+                        true,
+                        true,
+                        true,
+                        true,
+                        10L);
         mockClient.setResponseBody(resp);
 
         assertThat(sut.getAppSettingsPreview(10L, "ja")).isEqualTo(resp);
@@ -745,7 +809,19 @@ public void getAppSettingsPreview_long_String() {
     public void getAppSettingsPreview_GetAppSettingsPreviewRequest() {
         GetAppSettingsPreviewRequest req = new GetAppSettingsPreviewRequest();
         GetAppSettingsPreviewResponseBody resp =
-                new GetAppSettingsPreviewResponseBody("", "", null, "", 1);
+                new GetAppSettingsPreviewResponseBody(
+                        "",
+                        "",
+                        null,
+                        "",
+                        new TitleFiled().setSelectionMode(TitleFieldSelectionMode.AUTO),
+                        new NumberPrecision().setDigits(40).setDecimalPlaces(10),
+                        4,
+                        true,
+                        true,
+                        true,
+                        true,
+                        1);
         mockClient.setResponseBody(resp);
 
         assertThat(sut.getAppSettingsPreview(req)).isEqualTo(resp);