共用方式為


smapOne

使用此聯結器可從 smapOne 平台擷取有關 smap 的資料、更新資料來源或為使用者建立任務。

此連接器適用於以下產品和區域:

服務 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)
連絡人​​
名稱 smapOne 股份公司
URL https://www.smapone.com
Email support@smapone.com
連接器中繼資料
Publisher smapOne 股份公司
網站 https://www.smapone.com
隱私策略 https://en.smapone.com/privacy-policy/
類別 資料;生產力

正在建立連線

連接器支援下列驗證類型:

預設值 建立連線的參數。 所有區域 不可共享

預設

適用:所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
smapOne API 金鑰 securestring 您的 smapOne 帳戶的 API 密鑰

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

刪除 smap 版本的資料記錄

將所有資料記錄刪除至指定的 smap 版本。 請注意,如果您未設定狀態過濾器,則會刪除所有記錄!

刪除資料記錄

刪除指定 smap 版本的特定資料記錄。

取得 dataRecord 的結構描述

取得此 smap 資料的 json 結構描述

取得 smap 所有版本的所有資料記錄

將所有記錄傳回給定的 smapId。 傳回所有 smap 版本的資料記錄。 請注意,結果可能不相容,因為資料結構描述可能已在 smap 版本之間變更。

取得使用者和訂閱的統計資料

此作業會提供訂用帳戶的統計資料,例如資料計數。

取得使用者的相關資訊

此作業會傳回目前使用者的相關資訊。 例如,users e-mail 和 subscriptionId。

取得所有 smap 版本

傳回屬於指定 smapId 的 als 版本。 傳回的實體可用來查詢指定版本的資料記錄。 0.0 版是當前編輯的版本,而不是噴氣式飛機發布的 smap 版本。

取得所有地圖

傳回訂用帳戶的所有 smap。 傳回的實體可用來使用指定的 smapId 查詢可用的 smap 版本,或查詢 smap 的資料記錄。

取得所有版本的 smap 的所有資料記錄的報告

傳回指定 smapId 之所有記錄的報告。 會傳回所有 smap 版本的報告。

取得特定地圖的詳細資料

取得特定地圖的所有中繼資料

取得特定的 smap 版本

取得特定版本的地圖中繼資料

取得資料來源

傳回訂閱中可用的資料來源清單。 傳回的實體可用來使用指定的 dataSourceId 來查詢資料來源版本。

取得資料來源值

傳回特定資料來源版本的值。

取得資料來源詳細資料

將詳細資料傳回給指定的資料來源。

取得資料記錄

傳回指定 smap 版本的特定資料記錄。

取得資料記錄的報告

傳回指定 smap 版本之特定資料記錄的報告。

建立 smap 版本的任務

建立任務 - 可指派給使用者的預先填入資料記錄

從特定 smap 版本取得所有資料記錄的報告

傳回特定 smap 版本之所有記錄的報告。 對於所有新記錄,匯出日期將自動更新。 您可以使用 state 參數來篩選新記錄。

指派或移除工作

指派或移除使用者的工作

更新地圖中的所有資料來源

檢查所有參考的資料來源以取得更新。 如果參考資料來源有較新的次要版本,則會更新參考,並發佈此 Smap 的新版本。 如果沒有可用的更新,則不會執行發佈,並傳回最新版本。

更新資料來源

更新資料來源。 欄必須相等。 這表示資料行識別碼必須相符。

獲取smap版本的所有數據記錄

使用指定的 smapId 傳回特定 smap 版本的所有記錄。 對於所有新記錄,匯出日期將自動更新。 您可以使用 state 參數來篩選新記錄。

獲取數據記錄文件

傳回指定 smap 版本之指定 recordId 的特定檔案。

獲取數據記錄的所有文件元數據

傳回此資料記錄之所有檔案的中繼資料。

刪除 smap 版本的資料記錄

將所有資料記錄刪除至指定的 smap 版本。 請注意,如果您未設定狀態過濾器,則會刪除所有記錄!

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

