kintone のフォームフィールドを作成、更新、削除、クエリします。

Select

WHERE 句ではAppId カラムが必須です。connector はKintone API を使用してこのカラムによる結果をフィルタリングします。デフォルトでは、connector はクライアント側でconnector 内で他のフィルタを処理します。

例えば、次のクエリはサーバー側で処理されます。

SELECT * FROM FormFields WHERE AppId = 6
SELECT * FROM FormFields WHERE AppId = 6 AND Lang = 'en'
SELECT * FROM FormFields WHERE AppId = 6 AND IsPreview = false

Insert

INSERT ステートメントでは、AppId、Type、Code およびLabel カラムが必須です。

INSERT INTO FormFields (AppId, Type, Code, Label) VALUES (6, 'SINGLE_LINE_TEXT', 'Text__single_line_CRUD', 'Test')

挿入は、AppId カラムとProperties カラムをjson 集計として指定することでも実行できます。

INSERT INTO FormFields (AppId, Properties) VALUES (6, '{"Text__single_line_TD":{"type":"SINGLE_LINE_TEXT","code":"Text__single_line_TD","label":"Test"}}')

Kintone API はBulk Insert もサポートしています。

INSERT INTO FormFields#TEMP (AppId, Type, Code, Label) VALUES (6, 'SINGLE_LINE_TEXT', 'Text__single_line_temp1', 'Label1')
INSERT INTO FormFields#TEMP (AppId, Type, Code, Label) VALUES (6, 'SINGLE_LINE_TEXT', 'Text__single_line_temp2', 'Label2')
INSERT INTO FormFields (AppId, Type, Code, Label) SELECT AppId, Type, Code, Label FROM FormFields#TEMP

Update

用途に応じて、FormFields を更新する方法は2通りあります。

方法1：Properties カラムを使用する更新。複数のフォームフィールドの詳細を一度に更新したい場合は、Properties カラムを使用できます。このカラムには、code、label、type などのフィールド属性を含むJSON オブジェクトを指定します。この方法では、WHERE 句にAppId カラムを含める必要があります。

UPDATE FormFields SET Properties = '{"Text__single_line_TT":{"code":"Text__single_line_PT","label":"text","type":"SINGLE_LINE_TEXT"}}' WHERE AppId = 6

方法2：個別のカラムを使用する更新。label やcode などのフィールドを、Properties カラムを使わずに個別に直接更新することもできます。ただし、この方法では1項目ずつしか更新できません。この方法では、WHERE 句にAppId カラムとCode カラムの両方を含める必要があります。

UPDATE FormFields SET label='text', code='Item_update', type='SINGLE_LINE_TEXT' where appId=444 and code='Item';

Delete

削除したいCode カラムの値をカンマ区切りで指定する必要があります。FormFields を削除するには、AppId カラムが必須です。

DELETE FROM FormFields WHERE Code = 'Text__single_line_CRUD, Text__single_line_TD' AND AppId = 6

Columns

Name	Type	ReadOnly	References	Description
AppId [KEY]	Integer	False		kintone アプリケーションのアプリID。
Code [KEY]	String	False		フィールドコード。
Enabled	String	True		機能が有効かどうか。
Label	String	False		フィールド名。
NoLabel	Boolean	False		フィールド名を非表示にするかどうか。
Type	String	False		フィールドの種類。
Required	String	False		入力が必須かどうか。
Unique	String	False		重複を禁止するかどうか。
MaxValue	String	False		フィールドの最大値。
MinValue	String	False		フィールドの最小値。
MaxLength	String	False		フィールドの最大文字数。
MinLength	String	False		フィールドの最小文字数。
DefaultValue	String	False		初期値。複数の初期値を設定できるフィールドでは、配列が返ります。
DefaultNowValue	String	False		レコード登録時の日時を初期値にするかどうか。
Options	String	False		フィールドの選択肢のデータを含むオブジェクト。
Align	String	False		選択肢の並び。
Expression	String	False		自動計算式。
HideExpression	String	False		計算フィールドの計算式を非表示にするかどうか。
Digit	String	False		数値の桁区切りを表示するかどうか。
ThumbnailSize	String	False		画像のサムネイルの大きさ（ピクセル単位）。
Protocol	String	False		フィールドのリンクの種類。
Format	String	False		計算フィールドの表示形式。
DisplayScale	String	False		小数点以下の表示桁数。
Unit	String	False		単位記号。
UnitPosition	String	False		単位記号の表示位置。
Entities	String	False		選択肢のユーザーの一覧の配列。
ReferenceTable	String	False		関連レコード一覧フィールドの設定を含むオブジェクト。
LookUp	String	False		ルックアップフィールドの設定を含むオブジェクト。
OpenGroup	String	False		グループ内のフィールドを表示するかどうか。
Fields	String	False		テーブル内のフィールドのデータを含むオブジェクト。オブジェクトの構造は、properties と同じです。
Revision	String	True		アプリの設定のリビジョン番号。

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Name	Type	Description
Lang	String	取得する名称の言語。
IsPreview	Boolean	False に設定することで、運用環境のアプリのフォームフィールドの詳細を取得することができます。デフォルト値はtrue です。
Properties	String	Insert またはUpdate の実行にのみ使用されます。