Microsoft 365'de SharePoint içeriği dizine ekleme (önizleme)

Not

Microsoft 365 dizin oluşturucudaki SharePoint önizleme aşamasındadır. Tamamlayıcı Kullanım Koşulları altında "olduğu gibi" sunulur ve yalnızca en iyi çaba temelinde desteklenir. Önizleme özellikleri üretim iş yükleri için önerilmez ve genel kullanıma sunulması garanti edilmez.

Devam etmeden önce bilinen sınırlamaları gözden geçirin.

Önizlemeye kaydolmak için bu formu doldurun. Tüm istekler otomatik olarak onaylanmıştır. Formu doldurduktan sonra içeriğinizin dizinini oluşturmak için önizleme REST API'sini kullanın.

Önemli

Bu özellikler ve işlevler 2026-05-01-preview REST API'sinin bir parçasıdır. 2026-05-01-preview, Azure aboneliğinizin bir parçası olarak size lisanslanmıştır ve Microsoft Ürün Koşulları, Microsoft Ürünler ve Hizmetler Veri Koruma Eki ("DPA") ve Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları belgelerinde "Önizlemeler" için geçerli olan koşullara tabidir.

2026-05-01-preview, diğer Microsoft hizmetleri ve üçüncü taraf hizmetlerle bağlantıları destekler. Bu hizmetlerin kullanımı ilgili koşullara tabidir ve Azure uyumluluk sınırının dışında veri işleme veya depolamanın yanı sıra Azure uyumluluk sınırına akan verilere neden olabilir.

2026-05-01-preview, 2026-05-01-preview dışında ayarlanmış erişim izinlerini değiştiremez. Erişim veya izin kısıtlanmış içerikle 2026-05-01-preview kullanıyorsanız, 2026-05-01-preview bu erişim veya izin kısıtlamalarındaki değişiklikleri tanımadan önce bir zamanlama gecikmesi oluşur.

Verilerinizin kuruluşunuzun uyumluluk ve coğrafi sınırları dışında akıp akmayacağını ve ilgili etkileri ve uygun izinlerin, sınırların ve onayların sağlanıp sağlanmayacağını yönetmek sizin sorumluluğunuzdadır.

Özel kullanım örnekleriniz bağlamında oluşturduğunuz uygulamaları dikkatle gözden geçirmek ve test etmek ve tüm uygun kararları ve özelleştirmeleri yapmak sizin sorumluluğunuzdadır. Bu, metapromptlar, içerik filtreleri veya diğer güvenlik sistemleri gibi sorumlu yapay zeka risk azaltmalarınızı uygulamayı ve uygulamalarınızın uygun kalite, güvenilirlik, güvenlik ve güvenilirlik standartlarını karşılamasını sağlamayı içerir. Daha fazla bilgi için bkz. Azure Yapay Zeka Arama Saydamlık Notu.

Bu makalede, Azure Yapay Zeka Arama'da tam metin araması için SharePoint belge kitaplıklarında depolanan belgelerin dizinini oluşturmak için search indexer nasıl yapılandırılır açıklanmaktadır. İlk olarak yapılandırma adımları, ardından davranışlar ve senaryolar eklenir.

Azure Yapay Zeka Arama'te, bir dizin oluşturucu bir veri kaynağından aranabilir verileri ve meta verileri ayıklar. Microsoft 365 dizin oluşturucudaki SharePoint aşağıdaki işlevleri sağlar:

  • Bir veya daha fazla belge kitaplığındaki dosyaları ve meta verileri dizinler.
  • SharePoint listeleri ve öğe alanı değerlerini dizinler; her liste sütunu alan eşleme için kaynak alan olarak kullanılabilir. Bu özellik, 2026-05-01-preview REST API'sinde başlayarak önizleme aşamasındadır.
  • ASPX site sayfalarını (modern site sayfaları) dizine ekler. Bu özellik, 2026-05-01-preview REST API'sinde başlayarak önizleme aşamasındadır.
  • allSiteContent kapsayıcı değerini kullanarak karma SharePoint içeriği (belge kitaplıkları, listeler ve site sayfaları) tek bir dizin oluşturucuda dizinler. Bu özellik, 2026-05-01-preview REST API'sinde başlayarak önizleme aşamasındadır.
  • Veri kaynağı sorgusunda includeSubsites=true ayarlandığında alt sitelerdeki içeriği dizinler. Bu özellik, 2026-05-01-preview REST API'sinde başlayarak önizleme aşamasındadır.
  • Yalnızca yeni ve değiştirilmiş dosyaları, liste öğelerini, sayfaları ve meta verileri alarak artımlı olarak dizin oluşturur.
  • Silinen içeriği otomatik olarak algılar. Dosyaların, liste öğelerinin veya sayfaların silinmesi bir sonraki dizin oluşturucu çalıştırmasından alınır ve karşılık gelen arama belgesi dizinden kaldırılır.
  • Dizine alınan belgelerden metni ve normalleştirilmiş görüntüleri otomatik olarak ayıklar. İsteğe bağlı olarak, optik karakter tanıma (OCR) veya varlık tanıma gibi daha derin yapay zeka zenginleştirmesi için bir beceri kümesi ekleyebilirsiniz.
  • Belge temel erişim denetim listelerinin (ACL) önizleme sürümünde içe aktarılmasını destekler. 2026-05-01-preview sürümünden başlayarak, benzersiz izinlere sahip öğeler için her başarılı dizin oluşturucu çalıştırmasında ACL değişiklikleri algılanıp artımlı olarak güncelleştirilir. Bu sürüm ayrıca ACL alımını liste öğeleri, ASPX site sayfaları ve SharePoint gruplarına genişletir. Uyarılar ve yapılandırma adımları için bkz. İzin meta verilerini almak için SharePoint dizin oluşturucu kullanma.
  • Sorgu zamanında Microsoft Purview duyarlılık etiketi alımını ve uygulanmasını destekler. Bu işlev önizleme aşamasındadır.

Önkoşullar

İzin kurulumunuzu seçin

3. Adımda uygulama kaydını oluşturmadan önce aşağıdaki tabloda senaryonuzu tanımlayın. Gerekli Microsoft Graph izinlerini, SharePoint API izinlerini ve kimlik bilgisi türünü not edin, ardından bunları uygulamak için bu makalenin devamındaki bağlantılı adımları izleyin.

Scenario Microsoft Graph izinleri SharePoint API izinleri Credential Uygulama:
Yalnızca belge kitaplıklarını dizine ekleyin, ACL içe aktarımı yapmayın Files.Read.All, Sites.Read.All (uygulama) veya devredilmiş eşdeğerleri Hiçbiri İstemci parolası (uygulama) veya cihaz kodu (devredilen) 3. Adım, 6. Adım
Dizin listeleri, ASPX sayfaları veya karma içerik (ACL alımı yok) Files.Read.All, Sites.Read.All (uygulama) Hiçbiri İstemci gizli anahtarı veya federasyon kimlik bilgileri 3. Adım
Belge kitaplığı ACL alımı, Microsoft Entra kullanıcılar ve yalnızca standart gruplar Files.Read.All, Sites.FullControl.All (veya Sites.Selected) Hiçbiri İstemci gizli anahtarı veya federasyon kimlik bilgileri 3. Adım, ACL'ye Göre İzinler senaryosu
SharePoint site gruplarının kabul edilmesi gerektiğinde listelerde, ASPX sayfalarında veya belge kitaplıklarında ACL alımı Files.Read.All, Sites.FullControl.All (veya Sites.Selected) Sites.FullControl.All (veya Sites.Selected) Federasyon kimlik bilgileri (gerekli) Kayıtlı uygulamayı yönetilen kimlikle yapılandırma, ACL'ye göre izinler senaryosu
SharePoint site gruplarının sorgu zamanında çözümlemesi Ek Microsoft Graph izinleri gerekmez (belge kitaplıkları, listeler veya ASPX sayfaları da dizine ekleniyorsa önceki satırdan devralınır) User.Read.All Federasyon kimlik bilgileri SharePoint gruplarının desteğini yapılandırın

Notlar:

  • Devredilmiş izinler yalnızca küçük ölçekli testler için uygundur ve ACL alma işlemini desteklemez.
  • Federe kimlik bilgisi, gizli bilgi gerektirmeyen kimlik doğrulaması için önerilen yöntemdir. Hem dizin oluşturucu kimlik doğrulamasını hem de sorgu sırasında SharePoint grubu çözümlemesini kapsar.
  • Sites.Selected kullandığınızda, dizin oluşturmadan önce uygulamaya her hedef SharePoint sitesine açık erişim verin. Bir site açık bir izin olmadan veri kaynağında yapılandırılırsa dizin oluşturucu başarısız olur.
  • Bu matris, giriş noktası özetidir. ACL'ye özgü senaryo ayrıntıları için SharePoint ACL yapılandırma makalesindeki ACL senaryosuna göre Permissions bölümüne bakın.

Desteklenen belge biçimleri

Microsoft 365 dizin oluşturucudaki SharePoint aşağıdaki belge biçimlerinden metin ayıklayabilir:

Sınırlamalar ve dikkat edilmesi gerekenler

Bu özelliğin sınırlamaları şunlardır:

  • OneNote not defteri dosyaları desteklenmez.

  • Artımlı dizin oluşturma sınırlamaları:

    • bir SharePoint klasörünü yeniden adlandırmak artımlı dizin oluşturmayı keser. Yeniden adlandırılan bir klasör yeni içerik olarak değerlendirilir.

    • SharePoint dosya sistemi meta verilerini güncelleştiren Microsoft 365 işlemler, içerikte başka değişiklik olmasa bile artımlı dizin oluşturmayı tetikleyebilir. Dizin oluşturucuya veya yapay zeka zenginleştirmesine güvenmeden önce kurulumunuzu test edin. Microsoft 365 belgelerinizi nasıl işlediğini doğrulayın.

  • Güvenlik sınırlamaları:

Bu özelliği kullanırken dikkat edilmesi gereken bazı noktalar şunlardır:

Seçtiğiniz yaklaşımdan bağımsız olarak, SharePoint web kancalarıyla özel bağlayıcı oluşturma veya Azure Logic Apps iş akışı oluşturma konusunda güçlü güvenlik önlemleri uyguladığınıza emin olun. Önlemler arasında paylaşılan özel bağlantıları yapılandırmak, güvenlik duvarlarını ayarlamak ve kaynaktan gelen kullanıcı izinlerini korumak ve sorgu sırasında bu izinlere uygun davranmak yer alır. Ayrıca işlem hattınızı düzenli olarak denetlemeniz ve izlemeniz gerekir.

Microsoft 365 dizin oluşturucuda SharePoint yapılandırma

Microsoft 365 dizin oluşturucuda SharePoint ayarlamak için önizleme REST API'sini kullanın. Bu bölüm, adımları sunar.

(İsteğe bağlı) 1. Adım: Sistem tarafından atanan yönetilen kimliği etkinleştirme

Arama hizmetinin sağlandığı kiracıyı otomatik olarak algılamak için sistem tarafından atanan yönetilen kimliği etkinleştirin.

SharePoint sitesi arama hizmetiyle aynı kiracıdaysa bu adımı gerçekleştirin. SharePoint sitesi farklı bir kiracıdaysa bu adımı atlayın. Kimlik, kiracı algılama için kullanılır. Kiracı kimliğini bağlantı dizesi koymak isterseniz de bu adımı atlayabilirsiniz. Gizli dizi olmadan dizin oluşturma için sistem tarafından atanan veya kullanıcı tarafından atanan yönetilen kimliği kullanmak üzere, gizli dizi olmadan kimlik doğrulamalı uygulama izinlerini yapılandırın.

Sistem tarafından atanan yönetilen kimliğin nasıl etkinleştirildiğini gösteren ekran görüntüsü.

Kaydet'i seçtikten sonra, arama hizmetinize atanmış bir nesne kimliği alırsınız.

2. Adım: Dizin oluşturucunun hangi izinleri gerektirdiğine karar verme

ACL ve ACL dışı senaryoları kapsayan karar matrisi için bkz. İzin kurulumunuzu seçme. Devredilmiş izinleri seçerseniz, kullanıcıya devredilmiş belirteçlerin süresi 75 dakikada bir dolar ve süreleri dolduğunda Dizin Oluşturucuyu Çalıştır (önizleme) kullanılarak el ile dizinleme yapılması gerekir. Temsilci izinleri yalnızca küçük test işlemleri için önerilir.

3. Adım: Microsoft Entra uygulama kaydı oluşturma

Microsoft 365 dizin oluşturucudaki SharePoint kimlik doğrulaması için bir Microsoft Entra uygulaması kullanır. Azure Yapay Zeka Arama ile aynı kiracıda uygulama kaydını oluşturun.

  1. Azure portalında oturum açın.

  2. Microsoft Entra ID için arama yapın veya gidin, ardından Add>App registration öğesini seçin.

  3. + Yeni kayıt'ı seçin:

    1. Uygulamanız için bir ad girin.
    2. Tek kiracı'yı seçin.
    3. URI belirleme adımını atlayın. Yeniden yönlendirme URI'sine gerek yoktur.
    4. Kayıt seçin.

  4. Manage altındaki gezinti bölmesinde, API izinleri'i ve ardından > İzin ekle ve ardından Microsoft Graph öğesini seçin.

    • Dizin oluşturucunuz uygulama API'si izinlerini kullanıyorsa Uygulama izinleri'ni seçin.

      • Standart dizin oluşturma için şunları seçin:

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

        Uygulama API'si izinlerinin ekran görüntüsü.

      • ACL alma (önizleme) özelliğini etkinleştiriyorsanız, gerekli izinler hangi öğe türlerini (belge kitaplığı dosyaları, liste öğeleri, ASPX sayfaları) ve hangi grup türlerini (Microsoft Entra mı yoksa SharePoint site grupları mı) dizine eklediğinize bağlıdır. Bu adımı tamamlamadan önce bkz. ACL'ye göre izinler senaryosu . Senaryolar arası özet için bkz. İzin kurulumunuzu seçme.

        Uygulama izinlerini kullanmak, dizin oluşturucunun hizmet bağlamında SharePoint sitesine eriştiği anlamına gelir. Bu nedenle dizin oluşturucuyu çalıştırdığınızda, SharePoint kiracıdaki tüm içeriğe erişebilir ve bu da kiracı yöneticisi onayı gerektirir. Kimlik doğrulaması için bir istemci sırrı veya gizli gerektirmeyen yapılandırma da gereklidir. Kimlik doğrulama mekanizmasının ayarlanması, bu makalenin ilerleyen bölümlerinde yalnızca uygulama API izinleri için kimlik doğrulama modları altında açıklanmıştır.

    • Dizin oluşturucu, Temsilci API izinlerini kullanıyorsa, Temsilci izinleri'ni ve ardından Delegated - Files.Read.All, Delegated - Sites.Read.All, ve Delegated - User.Read'yi seçin.

      Temsilci api izinlerini gösteren ekran görüntüsü.

      Temsilci izinleri, arama istemcisinin geçerli kullanıcının güvenlik kimliği altında SharePoint'e bağlanmasını sağlar.

  5. Yönetici onayı verin.

    Uygulama API'si izinleri kullanılırken kiracı yöneticisi onayı gereklidir. Bazı kiracılar, temsilci API izinleri için de kiracı yöneticisi onayı gerektiği şekilde kilitlenir. Bu koşullardan biri geçerliyse, dizin oluşturucuyu oluşturmadan önce kiracı yöneticisinin bu Microsoft Entra uygulaması için onay vermesi gerekir.

    Microsoft Entra uygulamasına yönetici onayı verme ekran görüntüsü.

  6. Kimlik Doğrulaması sekmesini seçin.

  7. Genel istemci akışlarına izin ver'iEvet olarak ayarlayın ve Kaydet'i seçin.

  8. + Platform ekle'yi, ardından Mobil ve masaüstü uygulamaları'ı ve ardından https://login.microsoftonline.com/common/oauth2/nativeclient seçin.

    >Microsoft Entra uygulama kimlik doğrulaması yapılandırmasını gösteren ekran görüntüsü.

  9. Dizin oluşturucu kimlik doğrulama yöntemini çözüm gereksinimlerinize göre yapılandırın.

Yalnızca uygulama API'si izinleri için kullanılabilir kimlik doğrulama yöntemleri

Microsoft Entra uygulamasını uygulama izinleriyle yetkilendirmek için dizin oluşturucu bir istemci sırrı veya sır içermeyen yapılandırma kullanır.

İstemci sırrını kullanma

Bunlar, uygulamayı SharePoint'ten veri alabilmesi için dizin oluşturucuyu kimlik doğrulamak amacıyla bir istemci sırrı kullanacak şekilde yapılandırma yönergeleridir.

  • Soldaki menüden Sertifikalar ve Gizli Bilgiler, İstemci gizli anahtarları ve Yeni istemci gizli anahtarı seçin.

    Yeni istemci sırrını gösteren ekran görüntüsü.

  • Açılan menüde yeni istemci sırrı için bir açıklama girin. Gerekirse son kullanma tarihini ayarlayın. Gizli dizinin süresi dolarsa yeniden oluşturulması ve dizin oluşturucunun yeni gizli diziyle güncelleştirilmesi gerekir.

    Bir istemci sırrının nasıl yapılandırılacağını gösteren ekran görüntüsü.

  • Yeni müşteri sırrı, sırlar listesinde görünür. Sayfadan ayrıldıktan sonra gizli değer görünmez. Bu nedenle, değeri Kopyala düğmesini kullanarak kopyalayın ve güvenli bir konuma kaydedin.

    İstemci sırrının kopyalanacağı yeri gösteren ekran görüntüsü.

Uygulama belirteçlerini almak için gizli olmayan kimlik doğrulaması kullanma

İstemci parolası olmadan oturum açmak için federe kimlik bilgilerini kullanın. Microsoft Entra, bir uygulama erişim belirteci almak için yönetilen kimliğe güvenir; böylece dizin oluşturucu, saklanan bir gizli bilgi olmadan SharePoint'ten verileri alabilir. Sonraki bölümde yönetilen kimlik yapılandırma adımları gösterilmektedir.

Kayıtlı uygulamayı yönetilen kimlikle yapılandırma

  1. Kullanıcı tarafından atanan bir yönetilen kimlik oluşturun (veya seçin) ve senaryo gereksinimlerinize bağlı olarak arama hizmetinize veya sistem tarafından atanan yönetilen kimliğe atayın.

  2. Nesne (asıl) kimliğini yakalayın. Veri kaynağını oluştururken kimlik bilgileri yapılandırmasının bir parçası olarak bu değeri kullanın.

  3. Soldaki menüden Sertifikalar ve Sırlar'ı seçin.

  4. Federasyon kimlik bilgileri altında + Kimlik bilgisi ekle'yi seçin.

  5. Federasyon kimlik bilgisi senaryosu altında Yönetilen Kimlik'i seçin.

  6. Yönetilen kimlik seçin: 1. adımda oluşturulan yönetilen kimliği seçin.

  7. Kimlik bilgileriniz için bir ad ekleyin ve Kaydet'i seçin.

4. Adım: Veri kaynağı oluşturma

Bu bölümden başlayarak, kalan adımlar için tercihinize göre en son önizleme REST API'sini ve REST istemcisini veya desteklenen en son beta SDK'yı kullanın.

Veri kaynağı, verilerdeki değişiklikleri (yeni, değiştirilmiş veya silinmiş satırlar) verimli bir şekilde tanımlamak için dizine eklenecek verileri, kimlik bilgilerini ve ilkeleri belirtir. Aynı arama hizmetindeki birden çok dizin oluşturucu aynı veri kaynağını kullanabilir.

SharePoint dizin oluşturma için veri kaynağının aşağıdaki gerekli özelliklere sahip olması gerekir:

  • Arama hizmetinizdeki veri kaynağının benzersiz adı ad'dır.
  • türü "SharePoint" olmalıdır. Bu değer harf büyüklüğüne duyarlıdır.
  • credentials SharePoint uç noktasını ve uygulamanın Microsoft Entra belirteçlerini istemesine izin verilen kimlik doğrulama yöntemini sağlar. https://[your-tenant-name].sharepoint.com/teams/MySharePointSite örnek SharePoint uç noktasıdır. SharePoint sitenizin giriş sayfasına gidip URL'yi tarayıcıdan kopyalayarak uç noktayı alabilirsiniz. Desteklenen söz dizimi için bağlantı dizesi biçimini gözden geçirin.
  • kapsayıcısı , dizine eklenecek belge kitaplığını belirtir. Özellikler hangi belgelerin dizine eklendiğini denetler.

Veri kaynağı oluşturmak için Veri Kaynağı Oluştur (önizleme) çağrısında bulunur.

Aşağıda, uygulama gizli anahtarı veya sistem tarafından atanan yönetilen kimlik kullanan kimlik bilgileri için bir veri kaynağı tanımı örneği verilmiştir.

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

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

Kullanıcı tarafından atanan yönetilen kimlikler için veri kaynağına identity bloğunu ekleyin ve bağlantı dizesinden FederatedCredentialApplicationId öğesini çıkarın. Sistem tarafından atanan yönetilen kimlikler için bağlantı dizesi FederatedCredentialApplicationId ayarlayın (aşağıdaki bağlantı dizesi biçimlerine bakın).

POST https://[service name].search.windows.net/datasources?api-version=2026-05-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]"
    }
}

Bağlantı dizesi biçimi

bağlantı dizesi biçimi, dizin oluşturucunun temsilcili API izinlerini mi yoksa uygulama API'si izinlerini mi kullandığına bağlı olarak değişir.

  • Temsilcili API izinleri bağlantı dizesi biçimi

    SharePointOnlineEndpoint=[SharePoint site url];ApplicationId=[Azure AD App ID];TenantId=[SharePoint site tenant id]

  • Uygulama API izinleri, uygulama gizli anahtarının bağlantı dizesi formatıyla

    SharePointOnlineEndpoint=[SharePoint site url];ApplicationId=[Azure AD App ID];ApplicationSecret=[Azure AD App client secret];TenantId=[SharePoint site tenant id]

  • Gizli anahtarsız (federe kimlik bilgisi) bağlantı dizesi biçimine sahip Uygulama API izinleri:

    SharePointOnlineEndpoint=[SharePoint site url];ApplicationId=[Azure AD App ID];FederatedCredentialApplicationId=[Entra application (client) ID that the FIC federates to];TenantId=[SharePoint site tenant id]

Aşağıdaki tabloda her bağlantı dizesi alanı açıklanmaktadır.

Alan Zorunlu Açıklama
SharePointOnlineEndpoint Evet SharePoint site URL’si (örneğin, https://[your-tenant-name].sharepoint.com).
ApplicationId Evet Alma uygulamasının Microsoft Entra uygulama (istemci) kimliği. Geçerli bir GUID olmalı.
TenantId Optional Microsoft Entra kiracı GUID'si. SharePoint sitesi arama hizmetinden farklı bir kiracıda olduğunda gereklidir.
ApplicationSecret Conditional Veri alımı uygulamasının istemci parolası. Gizli anahtar tabanlı kimlik doğrulaması için kullanın.
FederatedCredentialApplicationId Koşullu (FIC modu) Federe kimlik kimlik bilgisinin federasyon kurduğu Microsoft Entra uygulama (istemci) kimliği. Geçerli bir GUID olmalı.

Önemli

FederatedCredentialApplicationId ve ApplicationSecret birbirini dışlar. Bunları birleştiren bağlantı dizeleri, veri kaynağı oluşturma veya güncelleştirmede reddedilir.

Not

Geriye dönük uyumluluk için SharePoint dizin oluşturucusu, bağlantı dizesinde hâlâ FederatedCredentialObjectId değerini (içeri aktarma uygulamasındaki federe kimlik bilgisinin nesne/temel kimliği) kabul eder; böylece mevcut veri kaynakları herhangi bir değişiklik gerektirmeden çalışmaya devam eder. Yeni ve güncelleştirilmiş veri kaynakları için kullanın FederatedCredentialApplicationId .

Microsoft 365 aboneliğinizdeki Microsoft Entra yönetim merkezi tenantId sayfasından alabilirsiniz.

Yönetilen kimliği, object (principal) ID yapılandırma bölümünden alabilirsiniz.

Not

SharePoint sitesi, arama hizmetiyle aynı kiracıdaysa ve sistem tarafından atanan yönetilen kimlik etkinleştirildiyse, TenantId bağlantı dizesine dahil edilmesine gerek yoktur. SharePoint sitesi arama hizmetinden farklı bir kiracıdaysa, TenantId eklenmelidir.

Aşağıdaki örnekte ile FederatedCredentialApplicationIdoluşturulan bir veri kaynağı gösterilmektedir:

PUT https://[service name].search.windows.net/datasources/sharepoint-ds?api-version=2026-05-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=[Azure AD App ID];TenantId=[SharePoint site tenant id];FederatedCredentialApplicationId=[Entra application (client) ID that the FIC federates to]"
  },
  "container": { "name": "defaultSiteLibrary" }
}

