CSV verilerini düz TXT dosyalarına dönüştürmek, veri hatları, raporlama araçları veya basit günlük dışa aktarıcıları oluştururken sıkça ihtiyaç duyulan bir durumdur. Aspose.Cells Cloud SDK for Node.js format dönüşümünün ağır işini sunucu tarafında halleden güçlü bir kütüphane sağlar. Bu rehberde CSV’den TXT’ye Node.JS’te adım adım nasıl yapılacağını öğrenecek, cURL‑tabanlı bir REST yaklaşımını keşfedecek, kodlama seçeneklerini ayarlayacak ve performans en iyi uygulamalarını uygulayacaksınız.
CSV’den TXT’ye Dönüştürme Gereksinimleri
Geliştiriciler genellikle, virgül içermeyen satır‑sınırlı metin bekleyen alt sistemler için, elektronik tablo‑stili CSV verilerini ham TXT dosyalarına dönüştürmeleri gerekir. Tipik gereksinimler şunları içerir:
- Yüksek hacimli işleme - tüm içeriği belleğe yüklemeden büyük dosyaları işleme yeteneği.
- Özel karakter kodlaması - birçok eski sistem UTF‑8, ISO‑8859‑1 veya diğer belirli kodlamaları gerektirir.
- Otomasyon - dönüşüm, manuel müdahale olmadan bir Node.JS arka uçtan çağrılabilir olmalıdır.
Genel dosya sistemi betikleri kullanmak, özellikle farklı kodlamalarla çalışırken veya uygulama yerel dosya erişiminin sınırlı olduğu bir bulut ortamında çalıştığında hızla hataya açık hale gelebilir.
İş için Aspose.Cells Cloud SDK for Node.js seçimi
Aspose.Cells Cloud SDK for Node.js, bulutta çalışan ve yerel Office kurulumlarına olan ihtiyacı ortadan kaldıran REST‑tabanlı bir API sunar. Gereksinimlerle eşleşen temel yetenekler şunlardır:
- Streaming support - dosyalar akış olarak yüklenir ve indirilir, bellek ayak izini azaltır.
- Encoding control - TxtSaveOptions sınıfı, desteklenen herhangi bir metin kodlamasını belirtmenizi sağlar.
- Batch‑ready design - dönüşümü döngülerde veya eşzamansız iş akışlarında çağırabilirsiniz.
SDK, diğer Aspose hizmetleriyle sorunsuz bir şekilde bütünleşir ve kapsamlı belgelendirme ve API referansı bu öğreticide kullanılan her yöntem için ayrıntılı rehberlik sağlar.
CSV’den TXT’ye Node.JS’te: Uygulama
Aşağıda tüm sürecin özlü bir yürütmesi yer almaktadır. Her adım, makalenin ilerleyen kısmında bulunan tam örnekten doğrudan alınan kısa bir kod alıntısını içerir.
SDK’yı Yükleyin ve Kimlik Bilgilerini Yapılandırın
İlk olarak, kütüphaneyi projenize ekleyin ve istemci kimliğiniz ve gizli anahtarınızla API istemcisini yapılandırın.
npm install asposecellscloud
const { CellsApi, ApiClient, model } = require('asposecellscloud');
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new ApiClient.Configuration({
clientId,
clientSecret,
basePath: 'https://api.aspose.cloud'
});
const cellsApi = new CellsApi(config);
CSV Dosyasını Bulut Depolamaya Yükle
Yerel CSV dosyasını okuyun ve Aspose Cloud depolamasına yükleyin.
const [fs](https://docs.fileformat.com/programming/fs/) = require('fs');
const path = require('path');
const localCsvPath = path.resolve(__dirname, ‘sample.csv’); const remoteCsvPath = ‘sample.csv’; const csvData = fs.readFileSync(localCsvPath);
const uploadRequest = new model.UploadFileRequest({ path: remoteCsvPath, file: csvData }); await cellsApi.uploadFile(uploadRequest);
Özel Kodlama ile TXT Kaydetme Seçeneklerini Tanımlama
UTF‑8 kodlamasını (veya ihtiyacınız olan başka bir kodlamayı) belirtmek için bir TxtSaveOptions nesnesi oluşturun.
const txtSaveOptions = new model.TxtSaveOptions({
encoding: 'utf-8' // custom encoding
});
<!--[CODE_SNIPPET_END]-->
### CSV'den TXT'ye Çalışma Kitabı Dönüştürme
Uzak CSV adını ve TXT seçeneklerini geçirerek dönüşüm isteğini çağırın.
<!--[CODE_SNIPPET_START]-->
```javascript
const convertRequest = new model.ConvertWorkbookRequest({
name: remoteCsvPath,
format: 'txt',
outPath: '',
options: txtSaveOptions
});
const convertResponse = await cellsApi.convertWorkbook(convertRequest);
<!--[CODE_SNIPPET_END]-->
### TXT Sonucunu İndir ve Uzaktaki Dosyayı Temizle
Dönüştürülmüş TXT içeriğini yerel bir dosyaya yazın ve isteğe bağlı olarak bulut depolamadan kaynak CSV dosyasını silin.
<!--[CODE_SNIPPET_START]-->
```javascript
const localTxtPath = path.resolve(__dirname, 'sample.txt');
fs.writeFileSync(localTxtPath, convertResponse.body);
const deleteRequest = new model.DeleteFileRequest({ path: remoteCsvPath });
await cellsApi.deleteFile(deleteRequest);
console.log('CSV successfully converted to TXT at:', localTxtPath);
Tam Kod Örneği: CSV’den TXT’ye Node.JS’de Aspose.Cells Kullanarak
Aşağıdaki kod, baştan sona tüm iş akışını gösterir.
const { CellsApi, ApiClient, model } = require('asposecellscloud');
const fs = require('fs');
const path = require('path');
(async () => { // ==== Configuration ==== const clientId = ‘YOUR_CLIENT_ID’; const clientSecret = ‘YOUR_CLIENT_SECRET’; const config = new ApiClient.Configuration({ clientId, clientSecret, basePath: ‘https://api.aspose.cloud’ }); const cellsApi = new CellsApi(config);
// ==== Dosya yolları ==== const localCsvPath = path.resolve(__dirname, ‘sample.csv’); // giriş CSV const remoteCsvPath = ‘sample.csv’; // Aspose Cloud depolamasındaki yol const localTxtPath = path.resolve(__dirname, ‘sample.txt’); // çıktı TXT
// ==== CSV'yi bulut depolama alanına yükle ====
const csvData = fs.readFileSync(localCsvPath);
const uploadRequest = new model.UploadFileRequest({
path: remoteCsvPath,
file: csvData
});
await cellsApi.uploadFile(uploadRequest);
// ==== Prepare TXT save options with custom encoding ==== const txtSaveOptions = new model.TxtSaveOptions({ encoding: ‘utf-8’ // custom encoding });
// ==== Convert CSV to TXT ==== const convertRequest = new model.ConvertWorkbookRequest({ name: remoteCsvPath, format: ’txt’, outPath: ‘’, options: txtSaveOptions }); const convertResponse = await cellsApi.convertWorkbook(convertRequest);
// ==== Dönüştürülen TXT'yi yerel olarak kaydet ====
fs.writeFileSync(localTxtPath, convertResponse.body);
// ==== Clean up remote file (optional) ==== const deleteRequest = new model.DeleteFileRequest({ path: remoteCsvPath }); await cellsApi.deleteFile(deleteRequest);
console.log(‘CSV successfully converted to TXT at:’, localTxtPath); })();
<!--[COMPLETE_CODE_SNIPPET_END]-->
> **Not:** Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen [resmi belgeler](https://docs.aspose.cloud/cells/) adresine bakın veya [destek ekibi](https://forum.aspose.cloud/c/cells/7) ile iletişime geçin.
## cURL ve REST API ile CSV'yi TXT'ye Dönüştürme
Saf bir REST yaklaşımını tercih ediyorsanız, aynı dönüşüm cURL komutlarıyla gerçekleştirilebilir.
### 1. Kimlik Doğrulama ve Erişim Token'ı Alın
```bash
curl -X POST "https://api.aspose.cloud/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
2. Kaynak CSV’yi Yükleyin
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/sample.csv" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: text/csv" \
--data-binary "@sample.csv"
3. Dönüşümü Gerçekleştirin
curl -X POST "https://api.aspose.cloud/v3.0/cells/sample.csv/convert?format=txt" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"TxtSaveOptions": {"Encoding": "utf-8"}}' \
-o sample.txt
4. Çıktı TXT’yi İndirin (zaten -o bayrağı ile kaydedildi)
Bu komutlar, herhangi bir Node.JS kodu yazmadan aynı akışı gösterir. Daha fazla ayrıntı için resmi API belgelerine bakın.
Dönüşüm Seçenekleri: CSV’den TXT’ye Dışa Aktarma Ayarları
SDK, çıktıyı ince ayar yapabilmeniz için çeşitli özellikler sunar.
- Encoding – TXT dosyasının karakter setini belirler. Yukarıdaki örnek
'utf-8'kullanır. - OutPath – Sonucun doğrudan bulut depolamada saklanmasını istiyorsanız,
'output/sample.txt'gibi bir yol ayarlayın. - SaveFormat – İstek formatı
'txt'olsa da, ek seçeneklerle farklı ayırıcılarla'txt'isteyebilirsiniz (burada ele alınmamıştır).
İşte çıktının konumunu değiştiren bir kod parçacığı:
const convertRequest = new model.ConvertWorkbookRequest({
name: remoteCsvPath,
format: 'txt',
outPath: 'output/result.txt', // store in cloud storage
options: txtSaveOptions
});
<!--[CODE_SNIPPET_END]-->
Yapılandırılabilir özelliklerin tam listesi için, [TxtSaveOptions sınıfı](https://reference.aspose.cloud/cells/model/TxtSaveOptions/) sayfasına bakın.
## Sonuç
Node.JS'te CSV'yi TXT'ye dönüştürmek, Aspose.Cells Cloud SDK for Node.js'i kullandığınızda oldukça basit hale gelir. Kütüphane dosya akışını, özel kodlamayı ve bulut depolama etkileşimini yönetir, böylece düşük seviyeli ayrıştırma yerine iş mantığına odaklanabilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; ücretli lisans sınırsız dönüşüm sağlar, geçici bir lisans ise [geçici lisans sayfasında](https://purchase.aspose.com/temporary-license/) test için mevcuttur. Sağlanan kod ve cURL örnekleriyle, CSV'den TXT'ye dışa aktarmayı herhangi bir Node.JS hizmetine hızlı ve güvenilir bir şekilde entegre edebilirsiniz.
## SSS
**CSV'yi TXT'ye Node.JS'te dönüştürürken özel kodlamayı nasıl yönetirim?**
`TxtSaveOptions` nesnesini kullanarak `encoding` özelliğini (ör. `'utf-8'` veya `'iso-8859-1'`) ayarlayın. Bu, oluşturulan TXT'nin hedef sistemin beklentileriyle eşleşmesini sağlar.
**Bir çalıştırmada birden fazla CSV dosyasını işleyebilir miyim?**
Evet. Dönüştürme mantığını bir döngü içinde yerleştirin, her CSV'yi yükleyin, `convertWorkbook` metodunu çağırın ve ortaya çıkan TXT'yi indirin. SDK'nın durum bilgisiz tasarımı toplu işleme basitlik kazandırır.
**Büyük CSV dosyaları için performans hususları nelerdir?**
Dosyanın tamamını belleğe yüklemek yerine dosya yükleme ve indirmeyi akış olarak gerçekleştirin. SDK'nın REST uç noktaları akışlarla çalışır, RAM kullanımını azaltır ve ölçeklenebilirliği artırır.
**Üretimde CSV'den TXT'ye dönüşüm için lisans gerekli mi?**
Üretim dağıtımları için ücretli bir lisans gereklidir. Değerlendirme için geçici bir lisansı [geçici lisans sayfasından](https://purchase.aspose.com/temporary-license/) alabilirsiniz.
## Daha Fazla Oku
- [XLSM'yi Node.js kullanarak CSV'ye Dönüştür | Excel Makrosunu CSV'ye Dönüştürme](https://blog.aspose.cloud/tr/cells/convert-xlsm-to-csv-in-nodejs/)
- [Node.js Bulut API'si ile CSV'yi JSON'a Dönüştür | CSV'yi Çevrimiçi JSON'a Aktar](https://blog.aspose.cloud/tr/cells/convert-csv-to-json-with-nodejs/)
- [Node.js kullanarak Excel'i Metin Dosyasına (.txt) Dönüştür | Excel'ten TXT API'si](https://blog.aspose.cloud/tr/cells/convert-excel-to-txt-in-nodejs/)