SharePoint referansı (önizleme)

Note

Bu makale, standard harness ile desteklenen ajanlarda veya ajan akışlarında kullanılan özellikleri açıklamaktadır.

Important

Bu bir önizleme özelliğidir.

• Microsoft, müşterilerin erken erişim elde edebilmesi ve geri bildirim sağlayabilmesi için önizleme özelliklerini resmi bir sürümden önce yayınlar.
• Önizleme özellikleri sınırlı işlevlere sahiptir ve üretim kullanımı için tasarlanmamıştır.
• Microsoft, önizleme MCP araç adlarını ve parametrelerini değiştirebilir. Sabit kodlanmış bağımlılıklardan kaçının. Microsoft senaryo desteğini korur.
• Önizleme özellikleri Microsoft ek kullanım koşullarına tabidir.

Genel Bakış

Sunucu Kimliği	Kiracı düzeyinde URL	Ekran adı	Description
mcp_SharePointRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_SharePointRemoteServer	SharePoint	SharePoint işlemleri için araçlar. Siteleri, listeleri, liste öğelerini, sütunları, belge kitaplıklarını, dosyaları, klasörleri ve dosya paylaşımını yönetmek için bu sunucuyu kullanın. Dosya işlemleri 5 MB veya daha az olan dosyalarla sınırlıdır.

Kullanılabilir araçlar

findSite

Erişebileceğiniz SharePoint siteleri bulur. Arama sorgusuyla eşleşen belirli siteleri veya sorgu sağlamazsanız ilgili en iyi 20 siteyi döndürür.

İsteğe bağlı parametreler:

• searchQuery: Arama sorgusu (site adının tamamı veya bir kısmı). İlk 20 erişilebilir siteyi döndürmek için atla.

getSiteByPath

Tam ana bilgisayar adını ve sunucu göreli yolunu kullanarak bir SharePoint sitesini çözümler. Bu yöntemi yalnızca tam site URL'si yapısına sahip olduğunuzda kullanın. Yalnızca bir site adı biliyorsanız kullanın findSite .

Gerekli parametreler:

• Hostname: Tam konak adı (örneğin, 'contoso.sharepoint.com')
• serverRelativePath: Sunucu göreli yolu (örneğin, 'siteler/Pazarlama'). Baştaki eğik çizgi isteğe bağlıdır.

listSubsites

bir SharePoint sitesinin tüm alt sitelerini (alt siteler) listeler.

Gerekli parametreler:

• siteId: Üst SharePoint sitesinin kimliği (biçim: 'ana bilgisayar adı,siteCollectionId,webId')

Sitedeki Belge Kitaplıklarını Listele

Belirtilen SharePoint sitesindeki belge kitaplıklarını (sürücüleri) listeler.

İsteğe bağlı parametreler:

• SharePoint sitesinin siteId: kimliği (varsayılan: 'root')

getDefaultDocumentLibraryInSite

SharePoint sitesinde varsayılan belge kitaplığını (sürücü) alır.

İsteğe bağlı parametreler:

• SharePoint sitesinin siteId: kimliği (varsayılan: 'root')

getFolderChildren

Belge kitaplığında (sürücü) belirtilen üst klasörde yer alan ilk 20 dosya ve klasörü (DriveItems) numaralandırır.

Gerekli parametreler:

• documentLibraryId: Belge kitaplığının (sürücü) kimliği

İsteğe bağlı parametreler:

• parentFolderId: Ana klasörün kimliği (varsayılan: 'root').

dosyaVeyaKlasorBul

Arama sorgusuyla kullanıcının erişebileceği bir dosya veya klasör (DriveItem) bulur. Kullanıcının erişimi olan tüm siteler ve belge kitaplıkları arasında aramalar.

Gerekli parametreler:

• searchQuery: Arama sorgusu (tam veya kısmi dosya adı)

getFileOrFolderMetadata

SharePoint belirtilen belge kitaplığından (sürücü) bir dosya veya klasörün (DriveItem) meta verilerini alır.

Gerekli parametreler:

• fileOrFolderId: Dosya veya klasörün kimliği (DriveItem)
• documentLibraryId: Belge kitaplığının (sürücü) kimliği

getFileOrFolderMetadataByUrl

Bir dosya veya klasör (DriveItem) için meta veriyi paylaşım URL'sinden alır. Yalnızca dosyaya erişmek için açık izinleri olan kullanıcılar meta verileri alabilir.

Gerekli parametreler:

