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).
  • ImportStringArrayOption modelini 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:

ImportStringArrayOption parametreleri ### **ImportStringArrayOption**
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: