Teams-Spirit （預覽版）
Teams-Spirit 連接器可讓您將 Teams-Spirit 訂閱連線至流程。
此連接器適用於以下產品和區域：
| 服務 | 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） |
| 連絡人 | |
|---|---|
| 名稱 | 伊曼紐爾·福克斯 |
| URL | https://teams-spirit.de/#kontakt |
| info@digitalteamwork.de |
| 連接器中繼資料 | |
|---|---|
| Publisher | DFK 數位團隊合作有限公司 |
| 網站 | https://teams-spirit.de |
| 隱私策略 | https://teams-spirit.de/datenschutz/ |
| 類別 | 傳達;生產力 |
Teams-Spirit 連接器
Teams-Spirit 提供廣泛的 REST API。 使用此 API，您可以透過 Teams-Spirit 管理您的核准、小組和使用者。
發行商：D.F.K. Digital Teamwork GmbH
先決條件
您將需要以下內容才能繼續：
- 具有自訂連接器功能的 Microsoft Power Apps 或 Power Automate 方案
- Teams-Spirit Azure AD 企業應用程式 （如果您使用 Teams-Spirit，通常會出現此應用程式）
- Teams-Spirit 訂閱
- Power platform CLI 工具
支援的作業
連接器提供下列觸發程式：
Action-Trigger
可透過 Teams-Spirit 動作觸發聯結器支援下列作業：
獲得所有批准
列出所有核准
核准
核准核准
拒絕
拒絕核准
檔案團隊
封存小組，並選擇性地將群組 SharePoint 網站標示為唯讀
刪除團隊
刪除團隊
將角色變更為成員
將使用者角色變更為成員
將角色變更為擁有者
將使用者角色變更為擁有者
移除所有來賓
從團隊中刪除所有訪客
移除除擁有者以外的所有使用者
移除指定擁有者以外的所有小組成員
從團隊中移除使用者
從小組中移除使用者
變更標籤值
變更 Teams-Spirit 標籤的值
取得標籤值
傳回 Teams-Spirit 標籤的值
延長到期日
延長團隊到期日
取得憑證
Teams-Spirit Connector 會針對 Azure Active Directory （AD） 使用 OAuth2。 這與 Teams-Spirit 應用程式本身使用的驗證方法相同，因此使用者在連接器和應用程式中將具有相同的許可權。
使用者入門
如果您希望由 Teams-Spirit 規則觸發流程，您可以使用動作觸發器建立新流程。 一旦您為它命名，它就會在 Teams-Spirit 中註冊自己，並在規則引擎中可用。 您可以將 Teams-Spirit 規則中可用的每個引數傳送至流程，並使用它來進一步自動化您的工作流程。
部署指示
由於 Teams-Spirit API 是由 Azure Active Directory （AD） 透過 OAuth2 保護，因此我們首先需要在 Azure AD 中設定一些專案，以便我們的連接器可以安全地存取 API。 完成後，您可以建立並測試連接器。
設定自訂連接器的 Azure AD 應用程式
我們首先需要將連接器註冊為 Azure AD 中的應用程式。 這可讓連接器向 Azure AD 識別自己，以便代表使用者要求存取 Teams-Spirit 資料的許可權。 您可以按照以下步驟操作：
建立 Azure AD 應用程式此 Azure AD 應用程式將用來識別 Teams-Spirit 的連接器。 這可以遵循此處的步驟，使用 [Azure 入口網站] （）https://portal.azure.com 來完成。 建立後，記下應用程式（用戶端）ID的值。 您稍後會需要這個。
設定 （更新） 您的 Azure AD 應用程式以存取 Teams-Spirit API此步驟可確保您的應用程式可以成功擷取存取權杖，以代表使用者叫用 Teams-Spirit。 為此，請按照 此處的步驟操作。
- 針對重新導向 URI，請使用 “https://global.consent.azure-apim.net/redirect”
- 對於認證，請使用用戶端密碼 （而不是憑證）。 記得記下秘密，你稍後會需要這個，而且它只顯示一次。
- 對於 API 權限，請新增 Teams-Spirit
access_as_user權限。 為此，請單擊Add a permission，導航到APIs my organization uses，搜索 Teams-Spirit 並添加access_as_user權限。
此時，我們現在有一個有效的 Azure AD 應用程序，可用於從最終用戶獲取權限並訪問 Teams-Spirit。
部署連接器
首先，將 {clientId} 取代 apiProperties.json 為您的 Azure AD 應用程式用戶端識別碼。
如果 {resourceId} 部署自訂連接器，則應取代為 api://app.teams-spirit.com/3a57026a-cf3f-4295-93f5-ca245af3d2df/access_as_user 。
然後執行下列命令並遵循提示：
paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <client_secret>
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| Approve |
核准給定的核准 |
| 刪除團隊 |
刪除團隊 |
| 取得標籤值 |
取得群組的標籤值 |
| 將角色變更為成員 |
將使用者角色變更為團隊中的成員 |
| 將角色變更為擁有者 |
將團隊中的使用者升級為擁有者 |
| 延長到期日 |
延長群組到期日 |
| 從團隊中刪除所有非所有者 |
從團隊中刪除除所有者之外的所有成員 |
| 從團隊中刪除用戶 |
從團隊中移除使用者 |
| 拒絕 |
拒絕 |
| 檔案團隊 |
檔案團隊 |
| 獲得所有批准 |
獲得所有批准 |
| 移除所有來賓 |
從團隊中刪除所有訪客 |
| 移除除擁有者以外的所有使用者 |
移除除一個選取的擁有者之外的所有使用者 |
| 變更標籤值 |
變更指定團隊中標籤的值 |
Approve
核准給定的核准
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
核准標識碼
|
Approval-ID | True | string |
核准標識碼 |
刪除團隊
刪除團隊
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組的 ID
|
Group-ID | True | string |
群組的 ID |
取得標籤值
取得群組的標籤值
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組的 ID
|
Group-ID | True | string |
群組的 ID |
|
標籤的 ID
|
Tag-ID | True | string |
標籤的 ID |
傳回
- 標記值
- string
將角色變更為成員
將使用者角色變更為團隊中的成員
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組的 ID
|
Group-ID | True | string |
群組的 ID |
|
使用者 ID
|
userId | string |
userId |
將角色變更為擁有者
將團隊中的使用者升級為擁有者
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組的 ID
|
Group-ID | True | string |
群組的 ID |
|
使用者 ID
|
userId | string |
userId |
延長到期日
延長群組到期日
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組的 ID
|
Group-ID | True | string |
群組的 ID |
|
Weeks
|
weeks | string |
星期 |
從團隊中刪除所有非所有者
從團隊中刪除除所有者之外的所有成員
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組的 ID
|
Group-ID | True | string |
群組的 ID |
從團隊中刪除用戶
從團隊中移除使用者
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組的 ID
|
Group-ID | True | string |
群組的 ID |
|
使用者 ID
|
userId | string |
userId |
拒絕
拒絕
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
核准標識碼
|
Approval-ID | True | string |
核准標識碼 |
檔案團隊
檔案團隊
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組的 ID
|
Group-ID | True | string |
群組的 ID |
|
將 SharePoint 網站設為小組成員唯讀
|
sharePointReadOnly | True | boolean |
sharePoint唯讀 |
獲得所有批准
獲得所有批准
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of object | ||
|
識別碼
|
id | string |
識別碼 |
|
使用者名稱
|
userName | string |
使用者名稱 |
|
userId
|
userId | string |
userId |
|
createForExternalUser
|
createForExternalUser | boolean |
createForExternalUser |
|
外部使用者標識碼
|
externalUserId | string |
外部使用者標識碼 |
|
reactingUserId
|
reactingUserId | string |
reactingUserId |
|
反應用戶名稱
|
reactingUserName | string |
反應用戶名稱 |
|
請求時間
|
requestTime | string |
請求時間 |
|
expirationDateTime
|
expirationDateTime | string |
expirationDateTime |
|
狀態
|
status | integer |
狀態 |
|
groupName
|
groupName | string |
groupName |
|
組描述
|
groupDescription | string |
組描述 |
|
reason
|
reason | string |
reason |
|
拒絕原因
|
rejectReason | string |
拒絕原因 |
|
訪問
|
access | boolean |
訪問 |
|
反應時間
|
reactionTime | string |
反應時間 |
|
型別
|
type | string |
型別 |
|
tid
|
tid | string |
tid |
|
樣板ID
|
templateId | string |
樣板ID |
|
屬性設定
|
attributeSettings | array of object |
屬性設定 |
|
屬性標識
|
attributeSettings.attributeId | string |
屬性標識 |
|
value
|
attributeSettings.value | string |
value |
|
型別
|
attributeSettings.type | integer |
型別 |
移除所有來賓
從團隊中刪除所有訪客
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組的 ID
|
Group-ID | True | string |
群組的 ID |
移除除擁有者以外的所有使用者
移除除一個選取的擁有者之外的所有使用者
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組的 ID
|
Group-ID | True | string |
群組的 ID |
|
擁有者識別碼
|
ownerId | string |
擁有者ID |
變更標籤值
變更指定團隊中標籤的值
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
群組的 ID
|
Group-ID | True | string |
群組的 ID |
|
標記
|
id | string |
識別碼 |
|
|
價值觀
|
value | string |
value |
觸發程序
| Action-Trigger |
Action-Trigger |
Action-Trigger
定義
物件
這是類型 'object'。
字串
這是基本資料類型「string」。