წარწერა

A quick view of MS Word document transformation.

სათაური არის თითოეული გვერდის ზედა ზღვარი, ხოლო ქვედა კიდე არის თითოეული გვერდის ქვედა ზღვარი. სათაურები და ქვედა კოლონტიტულები სასარგებლოა ინფორმაციის ჩასართავად, რომლის ჩვენებაც გსურთ დოკუმენტის ყველა გვერდზე, როგორიცაა თქვენი სახელი, თარიღები, დოკუმენტის სათაური, გვერდის ნომრები ან დოკუმენტების უარყოფა. MS Word-ის გამოყენებისას ის უზრუნველყოფს სათაურის და ქვედა კოლონტიტულის დამატების შესაძლებლობებს წინასწარ განსაზღვრული განლაგების საფუძველზე ან საშუალებას გაძლევთ დაამატოთ მორგებული სათაურები და ქვედა კოლონტიტული. ჩაშენებული სათაურების უმეტესობა შეიცავს რამდენიმე ჩანაცვლების ტექსტს და შეგიძლიათ შეინახოთ ჩანაცვლების ტექსტი ან შეცვალოთ იგი თქვენი საკუთარი მონაცემთა არხით. ასევე, სათაურის ან ქვედა ნაწილის ინფორმაციის განახლებისას, დოკუმენტის ძირითადი ნაწილის შინაარსი ნაცრისფერია, რაც მიუთითებს იმაზე, რომ ეს ობიექტები მთლიანად იზოლირებულია გვერდის დანარჩენი შინაარსისგან და ოპერაცია, რომელსაც თქვენ ასრულებთ ამ ობიექტებზე, სპეციფიკურია ამ ზონებისთვის. ამ სტატიაში ჩვენ ვაპირებთ ვისწავლოთ ნაბიჯები, თუ როგორ უნდა დაამატოთ ან განაახლოთ სათაურის ქვედა კოლონტიტული Word Document-ში REST API-ის გამოყენებით.

სიტყვების დამუშავების API

Aspose.Words Cloud API უზრუნველყოფს შესაძლებლობას ჩატვირთოს MS Word ფაილები ღრუბლოვანი მეხსიერებიდან, ასევე ის საშუალებას აძლევს მომხმარებელს გადასცეს შეყვანის ფაილი პირდაპირ მოთხოვნის სხეულში და API აბრუნებს განახლებულ ფაილს საპასუხო ობიექტში. ის უზრუნველყოფს ფუნქციებს წაკითხვის, დამატების, განახლების ან წაშლის კონკრეტული ან ყველა Header და Footer ობიექტებისათვის. გარდა ამისა, თქვენ ასევე შეგიძლიათ მიუთითოთ სხვადასხვა სათაურების/ქვედა კოლონტიტულის გაფორმება პირველი გვერდისთვის და კენტი/ლუწი გვერდებისთვის.

გარდა ამისა, API ასევე საშუალებას გაძლევთ დააყენოთ ფორმატირების ინფორმაცია, როგორიცაა შრიფტისა და აბზაცის თვისებები სათაურის/ძირის ტექსტისთვის. თქვენ ასევე იღებთ ბერკეტს, რომ ჩასვათ დინამიური გვერდის ნომრები სათაურში/სქოლიოში. დაბოლოს, მაგრამ არანაკლებ მნიშვნელოვანია, შეგიძლიათ გამოიყენოთ ცხრილის ობიექტები, რათა სათაურის/ძირის ტექსტის ერთი ნაწილი გაასწოროთ მარცხენა კიდეზე, ხოლო მეორე მარჯვენა კიდეზე.

სტატიის ფარგლები

ჩვენი Aspose.Words Cloud SDK for .NET გაძლევთ საშუალებას იმუშაოთ Aspose.Words Cloud REST API-ებთან სწრაფად და მარტივად, რადგან ის ზრუნავს უამრავ დაბალი დონის დეტალებზე მოთხოვნისა და პასუხების დამუშავებასთან დაკავშირებით და საშუალებას გაძლევთ ფოკუსირდეთ თქვენი ბიზნესის მოთხოვნების სპეციფიკური კოდის დაწერაზე. ამ სტატიაში ჩვენ ვაპირებთ გამოვიყენოთ Aspose.Words Cloud SDK for .NET Visual Studio-ში Mac-ისთვის. ეს პოსტი განსაზღვრავს ნაბიჯებს სათაურის ქვედა კოლონტიტულის Word დოკუმენტში ჩასართავად, სადაც განისაზღვროს მორგებული ფორმატირება. შემდეგ განახლდება ბოლოში გამოსული კონტენტის ფორმატირება და გვერდის ნომრის ინფორმაცია ჩასმულია ქვედა-მარჯვნივ პოზიციაზე. ყველა ეს ოპერაცია შესრულდება ღრუბელში.

ინსტალაცია

