在「連接器」中,事件發生後執行的步驟稱為「動作(Action)」。
kintone連接器動作清單
以下列出可在kintone連接器中使用的動作。
kintone動作遵從kintone API規範。
因此,各動作的限制事項等詳細資訊,請參閱參考API說明的連結。
| 動作名稱 | 詳細說明 | 設定內容 | 補充資料 | 參考API |
|---|---|---|---|---|
| 新增記錄 | 在設定了驗證連接器的應用程式裡新增記錄。 | 在「基本設定」畫面中將顯示所有應用程式表單中設定的項目。設定任何值。 | 若包含附件,需指定在「上傳附件」動作中取得的fileKey。 |
新增1筆記錄 |
| 取得一筆記錄 | 從認證連接器中設定的應用程式取得單筆紀錄。 | 在「基本設置」畫面中,指定要取得的紀錄 ID。 | - | 獲取1筆記錄 |
| 上傳附件 | 將在流程中取得的檔案,上傳至Cybozu的暫存區域。 | 在「基本設置」畫面,設定要上傳的檔案。 | 需事先在流程中下載附件。 上傳後取得的 filekey可在「新增紀錄」或「更新紀錄」動作中使用。 |
上傳檔案 |
| 下載附件 | 下載認證連接器中設定的應用程式紀錄的附件。 | 在「基本設定」中,指定要下載的檔案 key。 | 需指定於「取得1筆記錄」動作或「取得記錄清單」動作中取得的附件欄位的fileKey。與「上傳附件」動作取得的 fileKey不同。 |
下載檔案 |
| 更新記錄 | 更新設定了驗證連接器的應用程式的一筆記錄。 | 如果在[基本設定]的「更新類型」中指定了「禁止重複欄位代碼」,則會顯示設為「值為唯一」的欄位清單。 可複選要更新的欄位。 在[更新內容]中,設定項目里顯示在[選擇更新的欄位]中選擇的欄位。 |
在更新內容中,若輸入項為空,資料將被更新為空值。 | 更新1筆記錄 |
| 取得記錄清單 | 從設置了驗證連接器的應用程式中獲取多筆記錄。 | 在「基本設定」的「取得方法」可選擇「輸入查詢」或「從清單選擇」。 若選擇「輸入查詢」,可設定條件式以篩選想取得的紀錄。 若選擇「從清單選擇」,可從應用程式中儲存的清單中挑選。 |
有關查詢的寫法,請參考
如何編寫查詢
不過,目前無法取得「Lookup欄位」和「表格中包含的欄位」。 |
獲取多筆記錄 |
| 填寫記錄回覆 | 在指定的紀錄中填寫回覆。 | 在基本設定中,指定「紀錄 ID」與「留言內容」。 並可設定提及對象。 |
- | 填寫記錄回覆 |
| 更新記錄的表格 | 更新設定了驗證連接器的應用程式的表格欄位。 | 如果在[基本設定]的「更新類型」中指定了「禁止重複欄位代碼」,則會顯示設為「值為唯一」的欄位清單。 | 更新來源資料為流程中取得的表格資料。 更新時會全部覆寫。 |
更新1筆記錄 |
| 大量更新記錄 | 大量更新設定了驗證連接器的應用程式的記錄。 | 如果在[基本設定]的「更新類型」中指定了「禁止重複欄位代碼」,則會顯示設為「值為唯一」的欄位清單。 | 更新來源資料為流程中取得的表格資料。 若設定為「UPSERT 模式」無效或未指定,且表資料中包含新紀錄,處理將發生錯誤。 |
更新多條記錄 |
| 大量新增記錄 | 在設定了驗證連接器設定的應用程式中大量新增記錄。 | [新增內容]中會顯示對應的欄位,請設定要新增的內容。 | 新增資料為流程中取得的表格資料。 | 添加多條記錄 |
| 大量刪除記錄 | 大量刪除設定了驗證連接器的應用程式的記錄。 | 在「選取記錄ID行」中指定記錄編號的欄位代碼。 | 刪除資料為流程中取得的表格資料。 | 刪除多條記錄 |
| 取得紀錄清单(擴充版) | 從設置了驗證連接器的應用程式中獲取多筆記錄。 用於想要獲取超過10,000條記錄時。 |
與「取得記錄清單」動作的設定相同。 | - | 獲取多筆記錄 |
一般連接器的動作清單
提供可用於一般連接器的動作清單。
| 動作名稱 | 詳細說明 | 設定內容 | 補充資料 |
|---|---|---|---|
| 重複 | 建立重複執行區塊,重複執行區塊內設定的動作。 | 在「基本設定」中選擇重複目標(陣列或表資料)。 | 可設定是否在錯誤時跳過重複。 |
| 字串陣列連接 | 將字串陣列連接起來。 | 在「基本設定」中,指定要連接的陣列與分隔符號(,或空白)。 |
您可以指定任何分隔符號。 |
| 變更日期和時間格式 | 將日期和時間格式轉換為指定的格式。 | 在基本設定中,將UNIX時間轉換為指定的格式。 | - |
| 將字串輸出為文字檔案 | 將指定的字串輸出為文字檔案。 | 在「檔案」里指定輸出檔案名稱與內容。 | - |
| 指定等待時間 | 等待指定的秒數後再繼續執行。 | 在「基本設定」中,設定等待時間(以秒為單位)。 | - |
| 將JSON字串轉換為值 | 將 JSON 格式字串轉換為可操作的物件。 | 在[基本設定]下,指定JSON字串。 | - |
| 取得陣列或表資料件數 | 取得陣列或表資料的元素數量。 | 指定目標資料。 | - |
| 轉換電話號碼格式 | 將電話號碼轉換為指定的格式。 | 在[基本設定]下,指定目標電話號碼與轉換規則。 | 可設定是否加上國碼或連字號。 |
| 刪除文字檔中的指定行 | 刪除文字檔或 CSV 的特定行。 | 在「基本設定」中,指定要刪除的目標檔案和行號。 | 如果刪除的檔案名稱為空白,則會使用原文字檔案名稱。 |
| 執行欄位函數 | 對字串或數值欄位進行函數處理或轉換。 | 在「基本設定」中,指定欄位與使用的函數。 | 點擊運算式欄位時,資料選用區會顯示輸出資料清單和函數標籤。在「函數」標籤上點擊函數名稱,即可自動將函數插入運算式欄位中。 |
表格資料連接器動作清單
可在表資料連接器中使用的動作如下:
不僅限於表資料連接器,在連接器中將資料作為表資料處理時,最多可支援5000行。
| 動作名稱 | 詳細說明 | 設定內容 | 補充資料 |
|---|---|---|---|
| 取得單一行 | 依條件從表資料中取得單一行。 | 在「基本設定」中,選擇表資料。 在[篩選器]底下,設定搜尋條件。 |
必須至少對一行設置搜尋條件。 若設定多個條件,將以 AND 條件處理。 根據原始表格資料,行可能為3行或更多。 無法在搜尋條件中指定數值類型的欄。 |
| 取得多行 | 依條件從表資料中取得多行。 | 在「基本設定」中,選擇表資料。 在[搜尋條件]設定搜尋條件。 |
同上。 |
| 檢查資料是否存在 | 檢查表資料是否存在並以布林值回傳。 | 在「基本設定」中,選取您要檢查是否存在的表資料,然後選取[如果有資料,則傳回true]或[如果沒有資料,則傳回true]條件。 | - |
| 加工表資料 | 對表資料進行欄位加工、篩選、排序。 | 在「基本設定」中,選擇要加工的表格資料,並設定處理後表格資料名稱。 在「行的加工設定」中,可以新增行的設定。 在[列擷取設定]中,可對在[行的加工設定]中新增的行設定篩選條件,以從「目標行」中擷取符合「比較方法」和「比較值」的列。 在「列的順序設定」中,可以變更在「行的加工設定」中新增行的排序順序。 |
在「行的加工設定」中,行的設定上限為20行。 如果您在[列擷取設定]中設定了多行,則將是AND條件。 如果您在[列的順序設定]中設定多行,以頂部的設置為優先 |
| 表資料比較 | 比較兩組表資料並輸出結果。 | 在「基本設定」中,選取要比較的表格資料和要比較的方式,然後設定要建立的表格資料名稱。 在「比較行設定」中,您可以新增比較行的設定。 |
- |
| 表資料的彙總/彙總 | 依基準欄位彙總資料並輸出結果。 | 在「基本設定」中,選取表格資料,並設定要建立之表格資料名稱。 在「基準行的設定」中,可以新增基準行的設定。 在[彙總/彙總行的設定]中,可以新增彙總/彙總行的設定。 |
在[基準行的設定]中,可以選擇多個項目。 |
| 合併表資料 | 合併兩組表資料並輸出結果。 | 在「基本設定」中,選取基準表格資料以及合併方式,然後為要建立的表格資料設定任何值。 在[合併Key行的設定]中,為要合併的表資料設置任意行名稱。 |
- |
流程控制連接器的動作清單
以下是流程控制連接器的動作清單。
| 動作名稱 | 詳細說明 | 設定內容 | 補充資料 |
|---|---|---|---|
| 中斷判定 | 若條件符合,則終止流程執行。 | 設定為true或false。 |
true:流程在此步驟終止執行。false:將繼續執行流程。 |
| 條件式分支 | 如果符合條件,則分支執行。 | 設定為true或false。 |
true:執行條件區塊中的處理。false:不進入條件分支區塊,執行後續處理。 「區塊」是當條件為 true時才執行 |