smap版本
version True string

smap 版本號碼 (例如 1.0)

記錄狀態
state string

篩選狀態為「新」、「匯出」或「不完整」的記錄

刪除資料記錄

刪除指定 smap 版本的特定資料記錄。

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

smap版本
version True string

smap 版本號碼 (例如 1.0)

recordId
recordId True string

資料記錄識別碼

取得 dataRecord 的結構描述

取得此 smap 資料的 json 結構描述

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

smap版本
version True string

smap 版本號碼 (例如 1.0)

傳回

response
object

取得 smap 所有版本的所有資料記錄

將所有記錄傳回給定的 smapId。 傳回所有 smap 版本的資料記錄。 請注意,結果可能不相容,因為資料結構描述可能已在 smap 版本之間變更。

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

標記為已匯出
markAsExported boolean

將所有要求的記錄標示為已匯出

格式
format True string

輸出格式(.json, .xml),預設為 Json

記錄狀態
state string

篩選記錄的狀態:新記錄、匯出記錄或未完成記錄 (任務)

傳回

取得使用者和訂閱的統計資料

此作業會提供訂用帳戶的統計資料,例如資料計數。

傳回

取得使用者的相關資訊

此作業會傳回目前使用者的相關資訊。 例如,users e-mail 和 subscriptionId。

傳回

給使用者的資訊

身體
UserInfoModel

取得所有 smap 版本

傳回屬於指定 smapId 的 als 版本。 傳回的實體可用來查詢指定版本的資料記錄。 0.0 版是當前編輯的版本,而不是噴氣式飛機發布的 smap 版本。

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

傳回

取得所有地圖

傳回訂用帳戶的所有 smap。 傳回的實體可用來使用指定的 smapId 查詢可用的 smap 版本,或查詢 smap 的資料記錄。

傳回

取得所有版本的 smap 的所有資料記錄的報告

傳回指定 smapId 之所有記錄的報告。 會傳回所有 smap 版本的報告。

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

標記為已匯出
markAsExported boolean

將所有請求報告的資料記錄標記為匯出

記錄狀態
state string

篩選記錄的狀態:新記錄、匯出記錄或未完成記錄 (任務)

傳回

response
binary

取得特定地圖的詳細資料

取得特定地圖的所有中繼資料

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

要要求的 smap 的 smapId

傳回

有關 smap 的基本資訊

身體
SmapModel

取得特定的 smap 版本

取得特定版本的地圖中繼資料

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

smap版本
version True string

smap 版本號碼 (例如 1.0)

傳回

Smap-Version 的信息

取得資料來源

傳回訂閱中可用的資料來源清單。 傳回的實體可用來使用指定的 dataSourceId 來查詢資料來源版本。

傳回

取得資料來源值

傳回特定資料來源版本的值。

參數

名稱 機碼 必要 類型 Description
DatasourceId
dataSourceId True string

資料來源識別碼

資料來源版本
dataSourceVersion True string

資料來源版本號碼 (例如 1.0)

傳回

名稱 路徑 類型 Description
array of object
items
object

取得資料來源詳細資料

將詳細資料傳回給指定的資料來源。

參數

名稱 機碼 必要 類型 Description
DatasourceId
dataSourceId True string

資料來源的 ID

傳回

來源模型

取得資料記錄

傳回指定 smap 版本的特定資料記錄。

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

smap版本
version True string

smap 版本號碼 (例如 1.0)

recordId
recordId True string

資料記錄識別碼

格式
format string

Json、Xml

標記為已匯出
markAsExported boolean

將記錄標示為匯出

傳回

資料記錄的 REST API 模型

身體
DataRecordApi

取得資料記錄的報告

傳回指定 smap 版本之特定資料記錄的報告。

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

smap版本
version True string

smap 版本號碼 (例如 1.0)

recordId
recordId True string

資料記錄識別碼

格式
format True string

pdf、docx、doc、html、xml、txt(用於測試目的)

標記為已匯出
markAsExported boolean

