Microsoft Teams -integraatio
Microsoft Teams integration with Microsoft Graph API connector
Microsoft Teams -integraatio
Microsoft Teams integration with Microsoft Graph API connector
Microsoft Teams -integraation ominaisuudet sisältyvät Microsoft Graph API -liittimeen (aiemmin tunnettu nimellä Entra ID -liitin).
Microsoft Graph API -liittimen avulla on ollut mahdollista lukea tietoa Microsoft Teamsista. Versiosta 2025.2 alkaen voit myös suorittaa toimintoja Microsoft Teamsia kohti ja tehdä muutoksia Microsoft Teams -ympäristössä. Yhdessä nämä ominaisuudet tuottavat konkreettista liiketoiminta-arvoa neljällä keskeisellä osa-alueella:
Parempi näkyvyys ja hallinta: Lähes reaaliaikainen pääsy Microsoft Teams -tietoihin, kuten käyttäjiin, kanaviin ja tiimien jäsenyyksiin.
Automaatio ja tehokkuus: Automatisoidut toiminnot vähentävät manuaalista työtä, nopeuttavat vasteaikoja ja tehostavat prosesseja.
Strateginen integraatio ja innovointi: Saumaton integraatio muiden IT-järjestelmien kanssa mahdollistaa kehittyneen automaation, parantaa hallintaa ja tukee laajempia digitaalisen muutoksen hankkeita.
Microsoft Teams -integraatio voidaan toteuttaa käyttäen Microsoft Graph API Connector -liitintä.
Asiakasohjeet löytyvät osoitteesta https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
Microsoft Graph API -dokumentaatio Teams-integraatioon liittyen: https://learn.microsoft.com/en-us/graph/api/resources/teams-api-overview?view=graph-rest-1.0
Esimerkkejä Teamsin käyttötapauksista ovat
- Teams-tiimien ja kanavien tietojen lukeminen
- Tiimin jäsenyyksien hallinta
- Tiimin elinkaaren hallinta
- Tiimin omistajuuden vahvistaminen
- Integrointi käyttäjän elinkaariprosesseihin
- Tapahtumapohjainen tiimin luonti
- Tapahtumapohjainen kanavan luonti
Microsoft Teams -tiimien lukeminen
Azure-sovelluksen käyttöoikeudet
Teams-tuontia varten Azuren sovellus tarvitsee seuraavat käyttöoikeudet
Asiakasohjeet löytyvät osoitteesta https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
| Käyttöoikeustyyppi | Käyttöoikeudet |
| Application |
Group.Read.All, Team.ReadBasic.All ja (Channel.ReadBasic.All tai Channel.Read.All) |
Kyselyt ajastettua tehtävää varten
Kysely: groups?$filter=resourceProvisioningOptions/Any(x:x eq 'Team')
Alikyselyt:
teams/{id}/channels
teams/{id}/members
Kartoitukset ajastettua tehtävää varten
Käytä aina Generic Template -mallia Teams-kartoitustyyppinä:
| Ulkoinen attribuutti | Paikallinen attribuutti | Lisätietoja |
|---|---|---|
| id | team_id | Tiimin yksilöllinen tunniste |
| displayName | team_displayName | |
| description | team_description | |
| visibility | team_visibility | Julkinen tai yksityinen tiimi |
| teams/{id}/channels.id | channel_id |
Luettelo tiimin kanavien tunnisteista Tämän attribuutin on oltava monikko-arvoinen |
| teams/{id}/members.userId | team_members |
Luettelo tiimin jäsenten tunnisteista Tämän attribuutin on oltava monikko-arvoinen |
Avoin kysymys: Olisiko parempi hakea myös kanavan tiedot (displayName, description jne.) toiseen monikko-arvoiseen attribuuttiin tässä ajastetussa tehtävässä, vai hakea ne kanava kerrallaan työnkulun Orchestration-solmusta?
Tapahtumapohjaiset tehtävät (toiminnot) Microsoft Teams -tiimeille ja kanaville
Azure application permissions
Teams-toimintoja varten Azuren sovellus tarvitsee käyttöoikeuksia. Oikeiden käyttöoikeuksien määrittämiseksi katso: https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id ja https://learn.microsoft.com/en-us/graph/permissions-reference
Tapahtumapohjainen tehtävä
Tapahtumapohjaisen tehtävän URL voi olla tyhjä. Lopullinen kutsuttava URL muodostetaan yhdistämällä liittimen URL ja työnkulkusolmun URL.
Kartoitukset tapahtumapohjaiselle tehtävälle
Otsikko tapahtumapohjaiselle tehtävälle
Ylimääräisiä otsikoita ei tarvitse asettaa, Connector management asettaa tämän automaattisesti:
| Content-type | application/json |
Työnkulkusolmu
Valitse Workflow Orchestration -solmussa seuraavat: Orchestrate, Data Source ja Activity:
Valitse tätä toimintoa varten luomasi tapahtumapohjainen tehtävä. Voit myös käyttää yhtä tapahtumapohjaista tehtävää useille toiminnoille.
Useimmat näistä toiminnoista käyttävät HTTP-metodia POST. Muista asettaa oikea metodi Workflow Orchestration -solmulle näitä toimintoja varten.
Kanavan tietojen hakeminen
Toiminto: GET
URL: teams/{team-id}/channels/{channel-id}
Body: (none)
Jäsennä työnkulussa palautettu JSON-tulos "REST response attribute" -attribuutista luodaksesi kanavan viittausdatakortin.
Esimerkki palautetusta JSON-tuloksesta, kun {team-id}-tiimissä on 2 kanavaa:
Tiimin luominen
Toiminto: POST
URL: teams
Esimerkki sisällöstä:
Tiimin päivittäminen
Toiminto: PATCH
URL: teams/{team-id}
Esimerkki sisällöstä:
Tiimin arkistointi
Toiminto: POST
URL: teams/{id}/archive
Esimerkki sisällöstä: {"shouldSetSpoSiteReadOnlyForMembers": true}
Jäsenen/jäsenten lisääminen tiimiin
Toiminto: POST
URL: /teams/{team-id}/members
Esimerkki sisällöstä:
Jäsenen poistaminen tiimistä
Toiminto: DELETE
URL: /teams/{team-id}/members/{membership-id}
Sisältö: (none)
https://learn.microsoft.com/en-us/graph/api/team-delete-members?view=graph-rest-1.0&tabs=http
Microsoftin sovellusoikeudet Teamsille ja kanaville
Lisää oikeat käyttöoikeudet käyttötapauksesi tarpeen mukaan.
Käyttäjän laajuustyyppi Application:
| Toiminto | Tyyppi | Käyttöoikeus | Huomiot |
|---|---|---|---|
| Tiimien löytäminen | Application | Team.ReadBasic.All | Luettelee kaikki vuokraajan (tenant) tiimit. |
| Tiimin asetusten hallinta | Application | TeamSettings.ReadWrite.All |
Tiimin asetusten luku/päivitys; ei tueta henkilökohtaisille Microsoft-tileille. |
| Kanavien luominen (mikä tahansa tiimi) | Application | Channel.Create |
Vakio-/yksityisten kanavien luominen missä tahansa tiimissä. |
| Kanavien lukeminen (metatiedot) | Application | Channel.ReadBasic.All |
Kanavaluetteloiden ja perustietojen lukeminen koko vuokraajassa. |
| Kanava-asetusten lukeminen | Application | ChannelSettings.Read.All | Kaikkien kanavan ominaisuuksien/asetusten lukeminen. |
| Kanava-asetusten muokkaaminen | Application | ChannelSettings.ReadWrite.All |
Kanavan nimen, kuvauksen ja moderointiasetusten muokkaaminen. |
| Tiimin jäsenyyden hallinta | Application | TeamMember.ReadWrite.All |
Jäsenten lisääminen/poistaminen ja roolien vaihtaminen (vierailijan lisäys ei tuettu). |
| Kanavan jäsenyyden lukeminen | Application | ChannelMember.Read.All |
Kaikkien vakio-/yksityisten/ jaettujen kanavien jäsenyyden lukeminen. |
| Kanavan jäsenyyden hallinta | Application | ChannelMember.ReadWrite.All |
Jäsenten lisääminen/poistaminen/päivittäminen yksityisissä/jaetuissa kanavissa. |
| Kanavaviestien lukeminen | Application | ChannelMessage.Read.All |
Kaikkien kanavaviestien lukeminen koko vuokraajassa (vaatimustenmukaisuus/auditointi). |
Tunnetut rajoitukset
Rajoitukset versiossa 2025.2 ja vanhemmissa
Yli yhden tason alikyselyjä ei tueta suorituskykysyistä.
Useampaa kuin yhtä alikyselyä ei tueta.
Liitin ei vielä tue Teams-/kanavaobjektien merkitsemistä poistetuiksi Matrix42 Core-, Pro- ja IGA-järjestelmässä, kun objekti poistetaan Microsoft Teamsista.
Vianmääritys
- Jos käytössä on virhemalli (failure template), tarkista virhetiedot oikealta datakortilta
- Tarkista ajastetun tehtävän historia Connector managementista
- Tarkista Matrix42 Native Connectors -lokit, jotka löytyvät Connectors-välilehdeltä, Logs-osiosta
- Tarkista usein kysytyt kysymykset -dokumentit
Table of Contents