wscontrols
ワークシートのコントロール設定
{
"cid": "string", // コントロールID
"wsid": "string", // ワークシートID
"name": "string", // 名称
"type": "int", // コントロール種別。列挙値参照
"attribute": "int", // 属性。1: タイトル
"enumdef": "int", // サブタイプ。列挙値参照
"enumdef2": "int", // サブタイプ。列挙値参照
"dtsrc": "string", // データソース。詳細は仕様参照
"sourcecid": "string", // 参照元コントロールID
"unit": "string", // 単位
"opts": [{
"Key": "string", // ユニークキー値
"Value": "string", // テキスト値
"IsDeleted": "bool", // 削除済みかどうか
"Index": "int", // 並び順
"Color": "string", // カラー値
}], // オプション（配置情報）
"noticeitem": "int", // 通知項目（メンバーコントロール）。0: 通知なし、1: 追加時通知
"userpermission": "int", // 権限（メンバーコントロール）。0: 入力のみ、1: メンバー、2: オーナー
"showcids": ["string"], // 関連ワークシートで表示するフィールドのIDリスト
"unique": "bool", // ユニーク値検証
"covercid": "string", // カバーコントロールID（単行関連）
"defmen": ["string"], // デフォルトアカウントID（配列）、作成者：ユーザー自身
"desc": "string", // フィールド説明
"strdefault": "string", // 汎用文字列フィールド。詳細は仕様参照
"fieldpermission": "string", // 空または"111"。1桁目：閲覧可／不可、2桁目：編集可／不可（読取専用）、3桁目：追加可／不可。1: 可、0: 不可
"adset": [{
"key": "string", // 設定キー。詳細は次項参照
"value": "string" // 設定値。詳細は次項参照
}], // 詳細設定（連携設定用の辞書型<string,string>）
"alias": "string", // エイリアス（API用）
}
コントロール種別（type）
| コントロール | 列挙値 | 説明 |
|---|---|---|
| Text | 1 | テキスト（廃止予定） |
| TextArea | 2 | テキスト |
| MobilePhone | 3 | 電話番号 |
| Landline | 4 | 固定電話 |
| 5 | メールアドレス | |
| Number | 6 | 数値 |
| Certificates | 7 | 身分証番号 |
| Amount | 8 | 金額 |
| Radio | 9 | ラジオボタン |
| CheckBox | 10 | チェックボックス |
| Select | 11 | ドロップダウン |
| Attachment | 14 | ファイル |
| Date | 15 | 日付 |
| DateTime | 16 | 時刻 |
| District | 19/23/24 | 地域/都市 |
| Relation | 21 | 任意リンク |
| SplitLine | 22 | ライン |
| BigAmount | 25 | 大文字（金額） |
| UserSelect | 26 | メンバー選択 |
| DepartmentSelect | 27 | 部署選択 |
| Score | 28 | レベル評価 |
| RelationWorksheet | 29 | 関連データ連携 |
| RelationWSColumn | 30 | 外部参照 |
| WSFormula | 31 | 計算式 |
| FormulaString | 32 | 文字列連結 |
| Increase | 33 | 自動採番 |
| DetailTable | 34 | サブフォーム |
| Cascade | 35 | カスケード選択 |
| CheckRadio | 36 | チェック項目 |
| Summary | 37 | 集計（ロールアップ） |
| FormulaDate | 38 | 計 算式（日付） |
| ScanCode | 39 | スキャンコード |
| Location | 40 | 位置情報 |
| RichText | 41 | リッチテキスト |
| Signature | 42 | サイン |
| OCR | 43 | OCR認識 |
| Role | 44 | アプリロール |
| Embed | 45 | 埋め込み |
| Time | 46 | 時刻 |
| Code | 47 | バーコード |
| OrgRole | 48 | 組織ロール |
| Btn | 49 | クエリボタン |
| Search | 50 | APIクエリ |
データソース説明（dtsrc）
| コントロール | 値の説明 |
|---|---|
| BigAmount | 参照フィールドID |
| RelationWorksheet | 関連ワークシートID |
| RelationWSColumn | 関連コントロールID |
| FormulaDate | 計算式IDまたは終了日フィールドID |
| Select/CheckBox/Radio | オプションセットID |
| Embed | 埋め込みオブジェクトのURLまたはID |
| Code | 参照フィールドID |
EnumDefault 説明（enumdef）
| コントロール/値 | 0 | 1 | 2 | 3 | 4 | 5 |
|---|---|---|---|---|---|---|
| TextArea | デフォルトは複数行 | 複数行 | 1行 | |||
| MobilePhone | 国際番号 | 非国際番号 | ||||
| UserSelect | 単一 | 複数 | ||||
| DepartmentSelect | 単一 | 複数 | ||||
| Score | 5段階評価 | 10段階評価 | ||||
| RelationWorksheet | 関連 | サブフォーム | ||||
| Increase | 元の番号 | 桁数指定形式 | ||||
| Summary | 列挙値参照 | |||||
| FormulaDate | 期間算出 | 日付加算・減算 | 今日までの期間算出 | |||
| Attachment | 新規追加前方 | 既存追加前方 | ||||
| Location | 地図非表示 | 地図表示 | ||||
| Number | 桁区切り表示 | 桁区切り未表示 | ||||
| Select/CheckBox/Radio | スコア有効 | |||||
| OCR | 一般認識 | 身分証認識 | 請求書認識 | |||
| Embed | iframe | チャート | ||||
| Code | バーコード | QRコード |
EnumDefault2 説明（enumdef2）
| コントロール | 値の説明 |
|---|---|
| TextArea | 0: 形式検証なし／1: 形式検証あり |
| Increase | 表示桁数 |
| RelationWorksheet | 作成権限は1桁、関連権限は10桁。1:制限／0:全許可、1:追加不可、10:関連不可、11:追加・関連不可 |
| Summary | 集計結果の列挙値。コントロール種別参照 |
| Radio/Select | 0/空:色付け無効、1:色付け有効 |
| FormulaDate | 1:終了日の年を無視 |
| Attachment | 0:制限なし、1:写真のみ、2:動画のみ、3:写真・動画 |
| Location | 位置範囲。0:制限なし、1:現在位置 |
| Select/CheckBox/Radio | 1:色付け有効 |
| UserSelect | 0:選択範囲制限なし、1:選択範囲制限あり |
| Code | QRコードデータソース。1:内部リンク、2:外部リンク、3:フィールド値 |
StrDefault 説明（strdefault）
| コントロール | 値の説明 |
|---|---|
| TextArea | 1桁目:アルバム選択不可／2桁目:コードスキャン有効。"11":アルバム不可・コードスキャン有効 |
| FormulaDate | 空または0:開始0:00/終了0:00／1:開始0:00/終了24:00 |
| RelationWorksheet | 1桁目:ビュー＆権限検証、2桁目:アルバム不可、3桁目:コードスキャン連 携のみ。"111" |
| Attachment | 1桁目:アルバム選択不可、2桁目:モバイルのみ入力可能。"11" |
| ScanCode | 1桁目:アルバム不可、2桁目:モバイルのみ入力可能。"11" |
| Increase | 新規自動採番 |
| RelationWSColumn | 空または"00":値多重／"10":表示のみ |
| Location | 空または0:地図で位置指定／1:APPで現在位置取得 |
詳細設定 説明（adset）
| key | 値の説明 | コントロール |
|---|---|---|
| filters | 連携フィルター | 関連/ロールアップ |
| defsource | [{"rcid":"関連ワークシート内コントロールID","cid":"コントロールID","staticValue":"string"}] | |
| hasdef | 非表示時のデフォルト値有無。1:有／0:無 | |
| getinput | フォーム入力前取得。1:事前取得／0:未取得 | |
| getsave | 取得後直接フォーム送信。1:直接送信／0:送信なし | |
| direction | オプション配置方法 | 選択 |
| dismanual | 手動入力可否。空又は0:可／1:不可 | |
| scantype | コード種別。空又は0、1:バーコードのみ／2:QRコードのみ | |
| distance | 距離（100/200/500m単位） | 位置情報 |
| checkrange | 検証有 無。空又は0:なし／1:有 | |
| min | 最小値 | |
| max | 最大値 | |
| summaryresult | 集計結果。空又は0:値／1:百分率 | ロールアップ |
| showtype | 表示種別。1:カード型／2:リスト型／3:タイルドロップダウン／4:ツリードロップダウン／空:単一カード型、複数リスト型 | 関連 |
| showtype | 表示種別。5:年／4:年月／3:年月日／2:年月日時間／1:年月日時分／6:年月日時分秒 | 日付 |
| showtype | 表示種別。空又は0:チェックボックス／1:スイッチ／2:はい・いいえ | チェック項目 |
| showtype | 表示種別。空又は0:値／1:百分率／2:進捗 | 数値 |
| showtype | 表示種別。0:ドロップダウン／1:タイル／2:進捗 | 選択 |
| showformat | 表示形式。空又は0:ISO／1:中国／2:米国／3:EU | 日付 |
| allowlink | レコード閲覧可否。空又は0:不可／1:可 | 関連/埋め込み |
| allpath | フルパス表示。空又は0:最終階層表示／1:全階層表示 | カスケード選択 |
| anylevel | 階層選択可否。空又は0:任意階層選択／1:最終階層選択 | カスケード選択 |
| hide | 非表示設定。1:非表示／空又は0:表示 | |
| ddset | ドロップダウンカバー表示設定。1:設定有／空又は0:設定無 | 関連 |
| dateformulatype | 計算方法。1:目標日-今日／2:今日-目標日 | 計算式 |
| hideneg | マイナス値非表示。1:非表示 | 計算式 |
| increase | 自動採番設定 | 自動採番 |
| showxy | 緯度経度表示。1:表示／空又は0:非表示 | 位置情報 |
| allowweek | 曜日組合せ（例：1234567） | 日付 |
| allowtime | 時間帯（例：2:30-12:45） | 日付 |
| timeinterval | 分刻みのインターバル設定 | 日付 |
| checktype | 複数選択ボックス種別。0または空:タイル／1:ドロップダウン | 選択 |
| allowadd | 新規オプション追加可否。0:不可／1:可 | 選択-0/サブフォーム-1 |
| allowcancel | キャンセル可否。0:不可／1:可 | 関連/サブフォーム-1 |
| allowedit | 編集可否。0:不可／1:可 | サブフォーム-1 |
| userrange | 選択可能ユーザー | メンバー選択 |
| regex | 正規表現 {type="左クイックタイプ",regex="string",err="string"} | テキスト |
| ocrmap | OCRフィールドマッピング [{type="",name="",cid="",subId=""}] | OCR認識 |
| allowcountries | 選択可能国 [{iso2="cn",name="中国",dialCode:"+86"}] | 電話番号 |
| commcountries | よく選択される国 [{iso2="cn",name="中国",dialCode:"+86"}] | 電話番号 |
| defaultarea | デフォルトエリアコード | 電話番号 |
| suffix | 計算式サフィックス | 数値種別 |
| prefix | 計算式プレフィックス | 数値種別 |
| searchcontrol | 連携検索フィールド | 関連 |
| searchtype | 0または空:あいまい検索／1:完全一致検索 | 関連 |
| clicksearch | 0または空:直接表示／1:検索後データ表示 | 関連 |
| searchfilters | [{controlId:"string",filterType:int}] | 関連 |
| sorts | [{controlId:"string",isAsc:bool（false:降順、true:昇順）}] | 関連/サブフォーム |
| weekday | 曜日（例：1234567） | 日付計算式 |
| batchcids | [""]一括フィールド追加 | サブフォーム |
| dynamicsrc | ワークシートクエリ初期値 [] | |
| defaultfunc | 関数初期値 | |
| defaulttype | 初期値種別。空または0:基本初期値／1:関数／2:ワークシートクエリ | |
| nullzero | 計算式未入力時0計算。空または0:0換算しない／1:0換算 | 計算式 |
| usertype | ユーザー種別。1:内部メンバー、2:外部ポータル | メンバー選択 |
| watermark | 透かし ["user","time","address","xy"] | ファイル |
| maxcount | 最大数 | ファイル |
| filetype | ファイル種別 {type:int,values:[""]} | ファイル |
| compress | 添付ファイル圧縮。空または0:圧縮無／1:圧縮有 | ファイル |
| width | 幅 | |
| height | 高さ | |
| allowsingle | 単一追加許可 | サブフォーム |
| numshow | 空または0:通常表示／1:百分率表示／2:進捗表示 | 数値種別 |
| thousandth | 空または0:桁区切り表示／1:桁区切り非表示 | 数値種別 |
| itemicon | アイコンスタイル | レベル |
| itemcolor | 色 {type:int(1:固定、2:動的),color:"#000",colors:[{key:"1",value:"#000"}]} | レベル/数値 |
| itemnames | カスタムテキスト [{key:"1",value:"一般"}] | レベル/チェック項目/数値 |
| showvalue | 結果表示。0または空:非表示／1:表示 | レベル |
| numinterval | インターバル | 数値 |
| showinput | 入力ボックス表示。0:非表示／1:表示 | |
| faultrate | 許容誤差 | バーコード |
| analysislink | リンク解析。1:解析／空または0:未解析 | テキスト/連結 |