FormFields
kintone のフォームフィールドを作成、更新、削除、クエリします。
Select
WHERE 句ではAppId カラムが必須です。本製品 はKintone API を使用してこのカラムによる結果をフィルタリングします。デフォルトでは、本製品 はクライアント側で本製品 内で他のフィルタを処理します。
例えば、次のクエリはサーバー側で処理されます。
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 を更新するには、Properties を集計として指定します。FormFields を更新するには、AppId カラムが必須です。
UPDATE FormFields SET Properties = '{"Text__single_line_TT":{"code":"Text__single_line_PT","label":"text","type":"SINGLE_LINE_TEXT"}}' WHERE AppId = 6
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 の実行にのみ使用されます。 |