Microsoft Teams -integraatio
Microsoft Teams -integraatio Microsoft Graph API -liittimellä
Microsoft Teams -integraatio
Microsoft Teams -integraatio Microsoft Graph API -liittimellä
Microsoft Teamsin integrointiominaisuudet sisältyvät Microsoft Graph API -liittimeen (aiemmin tunnettu nimellä Entra ID -liitin).
Microsoft Graph API -liittimen avulla olet pystynyt lukemaan tietoja Microsoft Teamsista. Versiosta 2025.2 alkaen voit myös suorittaa toimintoja Microsoft Teamsiin ja tehdä muutoksia Teams-ympäristössä. Yhdessä nämä ominaisuudet tuottavat konkreettista liiketoiminta-arvoa neljällä keskeisellä alueella:
Parannettu näkyvyys ja hallinta: Lähes reaaliaikainen pääsy Microsoft Teamsiin liittyviin tietoihin, kuten käyttäjiin, kanaviin ja tiimijäsenyyksiin.
Automaatio ja tehokkuus: Automatisoidut toiminnot vähentävät manuaalista työtä, nopeuttavat vasteaikoja ja virtaviivaistavat prosesseja.
Strateginen integraatio ja innovaatio: Saumaton integraatio muihin IT-järjestelmiin mahdollistaa edistyneen automaation, paremman hallinnon ja tukee laajempia digitaalisen transformaation aloitteita.
Microsoft Teams -integraatio voidaan rakentaa Microsoft Graph API -liittimellä .
Asiakkaan ohjeet löytyvät osoitteesta https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
Teams-integraatioon liittyvä Microsoft Graph API -dokumentaatio: https://learn.microsoft.com/en-us/graph/api/resources/teams-api-overview?view=graph-rest-1.0
Esimerkkejä Teamsin käyttötapauksista ovat
- Ilmoitusviestien lähettäminen Teamsiin
- Tiimien ja kanavien tietojen lukeminen ITSM:lle
- Tiimin jäsenyyden hallinta
- Tiimin elinkaaren hallinta
- Tiimin omistajuuden validointi
- Integrointi käyttäjän elinkaariprosesseihin
- Tapahtumalähtöinen tiimin luominen
Lue Microsoft Teams -tiimit
Azure -sovellusten käyttöoikeudet
Teams-tuontia varten Azure sovellus tarvitsee nämä käyttöoikeudet
Asiakkaan ohjeet löytyvät osoitteesta https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
| Käyttöoikeustyyppi | Käyttöoikeudet |
| Hakemus |
Group.Read.All, Team.ReadBasic.All ja (Kanava.LueBasic.All tai Kanava.Lue.All) |
Ajoitetun tehtävän kyselyt
Kysely: groups?$filter=resource Pro visioningOptions/Any(x:x eq 'Tiimi')
Alikyselyt:
joukkueet/{id}/kanavat
joukkueet/{id}/jäsenet
Ajoitetun tehtävän yhdistämismääritykset
Käytä aina yleistä mallia Teams-kartoitusten tyypeille:
| Ulkoinen ominaisuus | Paikallinen ominaisuus | Lisätietoja |
|---|---|---|
| tunnus | tiimin_tunnus | Tiimin yksilöllinen tunniste |
| näyttönimi | team_displayName | |
| kuvaus | tiimin_kuvaus | |
| näkyvyys | tiimin_näkyvyys | Julkinen vai yksityinen tiimi |
| teams/{id}/channels.id | kanavan_tunnus |
Tiimin kanavien tunnusten luettelo Tämän attribuutin on oltava moniarvoinen |
| teams/{id}/members.userId | tiimin_jäsenet |
Tiimin jäsenten tunnisteluettelo Tämän attribuutin on oltava moniarvoinen |
Avoin aihe: Olisiko parempi hakea myös kanavan tiedot (näyttönimi, kuvaus jne.) toiseen moniarvoiseen attribuuttiin tässä ajoitetussa tehtävässä, vai hakea nämä kanavat kanava kerrallaan työnkulun orkestrointisolmusta.
Tapahtumapohjaiset tehtävät (toiminnot) Microsoft-tiimeille ja -kanaville
Azure sovelluksen käyttöoikeudet
Teams-toimintoja varten Azure -sovellus tarvitsee käyttöoikeudet. Katso ohjeet oikeiden käyttöoikeuksien määrittämiseen osoitteista: 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-osoite voi olla tyhjä. Lopullinen kutsuttava URL-osoite muodostetaan yhdistämällä liittimen URL-osoite ja työnkulun solmun URL-osoite.
Tapahtumapohjaisten tehtävien yhdistämismääritykset
Tapahtumapohjaisen tehtävän otsikko
Ylimääräisiä otsikoita ei tarvitse asettaa, liittimien hallinta asettaa tämän automaattisesti:
| Sisältötyyppi | sovellus/json |
Työnkulun solmu
Valitse Työnkulun orkestrointi-solmussa seuraavat Orkestrointi-, Tietolähde- ja Aktiviteetti-kohdat:
Valitse tälle toiminnolle 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äille toimille.
Lähetä tekstiviestikommentti/ilmoitus tiimikanavalle
Toiminto : POST
URL -osoite: teams/{team-id}/channels/{channel-id}/messages
Esimerkki kehosta :
Hanki kanavan tiedot
Toiminto : GET
URL-osoite : teams/{team-id}/channels/{channel-id}
Runko: (ei mitään)
Työnkulussa jäsennä resultset json " REST response attribute" -attribuutista luodaksesi kanavan viitedatakortin.
Esimerkki palautetusta JSON-tulosjoukosta, kun {team-id} team sisältää 2 kanavaa:
Luo tiimi
Toiminto : POST
URL-osoite : teams
Esimerkki vartalosta:
Päivitä tiimi
Toiminto : PATCH
URL -osoite: teams/{team-id}
Esimerkki kehosta :
Arkistoi tiimi
Toiminto : POST
URL-osoite : teams/{id}/archive
Esimerkki tekstistä : {"shouldSetSpoSiteReadOnlyForMembers": true}
Lisää jäsen(iä) tiimiin
Toiminto : POST
URL-osoite : /teams/{tiimitunnus}/jäsenet
Esimerkki vartalosta:
Jäsenen poistaminen tiimistä
Toiminto : DELETE
URL-osoite : /teams/{tiimitunnus}/jäsenet/{jäsenyystunnus}
Runko : (ei mitään)
https://learn.microsoft.com/en-us/graph/api/team-delete-members?view=graph-rest-1.0&tabs=http
Microsoft-sovellusten käyttöoikeudet Teamsille ja kanaville
Lisää oikeat käyttöoikeudet käyttötapauksesi tarpeiden mukaan.
Käyttäjän laajuustyyppi Sovellus :
| Käyttö | Lupa | Muistiinpanoja |
|---|---|---|
| Tutustu tiimeihin | Team.ReadBasic.All | Listaa kaikki vuokraajan tiimit. |
| Hallinnoi tiimin asetuksia | TeamSettings.ReadWrite.All | Lue/päivitä tiimin asetuksia; ei tuettu henkilökohtaisille Microsoft-tileille. |
| Luo kanavia (mikä tahansa tiimi) | Kanava.Luo | Luo vakiomuotoisia/yksityisiä kanavia missä tahansa tiimissä. |
| Lue kanavia (metadata) | Kanava.Lue.Perus.Kaikki | Lue kanavaluetteloita ja perustietoja vuokralaisen kesken. |
| Lue kanavan asetukset | Kanava-asetukset.Lue.Kaikki | Lue kaikki kanavan ominaisuudet/asetukset. |
| Muokkaa kanavan asetuksia | Kanava-asetukset. Lue. Kirjoita. Kaikki | Muokkaa kanavan nimeä, kuvausta ja moderointiasetuksia. |
| Hallinnoi tiimin jäsenyyttä | TiiminMember.ReadWrite.All | Lisää/poista jäseniä ja muuta rooleja (vierailijan lisäämistä ei tueta). |
| Lue kanavan jäsenyystiedot | KanavanJäsen.Lue.Kaikki | Lue kaikkien tavallisten/yksityisten/jaettujen kanavien jäsenyystiedot. |
| Hallinnoi kanavajäsenyyksiä | KanavanMember.ReadWrite.All | Lisää/poista/päivitä jäseniä yksityisillä/jaetuilla kanavilla. |
| Lue kanavan viestit | Kanavaviesti.Luettu.Kaikki | Lue kaikkien vuokralaisen laajuiset kanavaviestit (vaatimustenmukaisuus/tarkastus). |
Tunnetut rajoitukset
Rajoitukset versiossa 2025.2 ja vanhemmissa versioissa
Suorituskykysyistä ei tueta useampaa kuin yhtä alikyselytasoa.
Useampaa kuin yhtä alikyselyä ei tueta.
Yhdistin ei vielä tue Teams-/kanavaobjektien poistamista Matrix42 Core , Pro tai IGA sta, kun objekti poistetaan Microsoft Teamsista.