დასაწყებად, პირველ რიგში, თქვენ უნდა დააინსტალიროთ Visual Studio თქვენს სისტემაზე. შექმენით გამოსავლის ნიმუში და დაამატეთ NuGet მითითება Aspose.Words Cloud SDK for .NET. ამიტომ, მითითების დასამატებლად, დააწკაპუნეთ მაუსის მარჯვენა ღილაკით გამოსავალზე და აირჩიეთ Manage NuGet Packages… მენიუს ვარიანტი. საძიებო ტექსტის ველში შეიყვანეთ Aspose.Words-Cloud. აირჩიეთ ვარიანტი და დააჭირეთ ღილაკს დამატება პაკეტი.

ახლა Aspose.Words.Cloud.Sdk მითითება გამოჩნდება გამოსავალში. ღრუბლოვანი API-ების გამოყენებას აქვს გარკვეული უპირატესობები შიდა (aspose.com) API-ებისგან განსხვავებით. მიზეზი ის არის, რომ თქვენ არ გჭირდებათ ხელით თვალყური ადევნოთ და განაახლოთ API ვერსიები და არ გჭირდებათ მთელი ლიცენზიის გადახდა.

Aspose.Cloud Dashboard

უბრალოდ შექმენით ანგარიში Aspose.Cloud dashboard-ზე ან დარეგისტრირდით თქვენი არსებული Google ან GitHub ანგარიშით და დაიწყეთ ჩვენი Cloud API-ების გამოყენება. Cloud API-ების კიდევ ერთი საოცარი თვისება არის ის, რომ თქვენ შეგიძლიათ გამოიყენოთ ისინი ნებისმიერ პლატფორმაზე ნებისმიერი მხარდაჭერილი ენის გამოყენებით.

როგორც ზემოთ აღინიშნა, სტატიაში ხაზგასმულია ვარიანტები MS Word დოკუმენტებში Header და Footer ობიექტების დამატებასა და განახლებასთან დაკავშირებით. ტესტირების მიზნით, ჩვენ გამოვიყენეთ არსებული MS Word დოკუმენტის შაბლონი სახელწოდებით Business Letter. დოკუმენტი უნდა აიტვირთოს Aspose ღრუბლოვან საცავში და ყველა მანიპულირება და დოკუმენტის დამუშავება განხორციელდება ღრუბელში. ყველა დამუშავების დასრულების შემდეგ, ჩვენ ასევე შეგვიძლია გადმოვწეროთ შედეგად მიღებული ფაილის ასლი Cloud საცავიდან.

using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;

ახლა Aspose.Cloud API-ების გამოსაყენებლად, თქვენ უნდა გამოიყენოთ App Key და App SID ინფორმაცია თქვენს კოდში. ეს კლავიშები შედგება ალფანუმერული ციფრებისგან. ეს არის უნიკალური კოდები, რომლებიც დაკავშირებულია თქვენი გამოწერის ანგარიშთან. ამ დეტალების მისაღებად, გთხოვთ, დააწკაპუნოთ ჩანართზე My Apps Aspose.Cloud dashboard-ზე. როდესაც ჩვენ გვექნება Keys, ჩვენ გვჭირდება ინიციალიზაცია Aspose.Words API ობიექტი.

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);

Header ობიექტის ჩასმა

MS Word ფაილის შიგნით სათაურის ობიექტის დასამატებლად, თანმიმდევრულად უნდა შეასრულოთ შემდეგი ოპერაციები.

  1. შექმენით InsertHeaderFooterRequest-ის ობიექტი, სადაც არგუმენტად გადავცემთ HeaderFooterLink ტიპს.
  2. HeaderFooterRequest ობიექტის ჩასმა WordsApi ობიექტში InsertHeaderFooter (…) მეთოდის გამოყენებით.
  3. შექმენით Run ობიექტი, რომელიც ინახავს ტექსტურ ინფორმაციას.
  4. შექმენით InsertRunRequest ობიექტი, სადაც გადავცემთ აბზაცის (SectionPath) მითითებას HeaderFooter ობიექტში, სადაც Run ტექსტი უნდა დაემატოს.
    შემდეგ გამოიძახეთ WordsApi-ის InsertRun (…) მეთოდი, რომელიც ამატებს RunRequest-ს HeaderFooter ობიექტში.

HeaderFooter.TypeEnum შეიძლება იყოს შემდეგი მნიშვნელობებიდან რომელიმე.

string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// შექმენით WordsAPI-ს ობიექტი AppKey და AppSid ინფორმაციის გადაცემისას
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// ატვირთეთ ნიმუშის დოკუმენტი ღრუბლოვან საცავში
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// ჩადეთ Header Object პირველ გვერდზე
var putHeaderFooterRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertHeaderFooterRequest("BusinessLetter.docx", "HeaderFirst", null,null);  
var actual = wordsApi.InsertHeaderFooter(putHeaderFooterRequest);
// შექმენით Run ობიექტი, რომელიც შეიცავს ნიმუშის ტექსტს
var run = new Run { Text = "Aspose.Words Cloud SDK for .NET " };
// დაამატეთ Run ტექსტი პირველი HeaderFooter ობიექტის პირველ აბზაცში Word დოკუმენტის პირველ ნაწილში
var runRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertRunRequest("BusinessLetter.docx", "sections/0/headersfooters/1/paragraphs/0", run);
// ჩადეთ RunRequest to Word დოკუმენტში
var actual2 = wordsApi.InsertRun(runRequest);
წარწერა

