FormFields
アプリのフィールドを作成、更新、削除、およびクエリでき、アプリのデータモデルをプログラムで管理できるようにします。
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 を更新する方法は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 |
URLやリンクフィールドを開くときの動作を定義するリンクタイプ設定。 | |
| 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 |
フォームフィールド設定を動作テスト環境から取得するか（'true'）、運用環境から取得するか（'false'）を示します。デフォルト値は'true'です。 |
| Properties | String |
挿入または更新実行時に変更されたフィールド定義を提供するためにのみ使用される値。 |