Teams-Spirit (プレビュー)

  • リファレンス

Teams-Spirit コネクタを使用すると、Teams-Spirit サブスクリプションをフローに接続できます。

このコネクタは、次の製品および地域で利用可能です:

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   US Government (GCC)
     -   US Government (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 Immanuel Fuchs
[URL] https://teams-spirit.de/#kontakt
メール info@digitalteamwork.de
Connector Metadata
発行者 D.F.K. Digital Teamwork GmbH
Web サイト https://teams-spirit.de
プライバシー ポリシー https://teams-spirit.de/datenschutz/
カテゴリー 通信; 生産性

Teams-Spirit エンタープライズ アプリケーションのユーザーは、コネクタを使用して Teams 関連のビジネス プロセスを Flow で自動化し、それらを Flow で使用できる他のすべてのアプリケーションに接続できます。 チームの分類、使用法、またはライフサイクルに関連する Teans のメタデータは、フローのトリガーとして使用できます。 逆に、チームのメタデータは、フロー アクションによって変更および拡張できます。 ユーザーと権限は、フローを介してカスタマイズすることもできます。 全体として、既定の Teams コネクタよりもはるかに多くのアクションを使用できます。

前提条件

続行するには、次のものが必要です。

  • Teams-Spirit Microsoft Entra ID エンタープライズ アプリケーション (通常、これは Teams-Spirit を使用している場合に存在します)
  • Teams-Spirit サブスクリプション

資格情報の入手方法

Teams-Spirit コネクタが提供するアクションまたはトリガーのいずれかを使用してフローを作成すると、サインインするよう求められます。 サインインするには、Teams-Spirit が Microsoft Entra ID エンタープライズ アプリケーションに含まれている必要があります。これは、PowerAutomate の外部で Teams-Spirit をすでに使用している場合に当てはまります。

コネクタの使用を開始する

Teams-Spirit ルールによってフローをトリガーする場合は、アクション トリガーを使用して新しいフローを作成できます。 名前を付けると、Teams-Spirit に登録され、Rule-Engine で使用できるようになります。 Teams-Spirit ルールで使用可能なすべてのパラメーターをフローに送信し、それを使用してワークフローをさらに自動化できます。 以下を使う:

Teams-Spirit アクション トリガーを使用する新しい "自動クラウド フロー" を最初に作成する必要があります。

これには以下のステップが必要です。

  1. Power Automate で新しい "自動化したクラウド フロー" を作成します。
    • フローを作成するとき、ユーザーはフローのトリガーを選択するよう求められます。
      もし Teams-Spirit アクション トリガーが 利用できない 場合、選択をスキップする必要があります。
  2. teams-spirit アクション トリガーを追加する。
    • 最初に選択をスキップした後、ユーザーはフローのトリガーを選択するように求められます
    • "カスタム" タブの下で、"アクション トリガー" を提供する "Teams-Spirit" コネクタを選択できます
  3. 名前を選択します ( 入力パラメータ を参照)

入力パラメーター:

名称
input-type description
件名 ドロップダウン / カスタム値 Teams-Spirit ルール エンジンによってトリガーされるために後で使用される名前。
ドロップダウンから既存の名前を選択すると、この名前を使用するすべてのフローが対応するアクションによってトリガーされます。

出力:

名称
データ型 description
body JSON text Teams-Spirit アクションによって生成されたペイロード。

Actions

すべての承認を取得する

組織のすべての承認のリストを取得します。

入力パラメーター:

None

出力:

以下のパラメータを持つオブジェクトのコレクションです:

名称
データ型 description
id Text team spirit 承認の ID
userName text 承認を要求したユーザーのユーザー名
userId Text 承認を要求したユーザーのユーザー ID
externalUserId Text 外部ユーザー用にチームを作成する場合は、外部ユーザーのユーザー ID
reactingUserId Text 承認を要求したユーザーのユーザー ID
requestTime text 承認が作成された日付
expirationDateTime Text 利用可能な場合、チームの有効期限
groupName Text グループ/チームの名前
groupDescription Text グループ/チームの説明
reason Text チームの特定の理由
rejectReason Text 承認を拒否する理由がある場合
reactionTime Text 存在する場合は、承認に対する最後の反応の日付
タイプ Text 承認の種類
tid Text 組織のテナント ID
templateId Text 使用した Teams-Spirit テンプレートの ID
createForExternalUser ブール型 グループを外部ユーザー用に作成するかどうかを決定します
アクセス ブール型 ''true'': グループは公開、''false'': グループは非公開
ステータス 回数 ''0'' - 保留中
''1'' - 承認済み
''2'' - 却下済み
''3'' - 失敗
attributeSettings オブジェクトのリスト グループに設定されている teams spirit タグのリスト
承認​​

Teams-Spirit の承認を承認します

*フローで接続に使用するアカウントがロール "精神承認者" の場合のみ可能です。

入力パラメーター:

件名
入力タイプ Description
承認 ID テキスト フィールド 承認するチーム精神承認の ID

出力:

None

拒否する

Teams-Spirit の承認を拒否

*フローで接続に使用するアカウントがロール "Spirit 承認者" ロールの場合のみ可能です。

入力パラメーター:

名称
input-type description
承認 ID テキスト フィールド 拒否する team spirit 承認の ID

出力:

None

チームのアーカイブ

Microsoft 365 チームをアーカイブ

入力パラメーター:

名称
input-type description
Group ID テキスト フィールド アーカイブするグループの ID
チームの SharePoint サイトを読み取り専用にする ブール型 SharePoint サイトをチーム メンバーに対して読み取り専用に設定するかどうかを決定します

出力:

None

Team を削除

Microsoft 365 チームの削除

入力パラメーター:

名称
input-type description
Group ID テキスト フィールド 削除するグループの ID

出力:

None

メンバーへのロール変更する

グループ内のユーザーのロールを "メンバー" に変更します。

入力パラメーター:

名称
input-type description
Group-ID Textfield ロールをカスタマイズする必要があるグループの ID
User-ID テキスト フィールド ロールを変更すべきユーザーの ID

出力:

None

所有者へのロール変更する

グループ内のユーザーのロールを "所有者" に変更します。

入力パラメーター:

名称
input-type description
Group-ID Textfield ロールをカスタマイズする必要があるグループの ID
User-ID テキスト フィールド ロールを変更すべきユーザーの ID

出力:

None

すべてのゲストを削除

グループからすべてのゲストを削除します

入力パラメーター:

名称
input-type description
Group-ID Textfield ゲストを削除する必要があるグループの ID

出力:

None

チームから非所有者をすべて削除する

グループから所有者を除くすべてのメンバーを削除します

入力パラメーター:

名称
input-type description
Group-ID Textfield メンバーを削除する必要があるグループの ID

出力:

None

所有者以外のすべてのユーザーを削除します

グループから選択した所有者を除くすべてのメンバーを削除します

入力パラメーター:

名称
input-type description
Group-ID Textfield メンバーを削除する必要があるグループの ID
Owner-Id テキスト フィールド グループに残る所有者の ID

出力:

None

ユーザーをチームから削除する

グループからメンバーを削除する

入力パラメーター:

名称
input-type description
Group-ID Textfield メンバーを削除する必要があるグループの ID
User-ID Textfield 削除すべきユーザーの Id

出力:

None

タグ値の変更

グループの Teams-Spirit タグの値を変更します

入力パラメーター:

名称
入力の種類 description
Group ID テキスト フィールド タグを変更する必要があるグループの ID
Tag Dropdown 値を変更する必要があるタグ。
選択には、組織で使用可能なすべてのタグが含まれます
価値 ドロップダウン / カスタム値 タグの新しい値
選択したタグに定義済みの値が設定されている場合は、ドロップダウンで選択できます

出力:

None

タグの値を取得する

グループの Teams-Spirit タグの グローバル 値を変更します。

入力パラメーター:

名称
input-type description
Group-ID Textfield タグを取得する必要があるグループの ID
Tag Dropdown 値を取得する必要があるタグ。
選択には、組織で使用可能なすべてのタグが含まれます

出力:

名称
データ型 description
タグ値 text タグの値
有効期限の延長

チームの有効期限を延長します。

注: チームに既に有効期限がある場合は、週数だけ延長されます。 そうでない場合、アクションが実行される時間は週数だけ延長され、グループの有効期限として設定されます。

入力パラメーター:

名称
input-type description
Group ID テキスト フィールド 有効期限を延長する必要があるグループの ID
週 テキスト フィールド 有効期限を延長する必要がある週の番号

出力:

None

既知の問題と制限事項

フロー名の重複に注意
  • 同名の Flow-Trigger を複数登録することが可能です。
  • これは、Teams-Spirit Rule-Engine の 1 つのルールが複数のフローをトリガーする必要がある場合に役立ちます。
  • それを望まない場合は、フローに一意の名前を付けてください。
Payload

Teams-Spirit ルールで定義されたペイロードは、JSON 形式で指定する必要があります。 構文的に正しくない場合、フローをトリガーできません

JSON 形式の任意のデータをペイロードに指定できます。 さらに、ここではプレースホルダーもサポートされていますが、JSON 構文に準拠するためには、プレースホルダーのデータ型に注意することが重要です。

ペイロードの例は次のようになります。

'''json { "groupId": ${group.id}, "memberIds": ${group.members}, "myOwnKey": "myOwnValue" } '''

''${group.members}'' はユーザー ID のコレクションであるため、正しく解釈するために引用符で囲む必要はありません。

一般的なエラーと解決策

Action-Trigger の後に "Parse JSON" アクションを使用することが重要です。 これは、Teams-Spirit によって渡されるオブジェクトが Teams-Spirit ルール内で定義されるためです。 "JSON の解析" アクション、つまり有効な JSON でない場合、フローは失敗します。

接続を作成する

このコネクタは、次の認証タイプをサポートしています:
既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

すべてのゲストを削除

チームからすべてのゲストを削除します
すべての承認を取得する

すべての承認を取得する
タグの値を取得する

グループのタグ値を取得します
タグ値の変更

特定のチームのタグの値を変更します
チームから非所有者をすべて削除する

所有者を除くすべてのメンバーをチームから削除します
チームのアーカイブ

チームをアーカイブ
チームを削除

チームを削除する
ユーザーをチームから削除する

チームからユーザーを削除する
ロールをメンバーに変更する

ユーザーのロールをチームのメンバーに変更する
ロールを所有者に変更する

チーム内のユーザーを所有者に昇格させます
所有者以外のすべてのユーザーを削除します

選択した 1 人の所有者を除くすべてのユーザーを削除します
承認​​

与えられた承認を承認します
拒否する

拒否する
有効期限の延長

グループの有効期限を延長します

すべてのゲストを削除

操作 ID:
RemoveGuests

チームからすべてのゲストを削除します

パラメーター

名前 キー 必須 型 説明
グループの ID
 Group-ID True string

グループの ID

すべての承認を取得する

操作 ID:
GetApprovals

すべての承認を取得する

戻り値

名前 パス 型 説明
array of object
id
 id string

id
userName
 userName string

userName
userId
 userId string

userId
createForExternalUser
 createForExternalUser boolean

createForExternalUser
externalUserId
 externalUserId string

externalUserId
reactingUserId
 reactingUserId string

reactingUserId
reactingUserName
 reactingUserName string

reactingUserName
requestTime
 requestTime string

requestTime
expirationDateTime
 expirationDateTime string

expirationDateTime
ステータス
 status integer

ステータス
groupName
 groupName string

groupName
groupDescription
 groupDescription string

groupDescription
reason
 reason string

reason
rejectReason
 rejectReason string

rejectReason
アクセス
 access boolean

アクセス
reactionTime
 reactionTime string

reactionTime
タイプ
 type string

タイプ
tid
 tid string

tid
templateId
 templateId string

templateId
attributeSettings
 attributeSettings array of object

attributeSettings
attributeId
 attributeSettings.attributeId string

attributeId
価値
 attributeSettings.value string

価値
タイプ
 attributeSettings.type integer

タイプ

タグの値を取得する

操作 ID:
GetTagValue

グループのタグ値を取得します

パラメーター

名前 キー 必須 型 説明
グループの ID
 Group-ID True string

グループの ID
タグの ID
 Tag-ID True string

タグの ID

戻り値

タグ値
string

タグ値の変更

操作 ID:
ChangeTagValue

特定のチームのタグの値を変更します

パラメーター

名前 キー 必須 型 説明
グループの ID
 Group-ID True string

グループの ID
Tag
 id string

id
価値
 value string

価値

チームから非所有者をすべて削除する

操作 ID:
RemoveAllUsersExeptOwners

所有者を除くすべてのメンバーをチームから削除します

パラメーター

名前 キー 必須 型 説明
グループの ID
 Group-ID True string

グループの ID

チームのアーカイブ

操作 ID:
ArchiveTeam

チームをアーカイブ

パラメーター

名前 キー 必須 型 説明
グループの ID
 Group-ID True string

グループの ID
チームメンバーの SharePoint サイトを読み取り専用にする
 sharePointReadOnly True boolean

sharePointReadOnly

チームを削除

操作 ID:
DeleteTeam

チームを削除する

パラメーター

名前 キー 必須 型 説明
グループの ID
 Group-ID True string

グループの ID

ユーザーをチームから削除する

操作 ID:
RemoveUser

チームからユーザーを削除する

パラメーター

名前 キー 必須 型 説明
グループの ID
 Group-ID True string

グループの ID
ユーザー Id
 userId string

userId

ロールをメンバーに変更する

操作 ID:
ChangeRoleToMember

ユーザーのロールをチームのメンバーに変更する

パラメーター

名前 キー 必須 型 説明
グループの ID
 Group-ID True string

グループの ID
ユーザー Id
 userId string

userId

ロールを所有者に変更する

操作 ID:
ChangeRoleToOwner

チーム内のユーザーを所有者に昇格させます

パラメーター

名前 キー 必須 型 説明
グループの ID
 Group-ID True string

グループの ID
ユーザー Id
 userId string

userId

所有者以外のすべてのユーザーを削除します

操作 ID:
RemoveAllUsersExceptOneOwner

選択した 1 人の所有者を除くすべてのユーザーを削除します

パラメーター

名前 キー 必須 型 説明
グループの ID
 Group-ID True string

グループの ID
所有者 ID
 ownerId string

ownerId

承認​​

操作 ID:
Approve

与えられた承認を承認します

パラメーター

名前 キー 必須 型 説明
承認の ID
 Approval-ID True string

承認の ID

拒否する

操作 ID:
Reject

拒否する

パラメーター

名前 キー 必須 型 説明
承認の ID
 Approval-ID True string

承認の ID

有効期限の延長

操作 ID:
ExtendExpirationDate

グループの有効期限を延長します

パラメーター

名前 キー 必須 型 説明
グループの ID
 Group-ID True string

グループの ID
週
 weeks string

週間

トリガー

Action-Trigger

Action-Trigger

Action-Trigger

操作 ID:
ActionTrigger

Action-Trigger

パラメーター

名前 キー 必須 型 説明
件名
 name True string

件名

戻り値

返答
object

定義

オブジェクト

’オブジェクト’ という種類です。

string

これは基本的なデータ型 '文字列' です。