הוסף כותרת עליונה ותחתונה ב-PDF באמצעות Java REST API

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

יתר על כן, אנא שים לב לכך שכותרות עליונות ותחתונות שימושיות במתן מידע מהיר על המסמך שלך בפורמט צפוי וגם עוזרים בהגדרת חלקים שונים של מסמך. במאמר זה, אנו הולכים ללמוד על הוספת טקסט ותמונות לאזורי הכותרת העליונה והתחתונה של קבצי PDF באמצעות Aspose.PDF Cloud SDK עבור Java.

הוסף טקסט לכותרת באמצעות cURL
הוספת כותרת טקסט ב-PDF באמצעות Java
תמונה בכותרת PDF באמצעות ה-cURL
הוסף תמונה ב-Header באמצעות Java

הוסף טקסט לכותרת באמצעות cURL

פקודות cURL הן דרך מרגשת לגשת ל-RESTFul APIs דרך מסוף שורת הפקודה. מאז Aspose.PDF Cloud SDK פותח לפי עקרונות REST, כך שניתן לגשת אליו בקלות באמצעות שורת הפקודה. עם זאת, שים לב שכדי להבטיח את פרטיות המשתמש ושלמות הנתונים, כל ממשקי ה-API שלנו נגישים רק לאנשים מורשים. לכן, תחילה עליך לבקר ב-Aspose.Cloud Dashboard ואם יש לך חשבון GitHub או Google, פשוט הירשם. אחרת, לחץ על הלחצן צור חשבון חדש וספק את המידע הנדרש. כעת היכנס ללוח המחוונים באמצעות אישורים והרחב את קטע היישומים מלוח המחוונים וגלול מטה אל הקטע אישורי לקוח כדי לראות את פרטי זיהוי הלקוח ופרטי סוד הלקוח.

הפקודה הבאה מראה כיצד ליצור אסימון גישה ל-JWT אשר ישמש להוספת טקסט באזור הכותרת של המסמך PDF.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

השתמש בפקודת cURL הבאה כדי להוסיף טקסט בחלק הכותרת של מסמך ה-PDF.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/PdfWithAnnotations.pdf/header/text?startPageNumber=2&endPageNumber=2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-H  "Content-Type: application/json" \
-d "{  \"Background\": true,  \"HorizontalAlignment\": \"CENTER\",  \"Opacity\": 0.8,  \"Rotate\": \"None\",  \"RotateAngle\": 0,  \"XIndent\": 0,  \"YIndent\": 0,  \"Zoom\": 1,  \"TextAlignment\": \"CENTER\",  \"Value\": \"Aspose.PDF Cloud SDK for Java via cURL\",  \"TextState\": {    \"FontSize\": 16,    \"Font\": \"Arial\",    \"ForegroundColor\": {      \"A\": 0,      \"R\": 0xDA,      \"G\": 0xA5,      \"B\": 0x20    },    \"BackgroundColor\": {      \"A\": 0,      \"R\": 0xFA,      \"G\": 0xEB,      \"B\": 0xD7    },  },  \"LeftMargin\": 1,  \"TopMargin\": 20,  \"RightMargin\": 200}"

ניתן להוריד את הקבצים לדוגמה המשמשים בדוגמה זו מ:

הוספת כותרת טקסט ב-PDF באמצעות Java

כדי להשתמש ב-SDK, תחילה עליך להתקין אותו מ-Maven או GitHub. להלן הפרטים כיצד להוריד ולהשתמש ב-Aspose.Pdf.jar בפרויקט הבנייה של Maven.

הוסף את התלות הבאות בקובץ pom.xml שלך.

<repositories>
 <repository>
        <id>aspose-cloud</id>
        <name>artifact.aspose-cloud-releases</name>
        <url>https://artifact.aspose.cloud/repo</url>
    </repository>   
</repositories>
<dependencies>
 <dependency>
        <groupId>com.aspose</groupId>
        <artifactId>aspose-pdf-cloud</artifactId>
        <version>21.1.0</version>
        <scope>compile</scope>
    </dependency>
 </dependencies>

להלן השלבים כיצד לבצע את הדרישה הזו.

קודם כל, צור מופע של PdfApi תוך מתן פרטי ClientSecret ו-ClientId
שנית, צור אובייקט Color כדי להגדיר את פרטי צבעי ForeGround ו-BackGround.
שנית, צור אובייקט במחלקה TextState.
השתמש בשיטת fontSize(..) כדי להגדיר פרטי גודל גופן. שיטת הגופן (..) להגדרת פני הגופן. שיטת foregroundColor(…) מגדירה פרטי קדמת טקסט, ושיטה backgroundColor(…) להגדרת מידע רקע.
כעת צור אובייקט TextHeader והגדר את פרטי השוליים.
השתמש בשיטות value(..) כדי לציין את התוכן של אובייקט ה-Text Header.
כעת קרא למתודה textState(…) והעבר למעלה מופע TextState שנוצר כארגומנט.
על מנת להציג את ה-Header מאחורי תוכן העמוד, העבר את הערך האמיתי כארגומנט לשיטת רקע(…) של המחלקה TextHeader.
כעת על מנת לרנדר את התמונה בצד שמאל, העבר את ערך HorizontalAlignment.CENTER לשיטת horizontalAlignment(…).
שיטת האטימות(…) מציינת את האטימות החותמת. ערך ברירת המחדל הוא 1.0.
לאחר שקבענו את ערך הזום, צור אובייקט AsposeResponse.
לבסוף, קרא לשיטת PdfApi .postDocumentTextHeader(…) והעבר את שם קובץ ה-PDF של המקור, האובייקט TextHeader, דפי ההתחלה והסיום (כאשר יש להוסיף חותמת) כארגומנטים.

// קבל ClientID ו-ClientSecret מ-https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// ליצור מופע PDFApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// הזנת מסמך PDF
String sourcePDF = "PdfWithAnnotations.pdf";

// דף התחלה של PDF כדי למקם את תמונת הכותרת
int startPage = 2;

// עמוד סיום של PDF להצבת תמונת כותרת
int endPage = 3;
		        
// ציין את צבע החזית כ-SlateBlue בקוד Hex
Color foregroundColor = new Color();
foregroundColor.setA(0x00);
foregroundColor.setR(0x6A);
foregroundColor.setG(0x5A);
foregroundColor.setB(0xCD);

// ציין צבע רקע בתור AntiqueWhite בקוד Hex
Color backgroundColor = new Color();
backgroundColor.setA(0x00);
backgroundColor.setR(0xFA);
backgroundColor.setG(0xEB);
backgroundColor.setB(0xD7);

// צור אובייקט TextState כדי להגדיר את גודל הגופן, פרטי הפנים והצבע
TextState textState = new TextState()
  .fontSize(16.)
  .foregroundColor(foregroundColor)
  .backgroundColor(backgroundColor)
  .font("Arial");
		        
// צור מופע של אובייקט TextHeader
TextHeader headerObject = new TextHeader()    
  .leftMargin(1.)
  .rightMargin(200.)
  .topMargin(10.)
	
  // התוכן של כותרת הטקסט לעיבוד
  .value("Aspose.PDF Cloud SDK For Java")
	
  // הגדר יישור כמרכז
  .textAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
  .textState(textState);
	
  // הגדר טקסט כותרת מאחורי תוכן העמוד
  headerObject.background(true)
	
  // הגדר את יישור כותרות הטקסט כמרכז
  .horizontalAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.CENTER)
	
  // הגדר את האטימות של כותרת הטקסט כ-0.8
  .opacity(0.8)
  .rotate(com.aspose.asposecloudpdf.model.Rotation.NONE)
  .rotateAngle(0.)
  .xindent(2.0)
  .yindent(5.0)
  .zoom(1.0);

// התקשר לשיטת API כדי להוסיף כותרת טקסט ל-PDF
AsposeResponse response = pdfApi.postDocumentTextHeader(sourcePDF, headerObject,startPage, endPage, null, null);
assertEquals(200, (int)response.getCode());

כותרת טקסט נוספה ב-Java — תמונה 2:- תצוגה מקדימה של כותרת טקסט נוספה עם Java.

על מנת להוסיף טקסט באזור הכותרת התחתונה, אנא צור מופע של מחלקה TextFooter והתקשר לשיטת postDocumentTextFooter(…) של מחלקה PdfApi. שאר השלבים והפרטים יישארו כפי שהוזכרו לעיל עבור הוספת כותרת הטקסט.

תמונה בכותרת PDF באמצעות ה-cURL

אנו יכולים להוסיף בקלות קובצי תמונה באמצעות PostDocumentImageHeader API בחלק הכותרת של קובץ PDF באמצעות הפקודה cURL. תוך כדי הוספת חותמת תמונה, אנו מקבלים את האפשרות לציין פרטים אופקי, אטימות, RotateAngle, מקדם זום של התמונה, רוחב, גובה, LeftMargin, TopMargin, RightMargin וכו'.

פרמטר השם מגדיר את מסמך ה-PDF הקלט/מקור, imageHeader מציין את קובץ התמונה שיש להחתים, המאפיין startPageNumber מגדיר את עמוד ההתחלה ואת עמוד הסיום endPageNumber של מסמך ה-PDF כך שיכילו חותמות תמונה. בפקודה cURL הבאה, המאפיין Background מוגדר כ-false כך שהתמונה תהיה גלויה. היישור האופקי מוגדר כשמאלי, ערך האטימות מוגדר כ-0.8, מקדם הזום מוגדר כ-1, הרוחב מוגדר כ-250, הגובה מוגדר כ-80 נקודות ו-RightMargin מוגדר כ-500 נקודות.

curl -X POST "https://api.aspose.cloud/v3.0/pdf/PdfWithAnnotations.pdf/header/image?startPageNumber=2&endPageNumber=2" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>"  \
-H  "Content-Type: application/json" \
-d "{"Background":false,"HorizontalAlignment":'Left',"Opacity": .8,"Rotate":'None',"RotateAngle": 0,"XIndent": 2,"YIndent": 5,"Zoom": 1,"FileName": 'asposetoolsnew.png',"Width": 250,"Height": 80,"LeftMargin": 1,"TopMargin": 10,"RightMargin": 500}"

