Resco 雲
Resco Cloud 是一種一體化業務解決方案,具有高度可定制、安全、功能豐富且 100% 離線就緒。
此連接器適用於以下產品和區域:
| 服務 | 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) |
| 連絡人 | |
|---|---|
| 名稱 | Resco 專家隨時準備傾聽並提供幫助 |
| URL | https://www.resco.net/contact-support/ |
| mobilecrm@resco.net |
| 連接器中繼資料 | |
|---|---|
| Publisher | 雷斯科 |
| 網站 | https://www.resco.net/resco-cloud/ |
| 隱私策略 | https://www.resco.net/privacy-notice/ |
| 類別 | 銷售和客戶關係管理;生產力 |
Resco Cloud 為您提供高度可定制、安全、功能豐富且 100% 離線的一體化業務解決方案。 此連接器可讓您順暢地建立、讀取、更新和刪除記錄的作業。
先決條件
若要使用此聯結器,您將需要下列專案:
- Resco Cloud 的組織或 Resco 的任何附屬產品。
- 您可以在 此處註冊 30 天免費試用。
- 具有綱目存取權限或系統管理員權限的使用者帳戶。
如何取得認證
此連接器使用 Basic 驗證。 建立新的連接器 (在 Power Apps/Logic Apps 中) 時,您將需要提供登入認證。
您也必須選取要與此連接器搭配使用的伺服器,以及您在註冊期間指定的組織名稱。
開始使用連接器
只需將任何 Resco Cloud 連接器步驟新增至您的流程,即可開始存取/變更 Resco Cloud 組織中的資料。 此連接器可讓您執行基本資料作業,例如讀取/建立/更新/刪除。
已知問題與限制
Paging
此 List records 動作最多會傳回 1000 筆記錄。 如果您想獲得更多記錄,則必須使用 Skip token 輸入參數。 不會直接傳回, Skip token 而是 Next Link 傳回 Skip token 包含 also 的 。
若要解決 Skip token 下一個 List records 動作呼叫,您可以在步驟中使用 Set variable 運算式,如下所示:
{
"inputs": {
"name": "skipToken",
"value": "@{if(empty(outputs('List_records')?['body/@odata.nextLink']),null,decodeUriComponent(substring(outputs('List_records')?['body/@odata.nextLink'],add(indexOf(outputs('List_records')?['body/@odata.nextLink'], '$skipToken='),11))))}"
}
}
觸發器
Resco Cloud 連接器支援建立、更新和刪除作業的觸發器。
如果有進階需求,可以使用伺服器進程事件並叫用「收到 HTTP 要求時」提供的 HTTP 要求。 只需建立新的自動化雲端流程,命名,然後按一下略過即可建立空流程。 搜尋「請求」連接器並新增「收到 HTTP 請求時」觸發器。 設定「請求本文 JSON 結構描述」以接受參數 id :
{
"type": "object",
"properties": {
"id": {
"type": "string"
}
}
}
在「顯示進階選項」下,將方法設定為 POST。 儲存流程以產生「HTTP POST URL」。
現在,您必須建立程序,才能在流程中叫用觸發器。 登入您的 Resco Cloud 伺服器,啟動 Admin Console,然後從功能表中選取 [程序]。 單擊“新建”,輸入新流程的名稱,選擇所需的實體(例如帳戶)和所需的事件(例如創建記錄)。
新增 StringList 變數 headers ,並將專案 Content-Type: application/json;charset=utf-8 新增至其中。
新增字串變數 body 作為「格式化文字」,並使用:
\{ "id": "{Entity.id}" \}
然後,使用方法新增POST函數步驟Server.InvokeWebRequest。 從「收到 HTTP 請求時」觸發器和 body 變數複製的 URL。
現在,當您建立指定實體類型的記錄時,觸發程序會啟動。
常見錯誤和補救措施
對於雲端伺服器,請確保您已在「連線」對話框下指定了正確的伺服器。 如果沒有,您可能會收到未經授權的錯誤。 對於自訂或內部部署伺服器,請輸入包含通訊協定和連接埠(如果適用)的 URL,例如 https://mycompany.com[:8080]
FAQ
- Q:如何使用
List records輸入參數? 答:這些是標準 OData 查詢參數。 每個輸入參數的語法是由 OData 規格所定義。 唯一要考慮的是使用邏輯名稱而不是顯示名稱。 (例如帳戶 -> 帳戶、姓名 -> 姓名等)。 邏輯名稱可在 Admin Console 的「實體」下找到。 - 問:如何取得選項清單標籤?
答:每個選項清單欄位都會傳回 2 個值:
-
Field- 這是選項清單值 -
Field (Label)- 這是選項清單值的標籤。
-
- 問:如何取得查詢標籤?
答:每個查詢欄位都會傳回 3 個值:
-
Field- 這是參考的識別碼 (GUID) -
Field (Label)- 這是參照的標籤(主要名稱)。 -
Field (Type)- 這是參照的目標實體。
-
- 問:如何設定查找欄位?
答:設定查找欄位時,您必須建構一個由記錄類型和記錄 ID 組成的引用。
- 從流程中的現有記錄中,您可以使用
OData Id - 透過創造
logicalName:id表達 - 透過創造
logicalName('id')表達
- 從流程中的現有記錄中,您可以使用
正在建立連線
連接器支援下列驗證類型:
| 雲端伺服器 | 使用雲端伺服器存取您的組織。 | 所有區域 | 不可共享 |
| 內部部署伺服器 | 使用內部部署伺服器存取您的組織。 | 所有區域 | 不可共享 |
| 預設值 [已棄用] | 此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。 | 所有區域 | 不可共享 |
雲端伺服器
驗證 ID:cloudServer
適用:所有地區
使用雲端伺服器存取您的組織。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Resco 伺服器 | 字串 | 對 | |
| 組織 | 字串 | 對 | |
| 用戶名稱 | securestring | 對 | |
| 密碼 | securestring | 對 |
內部部署伺服器
驗證識別碼:onPremiseServer
適用:所有地區
使用內部部署伺服器存取您的組織。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Resco 伺服器 | 字串 | 對 | |
| 組織 | 字串 | 對 | |
| 用戶名稱 | securestring | 對 | |
| 密碼 | securestring | 對 |
預設值 [已棄用]
適用:所有地區
此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Resco 伺服器 | 字串 | 對 | |
| 組織 | 字串 | 對 | |
| 用戶名稱 | securestring | 對 | |
| 密碼 | securestring | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 列出問卷 |
取得問卷記錄清單 |
| 列出記錄 |
取得記錄清單 |
| 刪除記錄 |
依 ID 刪除記錄 |
| 取得問卷 |
通過 ID 獲取問卷記錄 |
| 取得目前的使用者 |
通過 ID 獲取當前用戶記錄 |
| 取得記錄 |
按 ID 獲取記錄 |
| 建立新記錄 |
建立新記錄 |
| 更新記錄 |
依識別碼更新記錄 |
| 產生報告 |
產生報告 |
列出問卷
取得問卷記錄清單
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選取查詢
|
$select | string |
限制擷取資料時傳回的屬性 |
|
|
篩選查詢
|
$filter | string |
ODATA 篩選查詢,以限制傳回的記錄 |
|
|
最高計數
|
$top | integer |
要擷取的記錄總數 |
|
|
略過計數
|
$skip | integer |
略過前 n 筆記錄 |
|
|
略過權杖
|
$skiptoken | string |
用於存取下一頁記錄的權杖 |
|
|
問卷名稱
|
questionnaire | True | string |
問卷名稱 |
傳回
列出記錄
取得記錄清單
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選取查詢
|
$select | string |
限制擷取資料時傳回的屬性 |
|
|
篩選查詢
|
$filter | string |
ODATA 篩選查詢,以限制傳回的記錄 |
|
|
訂購方式
|
$orderby | string |
ODATA orderBy 查詢,用於指定記錄順序 |
|
|
展開查詢
|
$expand | string |
要包含在要求記錄中的相關記錄 (預設值 = 無) |
|
|
最高計數
|
$top | integer |
要擷取的記錄總數 |
|
|
略過計數
|
$skip | integer |
略過前 n 筆記錄 |
|
|
略過權杖
|
$skiptoken | string |
用於存取下一頁記錄的權杖 |
|
|
實體名稱
|
entity | True | string |
實體的名稱 |
傳回
刪除記錄
依 ID 刪除記錄
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄識別碼
|
id | True | string |
輸入全域唯一識別碼 (GUID) |
|
Etag
|
If-Match | string |
ETag (實體版本) |
|
|
實體名稱
|
entity | True | string |
實體的名稱 |
取得問卷
通過 ID 獲取問卷記錄
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄識別碼
|
id | True | string |
輸入全域唯一識別碼 (GUID) |
|
選取查詢
|
$select | string |
限制擷取資料時傳回的屬性 |
|
|
問卷名稱
|
questionnaire | True | string |
問卷名稱 |
傳回
取得目前的使用者
通過 ID 獲取當前用戶記錄
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
選取查詢
|
$select | string |
限制擷取資料時傳回的屬性 |
|
|
展開查詢
|
$expand | string |
要包含在要求記錄中的相關記錄 (預設值 = 無) |
傳回
取得記錄
按 ID 獲取記錄
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄識別碼
|
id | True | string |
輸入全域唯一識別碼 (GUID) |
|
選取查詢
|
$select | string |
限制擷取資料時傳回的屬性 |
|
|
展開查詢
|
$expand | string |
要包含在要求記錄中的相關記錄 (預設值 = 無) |
|
|
實體名稱
|
entity | True | string |
實體的名稱 |
傳回
建立新記錄
建立新記錄
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
實體名稱
|
entity | True | string |
實體的名稱 |
|
body
|
body | True | dynamic |
新紀錄 |
傳回
更新記錄
依識別碼更新記錄
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
記錄識別碼
|
id | True | string |
輸入全域唯一識別碼 (GUID) |
|
Etag
|
If-Match | string |
ETag (實體版本) |
|
|
實體名稱
|
entity | True | string |
實體的名稱 |
|
body
|
body | True | dynamic |
新的屬性值 |
傳回
產生報告
產生報告
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
實體名稱
|
entity | True | string |
實體的名稱 |
|
記錄識別碼
|
id | True | string |
輸入全域唯一識別碼 (GUID) |
|
報表名稱
|
report | True | string |
報告名稱 |
|
格式
|
extension | True | string |
檔案格式 |
傳回
- 報表內容
- binary
觸發程序
| 建立-更新-刪除項目時 |
建立-更新-刪除項目時 |
建立-更新-刪除項目時
建立-更新-刪除項目時
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
實體名稱
|
$entity | True | string |
實體的名稱 |
|
動作名稱
|
$action | True | string |
行動 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
id | string |
定義
二進位
這是基本資料類型「二進位」。