Bir üstbilgi her sayfanın üst kenar boşluğudur ve bir altbilgi her sayfanın alt kenar boşluğudur. Üstbilgiler ve altbilgiler, adınız, tarihleriniz, belgenin başlığı, sayfa numaraları veya belgelere yönelik feragatnameler gibi bir belgenin her sayfasında görüntülemek istediğiniz bilgileri eklemek için kullanışlıdır. MS Word kullanırken, önceden tanımlanmış düzenlere göre Üstbilgi ve Altbilgiler ekleme veya özel üstbilgiler ve altbilgiler eklemenize olanak sağlama yetenekleri sağlar. Çoğu yerleşik üstbilgi, bir miktar yer tutucu metin içerir ve yer tutucu metni tutabilir veya kendi veri akışınızla değiştirebilirsiniz. Ayrıca, Üstbilgi veya Altbilgi bölümündeki bilgileri güncellerken, belgenin ana gövdesindeki içerik grileşir; bu, bu nesnelerin sayfa içeriğinin geri kalanından tamamen izole edildiğini ve bu nesneler üzerinde gerçekleştirdiğiniz işlemin bu alanlara özgü olduğunu gösterir. Bu makalede, REST API’yi kullanarak Word Belgesinde üstbilgi altbilgisinin nasıl ekleneceği veya güncelleneceği adımlarını öğreneceğiz.
Kelime işleme API’si
Aspose.Words Cloud API, MS Word dosyalarını Cloud depolama alanından yükleme olanağı sağlar ve ayrıca kullanıcının giriş dosyasını doğrudan istek gövdesine geçirmesine ve API’nin güncellenmiş dosyayı yanıt nesnesine döndürmesine olanak tanır. Belirli veya tüm Başlık ve Altbilgi nesnelerini Okuma, Ekleme, Güncelleme veya Silme özelliklerini sağlar. Ayrıca, ilk sayfa ve tek/çift sayfalar için farklı başlıklar/altbilgiler oluşturmayı da belirtebilirsiniz.
Ayrıca API, başlık/altbilgi metni için yazı tipi ve paragraf özellikleri gibi biçimlendirme bilgilerini ayarlamanıza da olanak tanır. Ayrıca, başlık/altbilgi bölümüne dinamik sayfa numaraları eklemek için kaldıraç elde edersiniz. Son olarak, başlık/altbilgi metninin bir kısmını sol kenara, diğer kısmını sağ kenara hizalamak için tablo nesnelerini kullanmayı düşünebilirsiniz.
Makalenin Kapsamı
Aspose.Words Cloud SDK for .NET, istekte bulunma ve yanıtları işlemeyle ilgili birçok düşük seviyeli ayrıntıyla ilgilenerek ve iş gereksinimlerinize özgü kod yazmaya odaklanmanızı sağlayarak Aspose.Words Cloud REST API’leri ile hızlı ve kolay bir şekilde çalışmanızı sağlar. Bu makalede, Mac için Visual Studio’da Aspose.Words Cloud SDK for .NET kullanacağız. Bu gönderi, özel biçimlendirmenin tanımlanacağı Word Belgesine Üstbilgi Altbilgisi ekleme adımlarını tanımlar. Ardından, çıkan Altbilgi içeriğinin biçimlendirmesi güncellenir ve Sayfa Numarası bilgisi Sağ Alt konuma eklenir. Tüm bu işlemler bulutta gerçekleştirilecektir.
Kurulum
Başlamak için öncelikle sisteminize Visual Studio yüklemeniz gerekir. Bir örnek çözüm oluşturun ve Aspose.Words Cloud SDK for .NET NuGet referansını ekleyin. Bu nedenle bir referans eklemek için çözüme sağ tıklayın ve Manage NuGet Packages… menü seçeneğini seçin. Arama metin alanına Aspose.Words-Cloud girin. Seçeneği seçin ve Add package düğmesine tıklayın.
Artık çözümde Aspose.Words.Cloud.Sdk referansı görünüyor. Şirket içi (aspose.com) API’lere kıyasla bulut API’lerini kullanmanın bazı avantajları vardır. Bunun nedeni, API sürümlerini manuel olarak takip edip güncellemeniz gerekmemesi ve tüm lisans için ödeme yapmanız gerekmemesidir.
Aspose.Cloud Kontrol Paneli
Aspose.Cloud panosunda bir hesap oluşturun veya mevcut Google veya GitHub hesabınız üzerinden kaydolun ve Cloud API’lerimizi kullanmaya başlayın. Cloud API’lerinin bir diğer harika özelliği de desteklenen herhangi bir dili kullanarak herhangi bir platformda kullanabilmenizdir.
Yukarıda belirtildiği gibi, makale MS Word belgelerinin içindeki Başlık ve Altbilgi nesnelerinin eklenmesi ve güncellenmesiyle ilgili seçenekleri vurgular. Test amacıyla, İş Mektubu adlı mevcut bir MS Word belge şablonu kullandık. Belgenin Aspose bulut depolamasına yüklenmesi gerekir ve tüm düzenleme ve belge işleme bulut üzerinden gerçekleştirilecektir. Tüm işleme tamamlandıktan sonra, ortaya çıkan dosya kopyasını Cloud depolamasından da indirebiliriz.
using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;
Şimdi Aspose.Cloud API’lerini kullanmak için kodunuzda Uygulama Anahtarı ve Uygulama SID bilgilerini kullanmanız gerekir. Bu anahtarlar Alfanümerik rakamlardan oluşur. Bunlar abonelik hesabınızla ilişkilendirilmiş benzersiz kodlardır. Bu ayrıntıları almak için lütfen [Aspose.Cloud panosundaki] Uygulamalarım sekmesine tıklayın 8. Anahtarlara sahip olduğumuzda Aspose.Words API nesnesini başlatmamız gerekir.
string MyAppKey = "f6axxxxxxxxxxxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "478e4827-xxxxx-xxxx-xxxx-xxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// create an object of WordsApi while passing AppKey and AppSid information
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
Başlık nesnesi ekle
MS Word dosyası içerisine header nesnesini ekleyebilmek için sırasıyla aşağıdaki işlemleri yapmamız gerekmektedir.
- InsertHeaderFooterRequest nesnesini, HeaderFooterLink türünü argüman olarak geçirdiğimiz bir nesne olarak oluşturalım.
- InsertHeaderFooter (…) metodunu kullanarak HeaderFooterRequest nesnesini WordsApi nesnesine ekleyin.
- Örnek Metin bilgilerini tutan bir Çalıştırma nesnesi oluşturun.
- Çalıştırma metninin eklenmesi gereken HeaderFooter nesnesinde paragraph(SectionPath) referansını geçirdiğimiz InsertRunRequest nesnesini oluşturun.
Daha sonra WordsApi’nin InsertRun(…) metodunu çağırarak RunRequest’i HeaderFooter nesnesine ekleyelim.
HeaderFooter.TypeEnum aşağıdaki değerlerden biri olabilir.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// AppKey ve AppSid bilgilerini geçirirken WordsAPI nesnesi oluşturun
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// örnek belgeyi bulut depolama alanına yükle
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// İlk sayfaya Başlık Nesnesi Ekle
var putHeaderFooterRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertHeaderFooterRequest("BusinessLetter.docx", "HeaderFirst", null,null);
var actual = wordsApi.InsertHeaderFooter(putHeaderFooterRequest);
// Örnek metin içeren Çalıştırma nesnesi oluşturun
var run = new Run { Text = "Aspose.Words Cloud SDK for .NET " };
// Word belgesinin ilk bölümündeki ilk HeaderFooter nesnesinin ilk paragrafına Çalıştır metnini ekleyin
var runRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertRunRequest("BusinessLetter.docx", "sections/0/headersfooters/1/paragraphs/0", run);
// RunRequest'i Word Belgesine Ekle
var actual2 = wordsApi.InsertRun(runRequest);
Yeni eklenen Başlığın Metin biçimlendirmesini güncelle
Header nesnesi eklendiğinde, içindeki içeriğin metin biçimlendirmesini güncelleyebiliriz. Bu gereksinimi karşılamak için aşağıdaki adımları gerçekleştirmemiz gerekir.
- Font sınıfından bir nesne oluşturalım, bu nesnede Font adı, boyutu, renk bilgilerini belirtelim.
- Metni daha okunabilir hale getirmek için Engrave özelliğini True olarak işaretleyin.
- Giriş dosyasını, Font’u, SectionPath’i ve runIndex’i argüman olarak geçirdiğimiz UpdateRunFontRequest sınıfının bir nesnesini oluşturun.
- Son olarak UpdateRunFont(..) metodunu kullanın ve WordsApi örneğine UpdateRunFontRequest nesnesini ekleyin.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// AppKey ve AppSid bilgilerini geçirirken WordsAPI nesnesi oluşturun
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// örnek belgeyi bulut depolama alanına yükle
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// Bir sonraki adım Başlık Nesnesinin biçimlendirmesini ayarlamak
var runIndex = 0;
var fontDto = new Font { Bold = true, Name = "Verdana", Size = 16, Color = new XmlColor { Web = "#e0a50d" } };
// Metnin biçimlendirmesini Gravür olarak ayarla
fontDto.Engrave = true;
// HeaderFooter nesnesinin ilk paragrafına biçimlendirme uygulayın
var documentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx",
fontDto, "sections/0/headersfooters/1/paragraphs/0", runIndex);
var actual4 = wordsApi.UpdateRunFont(documentParagraphRunFontRequest);
Mevcut Altbilgi nesnesinin biçimlendirmesini güncelle
API ayrıca mevcut Header / Footer nesnesinin içindeki içeriğin biçimlendirmesini güncelleme özelliğini de sunar. Bu gereksinimi karşılamak için yukarıda belirtilen kod satırlarını kullanabiliriz ancak tek fark headerfooter dizininin 2 olarak değiştirilmesidir. Aşağıdaki kod satırına bakın.
// Apply formatting to first paragraph of HeaderFooter object
var FooterDocumentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx",
FooterFontDto, "sections/0/headersfooters/2/paragraphs/0", FooterrunIndex);
Sayfa Numarası bilgisini Alt Bilgi Bölümüne Ekle
Sayfa numaraları, geçerli sayfa ve belgedeki toplam sayfa sayısı gibi çok yararlı bilgiler sağlar. Aşağıdaki adımlar, gereksinimlerin nasıl gerçekleştirileceğini tanımlar.
- Öncelikle PageNumber sınıfının bir nesnesini oluşturalım. Burada metnin hizalamasını, metnin biçimini, PageNumber bilgisinin işleneceği konumu tanımlayalım ve ayrıca PageNumber bilgisinin ilk sayfada işlenip işlenmeyeceğini belirleyelim.
- InsertPageNumbersRequest nesnesini oluşturun ve PageNumber nesnesini argüman olarak geçirin.
- Son olarak, InsertPageNumbersRequest’i WordsApi örneğine eklemek için InsertPageNumbers(..) metodunu çağırın.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// AppKey ve AppSid bilgilerini geçirirken WordsAPI nesnesi oluşturun
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// örnek belgeyi bulut depolama alanına yükle
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// API ayrıca HeaderFooter nesnesine Sayfa Numarası ayrıntıları ekleme özelliğini de sunar
// Sayfanın sağ altına sayfa numarası bilgisi ekleyin
var body = new PageNumber { Alignment = "right", Format = "{PAGE} of {NUMPAGES}", IsTop = false, SetPageNumberOnFirstPage = true };
var insertPageNumbersRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertPageNumbersRequest("BusinessLetter.docx", body);
// Word belgesinin içine PageNumber bilgisi ekle
var actual6 = wordsApi.InsertPageNumbers(insertPageNumbersRequest);
Çözüm
Bu makalede, Aspose.Words Cloud SDK for .NET kullanarak Word Belgesine Üstbilgi Altbilgisi ekleme adımlarını öğrendik. Ayrıca Java, PHP, Ruby, Python, Go, Swift, C++, Node.Js, Android için de Cloud SDK’larımız olduğunu lütfen unutmayın. Daha fazla ayrıntı için lütfen Aspose.Words Cloud adresini ziyaret edin.
İlgili Makaleler
Daha fazla bilgi edinmek için aşağıdakileri ziyaret etmenizi de öneririz