חותמת תמונה בכותרת — תמונה 3: - חותמת תמונה בחלק הכותרת של PDF.

ניתן להוריד את הקבצים לדוגמה המשמשים בדוגמה לעיל מהקישור הבא:

הוסף תמונה ב-Header באמצעות Java

Aspose.PDF Cloud SDK עבור Java מספק תכונה יוצאת דופן להוספת כותרת תמונה בקובץ PDF עם פחות שורות קוד.

להלן שלבים כיצד להוסיף כותרת תמונה במסמך PDF

צור אובייקט של PdfApi תוך מתן פרטי ClientSecret ו-ClientId.
שנית, צור אובייקט במחלקה ImageHeader.
השתמש בשיטות רוחב (..) וגובה (…) של מחלקה ImageHeader כדי להגדיר פרטי רוחב וגובה תמונה.
כעת השתמש בשיטת fileName(…) כדי להגדיר פרטי נתיב עבור תמונת הכותרת.
על מנת להציג את התמונה מאחורי תוכן העמוד, העבירו את ארגומנט השווא לשיטת רקע(…).
כעת על מנת לרנדר את התמונה בצד שמאל, העבר את הערך HorizontalAlignment.LEFT לשיטת horizontalAlignment(…).
שיטת האטימות(…) מציינת את האטימות החותמת. ערך ברירת המחדל הוא 1.0.
לאחר שקבענו את ערך הזום, צור אובייקט AsposeResponse.
לבסוף, קרא לשיטת PdfApi.postDocumentImageHeader(…) תוך העברת שם קובץ PDF של מקור, אובייקט ImageHeader, דפי התחלה וסיום (שם יש להוסיף חותמת) כארגומנטים לשיטה זו.

// קבל ClientID ו-ClientSecret מ-https://dashboard.aspose.cloud/
String clientId = "29ac1517-753f-4303-b755-7185e35cf939";
String clientSecret = "c537caf71eafc8a75a5ee7813b703276";
				
// ליצור מופע PDFApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// הזנת מסמך PDF
String sourcePDF = "PdfWithAnnotations.pdf";

// דף התחלה של PDF כדי למקם את תמונת הכותרת
int startPage = 2;

// עמוד סיום של PDF להצבת תמונת כותרת
int endPage = 3;
		        
// צור מופע של אובייקט ImageHeader
ImageHeader headerObject = new ImageHeader()
	.width(250.0)
	.height(80.0)
	.leftMargin(1.)
	.rightMargin(500.)
	.topMargin(10.)
	.fileName("asposetoolsnew.png");
	
	// הביאו את תמונת הכותרת לחזית/גלויה
	headerObject.background(false)
	
	// הגדר את יישור כותרת התמונה כשמאל
	.horizontalAlignment(com.aspose.asposecloudpdf.model.HorizontalAlignment.LEFT)
	.opacity(0.8)
	.rotate(com.aspose.asposecloudpdf.model.Rotation.NONE)
	.rotateAngle(0.)
	.xindent(2.0)
	.yindent(5.0)
	.zoom(1.0);

// התקשר לשיטת API כדי להוסיף תמונת כותרת ב-PDF
AsposeResponse response = pdfApi.postDocumentImageHeader(sourcePDF, headerObject,startPage, endPage, null, null);

על מנת להוסיף תמונה באזור הכותרת התחתונה, צור אובייקט של המחלקה ImageFooter וקרא לשיטת postDocumentImageFooter(…) של המחלקה pdfApi. שאר השלבים יישארו זהים כפי שהוסבר לעיל עבור התמונה בסעיף הכותרת למעלה.

מַסְקָנָה

במאמר זה, דנו בשלבים כיצד לגשת לענן Aspose.PDF באמצעות פקודות cURL כדי להוסיף טקסט ותמונות באזורי כותרת עליונה/תחתונה של מסמכי PDF. בדקנו גם את השלבים להתקנת Aspose.PDF Cloud SDK עבור Java ולהשתמש בו בשפת Java להוספת טקסט ותמונה בחלק הכותרת העליונה או התחתונה של קובץ ה-PDF. לפרטים נוספים על תכונות מרגשות אחרות של ה-API, אנא עיין בתיעוד מוצר.

כל ערכות פיתוח הענן שלנו הן OpenSource, כך שניתן להוריד קוד מקור מלא מ-GitHub.

הוסף טקסט לכותרת באמצעות cURL#

הוספת כותרת טקסט ב-PDF באמצעות Java#

תמונה בכותרת PDF באמצעות ה-cURL#

הוסף תמונה ב-Header באמצעות Java#

מַסְקָנָה#

הוסף טקסט לכותרת באמצעות cURL

הוספת כותרת טקסט ב-PDF באמצעות Java

תמונה בכותרת PDF באמצעות ה-cURL

הוסף תמונה ב-Header באמצעות Java

מַסְקָנָה