將記錄標示為匯出

使用預設範本
useDefault boolean

如果為true,則會產生新範本,並忽略上傳的報告範本。

傳回

response
binary

建立 smap 版本的任務

建立任務 - 可指派給使用者的預先填入資料記錄

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

smap版本
version True string

smap 版本號碼 (例如 1.0)

使用者電子郵件
userEmail string
title
title True string

任務的名稱

留言
comment string

任務建立者的評論

has優先順序
hasPriority boolean

任務優先順序

資料
data True object

傳回

資料記錄的 REST API 模型

身體
DataRecordApi

從特定 smap 版本取得所有資料記錄的報告

傳回特定 smap 版本之所有記錄的報告。 對於所有新記錄,匯出日期將自動更新。 您可以使用 state 參數來篩選新記錄。

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

smap版本
version True string

主要或 major.minor 格式的 smap 版本

標記為已匯出
markAsExported boolean

將所有請求報告的資料記錄標記為匯出

記錄狀態
state string

篩選狀態為新記錄、匯出記錄或未完成狀態

傳回

response
binary

指派或移除工作

指派或移除使用者的工作

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

smap版本
version True string

smap 版本號碼 (例如 1.0)

recordId
taskId True string

記錄識別碼

動作
action string
使用者電子郵件
userEmail string

傳回

資料記錄的 REST API 模型

身體
DataRecordApi

更新地圖中的所有資料來源

檢查所有參考的資料來源以取得更新。 如果參考資料來源有較新的次要版本,則會更新參考,並發佈此 Smap 的新版本。 如果沒有可用的更新,則不會執行發佈,並傳回最新版本。

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

更新設計工具版本
updateEditVersion boolean

如果目前的設計器版本也應該更新

傳回

Smap-Version 的信息

更新資料來源

更新資料來源。 欄必須相等。 這表示資料行識別碼必須相符。

參數

名稱 機碼 必要 類型 Description
DatasourceId
dataSourceId True string

資料來源識別碼

版本
dataSourceVersion True string

目前資料來源版本的版本號碼(例如 1.0)

values
values object

傳回

資料來源版本模型

獲取smap版本的所有數據記錄

使用指定的 smapId 傳回特定 smap 版本的所有記錄。 對於所有新記錄,匯出日期將自動更新。 您可以使用 state 參數來篩選新記錄。

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

smap版本
version True string

主要 (例如 1) 或主要 (例如 1.1) 格式的 smap 版本

標記為已匯出
markAsExported boolean

將所有要求的記錄標示為已匯出

格式
format string

輸出格式(.json 或 .xml),默認為Json

記錄狀態
state string

篩選狀態為「新」、「匯出」或「不完整」的記錄

傳回

獲取數據記錄文件

傳回指定 smap 版本之指定 recordId 的特定檔案。

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

smap版本
version True string

smap 版本號碼 (例如 1.0)

recordId
recordId True string

記錄識別碼

檔案標識符
fileId True string

檔案標識碼

獲取數據記錄的所有文件元數據

傳回此資料記錄之所有檔案的中繼資料。

參數

名稱 機碼 必要 類型 Description
smapId
smapId True string

smap ID

smap版本
version True string

smap 版本號碼 (例如 1.0)

recordId
recordId True string

資料記錄識別碼

傳回

定義

使用者資訊模型

給使用者的資訊

名稱 路徑 類型 Description
accountIsActivated
accountIsActivated boolean

指出帳戶是否已啟用。 如果沒有,則使用者尚未驗證帳戶。

subscriptionId
subscriptionId string

使用者的訂閱 ID

使用者名稱
userName string

使用者名稱

companyName
companyName string

註冊訂閱的公司名稱

電子郵件
email string

使用者的電子郵件地址

原始郵件
originalMail string

如果使用模擬存取目前帳戶,則會顯示原始使用者的電子郵件地址。

合約
contract string

合約類型

角色
roles array of string

套用至使用者的角色清單

smap限制
smapLimit integer

