Tartalom indexelése a SharePointból a Microsoft 365-ben (előzetes verzió)

A Microsoft 365 SharePoint-indexelője (előzetes verzió) dokumentumokat importál a SharePoint dokumentumtáraiból, és kereshetővé teszi azokat az Azure AI Keresésben. A konfigurációs lépések az elsők, amelyeket viselkedések és forgatókönyvek követnek.

A Azure AI Keresés egy indexelő kinyeri a kereshető adatokat és metaadatokat egy adatforrásból. A Microsoft 365 SharePoint-indexelő a következő funkciókat biztosítja:

• Egy vagy több dokumentumtár fájljait és metaadatait indexeli.
• Indexeli a SharePoint-listákat és azok elemmezőinek értékeit, és az egyes listaoszlopok forrásmezőként érhetők el a mezőleképezéshez. Ez a funkció előzetes verzióban érhető el, a 2026-05-01-es verziójú REST API-tól kezdve.
• Indexeli az ASPX-webhelylapokat (modern webhelylapok). Ez a funkció előzetes verzióban érhető el, a 2026-05-01-es verziójú REST API-tól kezdve.
• A vegyes SharePoint tartalmakat (dokumentumtárakat, listákat és webhelylapokat) egyetlen indexelőben indexeli a allSiteContent tárolóérték használatával. Ez a funkció előzetes verzióban érhető el, a 2026-05-01-es verziójú REST API-tól kezdve.
• Indexeli a tartalmat az alwebhelyeken keresztül, ha a(z) includeSubsites=true be van állítva az adatforrás lekérdezésében. Ez a funkció előzetes verzióban érhető el, a 2026-05-01-es verziójú REST API-tól kezdve.
• Növekményes indexelés, csak az új és módosított fájlok, listaelemek, lapok és metaadatok felvétele.
• Automatikusan észleli a törölt tartalmat. A következő indexelő futtatásakor a rendszer törli a fájlokat, listaelemeket vagy lapokat, és eltávolítja a megfelelő keresési dokumentumot az indexből.
• Automatikusan kinyeri a szöveget és a normalizált képeket az indexelt dokumentumokból. Igény szerint hozzáadhat egy készségkészletet a mélyebb AI-bővítéshez, például optikai karakterfelismeréshez (OCR) vagy entitásfelismeréshez.
• Támogatja a dokumentum alapszintű hozzáférés-vezérlési listák (ACL) előzetes verzióban való betöltését . A 2026-05-01 előzetes verziótól kezdve az ACL módosításait a rendszer növekményesen észleli és frissíti minden sikeres indexelőn az egyedi engedélyekkel rendelkező elemek esetében. Ez a kiadás kiterjeszti az ACL-betöltési műveletet az elemek, az ASPX-webhelylapok és SharePoint csoportok listájára is. A korlátozásokkal és a konfigurációs lépésekkel kapcsolatban lásd: A SharePoint indexelő használata az engedély metaadatainak betöltéséhez.
• Támogatja a Microsoft Purview bizalmassági címkék integrálását és érvényesítését lekérdezéskor. Ez a funkció előzetes verzióban érhető el.

Előfeltételek

• Töltse ki az indexelő előzetes regisztrációs űrlapot. A regisztráció automatikusan jóváhagyásra kerül.

• Azure AI Keresés, alapszintű tarifacsomag vagy magasabb.

• SharePoint Microsoft 365 felhőszolgáltatásban (OneDrive nem támogatott adatforrás).

• Dokumentumtárban lévő fájlok.

• Visual Studio Code a REST ügyfélbővítménnyel az indexelő folyamat beállításához és futtatásához.

Az engedélyek beállításának kiválasztása

Mielőtt létrehozza az alkalmazásregisztrációt a 3. lépésben, azonosítsa a forgatókönyvet az alábbi táblázatban. Figyelje meg a szükséges Microsoft Graph engedélyeket, SharePoint API-engedélyeket és hitelesítő adatokat. Ezután kövesse a jelen cikk későbbi, csatolt lépéseit az alkalmazásukhoz.

Az engedélyek beállításakor vegye figyelembe a következő információkat:

• A delegált engedélyek csak kis teszteléshez használhatók, és nem támogatják az ACL-betöltést.
• A föderált hitelesítő adat az ajánlott, titok nélküli hitelesítési módszer. Magában foglalja mind az indexelő hitelesítését, mind a SharePoint-csoportok lekérdezéskori feloldását.
• Ha a(z) Sites.Selected használja, az indexelés előtt adjon az alkalmazásnak kifejezett hozzáférést minden cél SharePoint-helyhez. Az Microsoft Entra ID rendszergazdai hozzájárulása Sites.Selected önmagában nem engedélyezi az alkalmazás számára a webhelytartalom elérését. Az egyes célwebhelyekhez is hozzá kell rendelnie egy engedélyt. Ha explicit helyengedély megadása nélkül ad hozzá webhelyet az adatforráshoz, az indexelő sikertelen lesz. Lásd: Webhelyhozzáférés engedélyezése a használat során Sites.Selected.

Támogatott dokumentumformátumok

A Microsoft 365 indexelő SharePoint a következő dokumentumformátumokból nyerhet ki szöveget:

• CSV (lásd : CSV-blobok indexelése)
• EML
• EPUB
• GZ
• HTML
• JSON (lásd : JSON-blobok indexelése)
• KML (XML földrajzi ábrázolásokhoz)
• Markdown
• Microsoft Office formátumok: DOCX/DOC/DOCM, XLSX/XLS/XLSM, PPTX/PPT/PPTM, MSG (Outlook e-mailek), XML (2003 és 2006 WORD XML)
• Dokumentumformátumok megnyitása: ODT, ODS, ODP
• PDF
• Egyszerű szöveges fájlok (lásd még : Egyszerű szöveg indexelése)
• RTF
• XML
• ZIP

Korlátozások és szempontok

A funkció korlátai a következők:

• OneNote jegyzetfüzetfájlok nem támogatottak.

