更改應用的操作設置
如果您的應用中存在同名操作,或者更新后的操作名稱與其他操作名稱重複,則在運行此 API 時將收到錯誤。
此 API 在測試環境中修改應用。
如果要將更改傳播到生產環境,請運行此 API,然後
運行將應用設置傳播到生產環境的 API 。
URL
- 常規應用
- https://sample.cybozu.com/k/v1/preview/app/actions.json
- 建立訪客空間
- https://sample.cybozu.com/k/guest/
GUEST_SPACE_ID
/v1/preview/app/actions.json
HTTP 方法
PUT
所需許可權
- 應用程式管理
請求
參數
參數名稱 | 型 | 必須 | 說明 |
---|---|---|---|
app | 數位或字串 | 必須 | 應用ID |
actions | 物件 | 必須 | 動作的設定 添加或更新操作配置時,請在 中 actions 指定現有操作的配置。如果未指定,則將刪除該操作的配置。 |
actions.操作名 |
物件 | 自選 | 動作的設定
|
actions.操作名 .name |
字串 | 條件必填項 | 動作名稱 指定 1 到 32 個字元。 如果要添加操作,請指定 操作名 與 相同的值,這是必需的。如果要更改現有操作的名稱,請指定新操作的名稱。 如果省略,則不會更改。 |
actions.操作名 .index |
數位或字串 | 條件必填項 | 按其顯示順序執行的操作 按值升序排序。 操作名 如果指定,則為必填項。 |
actions.操作名 .destApp |
物件 | 條件必填項 | 目標應用程式 如果要添加操作,則為必填項。 如果省略,則不會更改。 |
actions.操作名 .destApp.app |
數位或字串 | 條件必填項 | 目標應用的應用IDdestApp.app 或 destApp.code 為必填項。如果兩者都指定 destApp.code ,則設定值 。 |
actions.操作名 .destApp.code |
字串 | 條件必填項 | 目標應用的應用代碼destApp.app 或 destApp.code 為必填項。如果兩者都指定 destApp.code ,則設定值 。如果指定了"null"或空字元,則假定它未指定。 |
actions.操作名 .mappings |
陣列 | 條件必填項 | 相關欄位: 如果指定「添加」或 destApp 「添加操作」 則為必填項。如果省略,則不會更新。 如果指定了空陣列,則將其設置為無欄位關聯。 |
actions.操作名 .mappings[].srcType |
字串 | 條件必填項 | 源類型 指定以下值之一:
mappings 如果指定,則為必填項。 |
actions.操作名 .mappings[].srcField |
字串 | 條件必填項 | 源欄位的域代碼mappings[].srcType 如果為"FIELD",則為必填項。 |
actions.操作名 .mappings[]destField |
字串 | 條件必填項 | 目標欄位的欄位代碼mappings 如果指定,則為必填項。 |
actions.操作名 .entities |
陣列(字串) | 條件必填項 | 使用該操作的成員清單 如果要添加新操作,則為必填項。 如果省略,則不會更新。 如果指定了空陣列,則不會設置使用該操作的成員。 |
actions.操作名 .entities[].type |
字串 | 條件必填項 | 使用該操作的成員類型 指定以下值之一:
entities 如果指定,則為必填項。 |
actions.操作名 .entities[].code |
字串 | 條件必填項 | 使用操作的成員的代碼entity.type 這取決於的值。
entities 如果指定,則為必填項。 |
revision | 數位或字串 | 自選 | 預期修訂號 如果與實際修訂號不匹配,則會發生錯誤,並且不會更改設置。 如果指定值"-1"或未指定值,則不會驗證修訂號。 |
示例請求
URL
https://sample.cybozu.com/k/v1/preview/app/actions.json
頁眉
|
|
關於請求頭,請參見 kintone REST API的通用規範 。
身體
|
|
回應
財產
屬性名稱 | 型 | 說明 |
---|---|---|
actions | 物件 | 建立動作 |
actions.操作名 .id |
字串 | 操作ID |
revision | 字串 | 更新後應用設置的修訂號 |
示例回應
|
|
示例代碼
使用 curl 的請求
|
|
發送kintone REST API請求 使用API 發送請求
|
|