Image showing preview of recently added Header

განაახლეთ ახლად ჩასმული ჰედერის ტექსტის ფორმატირება

Header ობიექტის დამატების შემდეგ, ჩვენ შეგვიძლია განვაახლოთ მასში არსებული შინაარსის ტექსტის ფორმატირება. ამ მოთხოვნის შესასრულებლად, ჩვენ გვჭირდება შემდეგი ნაბიჯების შესრულება.

  1. შექმენით Font კლასის ობიექტი, სადაც ვაზუსტებთ ფონტის სახელს, ზომას, ფერს.
  2. იმისათვის, რომ ტექსტი უფრო წარმოჩენილი იყოს, მონიშნეთ Engrave თვისება როგორც True.
  3. შექმენით UpdateRunFontRequest კლასის ობიექტი, სადაც არგუმენტად გადავცემთ შეყვანის ფაილს, Font, SectionPath და runIndex.
  4. და ბოლოს, გამოიყენეთ UpdateRunFont(..) მეთოდი და დაამატეთ UpdateRunFontRequest ობიექტი WordsApi ინსტანციაში.
string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// შექმენით WordsAPI-ს ობიექტი AppKey და AppSid ინფორმაციის გადაცემისას
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// ატვირთეთ ნიმუშის დოკუმენტი ღრუბლოვან საცავში
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// შემდეგი ნაბიჯი არის Header Object-ის ფორმატირების დაყენება
var runIndex = 0;
var fontDto = new Font { Bold = true, Name = "Verdana", Size = 16, Color = new XmlColor { Web = "#e0a50d" } };
//  დააყენეთ ტექსტის ფორმატირება, როგორც Engrave
fontDto.Engrave = true;
// გამოიყენეთ ფორმატირება HeaderFooter ობიექტის პირველ აბზაცზე
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);
წარწერა

Image showing preview of Header after text formatting has been applied.

API ასევე გთავაზობთ ფუნქციას განაახლოს შინაარსის ფორმატირება არსებული Header / Footer ობიექტის შიგნით. ამ მოთხოვნის შესასრულებლად, ჩვენ შეგვიძლია გამოვიყენოთ ზემოთ მითითებული კოდის ხაზები, მაგრამ განსხვავება მხოლოდ არის headerfooter ინდექსის შეცვლა 2-ზე. იხილეთ შემდეგი კოდის ხაზი.

// 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);
წარწერა

Image displaying the change in Footer text formatting.

დაამატეთ გვერდის ნომრის ინფორმაცია ქვედა განყოფილებაში

გვერდის ნომრები იძლევა ძალიან სასარგებლო ინფორმაციას, როგორიცაა მიმდინარე გვერდი და დოკუმენტის გვერდების საერთო რაოდენობა. შემდეგი ნაბიჯები განსაზღვრავს, თუ როგორ უნდა შეასრულოთ მოთხოვნები.

  1. ჯერ შევქმენით PageNumber კლასის ობიექტი, სადაც განვსაზღვრავთ, ტექსტის გასწორება, ტექსტის ფორმატი, მდებარეობა PageNumber ინფორმაციის გამოსატანად და ასევე, ვაზუსტებთ, საჭიროა თუ არა PageNumber გამოსახვა პირველ გვერდზე.
  2. შექმენით InsertPageNumbersRequest ობიექტი და გადაიტანეთ PageNumber ობიექტი არგუმენტად.
  3. დაბოლოს, გამოიძახეთ InsertPageNumbers(..) მეთოდი WordsApi-ის მაგალითზე InsertPageNumbersRequest-ის დასამატებლად.
string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// შექმენით WordsAPI-ს ობიექტი AppKey და AppSid ინფორმაციის გადაცემისას
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);

// ატვირთეთ ნიმუშის დოკუმენტი ღრუბლოვან საცავში
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx", 
    FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));

// API ასევე გთავაზობთ ფუნქციას, დაამატოთ გვერდის ნომრის დეტალები HeaderFooter ობიექტში
// დაამატეთ გვერდის ნომრის ინფორმაცია გვერდის მარჯვენა ქვედა ნაწილში
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-ის დოკუმენტში PageNumber ინფორმაციის ჩასმა
var actual6 = wordsApi.InsertPageNumbers(insertPageNumbersRequest);
წარწერა

Preview Page number in the footer section.

დასკვნა

ამ სტატიაში ჩვენ ვისწავლეთ სათაურის ქვედა კოლონტიტულის დამატება Word Document-ში Aspose.Words Cloud SDK for .NET-ის გამოყენებით. გთხოვთ გაითვალისწინოთ, რომ ჩვენ ასევე გვაქვს Cloud SDK-ები Java, PHP, Ruby, Python, Go, Swift, C++, Node.Js, Android-ისთვის. დამატებითი დეტალებისთვის ეწვიეთ Aspose.Words Cloud.

დაკავშირებული სტატიები

ჩვენ ასევე გირჩევთ ეწვიოთ შემდეგს, რომ მეტი გაიგოთ: