kintone integration (2) : Register a record

Learn how to create a mobile app in Unifinity that works with kintone.

In this article, we will show you how to register records in kintone using kintone's REST API.
In my previous article.User Authenticationwill be required, so please check accordingly.

You can download a sample project of the Unifinity kintone application used in the explanation below. We hope you will take advantage of it.
kintone: Record Registration Application
Unifinity: kintone record registration application

Overview of the application to be created

Create a mobile app in kintone that registers records.

Setting up kintone

In this case, we will prepare an application to enter the following items: date, time, string, numerical value, radio button, check box, and drop-down, and register them from the mobile application.

Other commonly used attachments, lookups, tables, and user selections will be presented in another article.

In order to link, the kintone subdomain name, application ID, and field code for each field are required.
The subdomain name and app ID can be found in the following part of the URL when connecting to the app.

The field code for each field can be checked from the application's settings screen.

Unifinity collaboration settings

This section explains screen creation and process creation for each field in KINTONE.
(In this case, input data is not saved in the DB, but it can be saved.)

For basic Unifinity operation, click here.Tutorial Videosfor more information.

0. Preparation

In my previous article.User Authenticationin the application.

Also, set the global variable for the property to the subdomain name identified in the kintone configuration.

[Date]
1. screen creation

(1) Place a text box for entering the date and time.
Also, for text boxes, set the input to "Date/Time" in the object's behavior settings tab.

(2) Set up a button to send the entered information to kintone.

Screen creation is now complete (there are some areas to be updated after creating the process in section 2.)

2. process creation

Create the action when the button created on the screen is pressed.
For each item, we will explain the process one by one.

(1) Subdomain name calling

(2) Calling user authentication information

(3) Format data into a format for sending to kintone

When registering data in kintone, the format specified by kintone (e.g.This time, here it is.to format the data.
It will need to be formatted into the following format, and we will show you how to do this below.

#6	."Control/Content AcquisitionSelect what is entered on the screen using the
#7	."String Functions/FormatsConvert the contents of #6 to the format "YYYYY-MM-DDThh:mm:ss+09:00" to register the date and time in Kintone using "#6. This is the "field value. The list of formats for registering in kintone isthis way (direction close to the speaker or towards the speaker)for more information.
#8	."Dictionary/CreationThe "I" will be shaped using the "I". "value": To create the format "(field value)", enter value for the key and select the contents of #7 for the value.
#9	Next, create the format "(field code)": {#8}. Enter the "field code" that you confirmed in the kintone setup as the key and select the content of #8 as the value.
#10	Finally, create the format {"app": "(ID of app)", "record": {#9}}. Enter app as the key and the contents of the app ID as the value, then press Add Element and enter record as the key and #9 as the value.
#11	Finally, the well-formed elements are processed into JSON format. ."Dictionary/JSON ExportUse "#10" to select the contents of #10.

(4) Send data to kintone

When registering data in kintone, the URI (URI) specified by kintone (see below) must be used.This time, here it is.to send the data to the (M).

3. stringing

Then, we ask you to link the screen to the process, and you are done.

This is the basic creation process for registering records in KINTONE.

The process for updating other fields is as follows
(Attachments, lookups, tables, and user selection will be presented in a separate article. )

[String (one line), numeric]

String (one line) and numeric registrations are listed together because they are almost identical.

1. screen creation

(1) Place text boxes for text and numerical input.
Also, for strings, please check "All" for input content in the object's behavior settings tab, and for numbers, please check "Numeric" & "Pop-up Input" for input content in the object's behavior settings tab.

(2) Set up a button to send the entered information to kintone.

Screen creation is now complete (there are areas to be updated after process creation in section 2).

2. process creation

Create the action when the button created on the screen is pressed.
For each item, we will explain the process one by one.

(1) Subdomain name calling
　　The same as the ➜ date and time.

(2) Calling user authentication information
　　The same as the ➜ date and time.

(3) Format data into a format for sending to kintone

(4) Send data to kintone
　　The same as the ➜ date and time.

3. stringing

Then, we ask you to link the screen to the process, and you are done.

[Radio button]

1. screen creation

(1) Place the same number of radio buttons as set in kintone.
For the radio buttons, set the radio group in the object's behavior settings tab to the name common to the two buttons (kintone in this case) and also set the ON value to the name of the item to be entered in kintone (sample1 and sample2 in this case).

(2) Set up a button to send the entered information to kintone.

The screen creation is now complete (there are some areas to be updated after creating the DB in section 2 and the process in section 3).

2. creation of DB

(1) Create a DB in Unifinity to store the values selected by the radio buttons.
After creating the data file, enter an easy-to-understand name for the item name and physical item name, and check the Initialize at startup checkbox.

DB creation is now complete.

3. process creation

Create the action when the button created on the screen is pressed.
For each item, we will explain the process one by one.

(1) Subdomain name calling
　　The same as the ➜ date and time.

(2) Calling user authentication information
　　The same as the ➜ date and time.

(3) Format data into a format for sending to kintone

(4) Send data to kintone
　　The same as the ➜ date and time.

4. stringing

Two things need to be implemented: linking screens to the DB and linking screens to processing.

(1) Linking screens to DB
Link the screen and DB to store the selections made with the radio buttons in the DB created in 2.
First, on the screen where the radio buttons are placed, select nothing (or click on the black area outside the screen) and select the DB created in 2. from the data table name.

After making your selection, select each radio button, check the form for the data content, and select the appropriate field in the DB created in 2. for the field name.

(2) Linking screens and processes
　　The same as the ➜ date and time.

That is all.

[Check box]

We will introduce the checkboxes as those to be used when multiple selections are desired.

1. screen creation

(1) Place the same number of checkboxes as those set up in kintone.
For checkboxes, set the ON value in the object's behavior settings tab to the name of the item to be entered in kintone (in this case, sample1 and sample2).

(2) Set up a button to send the entered information to kintone.

Screen creation is now complete (there are areas to be updated after process creation in section 2).

2. process creation

Create the action when the button created on the screen is pressed.
For each item, we will explain the process one by one.

(1) Subdomain name calling
　　The same as the ➜ date and time.

(2) Calling user authentication information
　　The same as the ➜ date and time.

(3) Format data into a format for sending to kintone

(4) Send data to kintone
　　The same as the ➜ date and time.

3. stringing

　　The same as the ➜ date and time.

Then, we ask you to link the screen to the process, and you are done.

[Drop-down]

1. screen creation

(1) Place a combo box with a drop-down selection.
Also, to set the combo box choices, enter the choices you set in the drop-down in kintone in the value entry section in the list tab of the data.

(2) Set up a button to send the entered information to kintone.

Screen creation is now complete (there are areas to be updated after process creation in section 2).

2. process creation

Create the action when the button created on the screen is pressed.
For each item, we will explain the process one by one.

(1) Subdomain name calling
　　The same as the ➜ date and time.

(2) Calling user authentication information
　　The same as the ➜ date and time.

(3) Format data into a format for sending to kintone

(4) Send data to kintone
　　The same as the ➜ date and time.

3. stringing

Then, we ask you to link the screen to the process, and you are done.

When sending multiple items

If you wish to send multiple items, you can register them by setting multiple field codes as shown below when you create the dictionary that will be the content of the record.
Please check the details here from the sample application.

In the next issue, we will show you how to create an application that uploads images and other files to a KINTONE record.

The kintone application and sample projects used in this explanation can be downloaded from the following links.
kintone: Record Registration Application
Unifinity: kintone record registration application