允許此使用者發佈的地圖數目上限。 值為 null 表示無限制。

發行者
publisher string

向其使用者描述發行者的文字。

來源
source string

訂閱的來源。

isInternal
isInternal boolean

表示此帳戶由 smapOne 內部使用。

使用者限制
userLimit integer

建立者可以建立的使用者數目上限

已發布地圖
publishedSmaps integer

此帳戶已發佈的 smap 數量

可用功能
availableFeatures array of string

此帳戶的可用功能清單

設定
settings object

儲存在此帳戶上的自訂設定。 只有在請求上設定了「embed」參數時才會輸出。

文化特性 (Culture)
culture string

目前為此帳戶選取的文化特性。 以兩位數文化代碼的形式提供,例如“en”。

帳戶統計

名稱 路徑 類型 Description
識別碼
id string
訂閱類型
subscriptionType string
訂閱類型已變更
subscriptionTypeChanged date-time
訂閱類型標題
subscriptionTypeTitle string
subscriptionType值
subscriptionTypeValue integer
isMaster訂閱
isMasterSubscription boolean
smap限制
smapLimit integer
groupCount
groupCount integer
試驗持續時間天數
trialDurationInDays integer
DaysLeftForTrial
daysLeftForTrial integer
建立日期
createdDate date-time
使用者數量
userCount integer
使用者限制
userLimit integer
天自創造以來
daysSinceCreation integer
文化特性 (Culture)
culture string
lang代碼
langCode string
isInternal
isInternal boolean
systemVersion (系統版本)
systemVersion string
網域
domain string
isChild訂閱
isChildSubscription boolean
是冒充
isImpersonating boolean
資料計數
dataCount integer
smap計數
smapCount integer
已發佈的地圖計數
publishedSmapCount integer
notPublishedSmapCount
notPublishedSmapCount integer
distributedSmap計數
distributedSmapCount integer
已安裝的SmapsCount
installedSmapsCount integer
群組授權計數
groupLicenseCount integer
lastSmapId
lastSmapId string
預覽Smap計數
previewSmapCount integer

DataSourceListModel

來源模型

名稱 路徑 類型 Description
建立日期
createdDate date-time

建立資料來源的日期

最新版本
latestVersion string

此資料來源可用的最新版本

型別
type string

資料來源的類型

dataSourceId
dataSourceId string

資料來源的 ID

名稱
name string

資料來源的名稱。

DataSourceVersionModel

資料來源版本模型

名稱 路徑 類型 Description
定義
definition AbstractDataSourceDefinition

此資料來源版本的定義

建立日期
createdDate date-time

建立此版本資料來源的日期

版本
version string

此資料來源版本的版本號碼

dataSourceId
dataSourceId string

資料來源的識別碼

名稱
name string

資料來源的名稱。

抽象數據源定義

此資料來源版本的定義

名稱 路徑 類型 Description
title
title string
型別
type string
識別碼
id string
dataSourceId
dataSourceId string

資料來源的識別碼

DataSourceModel

來源模型

名稱 路徑 類型 Description
dataSourceId
dataSourceId string

資料來源的識別碼

型別
type string

資料來源的類型

名稱
name string

數據源的名稱

建立日期
createdDate date-time

建立資料來源的日期

最新版本
latestVersion string

此資料來源可用的最新版本

使用InSmaps
usedInSmaps array of DataSourceSmapModel

使用此資料來源的 SMAP

DataSourceSmapModel

描述地圖

名稱 路徑 類型 Description
smap名稱
smapName string

地圖的名稱

smapId
smapId string

smap 的 ID

SmapModel

有關 smap 的基本資訊

名稱 路徑 類型 Description
群組授權計數
groupLicenseCount integer

群組授權計數

變更類型
changeType string

指出與上次發佈的版本相比,對 smap 進行了哪些類型的變更。

使用者授權計數
userLicenseCount integer

使用者授權計數

最後變更
lastChanged date-time

對地圖進行最後一次變更的日期

isUpToDate
isUpToDate boolean

