Veriyi Excel Dosyalarına İçe Aktarın ve Excel Dosyalarından Veri Dışa Aktarın

Aspose.Cells Cloud API, çeşitli kaynaklardan veri içe aktarmayı destekler ve Excel çalışma kitaplarını, grafiklerini ve diğer nesnelerini XLSX, CSV, PDF, HTML, PNG ve daha fazlası gibi farklı formatlara dışa aktarabilir. Bu, veri yönetimi ve paylaşımını basit ve verimli hale getirir.

API sürümü: v3.0 – Son güncelleme: 2024‑03‑15

Hızlı Başlangıç Kılavuzu

İstek gövdesini hazırlayın – İçe veya dışa aktarma seçeneklerini tanımlayan bir JSON gövdesi oluşturun (örneğin, ImportCSVDataOption, ExportOptions).
İsteği gönderin – curl, Postman veya bir SDK kullanarak uygun uç noktayı (POST /cells/import veya POST /cells/export) çağırın.
Yanıtı işleyin – Başarılı olursa işlenmiş dosyayı (ikili veya Base64) alırsınız. Hata durumunda HTTP durum kodunu ve JSON gövdesinde döndürülen hata mesajını inceleyin.

Ön Gereksinimler

Aktif bir Aspose Cloud hesabı ve geçerli bir JWT belirteci.
Hedef çalışma kitabının belirtilen depolama konumunda mevcut olması (depoya dayalı API’ler için).
Doğru Content-Type başlık değerleri (dosya yükleme için multipart/form-data, JSON gövdeleri için application/json).

Çeşitli veri kaynaklarından veri nasıl içe aktarılır

Verinin bir Excel dosyasına içe aktarılması süreci sırasında dikkat edilmesi gereken birçok husus içerir. Aspose.Cells Cloud’un profesyonel kalitede birçok format ve veri türünü içe aktarma yeteneği, öne çıkan özelliklerinden biridir.

Veri İçe Aktarma API Bilgileri

Aşağıdaki API’ler, bir veya birden fazla Excel dosyasına veri içe aktarmak için sağlanmıştır:

API	Açıklama
POST /cells/import	Depolama kullanmadan veriyi Excel dosyalarına içe aktarır.
POST /cells/{name}/importdata	Bulutta depolanan bir Excel dosyasına veri içe aktarır.

İstek Parametreleri

Depolama kullanmadan

Parametre Adı	Tür	Konum	Açıklama
file	file	formData	Yüklenecek dosya
ImportOption	ImportOptions	body	İçe aktarma formatını belirtir (IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData, Picture)

Depolama kullanarak

Parametre Adı	Tür	Konum	Açıklama
name	string	path	Excel dosyasının adı
folder	string	query	Depolamadaki klasör yolu
storageName	string	query	Depolama adı
importData	ImportOptions	body	Veri içe aktarma gövdesi

Veri içe aktarma seçeneği parametreleri

Önemli parametreler aşağıdaki tablolarda açıklanmıştır:

ImportBatchDataOption

Parametre	Tür	Açıklama
BatchData	List<CellValue>	İçe aktarılacak toplu veri
DestinationWorksheet	string	Hedef çalışma sayfası adı
IsInsert	boolean	Verinin eklenip eklenmeyeceği (true/false)
ImportDataType	string	TwoDimensionStringBatchDataArray
Source	FileSource	BatchData null olduğunda veri dosyasının konumu

ImportCSVDataOption

Parametre	Tür	Açıklama
ConvertNumericData	boolean	Sayısal verilerin dönüştürülüp dönüştürülmeyeceği (true/false)
FirstRow	int	İlk satırın indeksi
FirstColumn	int	İlk sütunun indeksi
SeparatorString	string	Sütun ayırıcısı
DestinationWorksheet	string	Hedef çalışma sayfası adı
CustomParsers	List<CustomParserConfig>	Özel ayrıştırıcı yapılandırmaları
ImportDataType	string	CSVData
Source	FileSource	BatchData null olduğunda veri dosyasının konumu