Dizin oluşturucunuz SharePoint ACL yapılandırmasını (önizleme) veya Microsoft Purview duyarlılık etiketlerini koruma ve uygulama özelliğini (önizleme) kullanıyorsa, dizin oluşturucuyu oluşturmadan önce ilgili makaleleri gözden geçirin. Her özelliğin belirli veri kaynağı, dizin ve beceri kümesi yapılandırma adımları vardır.

5. Adım: Dizin oluşturma

Dizin, bir belgedeki alanları, öznitelikleri ve arama deneyimini şekillendiren diğer yapıları belirtir.

Dizin oluşturmak için Dizin Oluştur 'u (önizleme) çağırarak:

POST https://[service name].search.windows.net/indexes?api-version=2026-05-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 }
    ]
}

Önemli

Microsoft 365 dizin oluşturucusunda SharePoint tarafından doldurulan bir dizindeki anahtar alanı, veri kaynağındaki kapsayıcı türüne bağlıdır:

  • Belge kitaplığı içeriği (defaultSiteLibrary, allSiteLibrariesveya kitaplık veya useQuery klasör filtreleri ile) için kullanın metadata_spo_site_library_item_id. Veri kaynağında bir anahtar alanı yoksa, metadata_spo_site_library_item_id anahtar alanıyla otomatik olarak eşlenir.
  • Liste, sayfa veya karma içerik (allSiteLists, allSitePagesveya allSiteContent) için kullanın metadata_spo_site_asset_item_id. Bu anahtar alanı, 2026-05-01-preview REST API'sinde başlayarak önizleme aşamasındadır. Otomatik eşleme bu alan için geçerli değildir — metadata_spo_site_asset_item_id öğesinden dizin anahtar alanınıza açıkça belirtilmiş bir fieldMappings girişi tanımlayın.

base64Encode Bu anahtar alanlarını dizin id alanınızla eşlerken eşleme işlevini uygulayın.

6. Adım: Dizin oluşturucu oluşturma

Dizin oluşturucu bir veri kaynağını hedef arama dizinine bağlar ve veri yenilemeyi otomatikleştirmek için bir zamanlama sağlar. Veri kaynağı ve dizin oluşturulduktan sonra dizin oluşturucuyu oluşturabilirsiniz.