• Növekményes indexelési korlátozások:

  • A SharePoint mappa átnevezése megszakítja a növekményes indexelést. Az átnevezett mappa új tartalomként lesz kezelve.

  • Microsoft 365 SharePoint fájlrendszer metaadatait frissítő folyamatok növekményes indexelést válthatnak ki, még akkor is, ha más tartalommódosítás nem történt. Tesztelje a beállítást, mielőtt az indexelőre vagy az AI-bővítésre támaszkodik. Ellenőrizze, hogy Microsoft 365 hogyan dolgozza fel a dokumentumokat.

• Biztonsági korlátozások:

  • A privát végpontok nem támogatottak. A biztonságos hálózati konfigurációt tűzfalon keresztül kell engedélyezni.

  • A Microsoft Entra ID feltételes hozzáféréssel rendelkező bérlők nem támogatottak.

  • A felhasználó által titkosított fájlok és a jelszóval védett ZIP-fájlok nem támogatottak. A titkosított tartalom azonban akkor engedélyezett, ha Microsoft Purview bizalmassági címkék védik és ha a konfiguráció a címkék (előzetes verzió) megőrzésére és tiszteletére engedélyezve van.

  • A dokumentumszintű hozzáférési engedélyek korlátozott támogatása. Az ACL-szinkronizálás alapszintű verziója jelenleg előzetes verzióban érhető el. Részletekért és beállításért tekintse meg a SharePoint ACL konfigurációs dokumentációját. A forgatókönyvenkénti szükséges engedélyekért lásd : Az engedélyek beállításának kiválasztása.

A funkció használatakor az alábbi szempontokat érdemes figyelembe venni:

• A SharePoint adatokkal Azure AI Keresés használatával interakcióba lépő egyéni Copilot vagy lekéréssel bővített generációs (RAG) alkalmazás létrehozásához a Microsoft a remote SharePoint tudásbázis használatát javasolja. Ez a tudásbázis a Copilot Retrieveal API használatával közvetlenül a Microsoft 365 SharePoint szöveges tartalmait kérdezi le, és az eredményeket az ügynöki lekérési motornak adja vissza az egyesítéshez, a rangsoroláshoz és a válaszkészítéshez. Ez a tudásbázis nem használ keresési indexet, és csak szöveges tartalmakat kérdez le. Azure AI Keresés nem replikál adatokat. A SharePoint engedélymodellt úgy kényszeríti ki, hogy csak azokat az eredményeket adja vissza, amelyeket az egyes felhasználók láthatnak.

• Ha egyéni Copilot/RAG-alkalmazást vagy AI-ügynököt kell létrehoznia ahhoz, hogy SharePoint adatokkal csevegjen éles környezetben, érdemes lehet közvetlenül Microsoft Copilot Studio keresztül létrehozni. Ha Copilot Studio nem felel meg az igényeinek, fontolja meg a következő szempontokat:

  • Egyéni összekötő létrehozása SharePoint webhookokkal a Microsoft Graph API meghívásával exportálhat adatokat egy Azure Blob-tárolóba, majd a Azure blobindexelőt használva a növekményes indexeléshez.

  • Saját Azure Logic Apps munkafolyamat létrehozása, amely a Azure Logic Apps SharePoint összekötőt és a Azure AI Keresés összekötőt használja. Az Azure AI Keresés-összekötő az általános rendelkezésre állás elérése után érhető el. Használja a Azure portál varázsló által létrehozott munkafolyamatot kiindulási pontként, majd szabja testre a Azure Logic Apps tervezőben a szükséges átalakítási lépések hozzáadásához. Az Azure AI Keresés varázsló által létrehozott munkafolyamat egy felhasználási munkafolyamat. Éles számítási feladatok esetén váltson egy standard logikai alkalmazás munkafolyamatára a további nagyvállalati funkciók használatához.

A választott megközelítéstől függetlenül, függetlenül attól, hogy egyéni összekötőt hoz létre SharePoint webhookokkal, vagy Azure Logic Apps munkafolyamatot hoz létre, mindenképpen alkalmazzon robusztus biztonsági intézkedéseket. Ezek a mértékek közé tartozik a megosztott privát hivatkozások konfigurálása, a tűzfalak beállítása, a felhasználói engedélyek megőrzése a forrásból, valamint az engedélyek tiszteletben helyezése a lekérdezési időpontban. Emellett rendszeresen ellenőriznie és figyelnie kell a folyamatláncot.

Ha indexeli SharePoint ACL-eket, tekintse át a támogatott csoportkapcsolatokat. A SharePoint-csoportokba beágyazott Microsoft Entra-csoportok nem lesznek kibővítve.

A SharePoint konfigurálása Microsoft 365 indexelőben

Az SharePoint Microsoft 365 indexelőben való beállításához használjon egy előzetes REST API-t. Ez a szakasz ismerteti a lépéseket.

(Nem kötelező) 1. lépés: Rendszer által hozzárendelt felügyelt identitás engedélyezése

Engedélyezze a rendszer által hozzárendelt felügyelt identitást, hogy automatikusan észlelje azt a Microsoft Entra-bérlőt, amelyben a keresési szolgáltatás ki van építve.

Ezt a lépést akkor hajtsa végre, ha a SharePoint webhely és keresési szolgáltatás ugyanabban a Microsoft Entra bérlőben található. Hagyja ki ezt a lépést, ha különböző Microsoft Entra bérlőkben vannak. Az identitás a bérlőészleléshez használatos. Ezt a lépést akkor is kihagyhatja, ha a Microsoft Entra bérlőazonosítóját a kapcsolati karakterlánc szeretné elhelyezni. Ha rendszer által hozzárendelt vagy felhasználó által hozzárendelt felügyelt identitást szeretne használni a titkos indexeléshez, konfigurálja az alkalmazásengedélyeket titkos hitelesítéssel.

A Mentés lehetőség kiválasztása után megkapja a keresési szolgáltatáshoz rendelt objektumazonosítót.

2. lépés: Annak eldöntése, hogy az indexelő milyen engedélyeket igényel