ImportPictureOption

Parametre	Tür	Açıklama
FirstRow	int	İlk satırın indeksi
FirstColumn	int	İlk sütunun indeksi
IsVertical	boolean	Resmin dikey yerleştirilip yerleştirilmeyeceği (true/false)
Data	string[]	Resim verisi (base‑64 dizeleri)
DestinationWorksheet	string	Hedef çalışma sayfası adı
IsInsert	boolean	Verinin eklenip eklenmeyeceği (true/false)
ImportDataType	string	Picture
Source	FileSource	BatchData null olduğunda veri dosyasının konumu

Import2DimensionIntArrayOption

Parametre	Tür	Açıklama
FirstRow	int	İlk satırın indeksi
FirstColumn	int	İlk sütunun indeksi
Data	int[,]	İki boyutlu tamsayı dizisi
DestinationWorksheet	string	Hedef çalışma sayfası adı
IsInsert	boolean	Verinin eklenip eklenmeyeceği (true/false)
ImportDataType	string	TwoDimensionIntArray
Source	FileSource	BatchData null olduğunda veri dosyasının konumu

Import2DimensionDoubleArrayOption

Parametre	Tür	Açıklama
FirstRow	int	İlk satırın indeksi
FirstColumn	int	İlk sütunun indeksi
Data	double[,]	İki boyutlu çift noktalı sayı dizisi
DestinationWorksheet	string	Hedef çalışma sayfası adı
IsInsert	boolean	Verinin eklenip eklenmeyeceği (true/false)
ImportDataType	string	TwoDimensionDoubleArray
Source	FileSource	BatchData null olduğunda veri dosyasının konumu

Import2DimensionStringArrayOption

Parametre	Tür	Açıklama
FirstRow	int	İlk satırın indeksi
FirstColumn	int	İlk sütunun indeksi
Data	string[,]	İki boyutlu dize dizisi
DestinationWorksheet	string	Hedef çalışma sayfası adı
IsInsert	boolean	Verinin eklenip eklenmeyeceği (true/false)
ImportDataType	string	TwoDimensionStringArray
Source	FileSource	BatchData null olduğunda veri dosyasının konumu

ImportIntegerArrayOption

Parametre	Tür	Açıklama
FirstRow	int	İlk satırın indeksi
FirstColumn	int	İlk sütunun indeksi
IsVertical	boolean	Dizinin dikey olup olmadığı (true/false)
Data	int[]	Bir boyutlu tamsayı dizisi
DestinationWorksheet	string	Hedef çalışma sayfası adı
IsInsert	boolean	Verinin eklenip eklenmeyeceği (true/false)
ImportDataType	string	IntegerArray
Source	FileSource	BatchData null olduğunda veri dosyasının konumu

ImportDoubleArrayOption

Parametre	Tür	Açıklama
FirstRow	int	İlk satırın indeksi
FirstColumn	int	İlk sütunun indeksi
IsVertical	boolean	Dizinin dikey olup olmadığı (true/false)
Data	double[]	Bir boyutlu çift noktalı sayı dizisi
DestinationWorksheet	string	Hedef çalışma sayfası adı
IsInsert	boolean	Verinin eklenip eklenmeyeceği (true/false)
ImportDataType	string	DoubleArray
Source	FileSource	BatchData null olduğunda veri dosyasının konumu

ImportStringArrayOption

Parametre	Tür	Açıklama
UpperLeftRow	int	Sol üst satır indeksi
UpperLeftColumn	int	Sol üst sütun indeksi
LowerRightRow	int	Sağ alt satır indeksi
LowerRightColumn	int	Sağ alt sütun indeksi
Filename	string	Kaynak dosyanın adı
Data	string	İçe aktarılacak dize verisi
DestinationWorksheet	string	Hedef çalışma sayfası adı
IsInsert	boolean	Verinin eklenip eklenmeyeceği (true/false)
ImportDataType	string	StringArray
Source	FileSource	BatchData null olduğunda veri dosyasının konumu

