Partager via

Teams-Spirit (préversion)

Le connecteur Teams-Spirit vous permet de connecter votre abonnement Teams-Spirit à vos flux.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Government
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC)
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Immanuel Fuchs
URL https://teams-spirit.de/#kontakt
Messagerie électronique info@digitalteamwork.de
Métadonnées du connecteur
Éditeur D.F.K. Digitalteamwork GmbH
Site internet https://teams-spirit.de
Politique de confidentialité https://teams-spirit.de/datenschutz/
Catégories Communication; Productivité

connecteur Teams-Spirit

Teams-Spirit fournit une API REST complète. À l’aide de cette API, vous pouvez gérer vos approbations, vos équipes et vos utilisateurs via Teams-Spirit.

Éditeur : D.F.K. Digital Teamwork GmbH

Prerequisites

Vous devez procéder comme suit :

  • Un plan Microsoft Power Apps ou Power Automate avec une fonctionnalité de connecteur personnalisée
  • Une application d’entreprise Azure AD Teams-Spirit (généralement, celle-ci sera présente si vous utilisez Teams-Spirit)
  • Un abonnement Teams-Spirit
  • Outils CLI de la plateforme Power

Opérations prises en charge

Le connecteur fournit les déclencheurs suivants :

Action-Trigger

Peut être déclenché via une action Teams-Spirit Le connecteur prend en charge les opérations suivantes :

Obtenir toutes les approbations

Répertorie toutes les approbations

Approuve

Approuve une approbation

Rejeter

Rejeter une approbation

Archiver l’équipe

Archive une équipe et marque éventuellement le site SharePoint en lecture seule

Supprimer l’équipe

Supprime une équipe

Modifier le rôle en membre

Modifie un rôle d’utilisateur en membre

Modifier le rôle en propriétaire

Modifie un rôle d’utilisateur en propriétaire

Supprimer tous les invités

Supprime tous les invités d’une équipe

Supprimer tous les utilisateurs à l’exception du propriétaire

Supprime tous les membres de l’équipe à l’exception d’un propriétaire donné

Supprimer l’utilisateur de l’équipe

Supprime un utilisateur d’une équipe

Modifier la valeur de l’étiquette

Modifie la valeur d’une balise Teams-Spirit

Obtenir la valeur d’étiquette

Retourne la valeur d’une balise Teams-Spirit

Étendre la date d’expiration

Étend une date d’expiration d’équipe

Obtention des informations d’identification

Le connecteur Teams-Spirit utilise OAuth2 sur Azure Active Directory (AD). Il s’agit de la même méthode d’authentification utilisée par l’application Teams-Spirit elle-même. Par conséquent, l’utilisateur aura les mêmes autorisations dans le connecteur et l’application.

Getting Started

Si vous souhaitez qu’un flux soit déclenché par une règle de Teams-Spirit, vous pouvez créer un flux avec le déclencheur d’action. Une fois que vous lui avez donné un nom, il s’inscrit dans Teams-Spirit et sera disponible dans le moteur de règle. Vous pouvez envoyer chaque paramètre disponible dans la règle de Teams-Spirit au flux et l’utiliser pour automatiser davantage vos flux de travail.

Instructions de déploiement

Étant donné que l’API Teams-Spirit est sécurisée par Azure Active Directory (AD) via OAuth2, nous devons d’abord configurer quelques éléments dans Azure AD afin que nos connecteurs puissent accéder en toute sécurité à l’API. Une fois cette opération terminée, vous pouvez créer et tester le connecteur.

Configurer une application Azure AD pour votre connecteur personnalisé

Nous devons d’abord inscrire notre connecteur en tant qu’application dans Azure AD. Cela permet au connecteur de s’identifier à Azure AD afin qu’il puisse demander des autorisations d’accès à Teams-Spirit données pour le compte de l’utilisateur final. Vous pouvez suivre les étapes ci-dessous :

  1. Créer une application Azure AD Cette application Azure AD sera utilisée pour identifier le connecteur à Teams-Spirit. Cette opération peut être effectuée à l’aide du [portail Azure] (https://portal.azure.com), en suivant les étapes ci-dessous. Une fois créé, notez la valeur de l’ID d’application (client). Vous en aurez besoin plus tard.

  2. Configurez (Mettre à jour) votre application Azure AD pour accéder à l’API Teams-Spirit Cette étape garantit que votre application peut récupérer un jeton d’accès pour appeler Teams-Spirit pour le compte de vos utilisateurs. Pour ce faire, suivez les étapes ci-dessous.

    • Pour l’URI de redirection, utilisez «https://global.consent.azure-apim.net/redirect »
    • Pour les informations d’identification, utilisez une clé secrète client (et non des certificats). N’oubliez pas de noter le secret vers le bas, vous en aurez besoin plus tard et il n’est affiché qu’une seule fois.
    • Pour les autorisations d’API, ajoutez l’autorisation access_as_user Teams-Spirit. Pour ce faire Add a permission, accédez à APIs my organization uses, recherchez Teams-Spirit et ajoutez l’autorisation access_as_user .

À ce stade, nous disposons désormais d’une application Azure AD valide qui peut être utilisée pour obtenir des autorisations auprès des utilisateurs finaux et accéder à Teams-Spirit.

Déploiement du connecteur

Commencez par remplacer {clientId} l’ID apiProperties.json client de vos applications Azure AD.

Le {resourceId} paramètre doit être remplacé api://app.teams-spirit.com/3a57026a-cf3f-4295-93f5-ca245af3d2df/access_as_user par le cas d’un déploiement de connecteur personnalisé.

Exécutez ensuite les commandes suivantes et suivez les invites :

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

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :
Par défaut Paramètres de création de connexion. Toutes les régions Non partageable

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Approuver

Approuve l’approbation donnée
Archiver l’équipe

Archives de l’équipe
Modifier la valeur de l’étiquette

Modifie la valeur d’une balise dans une équipe donnée
Modifier le rôle en membre

Modifie un rôle d’utilisateur en membre dans l’équipe
Modifier le rôle en propriétaire

Promeut un utilisateur dans l’équipe au propriétaire
Obtenir la valeur d’étiquette

Obtient une valeur Tags pour un groupe
Obtenir toutes les approbations

Obtenir toutes les approbations
Rejeter

Rejeter
Supprimer l’utilisateur de l’équipe

Supprime un utilisateur de l’équipe
Supprimer l’équipe

Supprime l’équipe
Supprimer tous les invités

Supprime tous les invités de l’équipe
Supprimer tous les non-propriétaires de l’équipe

Supprime tous les membres exéptistes pour les propriétaires de l’équipe
Supprimer tous les utilisateurs à l’exception du propriétaire

Supprime tous les utilisateurs à l’exception d’un propriétaire sélectionné
Étendre la date d’expiration

Étend la date d’expiration des groupes

Approuver

ID d’opération :
Approve

Approuve l’approbation donnée

Paramètres

Nom Clé Obligatoire Type Description
ID de l’approbation
 Approval-ID True string

ID de l’approbation

Archiver l’équipe

ID d’opération :
ArchiveTeam

Archives de l’équipe

Paramètres

Nom Clé Obligatoire Type Description
ID du groupe
 Group-ID True string

ID du groupe
Rendre le site SharePoint en lecture seule pour les membres de l’équipe
 sharePointReadOnly True boolean

sharePointReadOnly

Modifier la valeur de l’étiquette

ID d’opération :
ChangeTagValue

Modifie la valeur d’une balise dans une équipe donnée

Paramètres

Nom Clé Obligatoire Type Description
ID du groupe
 Group-ID True string

ID du groupe
Tag
 id string

pièce d'identité
Valeur
 value string

value

Modifier le rôle en membre

ID d’opération :
ChangeRoleToMember

Modifie un rôle d’utilisateur en membre dans l’équipe

Paramètres

Nom Clé Obligatoire Type Description
ID du groupe
 Group-ID True string

ID du groupe
Identifiant
 userId string

userId

Modifier le rôle en propriétaire

ID d’opération :
ChangeRoleToOwner

Promeut un utilisateur dans l’équipe au propriétaire

Paramètres

Nom Clé Obligatoire Type Description
ID du groupe
 Group-ID True string

ID du groupe
Identifiant
 userId string

userId

Obtenir la valeur d’étiquette

ID d’opération :
GetTagValue

Obtient une valeur Tags pour un groupe

Paramètres

Nom Clé Obligatoire Type Description
ID du groupe
 Group-ID True string

ID du groupe
ID de balise
 Tag-ID True string

ID de balise

Retours

Valeur de la balise
string

Obtenir toutes les approbations

ID d’opération :
GetApprovals

Obtenir toutes les approbations

Retours

Nom Chemin d’accès Type Description
array of object
pièce d'identité
 id string

pièce d'identité
nom d’utilisateur
 userName string

nom d’utilisateur
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
groupeDescription
 groupDescription string

groupeDescription
reason
 reason string

reason
rejectReason
 rejectReason string

rejectReason
accès
 access boolean

accès
reactionTime
 reactionTime string

reactionTime
type
 type string

type
tid
 tid string

tid
identifiant de modèle
 templateId string

identifiant de modèle
attributeSettings
 attributeSettings array of object

attributeSettings
attributeId
 attributeSettings.attributeId string

attributeId
value
 attributeSettings.value string

value
type
 attributeSettings.type integer

type

Rejeter

ID d’opération :
Reject

Rejeter

Paramètres

Nom Clé Obligatoire Type Description
ID de l’approbation
 Approval-ID True string

ID de l’approbation

Supprimer l’utilisateur de l’équipe

ID d’opération :
RemoveUser

Supprime un utilisateur de l’équipe

Paramètres

Nom Clé Obligatoire Type Description
ID du groupe
 Group-ID True string

ID du groupe
Identifiant
 userId string

userId

Supprimer l’équipe

ID d’opération :
DeleteTeam

Supprime l’équipe

Paramètres

Nom Clé Obligatoire Type Description
ID du groupe
 Group-ID True string

ID du groupe

Supprimer tous les invités

ID d’opération :
RemoveGuests

Supprime tous les invités de l’équipe

Paramètres

Nom Clé Obligatoire Type Description
ID du groupe
 Group-ID True string

ID du groupe

Supprimer tous les non-propriétaires de l’équipe

ID d’opération :
RemoveAllUsersExeptOwners

Supprime tous les membres exéptistes pour les propriétaires de l’équipe

Paramètres

Nom Clé Obligatoire Type Description
ID du groupe
 Group-ID True string

ID du groupe

Supprimer tous les utilisateurs à l’exception du propriétaire

ID d’opération :
RemoveAllUsersExceptOneOwner

Supprime tous les utilisateurs à l’exception d’un propriétaire sélectionné

Paramètres

Nom Clé Obligatoire Type Description
ID du groupe
 Group-ID True string

ID du groupe
ID du propriétaire
 ownerId string

ownerId

Étendre la date d’expiration

ID d’opération :
ExtendExpirationDate

Étend la date d’expiration des groupes

Paramètres

Nom Clé Obligatoire Type Description
ID du groupe
 Group-ID True string

ID du groupe
Semaines
 weeks string

Semaines

Déclencheurs

Action-Trigger

Action-Trigger

Action-Trigger

ID d’opération :
ActionTrigger

Action-Trigger

Paramètres

Nom Clé Obligatoire Type Description
Nom
 name True string

Nom

Retours

response
object

Définitions

objet

Il s’agit du type 'object'.

ficelle

Il s’agit du type de données de base « string ».