Az ACL-t és a nem ACL-forgatókönyveket lefedő döntési mátrixot az engedélyek beállításának kiválasztása című témakörben találhatja meg. Ha delegált engedélyeket választ, a felhasználó által delegált jogkivonatok 75 percenként lejárnak, és a lejáratukkor manuális indexelést igényelnek az Indexelő futtatása (előzetes verzió) használatával. A delegált engedélyek csak kis tesztelési műveletekhez ajánlottak.

3. lépés: Microsoft Entra alkalmazásregisztráció létrehozása

A Microsoft 365 indexelő SharePoint egy Microsoft Entra alkalmazást használ a hitelesítéshez. Az engedélyeinek és hitelesítő adatainak konfigurálása előtt hozza létre az alkalmazásregisztrációt.

1. Jelentkezzen be a Azure portálra.

2. Keresse meg vagy navigáljon ide: Microsoft Entra ID.

3. Az Áttekintés lapon válassza az +Alkalmazásregisztráció>.

   1. Adja meg az alkalmazás nevét.
   2. Csak egyetlen bérlő kiválasztása – bérlő neve.
   3. Hagyja ki az URI-kijelölési lépést. Nincs szükség átirányítási URI-ra.
   4. Válassza a Regisztráció lehetőséget.

4. A bal oldali panelen válassza azAPI-engedélyek> lehetőséget.

5. Válassza a + Engedély hozzáadása, majd a Microsoft Graph lehetőséget.

   • Ha az indexelő alkalmazás API-engedélyeket használ, válassza az Alkalmazásengedélyek lehetőséget.

     • A standard indexeléshez válassza a következőt:

       • Files.Read.All
       • Sites.Read.All

       

     • Ha engedélyezi a ACL-betöltési (előzetes verzió), a szükséges engedélyek attól függenek, hogy mely elemtípusokat (dokumentumtárfájlokat, listaelemeket, ASPX-lapokat) és csoporttípusokat (Microsoft Entra és SharePoint webhelycsoportokat) indexeli. A lépés végrehajtása előtt tekintse meg az Engedélyek ACL-forgatókönyv szerint című témakört. A forgatókönyvek közötti összefoglalásért tekintse meg az engedélyek beállításának kiválasztása című témakört.

       Az alkalmazásengedélyek használata azt jelenti, hogy az indexelő egy szolgáltatáskörnyezetben fér hozzá a SharePoint webhelyhez. Ezért az indexelő futtatásakor hozzáféréssel rendelkezik a SharePoint bérlő összes tartalmához, amelyhez bérlői rendszergazdai jóváhagyás szükséges. A hitelesítéshez ügyféltitokkód vagy titok nélküli konfiguráció is szükséges. A hitelesítési mechanizmus beállításáról a cikk későbbi részében olvashat, amely a csak az alkalmazás API-engedélyekhez használható hitelesítési módszereket ismerteti.

   • Ha az indexelő delegált API-engedélyeket használ, válassza a Delegált engedélyek lehetőséget, majd válassza a következőt:

     • Files.Read.All
     • Sites.Read.All
     • User.Read

     

     A delegált engedélyek lehetővé teszik, hogy a keresési ügyfél az aktuális felhasználó biztonsági identitása alatt csatlakozzon SharePoint.

6. Válassza a bérlő nevének rendszergazdai hozzájárulásának megadása lehetőséget.

   Az alkalmazás API-engedélyeinek használatakor bérlői rendszergazdai hozzájárulásra van szükség. Egyes bérlők zárolva vannak oly módon, hogy a bérlői rendszergazdai hozzájárulás is szükséges a delegált API-engedélyekhez. Ha bármelyik feltétel érvényes, a bérlői rendszergazdának jóváhagyást kell adnia ehhez a Microsoft Entra alkalmazáshoz az indexelő létrehozása előtt.

   

7. A bal oldali panelen válassza a Hitelesítés kezelése>(előzetes verzió) lehetőséget.

8. Az Átirányítási URI konfiguráció lapján válassza az + Átirányítási URI hozzáadása lehetőséget.

   1. Válassza ki a Mobil- és asztali alkalmazásokat.
   2. Válassza ki az https://login.microsoftonline.com/common/oauth2/nativeclient átirányítási URI-t.
   3. Válassza a Konfigurálás lehetőséget.

9. A Beállítások lapon engedélyezze a Nyilvános ügyfélfolyamatok engedélyezése kapcsolót, majd válassza a Mentés lehetőséget.

10. Konfigurálja az indexelő hitelesítési módszerét a megoldás igényeinek megfelelően.

Engedélyezze a webhelyhozzáférést a Sites.Selected használatakor

Ha az alkalmazás regisztrációját a(z) Sites.Selected használatával konfigurálja, az indexelőprogram futtatása előtt hajtsa végre az alábbi lépéseket. A Microsoft Entra ID rendszergazdai hozzájárulásával Sites.Selected az alkalmazás csak hatókörön belüli SharePoint engedélyeket használhat. Nem biztosít hozzáférést egyetlen webhelyhez sem, amíg külön nem rendel hozzá webhelyengedélyt.

1. A Microsoft Entra ID-ban: adja hozzá a(z) Sites.Selected elemet az alkalmazásregisztrációhoz, és adjon rendszergazdai hozzájárulást. Adja hozzá a forgatókönyv által igényelt API-felülethez tartozó engedélyt, például Microsoft Graph és ACL-betöltési forgatókönyvek esetében SharePoint.

2. A SharePointban: Rendeljen az alkalmazáshoz engedélyszintet minden célwebhelyen. Tartalom indexeléséhez adjon legalább olvasási hozzáférést.

   A webhely engedélyének megadásához használja a Microsoft Graph. Cserélje le {siteId} a webhelyazonosítót:

   POST https://graph.microsoft.com/v1.0/sites/{siteId}/permissions
   Content-Type: application/json
   
   {
     "roles": ["read"],
     "grantedToIdentities": [
       {
         "application": {
           "id": "<application-client-id>",
           "displayName": "<application-display-name>"
         }
       }
     ]
   }
   

   Ha ugyanazt az engedélyt szeretné megadni a PnP PowerShell használatával:

   Grant-PnPEntraIDAppSitePermission `
     -AppId "<application-client-id>" `
     -DisplayName "<application-display-name>" `
     -Site "https://<tenant>.sharepoint.com/sites/<site-name>" `
     -Permissions Read
   

Csak az alkalmazás API-engedélyekhez elérhető hitelesítési módszerek

A Microsoft Entra alkalmazás engedélyekkel való hitelesítéséhez az indexelő egy ügyféltitkot vagy egy titokmentes konfigurációt használ.

Titkos ügyfélkód használata

Ezek az utasítások úgy konfigurálják az alkalmazást, hogy ügyfél-titkos kulcs használatával hitelesítse az indexelőt, így az adatokat tudjon beolvasni a SharePointból.

• A bal oldali menüben válassza a Tanúsítványok és titkos kulcsok lehetőséget, majd válassza az Ügyfél titkos kulcsok és az Új ügyfélkód lehetőséget.

  

• Az előugró menüben adja meg az új ügyfél titkos kódjának leírását. Szükség esetén módosítsa a lejárati dátumot. Ha a titkos kód lejár, újra létre kell hoznia, és frissítenie kell az indexelőt az új titkos kóddal.

  

• Az új ügyfélkód megjelenik a titkos kódok listájában. A lapról való navigálás után a titkos kód nem látható, ezért másolja az értéket a Másolás gombbal, és mentse biztonságos helyre.

  

Alkalmazásjogkivonatok beszerzése titok nélküli hitelesítéssel

Összevont hitelesítő adatok használatával jelentkezzen be titkos ügyfélkód nélkül. A Microsoft Entra egy felügyelt identitást használ az alkalmazástoken lekéréséhez, így az indexelő tárolt titok nélkül is tud adatokat betölteni a SharePointból. A következő szakasz végigvezeti egy felügyelt identitás konfigurálását.

A regisztrált alkalmazás konfigurálása felügyelt identitással

1. Hozzon létre (vagy válasszon ki) egy felhasználó által hozzárendelt felügyelt identitást, és rendelje hozzá a keresési szolgáltatáshoz vagy egy rendszer által hozzárendelt felügyelt identitáshoz a forgatókönyv követelményeitől függően.

2. Rögzítse az objektum (egyszerű) azonosítóját. Használja ezt az értéket a hitelesítő adatok konfigurációjának részeként az adatforrás létrehozásakor.

3. A bal oldali menüben válassza a Tanúsítványok &titkos kulcsok lehetőséget.

4. Az Összevont hitelesítő adatok csoportban válassza a + Hitelesítő adatok hozzáadása lehetőséget.

5. Az Összevont hitelesítőadat-forgatókönyv területen válassza a Felügyelt identitás lehetőséget.

6. Felügyelt identitás kiválasztása: Válassza ki az 1. lépésben létrehozott felügyelt identitást.

7. Adjon nevet a hitelesítő adatainak, és válassza a Mentés lehetőséget.

4. lépés: Adatforrás létrehozása

Ebből a szakaszból kiindulva használja a rest API legújabb előzetes verzióját és egy REST-ügyfelet vagy a legújabb támogatott béta SDK-t a többi lépéshez.

Az adatforrás meghatározza, hogy mely adatokat indexelje, hitelesítő adatokat és szabályzatokat az adatok változásainak (új, módosított vagy törölt sorok) hatékony azonosításához. Ugyanazon keresési szolgáltatás több indexelője is használhatja ugyanazt az adatforrást.

Az SharePoint indexeléshez az adatforrásnak a következő szükséges tulajdonságokkal kell rendelkeznie:

• A név az adatforrás egyedi neve a keresési szolgáltatásban.
• A típusnak "sharepoint" típusúnak kell lennie. Ez az érték megkülönbözteti a kis- és nagybetűk értékét.
• hitelesítő adatokat adja meg a SharePoint végpontot és azt a hitelesítési módszert, amely lehetővé teszi az alkalmazás számára a Microsoft Entra-jogkivonatok lekérését. Példa SharePoint végpont https://[your-tenant-name].sharepoint.com/teams/MySharePointSite. A végpont lekéréséhez navigáljon a SharePoint webhely kezdőlapjára, és másolja az URL-címet a böngészőből. Tekintse át a támogatott szintaxis kapcsolati karakterlánc formátumát.
• A tároló megadja, hogy melyik dokumentumtárat indexelje. A tulajdonságok szabályozzák, hogy mely dokumentumok legyenek indexelve.

Adatforrás létrehozásához hívja meg az Adatforrás létrehozása (előzetes verzió) parancsot.

Íme egy adatforrásdefiníciós minta az alkalmazás titkos kódjával vagy rendszer által hozzárendelt felügyelt identitással rendelkező hitelesítő adatokhoz.

POST https://[service name].search.windows.net/datasources?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sharepoint-datasource",
    "type" : "sharepoint",
    "credentials" : { "connectionString" : "[connection-string]" },
    "container" : { "name" : "defaultSiteLibrary", "query" : null }
}

A federált hitelesítőadat-konfigurációkhoz a kapcsolati sztringben FederatedCredentialApplicationId szükséges. Az érték identitástípusonként eltérő:

• Rendszer által hozzárendelt felügyelt identitás: Állítsa be FederatedCredentialApplicationId a szolgáltatás rendszer által hozzárendelt felügyelt identitásalkalmazás (ügyfél) azonosítóját. Hagyja ki a identity blokkot.
• Felhasználó által hozzárendelt felügyelt identitás: Adja meg a identity blokkot a felhasználó által hozzárendelt felügyelt identitás erőforrás-elérési útjával. Állítsa a(z) FederatedCredentialApplicationId értékét a felhasználó által hozzárendelt felügyelt identitás saját alkalmazásazonosítójára (ügyfél-azonosítójára).

POST https://[service name].search.windows.net/datasources?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sharepoint-datasource",
    "type" : "sharepoint",
    "credentials" : { "connectionString" : "[connection-string]" },
    "container" : { "name" : "defaultSiteLibrary", "query" : null },
    "identity": {
      "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
      "userAssignedIdentity": "/subscriptions/[Azure subscription ID]/resourceGroups/[resource-group]/providers/Microsoft.ManagedIdentity/userAssignedIdentities/[user-assigned managed identity]"
    }
}

Kapcsolati karakterlánc formátuma

A kapcsolati karakterlánc formátuma attól függően változik, hogy az indexelő delegált API-engedélyeket vagy alkalmazás API-engedélyeket használ-e.

• Delegált API-engedélyek kapcsolati karakterlánc formátuma

  SharePointOnlineEndpoint=[SharePoint site URL];ApplicationId=[Microsoft Entra application ID];TenantId=[SharePoint site's Microsoft Entra tenant ID]

• Alkalmazás API-engedélyei az alkalmazás titkos kapcsolati karakterlánc formátumával

  SharePointOnlineEndpoint=[SharePoint site URL];ApplicationId=[Microsoft Entra application ID];ApplicationSecret=[Microsoft Entra application client secret];TenantId=[SharePoint site's Microsoft Entra tenant ID]

• Alkalmazás-API-engedélyek titok nélküli (összevont identitáshitelesítő adatokkal történő) kapcsolatisztring-formátummal:

  SharePointOnlineEndpoint=[SharePoint site URL];ApplicationId=[Microsoft Entra application ID];FederatedCredentialApplicationId=[managed identity's application (client) ID];TenantId=[SharePoint site's Microsoft Entra tenant ID]

Az alábbi táblázat az egyes kapcsolati karakterlánc mezőket ismerteti.

Az engedélyek beállításakor vegye figyelembe a következő információkat:

A visszamenőleges kompatibilitás biztosítása érdekében a SharePoint-indexelő továbbra is elfogadja a kapcsolati sztringben a(z) FederatedCredentialObjectId értéket (a betöltési alkalmazásban lévő föderált identitás hitelesítő adatának objektumazonosítója/főazonosítója), így a meglévő adatforrások módosítás nélkül továbbra is működnek. Új és frissített adatforrásokhoz használható FederatedCredentialApplicationId .

A(z) TenantId lekéréséhez nyissa meg annak a bérlőnek a Microsoft Entra felügyeleti központját, amelyhez a SharePoint-webhely tartozik, majd másolja ki a Bérlőazonosító értékét az Áttekintés lapról.

A felügyelt identitást object (principal) ID a regisztrált alkalmazás konfigurálása felügyelt identitással szakaszból szerezheti be.

Az engedélyek beállításakor vegye figyelembe a következő információkat:

Ha a SharePoint-webhely és a keresési szolgáltatás ugyanabban a Microsoft Entra-bérlőben van, és engedélyezve van a rendszer által hozzárendelt felügyelt identitás, akkor nem kell megadnia a(z) TenantId elemet a kapcsolati sztringben. Ha különböző Microsoft Entra bérlőkben vannak, akkor a következőket kell tartalmazniaTenantId.

Az alábbi példák a következővel FederatedCredentialApplicationIdlétrehozott adatforrásokat mutatják be:

Rendszer által hozzárendelt felügyelt identitás összevont hitelesítő adatokkal:

POST https://[service name].search.windows.net/datasources?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
  "name": "sharepoint-ds",
  "type": "sharepoint",
  "credentials": {
    "connectionString": "SharePointOnlineEndpoint=https://[your-tenant-name].sharepoint.com;ApplicationId=[Microsoft Entra application ID];TenantId=[SharePoint site's Microsoft Entra tenant ID];FederatedCredentialApplicationId=[system-assigned managed identity's application (client) ID]"
  },
  "container": { "name": "defaultSiteLibrary" }
}

Felhasználó által hozzárendelt felügyelt identitás összevont hitelesítő adatokkal (egybérlős):

{
  "name": "sharepoint-uami-fed",
  "type": "sharepoint",
  "credentials": {
    "connectionString": "SharePointOnlineEndpoint=https://[your-tenant-name].sharepoint.com;ApplicationId=[Microsoft Entra application ID];TenantId=[SharePoint site's Microsoft Entra tenant ID];FederatedCredentialApplicationId=[user-assigned managed identity application (client) ID]"
  },
  "container": { "name": "defaultSiteLibrary" },
  "identity": {
    "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
    "userAssignedIdentity": "/subscriptions/[subscription-id]/resourceGroups/[resource-group]/providers/Microsoft.ManagedIdentity/userAssignedIdentities/[uami-name]"
  }
}

Bérlőközi, felhasználó által hozzárendelt felügyelt identitás föderált hitelesítő adattal (speciális):

A konfiguráció használata előtt győződjön meg arról, hogy a felhasználó által hozzárendelt felügyelt identitás olyan összevont identitás hitelesítő adatokkal van konfigurálva, amely megbízható a több-bérlős Microsoft Entra alkalmazásban. A beállítási lépésekért lásd : A regisztrált alkalmazás konfigurálása felügyelt identitással.

{
  "name": "sharepoint-uami-crosstenantfed",
  "type": "sharepoint",
  "credentials": {
    "connectionString": "SharePointOnlineEndpoint=https://[your-tenant-name].sharepoint.com;ApplicationId=[Microsoft Entra application ID];TenantId=[SharePoint site's Microsoft Entra tenant ID];FederatedCredentialApplicationId=[multitenant app client ID]"
  },
  "container": { "name": "defaultSiteLibrary" },
  "identity": {
    "@odata.type": "#Microsoft.Azure.Search.DataUserAssignedIdentity",
    "userAssignedIdentity": "/subscriptions/[subscription-id]/resourceGroups/[resource-group]/providers/Microsoft.ManagedIdentity/userAssignedIdentities/[uami-name]",
    "federatedIdentityClientId": "[multi-tenant app client ID]"
  }
}

A bérlőközi, felhasználó által hozzárendelt felügyeltidentitás-konfigurációt akkor használja, ha maga a felhasználó által hozzárendelt felügyelt identitás egy több-bérlős Microsoft Entra-alkalmazáshoz föderál. Ebben az esetben állítsa a identity blokkban lévő federatedIdentityClientId értékét a több-bérlős alkalmazás ügyfél-azonosítójára, és állítsa a kapcsolati karakterláncban lévő FederatedCredentialApplicationId értékét ugyanannak a több-bérlős alkalmazásnak az ügyfél-azonosítójára. A(z) FederatedCredentialApplicationId felhasználó által hozzárendelt felügyelt identitás saját ügyfél-azonosítójára állítása ebben az esetben nem megy át az érvényesítésen.

Ha az indexelő a SharePoint ACL-konfigurációt (előzetes verzió) vagy megőrzi és figyelembe veszi a Microsoft Purview bizalmassági címkéit (előzetes verzió) használja, tekintse át a kapcsolódó cikkeket, mielőtt létrehozza az indexelőt. Minden funkció konkrét adatforrás-, index- és képességkészlet-konfigurációs lépésekkel rendelkezik.

5. lépés: Index létrehozása

Az index meghatározza a dokumentum mezőit, attribútumait és a keresési felületet formázó egyéb szerkezeteket.

Index létrehozásához hívja meg az Index létrehozása (előzetes verzió) parancsot:

POST https://[service name].search.windows.net/indexes?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
    "name" : "sharepoint-index",
    "fields": [
        { "name": "id", "type": "Edm.String", "key": true, "searchable": false },
        { "name": "metadata_spo_item_name", "type": "Edm.String", "key": false, "searchable": true, "filterable": false, "sortable": false, "facetable": false },
        { "name": "metadata_spo_item_path", "type": "Edm.String", "key": false, "searchable": false, "filterable": false, "sortable": false, "facetable": false },
        { "name": "metadata_spo_item_content_type", "type": "Edm.String", "key": false, "searchable": false, "filterable": true, "sortable": false, "facetable": true },
        { "name": "metadata_spo_item_last_modified", "type": "Edm.DateTimeOffset", "key": false, "searchable": false, "filterable": false, "sortable": true, "facetable": false },
        { "name": "metadata_spo_item_size", "type": "Edm.Int64", "key": false, "searchable": false, "filterable": false, "sortable": false, "facetable": false },
        { "name": "content", "type": "Edm.String", "searchable": true, "filterable": false, "sortable": false, "facetable": false }
    ]
}

