Freigeben über

Teams-Spirit (Vorschau)

Mit dem Teams-Spirit Connector können Sie Ihr Teams-Spirit-Abonnement mit Ihren Flüssen verbinden.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Immanuel Fuchs
URL https://teams-spirit.de/#kontakt
Email info@digitalteamwork.de
Connectormetadaten
Herausgeber D.F.K. Digitalteamwork GmbH
Webseite https://teams-spirit.de
Datenschutzrichtlinie https://teams-spirit.de/datenschutz/
Kategorien Kommunikation; Produktivität

Teams-Spirit Connector

Teams-Spirit stellt eine umfangreiche REST-API bereit. Mit dieser API können Sie Ihre Genehmigungen, Teams und Benutzer über Teams-Spirit verwalten.

Herausgeber: D.F.K. Digital Teamwork GmbH

Voraussetzungen

Sie benötigen Folgendes, um fortzufahren:

  • Ein Microsoft Power Apps- oder Power Automate-Plan mit benutzerdefiniertem Connectorfeature
  • Eine Teams-Spirit Azure AD Enterprise-Anwendung (in der Regel ist dies vorhanden, wenn Sie Teams-Spiritverwenden)
  • Ein Teams-Spirit-Abonnement
  • Die Power Platform CLI-Tools

Unterstützte Vorgänge

Der Connector stellt die folgenden Trigger bereit:

Action-Trigger

Kann über eine Teams-Spirit Aktion ausgelöst werden. Der Connector unterstützt die folgenden Vorgänge:

Abrufen aller Genehmigungen

Listet alle Genehmigungen auf

Billigt

Genehmigt eine Genehmigung

Ablehnen

Ablehnen einer Genehmigung

Team archiven

Archiviert ein Team und kennzeichnet optional die SharePoint-Gruppenwebsite als schreibgeschützt.

Team löschen

Löscht ein Team.

Rolle in Mitglied ändern

Ändert eine Benutzerrolle in ein Mitglied

Rolle in Besitzer ändern

Ändert die Rolle eines Benutzers an den Besitzer.

Alle Gäste entfernen

Entfernt alle Gäste aus einem Team.

Alle Benutzer mit Ausnahme des Besitzers entfernen

Entfernt alle Teammitglieder mit Ausnahme eines bestimmten Besitzers.

Benutzer aus Team entfernen

Entfernt einen Benutzer aus einem Team.

Tagwert ändern

Ändert den Wert eines Teams-Spirit-Tags.

Tagwert abrufen

Gibt den Wert eines Teams-Spirit-Tags zurück.

Ablaufdatum verlängern

Erweitert ein Ablaufdatum für Teams

Abrufen von Anmeldeinformationen

Der Teams-Spirit Connector verwendet OAuth2 für Azure Active Directory (AD). Dies ist die gleiche Authentifizierungsmethode, die von der Teams-Spirit-Anwendung selbst verwendet wird, und daher verfügt der Benutzer sowohl im Connector als auch in der App über die gleichen Berechtigungen.

Erste Schritte

Wenn ein Fluss durch eine Teams-Spirit Regel ausgelöst werden soll, können Sie einen neuen Fluss mit dem Aktionstrigger erstellen. Sobald Sie ihm einen Namen gegeben haben, wird er sich in Teams-Spirit registriert und steht im Regelmodul zur Verfügung. Sie können jeden Parameter, der in der Teams-Spirit Regel verfügbar ist, an den Fluss senden und verwenden, um Ihre Workflows weiter zu automatisieren.

Bereitstellungsanweisungen

Da die Teams-Spirit-API durch Azure Active Directory (AD) über OAuth2 gesichert ist, müssen wir zunächst einige Dinge in Azure AD einrichten, damit unsere Connectors sicher auf die API zugreifen können. Nachdem dies abgeschlossen ist, können Sie den Connector erstellen und testen.

Einrichten einer Azure AD-Anwendung für Ihren benutzerdefinierten Connector

