Excel Online (OneDrive)
Excel Online (OneDrive) bağlantı sağlayıcısı, OneDrive'da depolanan Excel dosyalarıyla çalışmanızı sağlar. Bu bağlantı sağlayıcısı yalnızca kişisel (MSA) hesapları destekler.
Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:
| Hizmet | Class | Bölgeler |
|---|---|---|
| Copilot Studio | Standart | Aşağıdakiler dışında tüm Power Automate bölgeleri : - 21Vianet tarafından işletilen Çin Bulutu |
| Logic Apps | Standart | Tüm Logic Apps bölgeleri |
| Power Apps | - | Mevcut değil |
| Power Automate | Standart | Aşağıdakiler dışında tüm Power Automate bölgeleri : - 21Vianet tarafından işletilen Çin Bulutu |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Microsoft |
Bilinen Sorunlar ve Sınırlamalar
- Excel Online (OneDrive) bağlayıcısı tarafından desteklenen bir Excel dosyasının boyutu üst sınırı 5 MB'tır.
- Eylemde
List rows present in a tablefiltreleme veya sıralama kullanılırken veriler güncel olmayabilir (biraz gecikme olabilir). - Eylem
List rows present in a table, temel filtreleme ve sıralamayı destekler:- Şu filtre işlevlerini destekler: eq, ne, contains, startswith, endswith.
- Bir sütuna yalnızca 1 filtre işlevi uygulanabilir.
- Sıralama için yalnızca 1 sütun kullanılabilir.
- Eylem
List rows present in a tablevarsayılan olarak en çok 256 satır döndürür. Tüm satırları almak için sayfalandırmayı açın. - OneDrive'da bir Excel dosyası bir güncelleştirme için kilitlenebilir veya bağlayıcının son kullanımından bu yana 12 dakika kadar silinebilir.
- Diğer bağlayıcılar tarafından yapılan eşzamanlı dosya değişiklikleri veya el ile yapılan düzenlemeler desteklenmez. Kullanıcılar aynı anda birden çok istemciden (Excel Desktop, Excel Web, Power Automate, LogicApps veya PowerApps) tek bir Excel dosyasına veri yazmaktan kaçınmalıdır. Bu, olası birleştirme çakışmalarına ve veri tutarsızlığına neden olabilir.
- Bağlayıcı, Microsoft Excel Open XML Elektronik Tablosu (*.xlsx) ve Microsoft Excel İkili Çalışma Kitabı (.xlxb) biçimlerindeki dosyaları destekler.
- Bağlayıcı, eylemde
List rows present in a tableen fazla 500 sütun için satır alır. İlk 500 sütunun satırları varsayılan olarak döndürülür. parametresindeSelect Queryalınacak belirli sütunların virgülle ayrılmış listesini sağlayabilirsiniz. - Bağlayıcı, gizli sütunlar içeren tablolar için OData parametrelerinin kullanılmasını desteklemez.
- Yeniden hesaplamaların neden olduğu bağlayıcı zaman aşımı, karmaşık formüller veya çalışma sayfasında çok fazla satır olması nedeniyle oluşabilir. Her iki durumda da, yeniden deneme ilkesi nedeniyle veriler birden çok kez eklenebilir. Geçici bir çözüm olarak, formüllerin basitleştirilip basitleştirilemediğine veya azaltılıp azaltılamadığına bakın. Aksi takdirde, bu çalışma kitabı için hesaplama modunu El ile olarak ayarlayabilirsiniz. Diğer ayrıntılar için lütfen buraya bakın
- Bir dosyaya yazma erişimi tüm eylemler için gereklidir, aksi takdirde Graph API'sinde hata döndürülebilir
403 Forbidden. Ayrıca, elektronik tablo salt okunur moddaysa bağlayıcı hata döndürür502 BadGateway. Salt okunur modu devre dışı bırakmak için lütfen buradan daha fazla bilgi edinin. -
Filter Query/Order By/Select Queryişlem parametreleri yalnızca alfasayısal sütun adlarını destekler. - Graph API sınırlamaları nedeniyle özet tablolar desteklenmez.
- Bir kullanıcı kısa bir süre içinde çok fazla istekte bulunursa 429 yanıtı almak mümkündür. Azaltma sınırı her istek için benzersizdir ve istek sayısına, kullanılan belleğe ve diğer önemli faktörlere göre değişir.
- gibi
Delete a rowkey columnişlemlerde alanı şeklindedircase-sensitive. - gibi
Update a rowDelete a rowişlemlerde birden çok eşleşme olması durumunda, yalnızca ilk satır güncelleştirilir/silinir. - gibi
Create a rowUpdate a rowDelete a rowişlemler tarafından işlenen değişiklikler, ilgili Power Automate, LogicApps veya Power Apps eylemlerinden başarılı bir şekilde yanıt aldıktan hemen sonra her zaman etkilenmez. Temel arka uç hizmeti sınırlamaları nedeniyle 30 saniyeye kadar gecikmeler beklenir. - PowerApps'te tablo içeri aktarma sırasında seçenek belirlenirse
Insert auto generated id into Excel tablebağlayıcı en fazla 64000 satırı otomatik olarak doldurabilir. - Yalnızca bir sayı içeren tablo sütun başlıkları, temel alınan arka uç hizmeti sınırlamaları nedeniyle gibi
Update a rowDelete a rowişlemlerde beklenmeyen davranışlara neden olabilir. Geçici çözüm olarak lütfen bu tür sütunları başka karakterler de içerecek şekilde yeniden adlandırın. - Bir Excel dosyası değiştirilebilir ve "salt okunur" bir eylem yürütülse bile dosyanın Sürüm geçmişinde yeni bir sürüm görünebilir. Bu davranış, bağlayıcının arka uç hizmetinin iç kaydetme mekanizmaları nedeniyle tasarım gereğidir.
- Dosya el ile açılsa bile, şifrelenmiş veya korumalı sayfalar olarak işaretlenmiş, bozuk bir dosya hatası oluşturur.
Sütun adlarını işleme
Eylemin yanıt sonuçlarındaki sütun adlarının OData biçimiyle uyumlu olması için dönüştürülebileceğini lütfen unutmayın:
| Karakter | Kodlanmış değer |
|---|---|
| . | _x002e_ |
| @ | _x0040_ |
| : | _x003a_ |
| # | _x0023_ |
Örn. Column [one]#1 ->Column [one]_x0023_1
Kavramlar ve örnekler
-
Key column: tablodaki bir değerde arama yapmak için kullanılacak sütun (key value) -
Key value: içindeki belirli bir satırı tanımlamak için kullanılacak değerkey column.
Aşağıdaki tabloyu örnek olarak alın. Tablonun ikinci satırında satır işlemi gerçekleştirmek için ve key columnColumn 1key value olmalıdır.200
| Sütun 1 | Sütun 2 | Sütun 3 |
|---|---|---|
| 100 | A-2 | A-3 |
| 200 | B-2 | B-3 |
| 300 | C-2 | C-3 |
Genel Sınırlar
| İsim | Değer |
|---|---|
| Tek bir Excel tablosundan satır almak/eklemek/güncelleştirmek/silmek için kullanılabilecek en fazla kimlik sütunu değişkeni sayısı. Geçerli değer 2 olarak ayarlanır ve bu da belirli bir tablo için iş akışları arasında en fazla iki sütun adı değişkeninin kullanılması gerektiği anlamına gelir. | 2 |
| PowerApps'te bir tablo içeri aktarma işlemi sırasında 'Excel tablosuna otomatik oluşturulan kimlik ekle seçeneği' seçiliyse bağlayıcının otomatik olarak doldurabileceği en fazla satır sayısı. | 64000 |
Azaltma Sınırları
| Name | Çağrılar | Yenileme Dönemi |
|---|---|---|
| Bağlantı başına API çağrıları | 100 | 60 saniye |
Eylemler
| Satır alma |
Anahtar sütununu kullanarak satır alma. Bu eylem, bir sütun ve anahtar sütunu verilen belirtilen satırın tüm değerlerini alır. |
| Satır silme |
Anahtar sütunu kullanarak satır silme. |
| Satırı güncelleştir |
Anahtar sütun kullanarak satırı güncelleştirin. Giriş değeri belirtilen hücrelerin üzerine yazılır ve boş bırakılan sütunlar güncelleştirilmez. Bir değeri eklemek (üzerine yazmak yerine) için önce içeriği almak için "Satır al" eylemini kullanın. |
| Tablo oluştur |
Excel çalışma kitabında yeni bir tablo oluşturun. |
| Tabloda bulunan satırları listeleme |
Tabloda bulunan satırları listeleme. |
| Tabloları alma |
Excel çalışma kitabındaki tabloların listesini alın. |
| Tabloya anahtar sütunu ekleme |
Excel tablosuna anahtar sütunu ekleyin. Yeni sütun sağa eklenir. Yeni anahtar sütunu tabloda benzersiz olmalıdır. |
| Tabloya satır ekleme |
Excel tablosuna yeni bir satır ekleyin. |
| Tabloya satır ekleme [KULLANIM DIŞI] |
Bu eylem kullanım dışı bırakıldı. Lütfen bunun yerine Tabloya satır ekle'yi kullanın.
|
| Çalışma sayfalarını alma |
Excel çalışma kitabındaki çalışma sayfalarının listesini alın. |
| Çalışma sayfası oluşturma |
Excel çalışma kitabında yeni bir çalışma sayfası oluşturun. |
Satır alma
Anahtar sütununu kullanarak satır alma. Bu eylem, bir sütun ve anahtar sütunu verilen belirtilen satırın tüm değerlerini alır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Dosya
|
file | True | string |
Dosya Gözat aracılığıyla bir Excel dosyası seçin. |
|
Tablo
|
table | True | string |
Açılan listeden bir tablo seçin. |
|
Anahtar Sütunu
|
idColumn | True | string |
Açılan listeden bir sütun seçin. |
|
Anahtar Değeri
|
id | True | string |
Anahtar değerini girin. |
|
DateTime Biçimi
|
dateTimeFormat | string |
DateTime Biçimi. |
Döndürülenler
Satır silme
Anahtar sütunu kullanarak satır silme.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Dosya
|
file | True | string |
Dosya Gözat aracılığıyla bir Excel dosyası seçin. |
|
Tablo
|
table | True | string |
Açılan listeden bir tablo seçin. |
|
Anahtar Sütunu
|
idColumn | True | string |
Açılan listeden bir sütun seçin. |
|
Anahtar Değeri
|
id | True | string |
Anahtar değerini girin. |
Satırı güncelleştir
Anahtar sütun kullanarak satırı güncelleştirin. Giriş değeri belirtilen hücrelerin üzerine yazılır ve boş bırakılan sütunlar güncelleştirilmez. Bir değeri eklemek (üzerine yazmak yerine) için önce içeriği almak için "Satır al" eylemini kullanın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Dosya
|
file | True | string |
Dosya Gözat aracılığıyla bir Excel dosyası seçin. |
|
Tablo
|
table | True | string |
Açılan listeden bir tablo seçin. |
|
Anahtar Sütunu
|
idColumn | True | string |
Açılan listeden bir sütun seçin. |
|
Anahtar Değeri
|
id | True | string |
Anahtar değerini girin. |
|
Öğe özelliklerini sağlayın
|
item | True | dynamic |
Öğe özelliklerini sağlayın. |
|
DateTime Biçimi
|
dateTimeFormat | string |
DateTime Biçimi. |
Döndürülenler
Tablo oluştur
Excel çalışma kitabında yeni bir tablo oluşturun.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Dosya
|
file | True | string |
Dosya Gözat aracılığıyla bir Excel dosyası seçin. |
|
Tablo adı
|
TableName | string |
Excel tablo adını girin. |
|
|
Tablo aralığı
|
Range | True | string |
A1 gösterimini kullanarak tablo adresini girin. |
|
Sütun adları
|
ColumnsNames | string |
Sütun adlarını ';' veya ',' ile ayırarak girin. |
Döndürülenler
Tablo meta verileri
- Body
- TableMetadata
Tabloda bulunan satırları listeleme
Tabloda bulunan satırları listeleme.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Dosya
|
file | True | string |
Dosya Gözat aracılığıyla bir Excel dosyası seçin. |
|
Tablo
|
table | True | string |
Açılan listeden bir tablo seçin. |
|
Filtre Sorgusu
|
$filter | string |
Döndürülen girişleri kısıtlamak için bir ODATA filtre sorgusu. |
|
|
Sipariş Ölçütü
|
$orderby | string |
Girdilerin sırasını belirtmek için bir ODATA orderBy sorgusu. |
|
|
En Çok Sayı
|
$top | integer |
Alınacak toplam girdi sayısı (varsayılan = tümü). |
|
|
Sayıyı Atla
|
$skip | integer |
Atlanacak girdi sayısı (varsayılan = 0). |
|
|
Sorgu Seç
|
$select | string |
Alınacak sütunların virgülle ayrılmış listesi (varsayılan olarak ilk 500). |
|
|
DateTime Biçimi
|
dateTimeFormat | string |
DateTime Biçimi. |
Döndürülenler
Tabloları alma
Excel çalışma kitabındaki tabloların listesini alın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Dosya
|
file | True | string |
Dosya Gözat aracılığıyla bir Excel dosyası seçin. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
value
|
value | array of object | |
|
Kimlik
|
value.id | string |
Tablo Kimliği. |
|
İsim
|
value.name | string |
Tablo adı. |
|
Şeritli sütunları göster
|
value.showBandedColumns | boolean |
Şeritli sütunları göster. |
|
İlk sütunu vurgula
|
value.highlightFirstColumn | boolean |
İlk sütunu vurgulayın. |
|
Son sütunu vurgula
|
value.highlightLastColumn | boolean |
Son sütunu vurgulayın. |
|
Şeritli satırları göster
|
value.showBandedRows | boolean |
Şeritli satırları göster. |
|
Filtre düğmesini göster
|
value.showFilterButton | boolean |
Filtre düğmesini göster. |
|
Üst bilgileri göster
|
value.showHeaders | boolean |
Üst bilgileri göster. |
|
Toplamları göster
|
value.showTotals | boolean |
Toplamları göster. |
|
Style
|
value.style | string |
Tablo stili. |
Tabloya anahtar sütunu ekleme
Excel tablosuna anahtar sütunu ekleyin. Yeni sütun sağa eklenir. Yeni anahtar sütunu tabloda benzersiz olmalıdır.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Dosya
|
file | True | string |
Dosya Gözat aracılığıyla bir Excel dosyası seçin. |
|
Tablo
|
table | True | string |
Açılan listeden bir tablo seçin. |
|
Anahtar Sütunu
|
idColumn | string |
Anahtar sütun adını belirtin. |
Tabloya satır ekleme
Excel tablosuna yeni bir satır ekleyin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Dosya
|
file | True | string |
Dosya Gözat aracılığıyla bir Excel dosyası seçin. |
|
Tablo
|
table | True | string |
Açılan listeden bir tablo seçin. |
|
Row
|
item | True | dynamic |
Belirtilen Excel tablosuna eklenecek satır. |
|
DateTime Biçimi
|
dateTimeFormat | string |
DateTime Biçimi. |
Döndürülenler
Tabloya satır ekleme [KULLANIM DIŞI]
Bu eylem kullanım dışı bırakıldı. Lütfen bunun yerine Tabloya satır ekle'yi kullanın.
Excel tablosuna yeni bir satır ekleyin.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Dosya
|
file | True | string |
Dosya Gözat aracılığıyla bir Excel dosyası seçin. |
|
Tablo
|
table | True | string |
Açılan listeden bir tablo seçin. |
|
Row
|
item | True | dynamic |
Belirtilen Excel tablosuna eklenecek satır. |
Çalışma sayfalarını alma
Excel çalışma kitabındaki çalışma sayfalarının listesini alın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Dosya
|
file | True | string |
Dosya Gözat aracılığıyla bir Excel dosyası seçin. |
Döndürülenler
| Name | Yol | Tür | Description |
|---|---|---|---|
|
value
|
value | array of WorksheetMetadata |
Çalışma sayfası oluşturma
Excel çalışma kitabında yeni bir çalışma sayfası oluşturun.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Dosya
|
file | True | string |
Dosya Gözat aracılığıyla bir Excel dosyası seçin. |
|
İsim
|
name | string |
Çalışma sayfası adı. |
Döndürülenler
- Body
- WorksheetMetadata
Tanımlar
TableMetadata
Tablo meta verileri
| Name | Yol | Tür | Description |
|---|---|---|---|
|
name
|
name | string |
Tablo adı |
|
title
|
title | string |
Tablo başlığı |
|
x-ms-permission
|
x-ms-permission | string |
Tablo izni |
|
x-ms-capabilities
|
x-ms-capabilities | TableCapabilitiesMetadata |
Tablo meta verileri (özellikler) |
|
şema
|
schema | Object | |
|
başvurulan Varlıklar
|
referencedEntities | Object | |
|
webUrl
|
webUrl | string |
Url bağlantısı |
TableCapabilitiesMetadata
Tablo meta verileri (özellikler)
| Name | Yol | Tür | Description |
|---|---|---|---|
|
sortRestrictions
|
sortRestrictions | TableSortRestrictionsMetadata |
Tablo meta verileri (sıralama kısıtlamaları) |
|
filterRestrictions
|
filterRestrictions | TableFilterRestrictionsMetadata |
Tablo meta verileri (filtre kısıtlamaları) |
|
selectRestrictions
|
selectRestrictions | TableSelectRestrictionsMetadata |
Tablo meta verileri (kısıtlamaları seçin) |
|
isOnlyServerPagable
|
isOnlyServerPagable | boolean |
Sunucu sayfalama kısıtlamaları |
|
filterFunctionSupport
|
filterFunctionSupport | array of string |
Desteklenen filtre özelliklerinin listesi |
|
serverPagingOptions
|
serverPagingOptions | array of string |
Desteklenen sunucu tabanlı disk belleği özelliklerinin listesi |
Nesne
TableSortRestrictionsMetadata
Tablo meta verileri (sıralama kısıtlamaları)
| Name | Yol | Tür | Description |
|---|---|---|---|
|
sıralanabilir
|
sortable | boolean |
Bu tablonun sıralanabilir sütunları olup olmadığını gösterir |
|
unsortableProperties
|
unsortableProperties | array of string |
Sıralanamaz özelliklerin listesi |
|
ascendingOnlyProperties
|
ascendingOnlyProperties | array of string |
Yalnızca artan sırayı destekleyen özelliklerin listesi |
TableFilterRestrictionsMetadata
Tablo meta verileri (filtre kısıtlamaları)
| Name | Yol | Tür | Description |
|---|---|---|---|
|
filtrelenebilir
|
filterable | boolean |
Bu tablonun filtrelenebilir sütunları olup olmadığını gösterir |
|
NonFilterableProperties
|
nonFilterableProperties | array of string |
Filtrelenemeyen özelliklerin listesi |
|
requiredProperties
|
requiredProperties | array of string |
Gerekli özelliklerin listesi |
TableSelectRestrictionsMetadata
Tablo meta verileri (kısıtlamaları seçin)
| Name | Yol | Tür | Description |
|---|---|---|---|
|
seçilebilir
|
selectable | boolean |
Bu tabloda seçilebilir sütunlar olup olmadığını gösterir |
WorksheetMetadata
| Name | Yol | Tür | Description |
|---|---|---|---|
|
Kimlik
|
id | string |
Çalışma Sayfası Kimliği. |
|
İsim
|
name | string |
Çalışma sayfası adı. |
|
Position
|
position | integer |
Çalışma sayfası konumu. |
|
Görünürlük
|
visibility | string |
Çalışma sayfası görünürlüğü. |