6. lépés: Indexelő létrehozása

Az indexelők egy adatforrást csatlakoztatnak egy célkeresési indexhez, és ütemezést biztosítanak az adatfrissítés automatizálásához. Az adatforrás és az index létrehozása után hozza létre az indexelőt.

Az indexelő létrehozása:

1. Indexelő létrehozása (előzetes verzió) kérés küldése:

   POST https://[service name].search.windows.net/indexers?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [admin key]
   
   {
       "name" : "sharepoint-indexer",
       "dataSourceName" : "sharepoint-datasource",
       "targetIndexName" : "sharepoint-index",
       "parameters": {
       "batchSize": null,
       "maxFailedItems": null,
       "base64EncodeKeys": null,
       "maxFailedItemsPerBatch": null,
       "configuration": {
           "indexedFileNameExtensions" : ".pdf, .docx",
           "excludedFileNameExtensions" : ".png, .jpg",
           "dataToExtract": "contentAndMetadata"
         }
       },
       "schedule" : { },
       "fieldMappings" : [
           { 
             "sourceFieldName" : "metadata_spo_site_library_item_id", 
             "targetFieldName" : "id", 
             "mappingFunction" : { 
               "name" : "base64Encode" 
             } 
            }
       ]
   }
   

   Azoknál az adatforrásoknál, amelyek a allSiteLists, allSitePages vagy allSiteContent tárolóértékeket használják, a metadata_spo_site_asset_item_id helyett a metadata_spo_site_library_item_id értéket képezze le.

   Alkalmazásengedélyek használata esetén lekérdezheti az indexet, amíg a kezdeti indexelő futtatása folyamatban van, de csak az indexelt elemek adnak eredményül. Várjon, amíg a futtatás befejeződik a teljes lefedettség érdekében. A lépésben szereplő további utasítások csak a delegált engedélyekre vonatkoznak.

2. Amikor első alkalommal hozza létre az indexelőt, az Indexelő létrehozása (előzetes verzió) kérés megvárja, amíg végrehajtja a következő lépést. Az indexelő állapotának lekérdezéséhez és az új eszközkód megadásához meg kell hívnia a Get Indexer Status parancsot.

   GET https://[service name].search.windows.net/indexers/sharepoint-indexer/status?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [admin key]
   

   Ha 10 percen belül nem hívja meg az Indexelő állapotának lekérését , a kód lejár, és újra létre kell hoznia az adatforrást.

3. Másolja ki az eszköz bejelentkezési kódját az Indexelő állapotának lekérése válaszból. Az eszköz bejelentkezési kódja a "errorMessage" fájlban található.

   {
       "lastResult": {
           "status": "transientFailure",
           "errorMessage": "To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code <CODE> to authenticate."
       }
   }
   

4. Adja meg a hibaüzenetben szereplő kódot.

   

5. A Microsoft 365 indexelő SharePoint bejelentkezett felhasználóként fér hozzá a SharePoint tartalomhoz. A lépés során bejelentkező felhasználó az a bejelentkezett felhasználó. Ha tehát olyan felhasználói fiókkal jelentkezik be, amely nem rendelkezik hozzáféréssel az indexelni kívánt dokumentumtárban lévő dokumentumhoz, az indexelő nem fér hozzá a dokumentumhoz.

   Ha lehetséges, hozzon létre egy új szervezeti felhasználói fiókot, és adja meg neki a pontos engedélyeket, amelyekkel az indexelő rendelkezik.

6. Hagyja jóvá a kért engedélyeket.

   

7. Az Indexelő létrehozása (előzetes verzió) kezdeti kérés akkor fejeződik be, ha a korábban megadott összes engedély helyes, és a 10 perces időkereten belül.

Az engedélyek beállításakor vegye figyelembe a következő információkat:

Ha a Microsoft Entra alkalmazás rendszergazdai jóváhagyást igényel, és a bejelentkezés előtt nem lett jóváhagyva, a következő képernyő jelenhet meg. A folytatáshoz rendszergazdai jóváhagyás szükséges.

7. lépés: Az indexelő állapotának ellenőrzése

Az indexelő létrehozása után hívja meg az Indexelő állapotának lekérését:

GET https://[service name].search.windows.net/indexers/sharepoint-indexer/status?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

GET https://[service-name].search.windows.net/indexes/[index-name]/docs?search=*&$count=true&api-version=2026-08-01-preview
api-key: [admin-api-key]

Az adatforrás frissítése

Ha nem frissíti az adatforrás-objektumot, az indexelő felhasználói beavatkozás nélkül, ütemezés szerint fut.

Ha az eszközkód lejártakor módosítja az adatforrást, jelentkezzen be újra az indexelő futtatásához. Ha például módosítja az adatforrás lekérdezését, jelentkezzen be újra a(z) https://microsoft.com/devicelogin használatával, és szerezze be az új eszközkódot.

Adatforrás frissítéséhez kövesse az alábbi lépéseket egy lejárt eszközkód felvállalásával:

1. Az Indexelő futtatása (előzetes verzió)-t hívja meg az indexelő futtatásának manuális elindításához.

   POST https://[service name].search.windows.net/indexers/sharepoint-indexer/run?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [admin key]
   

2. Ellenőrizze az indexelő állapotát.

   GET https://[service name].search.windows.net/indexers/sharepoint-indexer/status?api-version=2026-08-01-preview
   Content-Type: application/json
   api-key: [admin key]
   

3. Ha hibaüzenet jelenik meg, amely arra kéri, hogy látogasson el https://microsoft.com/devicelogin, nyissa meg a lapot, és másolja ki az új kódot.

4. Illessze be a kódot a(z) párbeszédpanelbe.

5. Futtassa manuálisan újra az indexelőt, és ellenőrizze az indexelő állapotát. Ezúttal az indexelő futtatásának sikeresen kell elindulnia.

Dokumentum metaadatainak indexelése

Ha indexeli a dokumentum metaadatait ("dataToExtract": "contentAndMetadata"), az alábbi metaadatokat használhatja az indexeléshez.

A Microsoft 365 indexelő SharePoint az egyes dokumentumtípusokra jellemző metaadatokat is támogatja. További információért lásd: Az Azure AI Keresés-ben használt metaadat-tulajdonságok.

Az engedélyek beállításakor vegye figyelembe a következő információkat:

Az egyéni metaadatok indexeléséhez adja meg az "additionalColumns" értéket az adatforrás lekérdezési paraméterében.

SharePoint-listák indexe

SharePoint listák előzetes verzióban indexelhetők, a 2026-05-01-es verziójú REST API-tól kezdve. Állítsa az adatforrást container.name úgy, hogy allSiteLists egy webhely összes listaelemét indexelje allSiteContent , vagy egyesítse a listaelemeket dokumentumtárakkal és webhelylapokkal egyetlen indexelőben. Az alwebhelyek listáinak felvételéhez adja hozzá a(z) includeSubsites=true-hez a container.query-t.

Listaalapú vagy vegyes tartalmú indexelők esetén az indexkulcsmezőt a(z) metadata_spo_site_asset_item_id mezőből kell leképezni. A listaelem tartalma JSON formátumú mezőértékekként jelenik meg a content mezőben, és a normál metadata_spo_item_* mezők (például metadata_spo_item_name, metadata_spo_item_weburiés metadata_spo_item_last_modified) minden listaelemhez ki vannak töltve.

A lista oszlopainak leképezése indexmezőkhöz

A SharePoint list definiált összes oszlop forrásmezőként jelenik meg, amelynek neve megegyezik a SharePoint oszlop nevével. Az egyes oszlopok indexmezőhöz való leképezéséhez használjon mezőleképezéseket .

Vegyük például az alábbi oszlopokkal rendelkező SharePoint list.

Adjon hozzá egyező mezőket az indexdefinícióhoz, majd képezze le az egyes oszlopokat az indexelő célmezőjéhez:

{
  "name": "my-sharepoint-list-indexer",
  "dataSourceName": "my-sharepoint-list-ds",
  "targetIndexName": "products-index",
  "fieldMappings": [
    {
      "sourceFieldName": "metadata_spo_site_asset_item_id",
      "targetFieldName": "id",
      "mappingFunction": { "name": "base64Encode" }
    },
    { "sourceFieldName": "Title", "targetFieldName": "productName" },
    { "sourceFieldName": "Price", "targetFieldName": "price" },
    { "sourceFieldName": "InStock", "targetFieldName": "available" },
    { "sourceFieldName": "Category", "targetFieldName": "category" },
    { "sourceFieldName": "metadata_spo_item_last_modified", "targetFieldName": "lastUpdated" },
    { "sourceFieldName": "metadata_spo_item_weburi", "targetFieldName": "itemUrl" }
  ]
}

Győződjön meg arról, hogy az indexben minden célmező létezik kompatibilis típussal (például Edm.String a(z) Title esetén, Edm.Double vagy Edm.Int64 a(z) Price esetén, Edm.Boolean a(z) InStock esetén).

Index ASPX webhelylapok

A modern ASPX-webhelyoldalakat előzetes verzióban indexelheti, a 2026-05-01-es verziójú REST API-tól kezdve. Állítsa be az adatforrást container.name úgy, hogy allSitePages egy webhely összes lapját indexelje allSiteContent , vagy egyesítse a lapokat dokumentumtárakkal és listákkal egyetlen indexelőben. Az alwebhelyoldalak belefoglalásához adja hozzá a includeSubsites=true elemet a container.query-hez.

Oldalalapú vagy vegyes tartalmú indexelők esetén az indexkulcsmezőt a(z) metadata_spo_site_asset_item_id elemből kell leképezni. A lap szövegét a rendszer kinyeri a content mezőbe, és a szokásos metadata_spo_item_* mezőket (például metadata_spo_item_name, metadata_spo_item_weburiés metadata_spo_item_last_modified) az egyes lapokhoz tölti ki a rendszer.

