Delen via

Teams-Spirit (preview)

Met de Teams-Spirit Connector kunt u uw Teams-Spirit-abonnement verbinden met uw stromen.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logic-apps Standaard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure Government-regio's
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Premium Alle Power Apps-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC)
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contactpersoon
Naam Immanuel Fuchs
URL https://teams-spirit.de/#kontakt
E-mailen info@digitalteamwork.de
Connector-metagegevens
Uitgever D.F.K. Digitalteamwork GmbH
Webpagina https://teams-spirit.de
Privacybeleid https://teams-spirit.de/datenschutz/
Categorieën Communicatie; Productiviteit

Teams-Spirit-connector

Teams-Spirit biedt een uitgebreide REST API. Met deze API kunt u uw goedkeuringen, teams en gebruikers beheren via Teams-Spirit.

Uitgever: D.F.K. Digital Teamwork GmbH

Vereiste voorwaarden

U hebt het volgende nodig om door te gaan:

  • Een Microsoft Power Apps- of Power Automate-abonnement met aangepaste connectorfunctie
  • Een Teams-Spirit Azure AD-bedrijfstoepassing (meestal is dit aanwezig als u Teams-Spirit)
  • Een Teams-Spirit-abonnement
  • De CLI-hulpprogramma's voor Power Platform

Ondersteunde bewerkingen

De connector biedt de volgende triggers:

Action-Trigger

Kan worden geactiveerd via een Teams-Spirit Action De connector ondersteunt de volgende bewerkingen:

Alle goedkeuringen ophalen

Een lijst met alle goedkeuringen

Keurt

Hiermee wordt een goedkeuring goedgekeurd

Verwerpen

Een goedkeuring weigeren

Archiefteam

Een team archiveren en eventueel de SharePoint-site van de groepen markeren als alleen-lezen

Team verwijderen

Een team verwijderen

Rol wijzigen in lid

Een gebruikersrol wijzigen in lid

Rol wijzigen in eigenaar

Een gebruikersrol wijzigen in eigenaar

Alle gasten verwijderen

Verwijdert alle gasten uit een team

Alle gebruikers verwijderen behalve eigenaar

Verwijdert alle teamleden, met uitzondering van een bepaalde eigenaar

Gebruiker uit team verwijderen

Hiermee verwijdert u een gebruiker uit een team

Tagwaarde wijzigen

De waarde van een Teams-Spirit-tag wijzigen

Tagwaarde ophalen

Geeft als resultaat de waarde van een Teams-Spirit-tag

Vervaldatum verlengen

Breidt de vervaldatum van een teams uit

Referenties verkrijgen

De Teams-Spirit Connector maakt gebruik van OAuth2 voor Azure Active Directory (AD). Dit is dezelfde verificatiemethode die wordt gebruikt door de Teams-Spirit-toepassing zelf en daarom heeft de gebruiker dezelfde machtigingen in zowel de connector als de app.

Aan de slag komen

Als u wilt dat een stroom wordt geactiveerd door een Teams-Spirit-regel, kunt u een nieuwe stroom maken met de actietrigger. Zodra u deze een naam hebt gegeven, wordt deze geregistreerd in Teams-Spirit en is deze beschikbaar in de rule-engine. U kunt elke parameter die beschikbaar is in de Teams-Spirit-regel naar de stroom verzenden en deze gebruiken om uw werkstromen verder te automatiseren.

Implementatie-instructies

Omdat de Teams-Spirit-API wordt beveiligd door Azure Active Directory (AD) via OAuth2, moeten we eerst een aantal dingen instellen in Azure AD, zodat onze connectors veilig toegang hebben tot de API. Nadat dit is voltooid, kunt u de connector maken en testen.

Een Azure AD-toepassing instellen voor uw aangepaste connector

