Word belgesinin düzenini dönüştürmek, raporlar, sözleşmeler veya yazdırılabilir broşürler oluştururken sıkça ihtiyaç duyulan bir durumdur. GroupDocs.Merger Cloud SDK for Node.js geliştiricilerin sadece birkaç satır kodla Node.JS’de Word sayfa yönlendirmesini dönüştürmelerini sağlar. Bu kılavuz, gerekli adımları size gösterir, tam çalışan bir örnek sunar, eşdeğer cURL çağrılarını gösterir ve kurulum ile yapılandırmayı açıklar, böylece sayfa yönlendirme değişikliklerini Node.js uygulamalarınıza entegre edebilirsiniz.
Word Sayfa Yönlendirmesini Node.JS’te Dönüştürme Adımları
SDK’yı kurun ve kimlik bilgilerini yapılandırın: Kütüphaneyi eklemek ve istemci kimliğinizi ve gizlinizi ayarlamak için npm kullanın.
npm install groupdocs-merger-cloudAPI örneğini oluşturun:
ChangePageOrientationApi‘yi yapılandırma nesnesiyle başlatın.const GroupDocsMergerCloud = require('groupdocs-merger-cloud'); const clientId = 'YOUR_CLIENT_ID'; const clientSecret = 'YOUR_CLIENT_SECRET'; const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret); const orientationApi = new GroupDocsMergerCloud.ChangePageOrientationApi(config);İstek seçeneklerini oluşturun: Kaynak dosyayı, sayfa aralığını, istenen yönlendirmeyi ve çıktı yolunu tanımlayın.
const options = new GroupDocsMergerCloud.ChangePageOrientationOptions(); options.fileInfo = new GroupDocsMergerCloud.FileInfo(); options.fileInfo.filePath = 'input.docx'; options.pages = ['1-']; // all pages options.orientation = GroupDocsMergerCloud.Orientation.Landscape; // or Portrait options.outputPath = 'output.docx';Yönlendirme değişikliğini yürütün: İsteği gönderin ve yanıtı işleyin.
const request = new GroupDocsMergerCloud.ChangePageOrientationRequest(options);
orientationApi.changePageOrientation(request)
.then(response => {
console.log('Page orientation conversion completed.');
console.log('Output stored at:', response.path);
})
.catch(error => {
console.error('Error during orientation conversion:', error);
});
- (Opsiyonel) Ek ayarları düzenleyin:
pagesdizisini belirli sayfalara hedeflemek için değiştirebilir veya farklı bir düzen içinorientationenumunuPortraitolarak değiştirebilirsiniz.
Word Sayfa Yönlendirmesi Değişikliği - Tam Kod Örneği
Aşağıdaki örnek, bir DOCX dosyasının yönlendirmesini değiştirmek için GroupDocs.Merger Cloud SDK for Node.js kullanarak tam iş akışını göstermektedir.
const GroupDocsMergerCloud = require('groupdocs-merger-cloud');
// ==== Configuration ====
// Replace with your actual credentials
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
// ==== API Instance ====
const orientationApi = new GroupDocsMergerCloud.ChangePageOrientationApi(config);
// ==== Request Construction ====
const options = new GroupDocsMergerCloud.ChangePageOrientationOptions();
options.fileInfo = new GroupDocsMergerCloud.FileInfo();
options.fileInfo.filePath = 'input.docx'; // source Word document
options.pages = ['1-']; // apply to all pages (1 to end)
options.orientation = GroupDocsMergerCloud.Orientation.Landscape; // Portrait or Landscape
options.outputPath = 'output.docx'; // destination file
const request = new GroupDocsMergerCloud.ChangePageOrientationRequest(options);
// ==== Execution ====
orientationApi.changePageOrientation(request)
.then(response => {
console.log('Page orientation conversion completed.');
console.log('Output stored at:', response.path);
})
.catch(error => {
console.error('Error during orientation conversion:', error);
});
Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, dosya yollarını (
input.docx,output.docx) gerçek dosya konumları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 dokümantasyona bakın veya destek ekibi ile iletişime geçin.
cURL ile REST API Kullanarak Sayfa Yönelimini Değiştirme
Saf bir HTTP yaklaşımını tercih ediyorsanız, aynı işlem GroupDocs.Merger Cloud REST uç noktalarına karşı cURL komutlarıyla gerçekleştirilebilir.
- Erişim belirteci alın
curl -X POST "https://api.groupdocs.cloud/v1.0/oauth2/token" \
-H "Content-Type: application/json" \
-d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
Yanıt access_token içerir.
Kaynak DOCX dosyasını yükleyin
curl -X POST "https://api.groupdocs.cloud/v1.0/merger/storage/upload" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@input.docx" \ -F "path=/input.docx"Yönlendirme değişikliğini iste
curl -X POST "https://api.groupdocs.cloud/v1.0/merger/words/changePageOrientation" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"fileInfo": { "filePath": "/input.docx" },
"pages": ["1-"],
"orientation": "Landscape",
"outputPath": "/output.docx"
}'
- Oluşan dosyayı indirin
curl -X GET "https://api.groupdocs.cloud/v1.0/merger/storage/download?path=/output.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.docx
İstek yükleri ve desteklenen parametreler hakkında daha fazla ayrıntı için, resmi API belgelerine bakın.
GroupDocs.Merger Cloud SDK for Node.js’ı Kurma ve Yapılandırma
Başlamak için, paketi npm üzerinden kurun ve kimlik bilgilerinizi yapılandırın.
npm install groupdocs-merger-cloud
const GroupDocsMergerCloud = require('groupdocs-merger-cloud');
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
Belirli bir sürüme ihtiyacınız varsa, en son kütüphaneyi sürüm sayfası üzerinden indirin. Ortamınızın Node.js 12 veya daha yüksek bir sürüm çalıştırdığından ve geçerli bir GroupDocs Cloud hesabına sahip olduğunuzdan emin olun.
Sayfa Yönlendirme Seçeneklerini Yapılandırma
SDK, ayarlayabileceğiniz çeşitli özellikler sunar:
- pages - Etkilenecek sayfaları tanımlayın (ör.
['1-5']ilk beş sayfa için).options.pages = ['1-5']; - orientation -
GroupDocsMergerCloud.Orientation.PortraitveyaLandscapeseçin.options.orientation = GroupDocsMergerCloud.Orientation.Portrait; - outputPath - Bulut depolamanızdaki hedef yolu belirtin.
options.outputPath = 'converted/output.docx';
Bu seçenekler, API referansında belgelenen ChangePageOrientationOptions sınıfının bir parçasıdır.
Sonuç
Word dosyalarının düzenini programlı olarak değiştirmek, GroupDocs.Merger Cloud SDK for Node.js ile oldukça basittir. Yukarıdaki adımları izleyerek Node.JS’te Word sayfa yönlendirmesini dönüştür, toplu işlemeyi otomatikleştirebilir ve yönlendirme değişikliklerini herhangi bir belge iş akışına entegre edebilirsiniz. Üretim kullanımı için uygun bir lisans almayı unutmayın; fiyatlandırma detayları ürün sayfasında mevcuttur ve geçici bir lisansı geçici lisans sayfasından edinebilirsiniz. SDK yüklü ve yapılandırılmış olduğunda, uygulamalarınızı esnek belge manipülasyonu yetenekleriyle geliştirmeye hazırsınız.
SSS
Node.js kullanarak Word belgelerinde sayfa yönlendirmesini nasıl değiştiririm?
Node.js için GroupDocs.Merger Cloud SDK for Node.js,ChangePageOrientationApi‘yi kullanın, istenenorientationdeğerini istek seçeneklerinde ayarlayın ve API çağrısını yürütün.Node.JS’te kod yazmadan Word sayfa Yönlendirmesini dışa aktarmanın bir yolu var mı?
Evet, aynı işlem REST API üzerinden cURL komutları kullanılarak gerçekleştirilebilir; bu, hızlı betikler veya diğer sistemlerle entegrasyon için faydalıdır.Word belgeleri için hangi yönlendirmeler desteklenir?
SDK,PortraitveLandscapemodlarınıOrientationenumu aracılığıyla destekler. Değişikliği seçici olarak uygulamak için sayfa aralıklarını da belirtebilirsiniz.Üretimde bunu çalıştırmak için bir lisansa ihtiyacım var mı?
Geçerli bir lisans üretim dağıtımları için gereklidir. Geçici bir lisansla, geçici lisans sayfası üzerinden başlayabilir ve kullanımınız arttıkça tam bir lisansa yükseltebilirsiniz.