การใช้คำสั่ง cURL เพื่อประมวลผลส่วนหัวและส่วนท้ายของเอกสาร MS Word บน macOS

คำสั่ง cURL เป็นวิธีที่ดีเยี่ยมในการถ่ายโอนข้อมูลด้วย URL แนะนำให้ใช้คำสั่ง cURL เพื่อใช้ API จากเทอร์มินัลบรรทัดคำสั่ง ไม่เพียงแต่ช่วยให้เราส่งคำขอปกติได้เท่านั้น แต่ยังสามารถโพสต์ข้อมูลแบบฟอร์ม รับรองผู้ใช้ บันทึกการตอบกลับไปยังไฟล์ และการดำเนินการจัดการไฟล์อื่นๆ ที่เกี่ยวข้องได้อีกด้วย กล่าวอย่างง่ายๆ ก็คือ curl เป็นยูทิลิตี้บรรทัดคำสั่งสำหรับถ่ายโอนข้อมูลจากหรือไปยังเซิร์ฟเวอร์ที่ออกแบบมาเพื่อทำงานโดยไม่ต้องมีการโต้ตอบจากผู้ใช้ ด้วย curl คุณสามารถดาวน์โหลดหรืออัปโหลดข้อมูลโดยใช้โปรโตคอลที่รองรับโปรโตคอลหนึ่ง ได้แก่ HTTP, HTTPS, SCP, SFTP และ FTP

อย่างไรก็ตามมันยังช่วยให้เราทดสอบ RESTfull API ได้ด้วย

คำสั่ง cURL ที่ใช้

รับ

คำขอ/การดำเนินการที่ง่ายที่สุดและพบได้บ่อยที่สุดที่ใช้ HTTP คือการ GET URL เมื่อใช้คำสั่งนี้ เราจะส่งคำขอและดึงทรัพยากรจาก URL เฉพาะ (ในกรณีของเราคือเอกสาร)

โพสต์

คำขอเริ่มต้นคือ GET แต่ถ้าเราต้องการใช้คำสั่ง cURL เดียวกันในการส่งข้อมูลแบบฟอร์ม เราจำเป็นต้องใช้คำขอ POST ดังนั้นในบทความนี้ เราจะใช้คำสั่ง POST เดียวกันในการส่งเนื้อหาข้อความ โปรดทราบว่าในการโพสต์ข้อมูล เราใช้พารามิเตอร์ -d (หรือ – data) กับคำสั่ง cURL

ใส่

เราอาจพบข้อกำหนดในการอัปเดตข้อมูลที่มีอยู่ ดังนั้น จึงใช้เมธอด PUT เพื่อจุดประสงค์ดังกล่าว เพื่อให้บรรลุข้อกำหนดนี้ เราจำเป็นต้องใช้ -X PUT ในคำสั่ง cURL โดยที่ X จะต้องเป็นตัวพิมพ์ใหญ่

สำหรับข้อมูลเพิ่มเติม โปรดไปที่ บทช่วยสอน cURL

หมายเหตุ: เมื่อใช้คำสั่ง cURL โปรดอย่าใส่ช่องว่างเพิ่มเติมหลังเครื่องหมายแบ็กสแลช \ มิฉะนั้น คำสั่งจะไม่ถูกดำเนินการและจะแสดงข้อผิดพลาด

การตั้งค่า cURL บน Mac

ในบทความนี้ เราจะใช้คำสั่ง cURL บน macOS เพื่อแทรกและอัปเดตวัตถุ Header Footer ในเอกสาร MS Word โดยใช้แอปพลิเคชันเทอร์มินัล ดังนั้นเพื่อเริ่มต้น ขั้นแรกคือการติดตั้ง cURL บน macOS เปิดแอปพลิเคชัน Terminal ภายใต้หมวดหมู่ Others จากแถบเรียกใช้งาน หรือ กด Command+Space และพิมพ์ Terminal แล้วกดปุ่ม Enter/Return วิธีที่ง่ายที่สุดในการติดตั้ง cURL คือการใช้ Homebrew และด้วยเหตุนี้ ก่อนอื่น คุณต้องตั้งค่า Homebrew บนเครื่อง Mac ของคุณ พิมพ์คำสั่งต่อไปนี้บนเทอร์มินัลบรรทัดคำสั่ง แล้วกดปุ่ม Enter

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" < /dev/null 2> /dev/null
copy

ตอนนี้รับแพ็คเกจ brew สำหรับ cURL โดยใช้คำสั่งต่อไปนี้

 brew install curl 
copy