表示自上次發佈以來,smap 尚未變更

安裝計數
installationsCount integer

smap 的安裝數量

lastPublished版本
lastPublishedVersion SmapVersionModel

Smap-Version 的信息

總數據計數
totalDataCount integer

smap 所有版本的所有資料記錄計數

totalOpenTasksCount
totalOpenTasksCount integer

此地圖的開啟任務數目

tasks已啟用
tasksActivated boolean

表示已針對此 Smap 啟用從資料記錄建立任務的選項。

isCompany範本
isCompanyTemplate boolean

指出此地圖是否可作為公司範本使用

名稱
name string

地圖的名稱

smapId
smapId string

smap 的 ID

logoId
logoId string

地圖標誌的標識號

SmapVersionModel

Smap-Version 的信息

名稱 路徑 類型 Description
最後變更
lastChanged date-time

此版本的發佈日期。 對於 0.0 版(編輯版本),它顯示對地圖進行最後一次更改的時間。

lastRecord已接收
lastRecordReceived date-time

收到此版本地圖的最後一次資料記錄的日期

資料計數
dataCount integer

此 smap 版本的資料記錄數

smapVersionId
smapVersionId string

此版本的 smap 的 ID

版本
version string

此版本的 smap 版本號碼

DataRecordApi

資料記錄的 REST API 模型

名稱 路徑 類型 Description
schemaVersion
schemaVersion integer

資料格式版本

識別碼
id string

資料記錄的識別碼

記錄類型
recordType string

描述資料記錄的類型。 它要麼是任務,要麼是自建的資料記錄。

subscriptionId
subscriptionId string

資料記錄和相應 smap 所屬訂閱的識別碼。

smapId
smapId string

資料記錄所屬地圖的識別碼。

smapVersionId
smapVersionId string

資料記錄所屬的 smap 版本的識別碼。

版本
version string

資料記錄所屬的人類可讀的 smap 版本。

令牌ID
tokenId string

用於建立資料記錄的 smap 權杖的識別碼。

userId
userId string

建立資料記錄之使用者的識別碼

使用者電子郵件
userEmail string

建立資料記錄之使用者的電子郵件地址

使用者名稱
userName string

建立資料記錄的使用者名稱。 注意: 當資料記錄是透過匿名授權建立時,此欄位中具有無法讀取的唯一 ID。

發送日期
sendDate date-time

用戶完成數據記錄並排隊發送到 smapOne 應用程序中的服務器時的時間戳。

clientCreatedDate (客戶端建立日期)
clientCreatedDate date-time

使用者轉遞資料記錄並因此成為任務的時間戳記。

接收日期
receivedDate date-time

伺服器接收資料記錄的時間戳記。 當記錄本身已傳輸到伺服器時,將設定此設定,但相關聯的檔案可能尚未傳輸。 此時間戳記將晚於 sendDate,但早於 completedDate。

completedDate (已完成日期)
completedDate date-time

已完成資料記錄本身及所有參照檔案已完全傳輸至伺服器並由伺服器接收的時間戳記。

刪除日期
deletedDate date-time

刪除資料記錄的時間戳記

lastExportDate (最後匯出日期)
lastExportDate date-time

上次匯出資料記錄時的時間戳記

toCompleteOn
toCompleteOn date-time

資料記錄的發佈日期

title
title string

任務或資料記錄的名稱。

留言
comment string

任務的單一註解

資料
data

從 smap 收集的資料。 索引鍵值組清單,其中索引鍵是 smap 每個模組的 ID,值是該模組的實際資料。

單一檔案值

名稱 路徑 類型 Description
檔ID
fileId string
fileName
fileName string
時間戳記
timestamp date-time
總和檢查碼
checkSum string
內容類型
contentType string
size
size integer
元數據
meta FileMetaData
url
url string

檔案中繼資料

名稱 路徑 類型 Description
audio持續時間
audioDuration string

物件

這是類型 'object'。

二進位

這是基本數據類型 『binary』。