We moeten eerst onze connector registreren als een toepassing in Azure AD. Hierdoor kan de connector zichzelf identificeren bij Azure AD, zodat deze kan vragen om machtigingen voor toegang tot Teams-Spirit gegevens namens de eindgebruiker. U kunt de onderstaande stappen volgen:

  1. Maak een Azure AD-toepassing Deze Azure AD-toepassing wordt gebruikt om de connector te identificeren in Teams-Spirit. U kunt dit doen met behulp van [Azure Portal] (https://portal.azure.com), door de stappen hier uit te voeren. Noteer na het maken de waarde van de toepassings-id (client). U hebt dit later nodig.

  2. Configureer (update) uw Azure AD-toepassing voor toegang tot de Teams-Spirit-API. Deze stap zorgt ervoor dat uw toepassing een toegangstoken kan ophalen om Teams-Spirit namens uw gebruikers aan te roepen. Volg hier de stappen om dit te doen.

    • Gebruik voor omleidings-URI 'https://global.consent.azure-apim.net/redirect'
    • Gebruik voor de referenties een clientgeheim (en niet certificaten). Vergeet niet om het geheim op te merken. U hebt dit later nodig en wordt slechts één keer weergegeven.
    • Voor API-machtigingen voegt u de machtiging Teams-Spirit access_as_user toe. Als u dit wilt doen Add a permission, gaat u naar APIs my organization uses, zoekt u naar Teams-Spirit en voegt u de access_as_user machtiging toe.

Op dit moment hebben we nu een geldige Azure AD-toepassing die kan worden gebruikt om machtigingen te krijgen van eindgebruikers en toegang te krijgen tot Teams-Spirit.

De connector implementeren

{clientId} Vervang eerst de apiProperties.json client-id van uw Azure AD-toepassingen.

Deze {resourceId} wordt vervangen door api://app.teams-spirit.com/3a57026a-cf3f-4295-93f5-ca245af3d2df/access_as_user in het geval van implementatie van aangepaste connectors.

Voer vervolgens de volgende opdrachten uit en volg de aanwijzingen:

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

Een verbinding maken

De connector ondersteunt de volgende verificatietypen:
standaard Parameters voor het maken van verbinding. Alle regio's Niet deelbaar

Verstek

Van toepassing: Alle regio's

Parameters voor het maken van verbinding.

Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

Alle gasten verwijderen

Verwijdert alle gasten uit het team
Alle gebruikers verwijderen behalve eigenaar

Hiermee verwijdert u alle gebruikers behalve één geselecteerde eigenaar
Alle goedkeuringen ophalen

Alle goedkeuringen ophalen
Alle niet-eigenaren uit het team verwijderen

Hiermee verwijdert u alle leden die voor eigenaren zijn uit het team
Approve

Keurt de opgegeven goedkeuring goed
Archiefteam

Het team archiveren
Gebruiker verwijderen uit team

Hiermee verwijdert u een gebruiker uit het team
Rol wijzigen in Eigenaar

Bevordert een gebruiker in het team naar eigenaar
Rol wijzigen in lid

Een gebruikersrol wijzigen in lid in het team
Tagwaarde ophalen

Hiermee haalt u een tagswaarde voor een groep op
Tagwaarde wijzigen

De waarde van een tag in een bepaald team wijzigen
Team verwijderen

Hiermee verwijdert u het team
Vervaldatum verlengen

De vervaldatum van groepen uitbreiden
Verwerpen

Verwerpen

Alle gasten verwijderen

Bewerkings-id:
RemoveGuests

Verwijdert alle gasten uit het team

Parameters

Name Sleutel Vereist Type Description
Id van groep
 Group-ID True string

Id van groep

Alle gebruikers verwijderen behalve eigenaar

Bewerkings-id:
RemoveAllUsersExceptOneOwner

Hiermee verwijdert u alle gebruikers behalve één geselecteerde eigenaar

Parameters

Name Sleutel Vereist Type Description
Id van groep
 Group-ID True string

Id van groep
Eigenaar Id
 ownerId string

eigenaarId

Alle goedkeuringen ophalen

Bewerkings-id:
GetApprovals

Alle goedkeuringen ophalen

Retouren

Name Pad Type Description
array of object
identiteitskaart
 id string

identiteitskaart
gebruikersnaam
 userName string

gebruikersnaam
userId
 userId string

userId
createForExternalUser
 createForExternalUser boolean

createForExternalUser
externalUserId
 externalUserId string

externalUserId
reactingUserId
 reactingUserId string

reactingUserId
reactingUserName
 reactingUserName string

reactingUserName
requestTime
 requestTime string

requestTime
vervaldatumDatumTijd
 expirationDateTime string

vervaldatumDatumTijd
status
 status integer

status
groupName
 groupName string

groupName
groepBeschrijving
 groupDescription string

groepBeschrijving
reden
 reason string

reden
rejectReason
 rejectReason string

rejectReason
toegang
 access boolean

toegang
reactionTime
 reactionTime string

reactionTime
type
 type string

type
Tijd
 tid string

Tijd
templateId
 templateId string

templateId
attributeSettings
 attributeSettings array of object

attributeSettings
attributeId
 attributeSettings.attributeId string

attributeId
waarde
 attributeSettings.value string

waarde
type
 attributeSettings.type integer

type

Alle niet-eigenaren uit het team verwijderen

Bewerkings-id:
RemoveAllUsersExeptOwners

Hiermee verwijdert u alle leden die voor eigenaren zijn uit het team

Parameters

Name Sleutel Vereist Type Description
Id van groep
 Group-ID True string

Id van groep

Approve

Bewerkings-id:
Approve

Keurt de opgegeven goedkeuring goed

Parameters

Name Sleutel Vereist Type Description
Id van goedkeuring
 Approval-ID True string

Id van goedkeuring

Archiefteam

Bewerkings-id:
ArchiveTeam

Het team archiveren

Parameters

Name Sleutel Vereist Type Description
Id van groep
 Group-ID True string

Id van groep
De SharePoint-site alleen-lezen maken voor teamleden
 sharePointReadOnly True boolean

sharePointReadOnly

Gebruiker verwijderen uit team

Bewerkings-id:
RemoveUser

Hiermee verwijdert u een gebruiker uit het team

Parameters

Name Sleutel Vereist Type Description
Id van groep
 Group-ID True string

Id van groep
Gebruikersnaam
 userId string

userId

Rol wijzigen in Eigenaar

Bewerkings-id:
ChangeRoleToOwner

Bevordert een gebruiker in het team naar eigenaar

Parameters

Name Sleutel Vereist Type Description
Id van groep
 Group-ID True string

Id van groep
Gebruikersnaam
 userId string

userId

Rol wijzigen in lid

Bewerkings-id:
ChangeRoleToMember

Een gebruikersrol wijzigen in lid in het team

Parameters

Name Sleutel Vereist Type Description
Id van groep
 Group-ID True string

Id van groep
Gebruikersnaam
 userId string

userId

Tagwaarde ophalen

Bewerkings-id:
GetTagValue

Hiermee haalt u een tagswaarde voor een groep op

Parameters

Name Sleutel Vereist Type Description
Id van groep
 Group-ID True string

Id van groep
Id van tag
 Tag-ID True string

Id van tag

Retouren

Tagwaarde
string

Tagwaarde wijzigen

Bewerkings-id:
ChangeTagValue

De waarde van een tag in een bepaald team wijzigen

Parameters

Name Sleutel Vereist Type Description
Id van groep
 Group-ID True string

Id van groep
Tag
 id string

identiteitskaart
Waarde
 value string

waarde

Team verwijderen

Bewerkings-id:
DeleteTeam

Hiermee verwijdert u het team

Parameters

Name Sleutel Vereist Type Description
Id van groep
 Group-ID True string

Id van groep

Vervaldatum verlengen

Bewerkings-id:
ExtendExpirationDate

De vervaldatum van groepen uitbreiden

Parameters

Name Sleutel Vereist Type Description
Id van groep
 Group-ID True string

Id van groep
Weken
 weeks string

weken

Verwerpen

Bewerkings-id:
Reject

Verwerpen

Parameters

Name Sleutel Vereist Type Description
Id van goedkeuring
 Approval-ID True string

Id van goedkeuring

Triggers

Action-Trigger

Action-Trigger

Action-Trigger

Bewerkings-id:
ActionTrigger

Action-Trigger

Parameters

Name Sleutel Vereist Type Description
Naam
 name True string

Naam

Retouren

response
object

Definities

Voorwerp

Dit is het type 'object'.

touw

Dit is het basisgegevenstype 'tekenreeks'.