Dizin oluşturucuyu oluşturmak için:

  1. Dizin Oluşturucu Oluşturma (önizleme) isteği gönderme:

    POST https://[service name].search.windows.net/indexers?api-version=2026-05-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" 
          } 
         }
    ]
}

    allSiteLists, allSitePages veya allSiteContent kapsayıcı değerlerini kullanan veri kaynakları için, metadata_spo_site_library_item_id yerine metadata_spo_site_asset_item_id eşleyin.

    Uygulama izinlerini kullandığınızda, ilk dizin oluşturucu çalıştırması devam ederken dizin sorgulanabilir, ancak yalnızca dizine alınmış olan öğeler sonuçları döndürür. Tam kapsama için çalıştırma tamamlanana kadar bekleyin. Bu adımdaki diğer yönergeler yalnızca temsilci izinlerine uygulanır.

  2. Dizin oluşturucuyu ilk kez oluşturduğunuzda, Dizin Oluşturucu Oluştur (önizleme) isteği bir sonraki adımı tamamlayana kadar bekler. Bağlantıyı almak ve yeni cihaz kodunuzu girmek için Dizin Durumunu Al işlevini çağırmanız gerekir.

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

    Get Indexer Status'u 10 dakika içinde çağırmazsanız kodun süresi dolar ve data source'u yeniden oluşturmanız gerekir.

  3. Dizin Oluşturucu Durumu Al yanıtından cihaz oturum açma kodunu kopyalayın. Cihaz oturum açma bilgileri "errorMessage" içinde bulunabilir.

    {
    "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. Hata iletisine dahil edilen kodu girin.

    Cihaz kodunun nasıl girilir gösteren ekran görüntüsü.

  5. Microsoft 365 dizin oluşturucudaki SharePoint, oturum açmış kullanıcı olarak SharePoint içeriğine erişecektir. Bu adım sırasında oturum açan kullanıcı, oturum açılmış olan kullanıcı olacaktır. Bu nedenle, dizine eklemek istediğiniz Belge Kitaplığı'ndaki bir belgeye erişimi olmayan bir kullanıcı hesabıyla oturum açarsanız, dizin oluşturucunun bu belgeye erişimi olmaz.

    Mümkünse yeni bir kuruluş kullanıcı hesabı oluşturun ve dizin oluşturucunun sahip olmasını istediğiniz tam izinleri verin.

  6. İstenen izinleri onaylayın.

    API izinlerini onaylamayı gösteren ekran görüntüsü.

  7. Yukarıda verilen tüm izinler doğruysa ve 10 dakikalık zaman çerçevesi içindeyse Dizin Oluşturucu Oluştur (önizleme) ilk isteği tamamlar.

Not

Microsoft Entra uygulaması yönetici onayı gerektiriyorsa ve oturum açmadan önce onaylanmamışsa aşağıdaki ekranı görebilirsiniz. Devam etmek için yönetici onayı gereklidir.

Yönetici onayının gerekli olduğunu gösteren ekran görüntüsü.

7. Adım: Dizin oluşturucunun durumunu denetleme

Dizin oluşturucu oluşturulduktan sonra Dizin Oluşturucu Durumunu Al'ı çağırabilirsiniz:

GET https://[service name].search.windows.net/indexers/sharepoint-indexer/status?api-version=2026-05-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-05-01-preview
api-key: [admin-api-key]

Veri kaynağını güncelleştirme

Veri kaynağı nesnesinde güncelleştirme yoksa, dizin oluşturucu herhangi bir kullanıcı etkileşimi olmadan bir zamanlamaya göre çalışır.

Cihaz kodunun süresi dolduğunda veri kaynağını değiştirirseniz dizin oluşturucuyu çalıştırmak için yeniden oturum açın. Örneğin, veri kaynağı sorgusunu değiştirirseniz, kullanarak yeniden https://microsoft.com/devicelogin oturum açın ve yeni cihaz kodunu alın.

Süresi dolmuş bir cihaz kodu varsayarak veri kaynağını güncelleştirme adımları şunlardır:

  1. Dizin oluşturucu yürütmesini el ile başlatmak için Çalıştır Dizin Oluşturucusu'na (önizleme) çağrı yapın.

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

  2. Dizin oluşturucunun durumunu denetleyin.

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

  3. Eğer sizden https://microsoft.com/devicelogin adresini ziyaret etmenizi isteyen bir hata alırsanız, sayfayı açın ve yeni kodu kopyalayın.

  4. Kodu iletişim kutusuna yapıştırın.

  5. Dizin oluşturucuyu el ile yeniden çalıştırın ve dizin oluşturucunun durumunu denetleyin. Bu kez dizin oluşturucu çalıştırması başarıyla başlatılmalıdır.

Belge meta verilerini dizine alın

Belge meta verilerini ()"dataToExtract": "contentAndMetadata" dizine kaydediyorsanız, aşağıdaki meta veriler dizine alınabilir.

Tanımlayıcı Türü Açıklama
metadata_spo_site_library_item_id Edm.String Sitenin belge kitaplığındaki bir öğeyi benzersiz olarak tanımlayan site kimliği, kitaplık kimliği ve öğe kimliğinin birleşim anahtarı. Bu alanı, defaultSiteLibrary, allSiteLibraries ve useQuery (kitaplık veya klasör filtreleri) kapsayıcı değerleri için dizin anahtarı olarak kullanın.
metadata_spo_site_asset_item_id Edm.String Liste öğesini, ASPX site sayfasını veya karma içerik modundaki herhangi bir varlığı benzersiz olarak tanımlayan birleşim anahtarı. Bu alanı , allSiteListsve allSitePages kapsayıcı değerlerinin allSiteContentdizin anahtarı olarak kullanın. Önizleme, 2026-05-01-preview REST API'sinde başlar.
metadata_spo_site_id Edm.String SharePoint sitesinin kimliği.
metadata_spo_library_id Edm.String Belge kitaplığının kimliği.
meta_veri_spo_öğe_kimliği Edm.String Kitaplıktaki (belge) öğenin kimliği.
Öğe Son Değiştirilme Metaverisi Edm.DateTimeOffset Öğenin son değiştirme tarihi/saati (UTC).
metadata_spo_item_name (Öğe Adı Meta Verisi) Edm.String Öğenin adı.
meta_veri_spo_öğe_boyutu Edm.Int64 Öğenin boyutu (bayt cinsinden).
metadata_spo_öğe_içerik_türü Edm.String Öğenin içerik türü.
metadata_spo_öğe_uzantısı Edm.String Öğenin uzantısı.
metadata_spo_item_weburi Edm.String Öğenin URI'sini.
metadata_spo_öğe_yolu Edm.String Üst yol ve öğe adının birleşimi.

Microsoft 365 dizin oluşturucudaki SharePoint her belge türüne özgü meta verileri de destekler. Daha fazla bilgi için, Azure Yapay Zeka Arama'te kullanılan içerik meta veri özellikleri'ne bakın.

Not

Özel meta verileri dizine almak için veri kaynağının sorgu parametresinde "additionalColumns" belirtilmelidir.

SharePoint listelerini dizine ekle

SharePoint listeleri 2026-05-01-preview REST API'sinde başlayarak önizlemede dizinlenebilir. Bir sitedeki tüm liste öğelerini dizine almak veya liste öğelerini belge kitaplıkları ve site sayfalarıyla tek bir dizin oluşturucuda birleştirmek için container.name veri kaynağını allSiteListsallSiteContent olarak ayarlayın. Alt site listelerini eklemek için container.query öğesine includeSubsites=true ekleyin.

Liste tabanlı veya karma içerikli dizin oluşturucular için dizin anahtarı alanı, metadata_spo_site_asset_item_id öğesinden eşlenmelidir. Liste öğesi içeriği, JSON biçiminde alan değerleri olarak content alanında sunulur ve her liste öğesi için standart metadata_spo_item_* alanları (metadata_spo_item_name, metadata_spo_item_weburi ve metadata_spo_item_last_modified gibi) doldurulur.

Liste sütunlarını dizin alanlarıyla eşleyin

Bir SharePoint listesinde tanımlanan her sütun, SharePoint sütunuyla aynı adı taşıyan bir kaynak alanı olarak sunulur. Alan eşlemelerini kullanarak her sütunu bir dizin alanına eşleyebilirsiniz.

Örneğin, aşağıdaki sütunları içeren bir SharePoint list düşünün.

SharePoint sütunu SharePoint sütun türü
Title Tek metin satırı
Price Sayı
InStock Yes/No
Category Seçenek

Dizin tanımınıza eşleşen alanlar ekleyin, sonra her sütunu dizin oluşturucudaki hedef alanına eşleyin:

{
  "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" }
  ]
}

Her hedef alanın dizininizde uyumlu bir türle (örneğin, Edm.String için TitleEdm.Double veya Edm.Int64 için PriceEdm.BooleanInStock) var olduğundan emin olun.

ASPX site sayfalarını dizine ekleme