• fileOrFolderUrl: Dosya veya klasörün URL'si. URL, kullanıcıyla paylaşmak için kullanılmaz; açık erişime sahip olmaları gerekir.

readSmallTextFile

Belirli bir belge kütüphanesinden (sürücüden) 5 MB'tan küçük bir metin dosyasını okur (indirir).

Gerekli parametreler:

• fileId: Okunacak veya indirilmesi gereken dosyanın kimliği (DriveItem)
• documentLibraryId: Belge kitaplığının (sürücü) kimliği

readSmallBinaryFile

Belirli bir belge kitaplığından (sürücü) 5 MB'tan küçük bir ikili dosyayı okur. Dosya içeriği base64 ile kodlanmış bir dize olarak döndürülür.

Gerekli parametreler:

• fileId: Okunacak veya indirilmesi gereken dosyanın kimliği (DriveItem)
• documentLibraryId: Belge kitaplığının (sürücü) kimliği

createSmallTextFile (küçükMetinDosyasıOluştur)

5 MB'den küçük bir metin dosyası belirli bir belge kütüphanesine (sürücüye) yükler veya oluşturur.

Gerekli parametreler:

• Dosya adı: Dosyanın adı, uzantı dahil.
• içerikMetin: Dosyanın metin içeriği.
• documentLibraryId: Belge kitaplığının (sürücü) kimliği

İsteğe bağlı parametreler:

• parentFolderId: Ana klasörün kimliği (varsayılan: 'root').

createSmallBinaryFile

İçeriğini belirli bir belge kitaplığına (sürücü) kodlamak için base64 ile 5 MB'tan küçük bir ikili dosya oluşturur.

Gerekli parametreler:

• Dosya adı: Dosyanın adı, uzantı dahil.
• base64Content: Base64 dizesi olarak kodlanmış ikili dosya içeriği.
• documentLibraryId: Belge kitaplığının (sürücü) kimliği

İsteğe bağlı parametreler:

• parentFolderId: Ana klasörün kimliği (varsayılan: 'root').

klasörOluştur

Belirtilen belge kitaplığında (sürücü) yeni bir klasör (DriveItem) oluşturur. Aynı ada sahip bir klasör varsa, sistem sayısal bir sonek ekler (örneğin, NewFolder (1)).

Gerekli parametreler:

• Klasöradı: Klasörün adı
• documentLibraryId: Belge kitaplığının (sürücü) kimliği

İsteğe bağlı parametreler:

• parentFolderId: Ana klasörün kimliği (varsayılan: 'root').

dosyaVeyaKlasörAdınıDeğiştir

Belirtilen belge kitaplığındaki (sürücü) bir dosya veya klasörü (DriveItem) yeniden adlandırır. Yeni adın adlandırma kurallarına uyması gerekir.

Gerekli parametreler:

• documentLibraryId: Belge kitaplığının (sürücü) kimliği
• fileOrFolderId: Yeniden adlandıracak dosya veya klasörün kimliği
• newFileOrFolderName: Yeni ad

İsteğe bağlı parametreler:

• Etag: Eşzamanlılık denetimi için ETag

dosyaVeyaKlasörSil

Belirtilen belge kitaplığından (sürücü) bir dosya veya klasörü (DriveItem) siler.

Gerekli parametreler:

• documentLibraryId: Belge kitaplığının (sürücü) kimliği
• fileOrFolderId: Silinecek dosya veya klasörün kimliği

İsteğe bağlı parametreler:

• Etag: Eşzamanlılık denetimi için ETag

Dosya veya Klasörü Taşı

Bir dosya veya klasörü (DriveItem) hedef klasöre taşır. SharePoint içinde farklı belge kitaplıkları (sürücüler) arasında taşımayı destekler. Bu işlem zaman uyumsuzdur. İlerleme durumunu izlemek için kullanın checkOperationStatus .

Gerekli parametreler:

• sourcedoclibid: Kaynak belge kitaplığının (sürücü) kimliği
• sourcefileid: Taşınacak kaynak dosyanın veya klasörün kimliği
• destdoclibid: Hedef belge kitaplığının (sürücü) kimliği
• destfolderid: Hedef klasörün kimliği (mevcut olmalıdır)

İsteğe bağlı parametreler:

• newfilename: Taşınan öğenin yeni adı

DosyaVeyaKlasörüKopyala

Bir dosya veya klasörü (DriveItem) hedef klasöre kopyalar. SharePoint içindeki farklı belge kitaplıkları arasında kopyalamayı destekler. Bu işlem zaman uyumsuzdur. İlerleme durumunu izlemek için kullanın checkOperationStatus .

Gerekli parametreler:

• sourcedoclibid: Kaynak belge kitaplığının (sürücü) kimliği
• sourcefileid: Kopyalanacak kaynak dosya veya klasörün kimliği
• destdoclibid: Hedef belge kitaplığının (sürücü) kimliği
• destfolderid: Hedef klasörün kimliği (mevcut olmalıdır)

İsteğe bağlı parametreler:

• newfilename: Kopyalanan öğenin yeni adı

checkOperationStatus

Özgün işlemden döndürülen işlem belirtecini kullanarak kopyalama veya taşıma gibi zaman uyumsuz bir işlemin durumunu denetler.

Gerekli parametreler:

• operationToken:copyFileOrFolder veya moveFileOrFolder gibi zaman uyumsuz bir işlem tarafından döndürülen işlem belirteci

uploadFileFromUrl

SharePoint veya OneDrive URL'sinden bir belge kitaplığındaki (sürücü) hedef klasöre dosya yükler. Dosya kaynak URL'den kopyalandığından özgün dosya değiştirilmez.

Gerekli parametreler:

• sourceUrl: Kaynak URL'si (geçerli bir SharePoint veya OneDrive URL'si olmalıdır)
• destinationDocumentLibraryId: Hedef belge kitaplığının kimliği. Kullanıcının OneDrive için me kullanma

İsteğe bağlı parametreler:

• destinationFolderId: Hedef klasörün kimliği (varsayılan: root)
• Dosyaadı: Yeni dosya adı; varsayılan olarak özgün dosya adını kullanır

dosyaVeyaKlasörPaylaş

Belirtilen belge kitaplığındaki (sürücü) bir dosya veya klasörde (DriveItem) okuma veya yazma izinleri vermek için paylaşım daveti gönderir.

Gerekli parametreler:

• documentLibraryId: Belge kitaplığının (sürücü) kimliği
• fileOrFolderId: Paylaşacak dosyanın veya klasörün kimliği
• recipientEmails: Alıcıların e-posta adresleri dizisi
• Rolleri: Rol dizisi: 'read', 'write' (yazma hem okuma hem de yazma izni verir)

İsteğe bağlı parametreler:

• İleti: Davet e-postası için özel ileti (varsayılan: üzerinde işbirliği yaptığımız dosya aşağıdadır.)
• sendInvitation: Paylaşım daveti gönderip göndermeme (varsayılan: true)

SetSensitivityLabelOnFile (Dosya Üzerine Hassasiyet Etiketi Ayarla)

Belirtilen belge kitaplığından (sürücü) bir dosyanın duyarlılık etiketini ayarlar.

Gerekli parametreler:

• documentLibraryId: Belge kitaplığının (sürücü) kimliği
• fileId: Dosyanın kimliği (DriveItem)
• sensitivityLabelId: Duyarlılık etiketinin ID'si veya etiketi kaldırmak için boş bir dize

İsteğe bağlı parametreler:

• assignmentMethod: Atama yöntemi: 'standard', 'privileged', 'auto' veya 'unknownFutureValue' (varsayılan: 'privileged')
• justificationText: Denetim amacıyla gerekçe metni; bir etiketi düşürerken veya kaldırırken gereklidir (varsayılan: 'MCPServer tarafından değiştirildi')

listLists

Belirli bir sitede kullanılabilen tüm SharePoint listelerini alır. Site içinde hangi listelerin mevcut olduğunu bulmak için kullanın.

Gerekli parametreler:

• SharePoint sitesinin siteId: kimliği (biçim: 'hostname,siteCollectionId,webId')

createList

Site içinde yeni bir SharePoint list oluşturur.

Gerekli parametreler:

• SharePoint sitesinin siteId: kimliği
• Displayname: Yeni listenin görünen adı

İsteğe bağlı parametreler:

• Sütunlar: Anahtar-değer çiftlerinden oluşan sütun koleksiyonu: [{ Key: 'JobTitle', Value: 'text' }]. Geçerli türler: text, multilineText, number, boolean, dateTime, choice, lookup, personOrGroup, hyperlink, currency, calculated
• Şablon: Liste şablonu türü (varsayılan: 'genericList'). Seçenekler: genel liste, belge kitaplığı, olaylar, görevler, duyurular, kişiler, bağlantılar, anket, sorun izleme, tartışma panosu

deleteList

Bir sitedeki SharePoint listesini siler. Liste kapsayıcısının tamamını ve içindeki tüm öğeleri siler. Bu eylem geri alınamaz.

Gerekli parametreler:

• SharePoint sitesinin siteId: kimliği
• listId: Silinecek listenin kimliği

İsteğe bağlı parametreler:

• Etag: Eşzamanlılık denetimi için ETag

Liste için davet gönder

Bir SharePoint listesinde izinler vermek için paylaşım daveti gönderir.

Gerekli parametreler:

• listId: paylaşılacak SharePoint listesinin kimliği
• recipientEmails: Alıcıların e-posta adresleri dizisi
• Rolü: Rol: 'read' (yalnızca görüntüleme), 'contribute' (öğeleri görüntüleme, ekleme, güncelleştirme, silme), 'edit' (liste yapısı dahil tam düzenleme)

İsteğe bağlı parametreler:

• siteUrl: Listeyi içeren SharePoint sitesinin Site URL'si
• sendEmail: E-posta bildirimi gönderip göndermeme (varsayılan: true)

listListItems

Belirli bir SharePoint listesinden öğeleri (satırları/kayıtları) alır.

Gerekli parametreler:

• SharePoint sitesinin siteId: kimliği
• listId: SharePoint listesinin kimliği

getListItem

Bir SharePoint listesinden kimliğine göre tek bir öğe (satır veya kayıt) alır.

Gerekli parametreler:

• SharePoint sitesinin siteId: kimliği
• listId: SharePoint listesinin kimliği
• ıtemıd: Belirli liste öğesinin kimliği

createListItem

SharePoint listesinde yeni bir öğe (satır veya kayıt) oluşturur.

Gerekli parametreler:

• SharePoint sitesinin siteId: kimliği
• listId: SharePoint listesinin kimliği
• Alanlar: Alan değerleri için anahtar-değer çiftleri, örneğin [{ Key: 'Title', Value: 'Software Engineer' }, { Key: 'Department', Value: 'Engineering' }]. 'Başlık' alanı genellikle gereklidir.

updateListItem

SharePoint list varolan bir öğeyi (satır veya kayıt) güncelleştirir. Yalnızca belirtilen alanlar güncelleştirilir; atlanmış alanlar değerlerini tutar.

Gerekli parametreler:

• SharePoint sitesinin siteId: kimliği
• listId: SharePoint listesinin kimliği
• ıtemıd: Güncelleştirilecek öğenin kimliği
• Alanları: Güncelleştirilecek alanların anahtar-değer çiftleri

İsteğe bağlı parametreler:

• Etag: Eşzamanlılık denetimi için ETag

liste öğesini sil

Bir öğeyi (satır veya kayıt) SharePoint listesinden siler.

Gerekli parametreler:

• SharePoint sitesinin siteId: kimliği
• listId: SharePoint listesinin kimliği
• ıtemıd: Silinecek öğenin kimliği

İsteğe bağlı parametreler:

• Etag: Eşzamanlılık denetimi için ETag

sütunlarıListele

Bir SharePoint listesindeki tüm sütunları alır.

Gerekli parametreler:

• SharePoint sitesinin siteId: kimliği
• listId: SharePoint listesinin kimliği

Sütun oluştur

Bir SharePoint listesinde yeni bir sütun oluşturur. Metin, sayı, seçim, dateTime, boole, kullanıcı, arama, hesaplanan ve daha fazlası gibi birçok sütun türünü destekler.

Gerekli parametreler:

• SharePoint sitesinin siteId: kimliği
• listId: SharePoint listesinin kimliği
• Adı: İç sütun adı (programlı tanımlayıcı)
• Columntype: Sütun türü: text, note, number, integer, boolean, dateTime, choice, multichoice, currency, lookup, user, url, hesaplanan, terim, multiterm, location, geolocation, thumbnail, counter, computed, contentTypeId, file, attachment, guid, outcomeChoice, approvalStatus

İsteğe bağlı parametreler:

• columnProperties: Türe özgü ayarlar (örneğin, { "maxLength": 255 } metin için, { "choices": ["A","B","C"] } tercih için)
• Açıklama: Sütunun açıklaması
• Displayname: Kullanıcı arabiriminde gösterilen görünen ad (varsayılan olarak 'name' olarak gösterilir)
• zorunlu: Sütunu zorunlu yapın (varsayılan: false)
• Gizli: Sütunu görünümlerden gizleme (varsayılan: false)

updateColumn

Bir SharePoint listesindeki mevcut bir sütunu günceller.

Gerekli parametreler:

• SharePoint sitesinin siteId: kimliği
• listId: SharePoint listesinin kimliği
• Columnıd: Güncelleştirilecek sütunun kimliği

İsteğe bağlı parametreler:

• Columntype: Sütun türü ('columnProperties' sağlanırken gereklidir)
• columnProperties: Güncelleştirilecek türe özgü özellikler
• Açıklama: Yeni açıklama
• Displayname: Yeni görünen ad
• Gizli: Sütunu gizleme veya gösterme
• Gerekli: Sütunu gerekli veya isteğe bağlı yapma

deleteColumn

Bir SharePoint listesinden bir sütunu siler. Uyarı: Bu eylem, tüm öğeler için bu sütunda depolanan tüm verileri kaldırır.

Gerekli parametreler:

• SharePoint sitesinin siteId: kimliği
• listId: SharePoint listesinin kimliği
• Columnıd: Silinecek sütunun kimliği

Temel özellikler

Site yönetimi

• Siteleri ada göre bulun veya erişilebilir sitelere göz atın.
• Tam URL yoluna göre bir site alın.
• Alt siteleri ve bunların alt sitelerini listeleyin.
• Kapsamlı site hiyerarşisinde gezinme.

Belge kitaplığı yönetimi

• Sitedeki tüm belge kitaplıklarını listeleme.
• Varsayılan belge kitaplığını alın.
• Klasör içeriğine göz atın (en fazla 20 öğe).
• Klasör yapılarını oluşturma ve yönetme.

Dosya işlemleri

• Metin ve ikili dosyalar oluşturun (5 MB veya daha az).
• Metin ve ikili dosyaları okuyun (5 MB veya daha az).
• Dosya ve klasörleri silin, yeniden adlandırın ve taşıyın.
• Belge kitaplıkları arasında dosya ve klasör kopyalama.
• SharePoint veya OneDrive URL’leri üzerinden dosya yükleyin.
• Tüm erişilebilir sitelerdeki dosya ve klasörleri arayın.
• Dosya ve klasör meta verilerini alma.

Asenkron işlemler

• Dosya ve klasörleri zaman uyumsuz olarak belge kitaplıkları arasında kopyalayın ve taşıyın.
• İşlem belirteçlerini kullanarak eşzamansız işlemlerin durumunu kontrol edin.

İşlemleri listeleme

• Listeleri oluşturun, okuyun ve silin.
• Genel, belge kitaplığı, olaylar ve görevler de dahil olmak üzere birden çok liste şablonu için destek.
• Rol tabanlı izinlerle listeleri paylaşma.
• Liste öğelerini oluşturarak, okuyarak, güncelleştirerek ve silerek yönetin.

Sütun yönetimi

• Metin, not, sayı, mantıksal, tarih/saat, seçenek, arama alanı, kullanıcı, URL, hesaplanmış ve daha fazlası gibi çok çeşitli türlerde sütunlar oluşturun.
• Sütun özelliklerini ve meta verilerini güncelleştirin.
• Sütun gereksinimlerini ve görünürlüğü yapılandırın.
• Türe özgü sütun özelliklerini ayarlayın.

Paylaşım ve izinler

• Dosyaları, klasörleri ve listeleri kullanıcılarla paylaşın.
• Rol tabanlı erişim denetimini okuma, yazma, katkıda bulunma ve düzenleme rolleriyle kullanın.
• Paylaşmak için e-posta bildirimleri.
• Davetiyelerde özel mesajlar.

Güvenlik ve uyumluluk

• Duyarlılık etiketlerini uygulama ve kaldırma.
• Standart, ayrıcalıklı ve otomatik dahil olmak üzere birden çok atama yöntemi kullanın.
• Denetim gerekçesini destekleme.
• Eşzamanlılık denetimini eTag'lerle kullanın.

Notlar

• Dosya işlemleri, karşıya yükleme ve indirme için 5 MB veya daha az olan dosyalarla sınırlıdır.
• Kopyalama ve taşıma işlemleri eşzamansız gerçekleştirilir. İlerleme durumunu izlemek için kullanın checkOperationStatus .
• Kopyalama ve taşıma işlemleri, SharePoint içindeki kitaplıklar arası işlemleri destekler.
• uploadFileFromUrl geçerli bir SharePoint veya OneDrive kaynak URL gerektirir.
• eTag'ler güncelleştirmeler ve silmeler için eşzamanlılık denetimi sağlar.
• Yinelenen klasör adları için otomatik sayısal ek.
• Liste silme işlemi geri alınamaz.
• Sütun silme işlemi, bu sütunda depolanan tüm verileri kaldırır.
• Arama işlemleri varsayılan olarak ilk 20 sonucu döndürür.