CellValue

Parametre	Tür	Açıklama
rowIndex	int	Hücrenin satır indeksi
columnIndex	int	Hücrenin sütun indeksi
type	string	Hücre değeri veri türü
value	string	Hücre değeri
style	Style (object)	Hücre stili tanımı

FileSource

Parametre	Tür	Açıklama
FileSourceType	string	InMemoryFiles, CloudFileSystem veya RequestFiles
FilePath	string	Kaynak dosyanın yolu

Excel nesneleri nasıl çeşitli dosya formatlarına dışa aktarılır

Orijinal olarak bir Excel dosyasını XLS, XLSX, XLSB veya CSV formatında oluşturduysanız, belirli özelliklerden yararlanmak amacıyla başka bir formata dönüştürmek isteyebilirsiniz. Örneğin, PDF formatına dışa aktarmak, içeriğin yetkisiz değişikliklere karşı korunmasını sağlarken okunmasını ve paylaşılmasını kolaylaştırır.

Excel nesnelerinin dışa aktarılması bazı hususları içerir. Aspose.Cells Cloud, çalışma kitaplarını, grafikleri, şekilleri ve resimleri geniş bir format yelpazesine yüksek kalitede dışa aktarır:

Sadece dışa aktarma formatları: PDF, OTS, XPS, DIF, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS.
Hem içe hem de dışa aktarma: XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT.

İstek, [RFC 2046] ve [RFC 1341]’de tanımlanan multipart içeriği kullanır. İlk kısım veri dosyasını içerir; ikinci kısım kaydetme seçeneklerini içerir.

Dışa Aktarma API Bilgileri

POST https://api.aspose.cloud/v3.0/cells/export

İstek parametreleri

Parametre Adı	Tür	Konum	Açıklama
file	file	formData	Yüklenecek dosya
objectType	string	query	Nesne türü (`workbook`, `worksheet`, `chart`, `shape`, `picture`, `listobject`, `oleobject`)
format	string	query	İstenen çıktı dosya formatı (Desteklenen Dosya Formatları bakın)

OpenAPI Specification, web tarayıcınızdan doğrudan REST etkileşimleri gerçekleştirmenize olanak tanıyan herkese açık bir programlama arayüzü tanımlar.

API’yi çağırmak için cURL komut satırı aracını kullanabilirsiniz. Aşağıdaki örnek, bir isteği ve JSON yanıtını göstermektedir.

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/export" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -F 'file1=@example1.xlsx' \
  -F 'file2=@example2.xlsx'

Yanıt

{
  "Files": [
    {
      "Filename": "example1.pdf",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "example2.pdf",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

Yaygın HTTP durum kodları

Durum	Anlam	Önerilen eylem
200	Başarılı – dosya dışa aktarıldı	Döndürülen dosya(lar)ı işleyin
400	Hatalı istek – eksik veya geçersiz parametreler	İstek gövdesini ve sorgu dizelerini kontrol edin
401	Yetkisiz – geçersiz veya süresi geçmiş JWT belirteci	Belirteci yenileyin ve tekrar deneyin
404	Bulunamadı – belirtilen çalışma kitabı veya çalışma sayfası yok	Dosya adını ve depolama yolunu kontrol edin
500	İç sunucu hatası – sunucuda beklenmeyen durum	İstek kimliğiyle Aspose destek ekibine başvurun

İçe ve dışa aktarma API’leri nasıl çağrılır

Aşağıdaki makaleler her bir API’yi ayrıntılı olarak açıklar ve cURL ile SDK örnekleri içerir:

Excel Dosyalarını Birleştir ve Bölümlere Ayır Bir Excel dosyasını başka bir formata dönüştürün veya farklı bir şekilde kaydedin.