Excel Çalışma Sayfasına Dize Dizisi İçe Aktar – Aspose.Cells Cloud
Bir dize dizisini Excel çalışma sayfasına içe aktarmak, lisel verilerle spreadsheets doldururken yaygın bir görevdir. Bu işlem, yapılandırma değerlerini yükleme, harici kaynaklardan veri aktarma veya çalışma sayfalarını önceden tanımlanmış dize koleksiyonlarıyla başlatma gibi senaryolar için kullanışlıdır.
Önkoşullar:
- Aspose.Cells Cloud kimlik doğrulama akışı aracılığıyla elde edilen geçerli bir JWT jetonu.
- Aspose Cloud depolarınızda mevcut bir çalışma kitapçığı (veya yeni oluşturabilme yeteneği).
ImportStringArrayOptionmodelini destekleyen uygun SDK sürümü.
Bu REST API, dize dizisi verilerini bir Excel çalışma sayfasına içe aktarır.
PostImportData API
POST https://api.aspose.cloud/v3.0/cells/import
Güvenlik ve Kimlik Doğrulama
Aspose.Cells Cloud API’leri güvenlidir ve JWT jeton tabanlı kimlik doğrulama gerektirir.
İstek Parametreleri
İstek, çok parçalı HTTP içeriği kullanır (bkz. RFC 2046 veya RFC 1341).
Çok parçalı gövdenin ilk parçası bir ImportStringArrayOption yükünü içerir; ikinci parça kaynak veri dosyasını içerir.
Önemli parametreler aşağıdaki tabloda açıklanmıştır:
| Parametre Adı | Tür | Açıklama |
|---|---|---|
| FirstRow | int | Verilerin yerleştirileceği başlangıç satır indeksi (1‑tabanlı). |
| FirstColumn | int | Verilerin yerleştirileceği başlangıç sütun indeksi (1‑tabanlı). |
| IsVertical | boolean | Verileri dikey eklemek için true; yatay eklemek için false. |
| Data | String[] | İçe aktarılacak dize dizisi. |
| DestinationWorksheet | string | Verilerin gönderileceği çalışma sayfasının adı. |
| IsInsert | boolean | Satırları/sütunları eklemek için (true, mevcut hücreleri kaydırarak); mevcut hücreleri üzerine yazmak için (false). |
| ImportDataType | string | İçe aktarılan veri türü (örn. IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData). |
| Source | FileSource | BatchData null olduğunda veri dosyasının bulunduğu yeri tanımlar (örn. CloudFileSystem, LocalFile). BatchData sağlanmadıysa gereklidir. |
Örnek
<ImportStringArrayOption>
<DestinationWorksheet>Sheet1</DestinationWorksheet>
<IsInsert>false</IsInsert>
<ImportDataType>StringArray</ImportDataType>
<FirstRow>1</FirstRow>
<FirstColumn>1</FirstColumn>
<IsVertical>true</IsVertical>
<Source>
<FileSourceType>CloudFileSystem</FileSourceType>
<FilePath>Array_string_xml.txt</FilePath>
</Source>
</ImportStringArrayOption>
Yanıt
Başarılı bir istek, JSON yükü içeren HTTP 200 döndürür:
{
"Code": 200,
"Status": "OK"
}
Olası durum kodları:
| Kod | Anlam |
|---|---|
| 200 | İçe aktarma başarılı |
| 400 | Geçersiz istek – eksik veya geçersiz veri |
| 401 | Yetkisiz – geçersiz veya eksik jeton |
| 500 | Sunucu iç hatası |
SDK ile PostImportData API Nasıl Kullanılır
PostImportData API Spesifikasyonu
OpenAPI Spesifikasyonu, herkese açık bir programlama arayüzü tanımlar ve REST etkileşimlerini doğrudan bir web tarayıcısından gerçekleştirmenize izin verir.
Aspose.Cells Cloud SDK Kullanın
SDK kullanmak, geliştirme sürecini hızlandırmanın en iyi yoludur. Bir SDK, düşük seviye detayları yöneterek projenizin görevlerine odaklanmanızı sağlar. Aspose.Cells Cloud SDK’larının tam listesi için GitHub deposunu inceleyin.
Aşağıdaki kod örnekleri, çeşitli SDK’lar kullanarak Aspose.Cells web servislerini nasıl çağıracağınızı göstermektedir: