Microsoft Graph obezbeđuje jedan objedinjeni API za pretragu celog sadržaja u SharePoint, OneDrive, Outlook i drugim Microsoft 365 uslugama. To menja način na koji pravimo SharePoint aplikacije.
Autor Simon Bisson
Uloga SharePoint-a kao sistema za upravljanje sadržajem preduzeća možda je staromodna, ali to ne znači da je platforma zabetonirana. Vremenom, Microsoft dodaje nove funkcije, a uklanja i proglašava zastarelim stare. Kompanija je čak počela da izdvaja SharePoint funkcije u zasebne aplikacije.
Kako SharePoint prelazi sa jednog načina rada na drugi, ove promene često zahtevaju od nas da ponovo napišemo i preradimo svoje aplikacije i kôd proširenja. SharePoint trenutno počinje jednu takvu tranziciju, udaljavajući se od sopstvenih API-ja za pretragu na novi model zasnovan na Microsoft Graph-u.
Na sreću, jedan od glavnih razloga za uspeh SharePoint-a je njegova prilagodljivost, podržana sopstvenim okvirom za proširivost i modelom programiranja koji se lako uči.
Zašto koristiti Microsoft Graph?
Iako ne postoji datum za kraj životnog veka postojećeg API-ja za pretragu, nova funkcionalnost će biti dostupna samo preko Microsoft Graph-a. Zato vredi da sada počnete da ponovo pišete kôd, posebno pošto je Microsoft Graph ključan za obezbeđivanje veze za Microsoft Copilot AI asistente za Microsoft 365. Ove promene se ne odnose samo na SharePoint, već i na OneDrive.
Kao deo ove promene, sve pretrage će ići kroz jedan API. To znači da će kôd koji napišete za SharePoint takođe funkcionisati sa drugim Microsoft 365 uslugama, uključujući Outlook, gde god postoji indeks pretrage. Korišćenje zajedničkog API-ja za pretragu za sav vaš Microsoft 365 sadržaj ima smisla, posebno sa Microsoft-ovim fokusom na AI, gde će taj sadržaj pružiti osnovu za generativnu veštačku inteligenciju i velike jezičke modele.
Uspostavljanjem zajedničkog API-ja za pretragu za sve Microsoft 365 usluge počinje davno zakasnelo udaljavanje od metafore o starenju foldera. Uz dobre mogućnosti pretraživanja i efikasno označavanje metapodataka, nema stvarne potrebe za veštačkom strukturom koja bi pomogla u navigaciji fajlovima. Umesto toga, informacije se isporučuju po potrebi iz jednog indeksa, obezbeđujući transparentan most među silosima aplikacija
Pretraživanje pomoću API-ja Microsoft Graph
API Microsoft Graph je tipičan REST API, koji koristi POST sa JSON korisnim opterećenjem. Svaki JSON korisni teret se sastoji od skupa zahteva koji se pokreću prema entitetu i koji sadrže upite. Upiti su stringovi i mogu se koristiti za opseg vaših zahteva. Tako možete da uključite određene SharePoint lokacije u svog zakupca ili da isključite delove svog zakupca koje ne želite da se pretražuju.
Postoje neki manji problemi koje treba uzeti u obzir prilikom pravljenja upita. Na primer, pošto je prodavnica OneDrive for Business zaista SharePoint entitet, ona mora da se postavlja drugačije od lične OneDrive prodavnice.
Kada izgradite svoj osnovni JSON upit, možete početi da precizirate njegov rad. Rezultate možete sortirati koristeći poznate tehnike paginacije, ili primere, i možete primeniti dodatne filtere, kao što je određeni vremenski prozor.
Imajte na umu da niste ograničeni na hijerarhijsku strukturu upita na grafikonu, jer možete kao deo vaših upita koristiti Microsoftov jezik upita ključnih reči (KQL – Microsoft’s Keyword Query Language). Upiti se zatim mogu agregirati, nudeći mogućnost da se konstruišu složeni upiti koji rade u različitim Microsoft 365 entitetima. Ovaj pristup vam omogućava da prikupite ne samo dokumente koji se odnose na upit, već i relevantne mejlove i liste ljudi.
Niste ograničeni ni na pretragu samo podataka Microsoft Graph-a. Ako koristite Graph konektor da povežete poslovne sisteme sa vašom Graph instancom, Graph pretrage mogu izdvojiti sve vrste podataka preduzeća—HR, ERP, CRM i još mnogo toga. Pored biblioteke unapred izgrađenih konektora, Microsoft obezbeđuje alate koje možete da koristite za pravljenje sopstvenih prilagođenih konektora za aplikacije po meri ili za rad sa zastarelim podacima u mejnfrejm računarima ili mini računarima.
Posmatrajte osnovni Microsoft Graph kao dinamičan, stalno ažuriran indeks vaših nerelacionih podataka. Čim se novi sadržaj skladišti u Microsoft 365 i na platformama kao što je SharePoint Online, taj indeks se automatski ažurira i čini vaš sadržaj dostupnim širom vašeg Microsoft 365 zakupca i dostupan svim vašim korisnicima.
Rad sa KQL-om u Microsoft Graph-u
Kada savladate osnovne upite, poželećete da pređete na naprednije načine rada sa Microsoft Graph-om. Ovde možete da iskoristite postojeće veštine koristeći jezik upita ključnih reči (koji ne treba mešati sa drugim Microsoft-ovim KQL-om, jezikom za upite velikih razmera, Kusto).
KQL vam omogućava da koristite slobodan tekst kao osnovu upita, tražeći reči ili fraze u sadržaju, uz podršku za jednostavne dopune džoker znacima. Pored pretraživanja teksta, KQL vam omogućava da koristite metapodatke dokumenta da biste ograničili pretragu na određene fajlove i autore. Možete da kombinujete i uparite ograničenja da biste napravili složenije upite, koristeći zagrade za grupisanje termina za pretragu gde ste u SQL-u ili sličnim jezicima upita možda koristili izraz AND.
Postoje neki KQL zahtevi koji u početku mogu izgledati zbunjujuće. Na primer, datumi i vremena treba da budu izraženi u ISO 8601 formatu, tako da koristite obrazac GGGG-MM-DD za datum i GGGG-MM-DDThh:mm:ss za datum i vreme (T se koristi kao graničnik između datuma i vremena). Postoji čak i opcija korišćenja relativnog vremena, tako da su „today“ i „this year“ važeći uslovi upita i daće različite rezultate kada se pokrenu različitim danima. Druge korisne opcije uključuju Bulove vrednosti, operatore blizine i operator ONEAR, koji za vraćanje rezultata koristi redosled termina.
Ako koristite KQL u Microsoft Graph upitima, dobro je da koristite KQL za pravljenje šablona upita. Oni vam daju gotov KQL upit, pa vam ostaje jedino da unesete svoj konkretan termin za pretragu. Ovo može biti posebno korisno ako programski konstruišete JSON korisni teret pretrage, koristite unapred napravljen upit i prosledite termin za pretragu kao string.
Jedan API za sva pretraživanja
Navikli smo da tretiramo SharePoint kao samostalnu alatku, ali to je sada jedna od osnovnih tehnologija za Microsoft 365 i za Power Platformu. Korišćenje Microsoft Graph-a za upite na celoj platformi je važna promena, ona koja ima za cilj da obuhvati celokupni radni rezultat za korisnika ili tim, kroz sve alate koji se koriste u svakodnevnom radu.
Postoji još jedan razlog za korišćenje jednog API-ja za pretragu: može pomoći da se osigura da ovlašćeni korisnici pristupaju kontrolisanim podacima. Omotavanje vaših Microsoft Graph upita u šemu za autentifikaciju zasnovanu na ulozi pomaže da se osigura da je pristup podacima kontrolisan i da korisnici mogu pristupiti samo podacima dozvoljenim za njihovu ulogu ili njihovu grupu.
S druge strane, ne postoji datum za kraj životnog veka starih SharePoint alatki za pretragu, tako da ste slobodni da ih i dalje koristite. Međutim, sada kada su Microsoftovi razvojni resursi fokusirani na Microsoft Graph, možete to iskoristiti kao priliku da počnete da prepravljate postojeće SharePoint aplikacije i proširenja, kao i da eksperimentišete sa mogućnostima Microsoft Graph-a za unakrsno povezane aplikacije.
Na kraju krajeva, imamo mnogo podataka uskladištenih u Microsoft Graph-u, pa zašto da ih ne koristimo. Pretraživanje u SharePoint-u, Outlook-u i OneDrive-u daje vam objedinjen pristup možda najvećoj bazi znanja vaše kompanije, omogućavajući vam da izvučete informacije i uvide koje inače ne biste pronašli. To bi bio najbolji razlog za promenu.
Izvor: InfoWorld