Cognito 表單
Cognito Forms 可讓您輕鬆建立功能強大的線上表單，例如調查、訂單、註冊表等。 免費。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 標準 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 標準 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | Cognito 表單支援 |
| URL | https://www.cognitoforms.com/support |
| support@cognitoforms.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Cognito 表單 |
| 網站 | https://www.cognitoforms.com |
| 隱私權原則 | https://www.cognitoforms.com/legal/privacy |
| 類別 | 生產力;通敵 |
Cognito 表單
Cognito Forms 可讓您輕鬆建立功能強大的線上表單，例如調查、訂單、註冊表等。 免費。 請參閱我們的 支援檔 ，或 連絡我們以 取得公用 Power Automate 連接器的協助。
發行商： Cognito Forms
先決條件
需要付費訂閱。
支援的作業
觸發器
觸發器將在訂閱事件發生後不久傳送。
新條目
當為指定的表單建立新項目時，將觸發此操作。 輸出將是輸入資料，包括檔案資料以及檔案、簽名和輸入文件的臨時連結。
參數：
-
form：將訂閱新項目事件的表單名稱。
更新項目
當更新指定表單的條目時，將觸發此操作。 輸出將是輸入資料，包括檔案資料以及檔案、簽名和輸入文件的臨時連結。
參數：
-
form：將訂閱更新項目事件的表單名稱。
條目已刪除
當刪除指定表單的條目時，將觸發此操作。 輸出將是條目數據，不包括鏈接。
參數：
-
form：將訂閱已刪除項目事件的表單名稱。
行動
建立項目
此動作會為指定的表單建立專案。 此動作將包含每個輸入欄位的可設定屬性，但不包括某些欄位類型。 輸出將是條目資料。
參數：
-
form：內部表單名稱或 ID
編輯項目
此動作會更新指定表單的現有項目。 此動作將包含每個輸入欄位的可設定屬性，但不包括某些欄位類型。 如果項目包含已付款訂單或entryId不存在，則此動作將會失敗。 輸出將是更新的條目資料。
參數：
-
form：內部表單名稱或 ID -
entryId：要更新的項目的項目編號或項目 ID
SetForm可用性
此動作將設定表單的可用性限制設定。
and startend 參數應該為空白，才能讓表單隨時可用。
輸出將是更新的可用性設定。
參數：
-
form：內部表單名稱或 ID -
start：表單應可供使用的日期時間。 -
end：表單不應再可用的日期時間。 -
message：應向在可用期間之外嘗試存取表單的使用者顯示的訊息。
GetFile
此動作會從儲存體擷取檔案。 輸出將是一個物件，其中包含檔案資料、中繼資料和檔案的臨時連結。
參數：
-
id：要擷取之檔案的檔案 ID。
取得文件
此動作將使用指定的表單、項目和範本產生和擷取項目文件。 輸出將是一個對象，其中包含文件的文件數據、元數據和文檔的臨時鏈接。
參數：
-
form：內部表單名稱或 ID -
entry：應為其產生文件之項目的項目 ID 或項目編號 -
templateNumber：應用於產生輸入文件的範本編號
取得入口
此動作會取得指定表單的現有專案。 如果項目不存在，此動作將會失敗。 輸出將是條目資料。
參數：
-
form：內部表單名稱或 ID -
entryId：要擷取的項目的項目編號或項目 ID
刪除項目
此動作將刪除指定表單的現有項目。 如果項目不存在，此動作將會失敗。 不會有輸出。
參數：
-
form：內部表單名稱或 ID -
entryId：要刪除的項目的項目編號或項目 ID
私人運營
這些作業是公用觸發器和動作的啟用器。
取得表格
此作業會傳回表單清單，做為包含 Id、 InternalName和 Name的物件。
當用於動作和觸發器的參數時 form ，使用者應該會看到 Name，但應該將 傳送 InternalName 至 API。
GetFormSchema
此作業會傳回指定表單的結構描述。
對於排除唯讀屬性的動作，參數 input 應該為 true，對於觸發程序包含所有屬性，參數應該為 false。
includeLinks除了 EntryDeleted 之外，所有動作和觸發程式的參數都應該為 true。
參數：
-
form：內部表單名稱或 ID -
input：布林值，指出傳回的結構描述是否應該排除無法設定的屬性。 False 預設為 False。 -
includeLinks：布林值，指出檔案、簽名和文件的連結屬性是否應包含在結構描述中。 預設為 True。
取消訂閱Webhook
此作業會取消訂閱指定的 Webhook。 傳送所有目前排入佇列的事件之後，Webhook 將不再接收任何事件。
參數：
-
id：應取消訂閱的 Webhook 的 ID。 -
module：Webhook 的模組。 這應該設定為「表單」，因為此連接器僅支援該模組。
取得憑證
組織的擁有者必須登入 Cognito Forms 並授權連線。
已知問題
None
部署指示
Cognito Forms需要有效的 Client id 和 Client secret 才能建立聯結器。
這些屬性可以在金鑰保存庫中找到，而且只能在自訂連接器的驗證設定中設定。
請執行：
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json登入 PowerAutomate
導覽至新的連接器
在「安全性」下，更新
Client id和Client secret更新連接器
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 刪除項目 |
刪除項目。 |
| 取得參賽資格 |
取得專案。 |
| 取得文件 |
取得文件 |
| 取得檔案 |
依 ID 取得檔案 |
| 建立項目 |
建立新項目。 |
| 更新項目 |
更新項目。 |
| 設定表單可用性 |
設定表單的可用性。 |
刪除項目
刪除項目。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Form
|
form | True | string |
表單的名稱 |
|
項目標識碼
|
entryId | True | string |
項目標識符 |
傳回
取得參賽資格
取得專案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Form
|
form | True | string |
表單的名稱 |
|
項目標識碼
|
entryId | True | string |
項目標識符 |
傳回
取得文件
取得文件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Form
|
form | True | string |
表單的名稱 |
|
項目標識碼
|
entry | True | string |
項目標識符 |
|
範本編號
|
templateNumber | True | integer |
範本編號 |
傳回
包含檔案資料和中繼資料的檔案參考
- 身體
- FileDataRef
取得檔案
依 ID 取得檔案
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔案標識碼
|
id | True | string |
檔案的唯一識別碼 |
傳回
包含檔案資料和中繼資料的檔案參考
- 身體
- FileDataRef
建立項目
建立新項目。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Form
|
form | True | string |
表單的名稱 |
|
Entry
|
entry | True | dynamic |
要為表單建立的項目 |
傳回
更新項目
更新項目。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Form
|
form | True | string |
表單的名稱 |
|
項目標識碼
|
entryId | True | string |
項目標識符 |
|
Entry
|
entry | True | dynamic |
更新後的條目數據 |
傳回
設定表單可用性
設定表單的可用性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Form
|
form | True | string |
表單的名稱 |
|
可用性開始
|
start | date-time |
可用性開始日期 |
|
|
可用性結束
|
end | date-time |
可用性結束日期 |
|
|
無法使用訊息
|
message | string |
無法使用訊息 |
傳回
表單可用性資訊，例如開始/結束可用性和無法使用訊息。
觸發程序
| 刪除項目時 |
當有人刪除項目時觸發。 |
| 建立新項目時 |
當有人建立新項目時觸發。 |
| 更新項目時 |
當有人更新項目時觸發。 |
刪除項目時
當有人刪除項目時觸發。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Form
|
publisher | True | string |
表單的名稱 |
傳回
建立新項目時
當有人建立新項目時觸發。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Form
|
publisher | True | string |
表單的名稱 |
傳回
更新項目時
當有人更新項目時觸發。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Form
|
publisher | True | string |
表單的名稱 |
傳回
定義
檔案資料參考
包含檔案資料和中繼資料的檔案參考
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
檔案標識碼
|
Id | string |
檔案的唯一 ID。 |
|
檔案名稱
|
Name | string |
檔案名稱 |
|
檔案內容類型
|
ContentType | string |
檔案的內容類型。 |
|
檔案大小
|
Size | integer |
檔案的大小。 |
|
檔案網址
|
File | string |
檔案的 URL。 |
|
檔案內容
|
Content | byte |
檔案內容 |
表格可用性
表單可用性資訊，例如開始/結束可用性和無法使用訊息。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
表單可用性開始
|
availabilityStart | date-time |
表單可用性開始 |
|
表單可用性結束
|
availabilityEnd | date-time |
表單可用性結束 |
|
無法使用訊息
|
notAvailableMessage | string |
無法使用訊息 |