Fájltípus szerinti belefoglalás vagy kizárás

Az indexelő definíciójának "paraméterek" szakaszában adja meg a belefoglalási és kizárási feltételeket annak szabályozásához, hogy mely fájlok legyenek indexelve.

Adott fájlkiterjesztések hozzáadásához állítsa be "indexedFileNameExtensions" a kezdő ponttal rendelkező fájlkiterjesztések vesszővel tagolt listáját. Adott fájlkiterjesztések kizárásához állítsa a(z) "excludedFileNameExtensions" értékét azokra a fájlkiterjesztésekre, amelyeket ki szeretne hagyni. Ha ugyanaz a bővítmény mindkét listában megjelenik, az indexelő kizárja az indexelésből.

PUT /indexers/[indexer name]?api-version=2026-08-01-preview
{
    "parameters" : { 
        "configuration" : { 
            "indexedFileNameExtensions" : ".pdf, .docx",
            "excludedFileNameExtensions" : ".png, .jpeg" 
        } 
    }
}

Az indexelt dokumentumok szabályozása

A Microsoft 365 indexelők egyetlen SharePoint egy vagy több dokumentumtár tartalmát indexelhetik. Az indexelendő helyek és dokumentumtárak megadásához használja a "container" paramétert az adatforrás definíciójában.

Az adatforrás "tároló" szakaszának két tulajdonsága van ehhez a feladathoz: "name" és "query".

Név

A name tulajdonság megadása kötelező, és az alábbi értékek egyikének kell lennie:

Azon adatforrások esetében, amelyek allSiteLists, allSitePages vagy allSiteContent elemet használnak, az indexelő kulcsmező-hozzárendelésének metadata_spo_site_asset_item_id kell használnia metadata_spo_site_library_item_id helyett. További részletekért lásd : 6. lépés: Indexelő létrehozása.

Lekérdezés

Az adatforrás "lekérdezés" paramétere kulcsszó-/érték párokból áll. Használja az alábbi kulcsszavakat. Az értékek vagy webhely URL-címei, vagy a dokumentumtár URL-címei.

Az engedélyek beállításakor vegye figyelembe a következő információkat:

Egy adott kulcsszó értékének lekéréséhez nyissa meg azt a dokumentumtárat, amelyet fel szeretne venni vagy kizárni, és másolja az URI-t a böngészőből. Ez a módszer a legegyszerűbb módja annak, hogy a lekérdezésben egy kulcsszóval használandó értéket lekérje.

Hibák kezelése

Invalid AAD tenant Egy üzenet, egy hiányzó Microsoft Entra bérlőazonosító vagy az indexelőzmények végrehajtási előzményeiben megjelenő bérlői eltérés esetén tekintse meg az indexelőzmények gyakori hibáinak és figyelmeztetéseinek hibaelhárítását.

Alapértelmezés szerint a Microsoft 365 indexelőben lévő SharePoint leáll, amint nem támogatott tartalomtípusú dokumentumba, például képbe ütközik. A paraméter használatával excludedFileNameExtensions kihagyhat bizonyos tartalomtípusokat. Előfordulhat azonban, hogy az összes lehetséges tartalomtípus előzetes ismerete nélkül kell indexelnie a dokumentumokat. Ha folytatni szeretné az indexelést, amikor az indexelő nem támogatott tartalomtípussal találkozik, állítsa a failOnUnsupportedContentType konfigurációs paramétert hamisra:

PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=2026-08-01-preview
Content-Type: application/json
api-key: [admin key]

{
    ... other parts of indexer definition
    "parameters" : { "configuration" : { "failOnUnsupportedContentType" : false } }
}

Egyes dokumentumok esetében Azure AI Keresés nem tudja meghatározni a tartalomtípust, vagy nem tudja feldolgozni az egyébként támogatott tartalomtípusú dokumentumokat. Ha figyelmen kívül szeretné hagyni ezt a hibamódot, állítsa a failOnUnprocessableDocument konfigurációs paramétert hamisra:

"parameters" : { "configuration" : { "failOnUnprocessableDocument" : false } }

SharePoint forrásfájlok a megosztott forrásfájl méretét és a kibontott karakterkorlátokat használják a blobszerű indexelők számára. Alapértelmezés szerint a túlméretezett dokumentumok hibákként lesznek kezelve. A túlméretezett dokumentumok tárolási metaadatait azonban továbbra is indexelheti, ha igazra állítja a indexStorageMetadataOnlyForOversizedDocuments konfigurációs paramétert:

"parameters" : { "configuration" : { "indexStorageMetadataOnlyForOversizedDocuments" : true } }

Ha hozzáad egy készségkészletet, külön ellenőrizze az egyes képességek bemeneti és alsóbb rétegbeli szolgáltatási korlátait. A képesség kevesebb adatot fogad el, mint a SharePoint indexelő kinyeri.

Akkor is folytathatja az indexelést, ha hibák történnek a feldolgozás bármely pontján, akár a dokumentumok elemzésekor, akár az indexhez való hozzáadáskor. Adott számú hiba figyelmen kívül hagyásához állítsa be a maxFailedItems konfigurációs paramétereket maxFailedItemsPerBatch a kívánt értékekre. Például:

{
    ... other parts of indexer definition
    "parameters" : { "maxFailedItems" : 10, "maxFailedItemsPerBatch" : 10 }
}

Kapcsolódó tartalom

• YouTube videó: SharePoint Microsoft 365 indexelőben
• Indexálók az Azure AI Keresés-ben
• Az Azure AI Keresés során használt metaadat-tulajdonságok
• Azure Logic App-összekötők használatával indexelje a SharePoint tartalmat és egyéb forrásokat az Azure AI Keresés-be
• A SharePoint ACL-konfiguráció beolvasása (előzetes verzió)
• ACL-ek aszinkronizálása a SharePoint és az index között
• Konfigurálás SharePoint csoportok támogatása
• A Microsoft Purview bizalmassági címkék megőrzése és tiszteletben tartása (előzetes verzió)