Tijekom proteklih nekoliko godina Microsoft je polako širio iskustvo “profila”. Nedavni dodatak potvrde i nagrade je ono što me potaknulo da osvježim sjećanje na /profil krajnja točka, pa pogledajmo dublje, hoćemo li.
Kao podsjetnik, svaki korisnik unutar grafikona predstavljen je ne samo svojim pridruženim korisničkim objektom, već i profil resurs, skup odnosa koji prikazuje dodatne metapodatke, kao što je skup projekata na kojima je korisnik radio, na primjer. Uz nedavni dodatak nagrade i potvrde odnosa, ne postoji manje od 20 takvih dodatnih skupova svojstava koji se mogu konfigurirati za svakog od vaših korisnika. Nepotrebno je reći da to nadilazi ono što smo navikli vidjeti u profilnim karticama za korisnike u raznim aplikacijama, iako nisu svi od 20 skupova odnosa trenutno izloženi u obliku korisničkog sučelja.
Da biste otkrili korisnički profil, možete iskoristiti /beta/users/id/profil krajnja točka. Ovdje valja navesti nekoliko važnih napomena. Prvo, nedostatak podrške za dopuštenja aplikacija je odmah vidljiv, što automatizaciju čini kompliciranijom. Što se tiče stvarno potrebnih dozvola, Korisnik.Pročitaj.Sve poslužit će za operacije čitanja, i User.ReadWrite.All za pisanje. Na kraju, sve krajnje točke i metode o kojima ovdje raspravljamo dostupne su samo pod /beta ogranak, koji nije službeno podržan.
Evo kako izgleda ogledni profil. Prilično dugo, čak i ako sve odbacimo @odata.kontekst svojstva!
GET https://graph.microsoft.com/beta/users/user@domain.com/profile
Također obratite pažnju na sažete/istaknute unose – oni odgovaraju (skupovima) svojstava koja se automatski popunjavaju na temelju podataka dostupnih unutar usluge, tako da ne počinjete ispočetka! Na primjer, odjeljak Računi bit će popunjen podacima iz Grapha, dok se podaci u polju Bilješke pojavljuju iz SharePoint Onlinea. Također možete primijetiti da je svako od ovih svojstava kolekcija, tj. može pohraniti više vrijednosti. Evo primjera za skup vrijednosti pod mojim elektronička pošta polje:
Invoke-MgGraphRequest -Uri "https://graph.microsoft.com/beta/users/user@domain.com/profile/emails" | select -ExpandProperty value | select type,address type address ---- ------- main user@domain.com work user+test@domain.com work user@tenant.onmicrosoft.com work webmaster@domain.com work postmaster@domain.com work hostmaster@domain.com
Budući da svako od izloženih svojstava predstavlja samostalni resurs, možete ih pojedinačno ispitivati prema njihovoj odgovarajućoj krajnjoj točki, kao što je /e-pošta u gornjem primjeru. Imajte na umu da korištenje $odaberi uz pokrivač /profil upit će vratiti sva svojstva.
Zanimljiv dio je naravno dodavanje stvari, pa da vidimo kako možemo dodati nekoliko nagrada na moj vlastiti korisnički profil. Moramo izdati POST zahtjev protiv /profil/nagrade endpoint, s JSON korisnim opterećenjem koje predstavlja personAward resurs. Za razliku od drugih Graph metoda, ne morate koristiti ISO-8601 format za datume. Evo primjera zahtjeva:
POST https://graph.microsoft.com/beta/me/profile/awards "description": "This award is given to exceptional technical community leaders who actively share their high quality, real world expertise with others.", "displayName": "MVP - Office 365", "issuedDate": "01 October 2014", "issuingAuthority": "Microsoft", "webUrl": "https://mvp.microsoft.com/"
Budući da smo ovaj put koristili /mi krajnju točku i nije navela vrijednost za dopuštena publika vlasništvo u našem zahtjevu, kasnije bi se mogao pojaviti problem: nitko osim mog vlastitog korisnika neće moći vidjeti ove podatke. To možemo ispraviti izdavanjem novog zahtjeva za KRPANJE dopuštena publika vrijednost. Kao što je gore spomenuto, svako od svojstava profila predstavlja zbirku, tako da u našem slučaju moramo također navesti pojedinačnu instancu dodjele ( id vrijednost prikazana gore) u PATCH:
PATCH https://graph.microsoft.com/beta/me/profile/awards/0066c42b-f467-4d41-93e1-8bc1e53b2983 "allowedAudiences": "organization"
A 204 Bez sadržaja odgovor signalizira uspješno izvršenje, što možemo potvrditi putem drugog GET zahtjeva, ako je potrebno.
Stvaranje a ovjera unos funkcionira uglavnom na isti način, s jedinom razlikom što je izloženo malo više svojstava. To uključuje CertificationIdjedinstveni identifikator koji predstavlja vašu postignutu certifikaciju, datum početka i završetka i issuingCompany (tj. PearsonVue u ime Microsofta). Evo primjera kako to konfigurirati u ime drugog korisnika (trebat će vam User.ReadWrite.All dopuštenja i Globalni administrator ili Administrator za osobe uloga):
POST https://graph.microsoft.com/beta/users/user@domain.com/profile/certifications "certificationId": "D725-3153", "issuedDate": "24 Jan 2012", "description": "This certification is granted to individuals that have completed the beta Office 365 exams", "displayName": "Microsoft® Certified IT Professional: Office 365 Charter Member", "thumbnailUrl": "https://learn.microsoft.com/en-us/media/learn/certification/badges/microsoft-certified-general-badge.svg?branch=main", "webUrl": "https://learn.microsoft.com/en-us/users/michev/credentials/certification-o-/nouid.1442?tab=credentials-tab", "allowedAudiences": "organization", "issuingAuthority": "Prometric", "issuingCompany": "Microsoft"
Nakon što konfigurirate željena svojstva profila, ona će odmah biti vidljiva ispod kartice profila korisnika i drugih iskustava. Dobra vijest je da ne morate raditi ništa drugo, nema potrebe da to radite ručno preslikajte polja na karticu profila ili slično. Snimka zaslona u nastavku pokazuje kako se Nagrade i certifikati odjeljak kartice profila izgleda ovako, a više primjera možete pronaći u službena dokumentacija.
Možete kliknuti na određeni certifikat ili unos nagrade kako biste donijeli njegov detaljan opis, datum izdavanja i poveznicu na stranicu izdavatelja, ako je primjenjivo. Do četiri “bedža” prikazana su na Pregled karticu s nedavnim postignućima (iz proteklih 30 dana) istaknutim na vrhu prikaza. Da biste dobili cijeli set, kliknite na Prikaži više nagrada i certifikata poveznica koja vas vodi do Kontakti karticu kartice profila i odgovarajući odjeljak u njoj.
Sada smo do sada govorili samo o konfiguraciji svojstava profila po korisniku. Budući da već imamo dostupne odgovarajuće Graph API metode, to naravno možemo učiniti skupno za sve naše korisnike ili automatizirati uvoz relevantnih podataka iz vanjskog sustava. Microsoft zapravo nudi takvo rješenje u obliku Credly konektor za Copilot, jer naravno nijedna automatizacija nije moguća bez AI/Copilot.
Ono što Microsoft ne nudi je način na koji krajnji korisnici mogu unijeti vlastite podatke (pod pretpostavkom da ne idu Graphovim putem, to jest). Iskustvo kartice profila ne dopušta korisnicima upravljanje nagradama i certifikatima, a isto vrijedi i za sve druge “ulazne točke” koje krajnji korisnik može iskoristiti. Što se krajnjih korisnika tiče, ovo je iskustvo samo za čitanje, što pak malo umanjuje njegovu vrijednost.
Još jedna stvar prije nego što zatvorimo članak. Možda ćete primijetiti da većinu vremena, createdBy i lastModifiedBy svi imaju nulte vrijednosti u mnogim podržanim svojstvima profila. To je više-manje očekivano i ne biste se trebali oslanjati na ova polja u bilo kojoj vrsti scenarija istrage/revizije. U najboljem slučaju, možete iskoristiti izvor imovine i izvori GUID za savjet o tome odakle podaci potječu, pogledajte ovaj stol.