שימוש בפקודות cURL לעיבוד כותרת עליונה ותחתונה של מסמך MS Word ב-macOS

פקודות cURL הן דרך מצוינת להעברת נתונים עם כתובות URL. מומלץ להשתמש בפקודות cURL כדי להשתמש בממשקי API ממסופי שורת הפקודה. זה לא רק מאפשר לנו להגיש בקשות קבועות, אלא גם לפרסם נתוני טפסים, לאמת משתמשים, לשמור תגובות לקבצים ופעולות אחרות של מניפולציה של קבצים קשורות. במילים פשוטות, curl הוא כלי שורת פקודה להעברת נתונים משרת או אל שרת שנועד לעבוד ללא אינטראקציה של המשתמש. עם curl, אתה יכול להוריד או להעלות נתונים באמצעות אחד מהפרוטוקולים הנתמכים כולל HTTP, HTTPS, SCP, SFTP ו-FTP.

עם זאת, זה גם מקל עלינו לבדוק ממשקי API של RESTfull.

נעשה שימוש בפקודות cURL

לְקַבֵּל

הבקשה/פעולה הפשוטה והנפוצה ביותר שנעשתה באמצעות HTTP היא קבלת כתובת URL. בעת שימוש בפקודה זו, אנו שולחים בקשה ומחזירים משאבים מכתובת URL ספציפית (מסמך במקרה שלנו).

שֶׁלְאַחַר

בקשת ברירת המחדל היא GET אך אם יש לנו דרישה להשתמש באותה פקודת cURL לשליחת נתוני טפסים, עלינו להשתמש בבקשת POST. לכן במאמר זה, נשתמש באותה פקודת POST כדי לשלוח תוכן טקסט. שים לב שכדי לפרסם נתונים, אנו משתמשים בפרמטר -d (או – data) עם הפקודה cURL.

לָשִׂים

אנו עשויים להיתקל בדרישה לעדכן נתונים קיימים, ולכן לשם כך, נעשה שימוש בשיטת PUT. על מנת למלא את הדרישה הזו, עלינו להשתמש ב-X PUT בפקודה cURL כאשר X צריך להיות באותיות רישיות.

למידע נוסף, בקר בcURL Tutorial.

הערה: בעת שימוש בפקודות cURL, ודא שאינך מכניס רווח נוסף לאחר הקו הנטוי \ else, הפקודה לא תבוצע ושגיאות יוצגו.

הגדרת cURL ב-Mac

במאמר זה, אנו הולכים להשתמש בפקודות cURL ב-macOS כדי להוסיף ולעדכן אובייקטים של כותרת תחתונה בתוך מסמך MS Word באמצעות יישום מסוף. אז כדי להתחיל, הדבר הראשון הוא להתקין cURL ב-macOS. פתח את אפליקציית המסוף תחת קטגוריית אחרים מלוח ההפעלה או, הקש Command+רווח והקלד 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

כעת קבל את חבילת הבישול עבור cURL באמצעות הפקודה הבאה.

 brew install curl 
copy

נַעֲשָׂה! עכשיו אתה יכול להשתמש בתלתל.

אישור חשבון Aspose.Cloud

על מנת להתחיל עם Aspose.Cloud APIs, הצעד הראשון הוא לאמת את החשבון שלך ולקבל JWT בתגובה. אם אין לך חשבון, אתה יכול ליצור אחד ב-Aspose.Cloud dashboard או להירשם דרך חשבון Google או GitHub הקיים שלך ולהתחיל להשתמש בממשקי ה-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.Words Cloud

Aspose מציעה ממשקי API לתמרן מסמכי MS Word ואתה מקבל אפשרות להשתמש ב-Cloud APIs, On-Premise APIs או, Cross-platform Apps לעיבוד מסמכי Word. בבלוג זה, הדגשנו על ממשקי API של ענן המספקים לנו את היכולות ליצור, לתפעל ולשנות מסמכי MS Word בענן. לא נדרשת הורדה או התקנה ספציפית של תוכנה כדי לעבוד עם קבצי MS Word.

משפחת Aspose.Cloud Product מספקת קבוצה של ערכות פיתוח ענן המתמקדות בשפות תכנות פופולריות כולל .NET, Java, PHP, Python, Node.js, Android, C++, Ruby, Swift ו-Go. כל ה-SDKs הללו הם מעטפת סביב Aspose.Words Cloud REST API ופקודות cURL הן אחת הדרכים הפשוטות והקלות ביותר לגשת לממשקי REST API דרך שורת הפקודה/טרמינל.

בבלוג זה, אנו שמים דגש על שימוש בפקודות cURL כדי לתפעל את קטע הכותרת העליונה והתחתונה בתוך קבצי MS Word תוך גישה ל-Aspose.Words Cloud API.

העלה מסמך וורד

לאחר ביצוע האימות, השלב הבא הוא העלאת הקובץ לאחסון בענן. על ידי שימוש בפקודה 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 מופיעה ברשימה.

הוסף אובייקט כותרת

לאחר העלאת המסמך, נוכל להכניס אובייקט Header או Footer חדש או לגשת לאובייקט קיים ולעדכן את המאפיינים שלו. נכון לעכשיו, Aspose.Words Cloud API תומך בסוגים הבאים של אובייקטי Header ו-Footer.

הפקודה הבאה מראה כיצד להוסיף אובייקט 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

הוסף מספר עמוד בכותרת התחתונה

אחד השימושים החשובים באובייקטי Header ו-Footer הוא להציג מידע על מספרי עמודים ובזמן השימוש ב-Aspose.Words Cloud, נוכל לעמוד בדרישה זו בקלות. ה-API מספק גם את היכולות לציין את המיקום שבו יש להציג את חותמת ה-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

בדומה לעדכון מאפייני גופן למופע Header, אנו יכולים גם לעדכן את מאפייני הגופן של אובייקט Footer המכיל מידע PageNumber. מכיוון שמידע מספר העמוד מורכב מאובייקטים של שלוש ריצות (runs/0, runs/2 ו-runs/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

לאחר ביצוע כל הפקודות לעיל, המסמך שנוצר ייראה דומה לתצוגה המקדימה שלמעלה.

לעיונך, מצורפים גם המסמכים לדוגמה:

• קובץ קלט
• קובץ שנוצר