เสร็จเรียบร้อย! ตอนนี้คุณสามารถใช้ curl ได้แล้ว

อนุญาตบัญชี Aspose.Cloud

หากต้องการเริ่มต้นใช้งาน Aspose.Cloud APIs ขั้นตอนแรกคือการตรวจสอบบัญชีของคุณและรับ JWT ตอบกลับ หากคุณไม่มีบัญชี คุณสามารถสร้างบัญชีบน Aspose.Cloud Dashboard หรือสมัครผ่านบัญชี Google หรือ GitHub ที่มีอยู่และเริ่มใช้ Cloud API ของเรา

// First get JSON Web Token for authentication
// Get App Key and App SID from https://dashboard.aspose.cloud/
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=[APP_SID]&client_secret=[APP_KEY]" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
copy

Aspose.คำคลาวด์

Aspose นำเสนอ API สำหรับจัดการเอกสาร MS Word และคุณสามารถเลือกใช้ Cloud APIs, On-Premise APIs หรือ Cross-platform Apps เพื่อประมวลผลเอกสาร Word ในบล็อกนี้ เราเน้นที่ Cloud API ซึ่งให้ความสามารถในการสร้าง จัดการ และแปลงเอกสาร MS Word ในระบบ Cloud โดยไม่ต้องดาวน์โหลดหรือติดตั้งซอฟต์แวร์เฉพาะใดๆ เพื่อทำงานกับไฟล์ MS Word

กลุ่มผลิตภัณฑ์ Aspose.Cloud นำเสนอชุด SDK บนคลาวด์ที่กำหนดเป้าหมายไปที่ภาษาการเขียนโปรแกรมยอดนิยม ได้แก่ .NET, Java, PHP, Python, Node.js, Android, C++, Ruby, Swift และ Go SDK เหล่านี้ทั้งหมดเป็นตัวห่อหุ้มรอบ Aspose.Words Cloud REST API และคำสั่ง cURL เป็นหนึ่งในวิธีที่ง่ายและสะดวกที่สุดในการเข้าถึง REST API ผ่านพรอมต์คำสั่ง/เทอร์มินัล

ในบล็อกนี้ เราเน้นการใช้คำสั่ง cURL เพื่อจัดการส่วนหัวและส่วนท้ายในไฟล์ MS Word ขณะเข้าถึง Aspose.Words Cloud API

อัพโหลดเอกสาร Word

เมื่อดำเนินการตรวจสอบเรียบร้อยแล้ว ขั้นตอนต่อไปคือการอัปโหลดไฟล์ไปยังที่เก็บข้อมูลบนคลาวด์ โดยใช้คำสั่ง cURL ต่อไปนี้ ไฟล์จะถูกอัปโหลดไปยังที่เก็บข้อมูลเริ่มต้นภายใต้ InputFolder

curl -v -X PUT "https://api.aspose.cloud/v4.0/words/storage/file/InputFolder" \
-H "accept: application/json" \
-H "authorization: Bearer <jwt token>" \
-F document=@BusinessLetter2.docx
copy

ขณะนี้เพื่อยืนยันการมีอยู่ของไฟล์บนที่เก็บข้อมูลบนคลาวด์ ให้เปิดแท็บไฟล์ของฉันบน dashboard.aspose.cloud เราจะสังเกตเห็นว่าโฟลเดอร์ใหม่ชื่อ InputFolder ซึ่งมี BusinessLetter2.docx ปรากฏอยู่ในรายการ

แทรกวัตถุส่วนหัว

หลังจากอัปโหลดเอกสารแล้ว เราสามารถแทรกวัตถุส่วนหัวหรือส่วนท้ายใหม่ หรือเข้าถึงวัตถุที่มีอยู่แล้วและอัปเดตคุณสมบัติของวัตถุนั้นได้ ปัจจุบัน Aspose.Words Cloud API รองรับวัตถุส่วนหัวและส่วนท้ายประเภทต่อไปนี้

คำสั่งต่อไปนี้จะแสดงวิธีแทรกวัตถุ HeaderFirst ลงในเอกสาร Word ที่มีอยู่แล้วในที่จัดเก็บข้อมูลบนคลาวด์ภายใต้ InputFolder

curl -v -X PUT "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/headersfooters?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "'HeaderFirst'" \
-H "Content-Type: application/json"
copy

เมื่อดำเนินการคำสั่งข้างต้นแล้ว คอนโซลจะแสดงรายการส่วนต่างๆ ภายในเอกสาร Word

ส่วนหัวและส่วนท้ายโดยปกติจะมีข้อความ รูปภาพ ฯลฯ และในคำสั่งต่อไปนี้ เราจะแทรกข้อความตัวอย่างภายในย่อหน้าแรกภายในอ็อบเจ็กต์ส่วนหัวที่สร้างขึ้นด้านบน

curl -v -X POST "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/sections/0/headersFooters/1/paragraphs?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "{ 'Text': 'Aspose.Words Cloud .NET SDK' }" \
-H "Content-Type: application/json"
copy

อัปเดตการจัดรูปแบบข้อความของวัตถุส่วนหัว

เมื่อแทรกข้อความแล้ว เราสามารถอัปเดตคุณสมบัติของฟอนต์ข้อความได้ เนื่องจากเอกสาร Word อาจมีอินสแตนซ์ข้อความจำนวนมาก ดังนั้นเพื่ออัปเดตข้อความ เราจึงต้องระบุเส้นทางที่แน่นอน ดังนั้น หากเราจำเป็นต้องอัปเดตคุณสมบัติของฟอนต์สำหรับข้อความที่แทรกไว้ด้านบนซึ่งแทรกไว้เหนือ sections/0/headersfooters/1/paragraphs/0/runs/0 เราจะต้องใช้คำสั่งต่อไปนี้

โปรดทราบว่าตอนนี้เราจะอัปเดตคุณสมบัติแบบอักษรของวัตถุที่วางไว้แล้ว ดังนั้น เราจึงต้องใช้คำสั่ง PUT

curl -v -X PUT "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/sections/0/headersFooters/1/paragraphs/0/runs/0/font?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "{ 'Bold':true, 'Size': 21.0, 'Name': 'Calibri',  'Color': { 'Web': '#f54269', 'Alpha': 0 } }" \
-H "Content-Type: application/json"
copy

แทรกหมายเลขหน้าในส่วนท้าย

การใช้งานที่สำคัญอย่างหนึ่งของวัตถุส่วนหัวและส่วนท้ายคือการแสดงข้อมูลหมายเลขหน้า และในขณะที่ใช้ Aspose.Words Cloud เราก็สามารถบรรลุข้อกำหนดนี้ได้อย่างง่ายดาย นอกจากนี้ API ยังให้ความสามารถในการระบุตำแหน่งที่ต้องการแสดงตราประทับ PageNumber ตามที่แสดงในคำสั่งด้านล่าง เราได้ระบุให้เพิ่มข้อมูล PageNumber เพื่อแสดงที่ตำแหน่งด้านบนขวาของหน้า และแสดงข้อมูลดังกล่าวเหนือหน้าแรกของเอกสารด้วย

curl -v -X PUT "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/PageNumbers?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "{ 'Format': '{PAGE} of {NUMPAGES}', 'Alignment': 'right', 'IsTop': false, 'SetPageNumberOnFirstPage': true }" \
-H "Content-Type: application/json"
copy

คล้ายกับการอัปเดตคุณสมบัติฟอนต์สำหรับอินสแตนซ์ส่วนหัว เราสามารถอัปเดตคุณสมบัติฟอนต์ของอ็อบเจกต์ส่วนท้ายซึ่งประกอบด้วยข้อมูลหมายเลขหน้าได้เช่นกัน เนื่องจากข้อมูลหมายเลขหน้าประกอบด้วยอ็อบเจกต์ที่รัน 3 รายการ (รัน/0, รัน/2 และรัน/3) ดังนั้นเราจึงต้องอัปเดตคำสั่งอัปเดตฟอนต์ 3 ครั้งสำหรับแต่ละอินสแตนซ์ที่รัน

curl -v -X PUT "https://api.aspose.cloud/v4.0/words/BusinessLetter2.docx/sections/0/headersFooters/3/paragraphs/1/runs/3/font?folder=InputFolder" \
-H "accept: multipart/form-data" \
-H "authorization: Bearer <jwt token>" \
-d "{ 'Bold':true, 'Size': 21.0, 'Name': 'Arial', 'Shadow': true, 'Color': { 'Web': '#f5b642', 'Alpha': 0 } }" \
-H "Content-Type: application/json"
copy

เมื่อดำเนินการคำสั่งทั้งหมดข้างต้นแล้ว เอกสารผลลัพธ์จะมีลักษณะคล้ายกับภาพตัวอย่างด้านบน

เพื่อเป็นข้อมูลอ้างอิง เอกสารตัวอย่างยังแนบมาด้วย:

• ไฟล์อินพุต
• ไฟล์ผลลัพธ์