Modern ASPX site sayfaları, 2026-05-01-preview REST API'sinde başlayarak önizlemede dizinlenebilir. Veri kaynağını container.nameallSitePages bir sitedeki tüm sayfaları dizine almak veya allSiteContent sayfaları tek bir dizin oluşturucudaki belge kitaplıkları ve listeleriyle birleştirmek için olarak ayarlayın. Alt site sayfalarını eklemek için container.query öğesine includeSubsites=true ekleyin.

Sayfa tabanlı veya karışık içerikli dizin oluşturucularda, dizin anahtarı alanı metadata_spo_site_asset_item_id öğesinden eşlenmelidir. Sayfa metni content alanına çıkarılır ve her sayfa için standart metadata_spo_item_* alanları (örneğin metadata_spo_item_name, metadata_spo_item_weburi ve metadata_spo_item_last_modified) doldurulur.

Dosya türüne göre dahil et veya hariç tut

Dizin oluşturucu tanımının "parametreler" bölümünde ekleme ve dışlama ölçütlerini ayarlayarak hangi dosyaların dizine alınabileceğini denetleyebilirsiniz.

Belirli dosya uzantılarını, virgülle ayrılmış dosya uzantıları listesine ayarlayarak "indexedFileNameExtensions" (baştaki noktayla) ekleyin. Belirli dosya uzantılarını hariç tutmak için "excludedFileNameExtensions" ile atlanması gereken uzantıları belirleyin. Aynı uzantı her iki listede de yer alırsa dizin oluşturmanın dışında tutulur.

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

Hangi belgelerin dizine eklendiğini denetleme

Microsoft 365 dizin oluşturucudaki tek bir SharePoint, bir veya daha fazla belge kitaplığındaki içeriği dizine alabilir. Dizine eklenecek siteleri ve belge kitaplıklarını belirtmek için veri kaynağı tanımındaki "container" parametresini kullanın.

Veri kaynağı "kapsayıcı" bölümü bu görev için iki özelliğe sahiptir: "name" ve "query".

Adı

"name" özelliği gereklidir ve üç değerden biri olmalıdır:

Değer Açıklama
varsayılanSiteKütüphanesi Sitenin varsayılan belge kitaplığındaki tüm içeriği dizine alın.
tümSiteKütüphaneleri Sitedeki tüm belge kitaplıklarındaki tüm içeriği dizine alın. Sorguda ayarlamadığınız includeSubsites=true sürece bir alt sitedeki belge kitaplıkları kapsam dışındadır (önizleme, 2026-05-01-preview). Ayrıca useQuery seçebilir ve kapsamı belirli siteler veya alt sitelerle sınırlandırmak için includeLibrariesInSite belirtebilirsiniz.
allSiteLists Siteden tüm SharePoint list öğelerini dizine alın. Önizleme, 2026-05-01-preview REST API'sinde başlar.
allSitePages Bir sitedeki tüm modern ASPX site sayfalarını dizine alın. Önizleme, 2026-05-01-preview REST API'sinde başlar.
allSiteContent Bir sitedeki kitaplıkları, listeleri ve sayfaları tek bir dizin oluşturucuda dizinleyin. Önizleme, 2026-05-01-preview REST API'sinde başlar.
useQuery Yalnızca query içinde tanımlanan içeriği dizine ekleyin.

allSiteLists, allSitePages veya allSiteContent kullanan veri kaynakları için dizin oluşturucu anahtar alan eşlemesi, metadata_spo_site_library_item_id yerine metadata_spo_site_asset_item_id kullanmalıdır. Ayrıntılar için bkz. 6. Adım: Dizin oluşturucu oluşturma.

Sorgu

Veri kaynağının "query" parametresi anahtar sözcük/değer çiftlerinden oluşur. Aşağıdaki anahtar sözcükler kullanılabilir. Değerler site URL'leri veya belge kitaplığı URL'leridir.

Not

Belirli bir anahtar sözcüğün değerini almak için, eklemek veya dışlamak istediğiniz belge kitaplığına gidin ve URI'yi tarayıcıdan kopyalayın. Bu, sorgudaki bir anahtar sözcükle kullanılacak değeri almanın en kolay yoludur.

Anahtar kelime Değer açıklaması ve örnekler
Null Null veya boşsa, kapsayıcı adına bağlı olarak varsayılan belge kitaplığını veya tüm belge kitaplıklarını dizine ekleyin.

Örnek:

"container" : { "name" : "defaultSiteLibrary", "query" : null }
Alt siteleri dahil et olarak ayarlandığında true, dizin oluşturucu kök siteyi ve tüm alt siteleri gezer. allSiteLibraries, allSiteLists, allSitePages veya allSiteContent ile birleştirin. Önizleme, 2026-05-01-preview REST API'sinde başlar.

Örnek:

"container" : { "name" : "allSiteLibraries", "query" : "includeSubsites=true" }
kütüphaneleriSiteyeDahilEt Belirtilen bağlantı dizgesindeki sitenin altındaki tüm kitaplıklardan içerik indeksleyin. Değer, sitenin veya alt sitenin URI'si olmalıdır.

Örnek 1:

"container" : { "name" : "useQuery", "query" : "includeLibrariesInSite=https://mycompany.sharepoint.com/mysite" }

Örnek 2 (yalnızca birkaç alt site içerir):

"container" : { "name" : "useQuery", "query" : "includeLibrariesInSite=https://mycompany.sharepoint.com/sites/TopSite/SubSite1;includeLibrariesInSite=https://mycompany.sharepoint.com/sites/TopSite/SubSite2" }
includeLibrary Bu kitaplıktan tüm içeriği dizine alın. Değer, tarayıcınızdan kopyalanabilen kitaplığın tam yoludur:

Örnek 1 (tam yol):

"container" : { "name" : "useQuery", "query" : "includeLibrary=https://mycompany.sharepoint.com/mysite/MyDocumentLibrary" }

Örnek 2 (tarayıcınızdan kopyalanan URI):

"container" : { "name" : "useQuery", "query" : "includeLibrary=https://mycompany.sharepoint.com/teams/mysite/MyDocumentLibrary/Forms/AllItems.aspx" }
kütüphaneyi dışla Bu kütüphaneden içerik indeksleme yapmayın. Değer, tarayıcınızdan kopyalanabilen kitaplığın tam yoludur:

Örnek 1 (tam yol):

"container" : { "name" : "useQuery", "query" : "includeLibrariesInSite=https://mysite.sharepoint.com/subsite1; excludeLibrary=https://mysite.sharepoint.com/subsite1/MyDocumentLibrary" }

Örnek 2 (tarayıcınızdan kopyalanan URI):

"container" : { "name" : "useQuery", "query" : "includeLibrariesInSite=https://mycompany.sharepoint.com/teams/mysite; excludeLibrary=https://mycompany.sharepoint.com/teams/mysite/MyDocumentLibrary/Forms/AllItems.aspx" }
klasörDahilEt Belirli bir klasörü ve alt klasörlerini dizinle. Değer tam bir SharePoint klasör URL'si olmalıdır.

Davranış: Tüm alt klasörlere özyinelemeli olarak uygulanır. Parametre noktalı virgülle yinelenerek birden çok klasör belirtilebilir. Klasör filtrelerinin kapsamı tek bir belge kitaplığı olarak belirlenmiş. Yalnızca kök yollar desteklenmez. Başvuruda bulunılan bir klasör yeniden adlandırılırsa, sorgu güncelleştirilmelidir.

Örnek 1 (tek klasör):
"container": { "name": "useQuery", "query": "includeFolder=[your-tenant-name].sharepoint.com/sites/hr/Shared Documents/Policies" }

Örnek 2 (birden çok klasör):
"container": { "name": "useQuery", "query": "includeFolder=[your-tenant-name].sharepoint.com/sites/hr/Shared Documents/Specs;includeFolder=[your-tenant-name].sharepoint.com/sites/hr/Shared Documents/Designs" }
klasörüHariçTut Belirli bir klasördeki ve alt klasörlerindeki içeriği dizine eklemeyin. Değer tam bir SharePoint klasör URL'si olmalıdır.

Davranış: Tüm alt klasörlere özyinelemeli olarak uygulanır. Bir dosya hem ekleme hem de dışlama kurallarıyla eşleşiyorsa, dışlama öncelikli olur ve dosya atlanır. Klasör filtrelerinin kapsamı tek bir belge kitaplığı olarak belirlenmiş.

Örnek 1 (klasörü dışla):
"container": { "name": "useQuery", "query": "excludeFolder=[your-tenant-name].sharepoint.com/sites/hr/Shared Documents/Policies/Archive" }

Örnek 2 (ekleme + dışlama işlevini birleştirin):
"container": { "name": "useQuery", "query": "includeFolder=[your-tenant-name].sharepoint.com/sites/hr/Shared Documents/Policies;excludeFolder=[your-tenant-name].sharepoint.com/sites/hr/Shared Documents/Policies/Drafts" }
additionalColumns Belge kitaplığındaki dizin sütunları. Değer, dizine eklemek istediğiniz sütun adlarının virgülle ayrılmış bir listesidir. Sütun adlarında noktalı virgüllerden ve virgüllerden kurtulmak için çift ters eğik çizgi kullanın:

Örnek 1 (ekKolonlar=MyCustomColumn,MyCustomColumn2):

"container" : { "name" : "useQuery", "query" : "includeLibrary=https://mycompany.sharepoint.com/mysite/MyDocumentLibrary;additionalColumns=MyCustomColumn,MyCustomColumn2" }

Örnek 2 (çift ters eğik çizgi kullanan kaçış karakterleri):

"container" : { "name" : "useQuery", "query" : "includeLibrary=https://mycompany.sharepoint.com/teams/mysite/MyDocumentLibrary/Forms/AllItems.aspx;additionalColumns=MyCustomColumnWith\\,,MyCustomColumnWith\\;" }

Hatalarla başa çıkma

Varsayılan olarak, Microsoft 365 dizin oluşturucudaki SharePoint, resim gibi desteklenmeyen içerik türüne sahip bir belgeyle karşılaştığı anda durur. Parametresini excludedFileNameExtensions kullanarak belirli içerik türlerini atlayabilirsiniz. Ancak, tüm olası içerik türlerini önceden bilmeden belgeleri dizine almanız gerekebilir. Desteklenmeyen bir içerik türüyle karşılaşıldığında dizin oluşturma işlemine devam etmek için yapılandırma parametresini failOnUnsupportedContentType false olarak ayarlayın:

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

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

Bazı belgeler için, Azure Yapay Zeka Arama içerik türünü belirleyemiyor veya başka bir şekilde desteklenen içerik türündeki bir belgeyi işleyemiyor. Bu hata modunu yoksaymak için yapılandırma parametresini failOnUnprocessableDocument false olarak ayarlayın:

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

Azure Yapay Zeka Arama, dizine alınan belgelerin boyutunu sınırlar. Bu sınırlar Azure Yapay Zeka Arama içindeki Service Sınırları'nda belgelenmiştir. Aşırı büyük belgeler, varsayılan ayarda hata olarak işlenir. Ancak, yapılandırma parametresini true olarak ayarlarsanız indexStorageMetadataOnlyForOversizedDocuments büyük büyük belgelerin depolama meta verilerini dizine almaya devam edebilirsiniz:

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

Ayrıca, belgeler ayrıştırırken veya bir dizine belge eklerken herhangi bir işleme noktasında hata oluşursa dizine eklemeye devam edebilirsiniz. Belirli sayıda hatayı yoksaymak için maxFailedItems ve maxFailedItemsPerBatch yapılandırma parametrelerini istenen değerlere ayarlayın. Örneğin:

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

SharePoint sitesindeki bir dosyada şifreleme etkinleştirildiyse aşağıdaki hata iletisini görebilirsiniz:

Code: resourceModified Message: The resource has changed since the caller last read it; usually an eTag mismatch Inner error: Code: irmEncryptFailedToFindProtector

Hata iletisi aşağıdaki desende SharePoint site kimliğini, sürücü kimliğini ve sürücü öğesi kimliğini de içerir: <sharepoint site id> :: <drive id> :: <drive item id>. SharePoint ucunda hangi öğenin başarısız olduğunu belirlemek için bu bilgileri kullanın. Kullanıcı daha sonra sorunu çözmek için öğeden şifrelemeyi kaldırabilir.

İlgili içerik

  • Last updated on