Zunächst müssen wir unseren Connector als Anwendung in Azure AD registrieren. Dadurch kann sich der Connector selbst für Azure AD identifizieren, sodass er berechtigungen für den Zugriff auf Teams-Spirit Daten im Auftrag des Endbenutzers anfordern kann. Führen Sie die folgenden Schritte aus:

  1. Erstellen Sie eine Azure AD-Anwendung Diese Azure AD-Anwendung wird verwendet, um den Connector zu Teams Spirit zu identifizieren. Dazu können Sie [Azure-Portal] (https://portal.azure.com) verwenden, indem Sie die hier beschriebenen Schritte ausführen. Notieren Sie sich nach der Erstellung den Wert der Anwendungs-ID (Client-ID). Sie benötigen dies später.

  2. Konfigurieren (Aktualisieren) Sie Ihre Azure AD-Anwendung für den Zugriff auf die Teams-Spirit-API Dieser Schritt stellt sicher, dass Ihre Anwendung erfolgreich ein Zugriffstoken abrufen kann, um Teams-Spirit im Auftrag Ihrer Benutzer aufzurufen. Führen Sie dazu die hier beschriebenen Schritte aus.

    • Verwenden Sie für umleitungs-URI "https://global.consent.azure-apim.net/redirect"
    • Verwenden Sie für die Anmeldeinformationen einen geheimen Clientschlüssel (und keine Zertifikate). Denken Sie daran, den geheimen Schlüssel zu notieren, sie benötigen sie später, und sie wird nur einmal angezeigt.
    • Fügen Sie für API-Berechtigungen die Teams-Spirit access_as_user Berechtigung hinzu. Klicken Sie dazu auf Add a permission, navigieren Sie zu APIs my organization uses, suchen Sie nach Teams-Spirit, und fügen Sie die access_as_user Berechtigung hinzu.

An diesem Punkt verfügen wir jetzt über eine gültige Azure AD-Anwendung, die verwendet werden kann, um Berechtigungen von Endbenutzern zu erhalten und auf Teams Spirit zuzugreifen.

Bereitstellen des Connectors

Ersetzen Sie {clientId} zuerst die apiProperties.json Client-ID Ihrer Azure AD-Anwendungen.

Dies {resourceId} muss bei der Bereitstellung von benutzerdefinierten Connectors ersetzt api://app.teams-spirit.com/3a57026a-cf3f-4295-93f5-ca245af3d2df/access_as_user werden.

Führen Sie dann die folgenden Befehle aus, und folgen Sie den Eingabeaufforderungen:

paconn create --api-def apiDefinition.swagger.json --api-prop apiProperties.json --secret <client_secret>

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:
Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Ablaufdatum verlängern

Erweitert das Ablaufdatum der Gruppen
Ablehnen

Ablehnen
Abrufen aller Genehmigungen

Abrufen aller Genehmigungen
Alle Benutzer außer Besitzer entfernen

Entfernt alle Benutzer mit Ausnahme eines ausgewählten Besitzers.
Alle Gäste entfernen

Entfernt alle Gäste aus dem Team.
Benutzer aus Team entfernen

Entfernt einen Benutzer aus dem Team.
Entfernen aller Nichtbesitzer aus dem Team

Entfernt alle Mitglieder, die für Besitzer aus dem Team exept wurden.
Genehmigen

Genehmigt die angegebene Genehmigung.
Rolle in Besitzer ändern

Fördert einen Benutzer im Team zum Besitzer
Rolle in Mitglied ändern

Ändert eine Benutzerrolle in ein Mitglied im Team
Tagwert abrufen

Ruft einen Tags-Wert für eine Gruppe ab.
Tagwert ändern

Ändert den Wert eines Tags in einem bestimmten Team.
Team archiven

Archiviert das Team
Team löschen

Löscht das Team.

Ablaufdatum verlängern

Vorgangs-ID:
ExtendExpirationDate

Erweitert das Ablaufdatum der Gruppen

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID der Gruppe
 Group-ID True string

ID der Gruppe
Wochen
 weeks string

Wochen

Ablehnen

Vorgangs-ID:
Reject

Ablehnen

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID der Genehmigung
 Approval-ID True string

ID der Genehmigung

Abrufen aller Genehmigungen

Vorgangs-ID:
GetApprovals

Abrufen aller Genehmigungen

Gibt zurück

Name Pfad Typ Beschreibung
array of object
id
 id string

id
Nutzername
 userName string

Nutzername
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
 status integer

status
groupName
 groupName string

groupName
groupBeschreibung
 groupDescription string

groupBeschreibung
Grund
 reason string

Grund
rejectReason
 rejectReason string

rejectReason
Zugang
 access boolean

Zugang
reactionTime
 reactionTime string

reactionTime
type
 type string

type
tid
 tid string

tid
templateId
 templateId string

templateId
attributeSettings
 attributeSettings array of object

attributeSettings
attributeId
 attributeSettings.attributeId string

attributeId
value
 attributeSettings.value string

value
type
 attributeSettings.type integer

type

Alle Benutzer außer Besitzer entfernen

Vorgangs-ID:
RemoveAllUsersExceptOneOwner

Entfernt alle Benutzer mit Ausnahme eines ausgewählten Besitzers.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID der Gruppe
 Group-ID True string

ID der Gruppe
Inhaber-ID
 ownerId string

ownerId

Alle Gäste entfernen

Vorgangs-ID:
RemoveGuests

Entfernt alle Gäste aus dem Team.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID der Gruppe
 Group-ID True string

ID der Gruppe

Benutzer aus Team entfernen

Vorgangs-ID:
RemoveUser

Entfernt einen Benutzer aus dem Team.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID der Gruppe
 Group-ID True string

ID der Gruppe
Benutzer-ID
 userId string

userId

Entfernen aller Nichtbesitzer aus dem Team

Vorgangs-ID:
RemoveAllUsersExeptOwners

Entfernt alle Mitglieder, die für Besitzer aus dem Team exept wurden.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID der Gruppe
 Group-ID True string

ID der Gruppe

Genehmigen

Vorgangs-ID:
Approve

Genehmigt die angegebene Genehmigung.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID der Genehmigung
 Approval-ID True string

ID der Genehmigung

Rolle in Besitzer ändern

Vorgangs-ID:
ChangeRoleToOwner

Fördert einen Benutzer im Team zum Besitzer

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID der Gruppe
 Group-ID True string

ID der Gruppe
Benutzer-ID
 userId string

userId

Rolle in Mitglied ändern

Vorgangs-ID:
ChangeRoleToMember

Ändert eine Benutzerrolle in ein Mitglied im Team

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID der Gruppe
 Group-ID True string

ID der Gruppe
Benutzer-ID
 userId string

userId

Tagwert abrufen

Vorgangs-ID:
GetTagValue

Ruft einen Tags-Wert für eine Gruppe ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID der Gruppe
 Group-ID True string

ID der Gruppe
ID des Tags
 Tag-ID True string

ID des Tags

Gibt zurück

Tagwert
string

Tagwert ändern

Vorgangs-ID:
ChangeTagValue

Ändert den Wert eines Tags in einem bestimmten Team.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID der Gruppe
 Group-ID True string

ID der Gruppe
Tag
 id string

id
Wert
 value string

value

Team archiven

Vorgangs-ID:
ArchiveTeam

Archiviert das Team

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID der Gruppe
 Group-ID True string

ID der Gruppe
Festlegen einer schreibgeschützten SharePoint-Website für Teammitglieder
 sharePointReadOnly True boolean

sharePointReadOnly

Team löschen

Vorgangs-ID:
DeleteTeam

Löscht das Team.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
ID der Gruppe
 Group-ID True string

ID der Gruppe

Auslöser

Action-Trigger

Action-Trigger

Action-Trigger

Vorgangs-ID:
ActionTrigger

Action-Trigger

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Name
 name True string

Name

Gibt zurück

response
object

Definitionen

Objekt

Dies ist der Typ „Objekt“.

Schnur

Dies ist der grundlegende Datentyp "string".