הדגש או מחיק טקסט, הוסף הערות שורה או עיגול ב-PDF באמצעות Java REST API

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

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

התקנה של SDK
טקסט מחיק באמצעות Java
הוסף הערת סימון
כיצד להוסיף הערת שורה
הוספת הערת מעגל ב-PDF

התקנה של SDK

Aspose.PDF Cloud SDK עבור Java הוא ממשק API לתכנות המאפשר למתכנתי Java ליצור, לתפעל כמו גם להפוך מסמכי PDF קיימים לפורמטים נתמכים של מסמכים אחרים. ה-Cloud SDK זמין להורדה דרך Maven ו-GitHub. כעת הוסף את הפרטים הבאים בקובץ pom.xml שלך כדי להוריד ולהשתמש ב-Aspose.Pdf.jar בפרויקט הבנייה שלך ב-Maven.

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

למידע נוסף, בקר בכתובת כיצד להתקין ערכות SDK של Aspose.Cloud.

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

טקסט מחיק באמצעות Java

לפעמים יש לנו דרישה לסמן תוכן מסוים בתוך המסמך כמיושן מבלי להסיר אותו מהמסמך. המחיקה (המכונה המחיקה) מיוצגת על ידי מילים עם קו אופקי במרכזן. זה מרמז שהטקסט שגוי או מיושן ונמחק לאחרונה או סומן ככזה. אנו יכולים להגדיר את ההגדרות של הערות חוצה באמצעות המאפיין strikethroughSettings. המאפיין strikethroughSettings משמש לקביעת המאפיינים צבע, אטימות, מחבר, נושא, modifiedDate ו-isLocked של הערות חוצה.

// קבל 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 = "PdfWithTable.pdf";	        
			        
int pageNumber = 1;
// צור אזור מלבני עבור הערות  
Rectangle rect = new Rectangle()
    .LLX(200.)
    .LLY(380.)
    .URX(250.)
    .URY(375.);

List<AnnotationFlags> flags = new ArrayList<>();
flags.add(AnnotationFlags.DEFAULT);

List<Point> points = new ArrayList<>();
points.add(new Point().X(132.).Y(380.)); // Top-Left edge of the Strike Through line
points.add(new Point().X(95.).Y(10.));	// Top-Right edge of the strike through line
points.add(new Point().X(130.).Y(25.));
points.add(new Point().X(130.).Y(10.));

StrikeOutAnnotation annotation = new StrikeOutAnnotation();
annotation.setName("Name");
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setHorizontalAlignment(HorizontalAlignment.CENTER);
annotation.setRichText("Rich Text");
annotation.setSubject("Subj");
annotation.setZindex(1);
annotation.setTitle("Title");
annotation.setQuadPoints(points);
annotation.setModified("05/22/2021 00:00:00.000 AM");
			        

List<StrikeOutAnnotation> annotations = new ArrayList<>();
annotations.add(annotation);

AsposeResponse response = pdfApi.postPageStrikeOutAnnotations(sourcePDF, pageNumber, annotations, null, null);
assertEquals(200, (int)response.getCode());

הוסף הערת סימון

הדגשת התוכן בתוך PDF היא חיונית מכיוון שהיא מאפשרת לנו למשוך תשומת לב למידע חשוב בתוך המסמך. הדגשה יעילה מכיוון שהיא מבקשת תחילה מהקורא לבחור את החלקים החשובים, ולאחר מכן נותנת דרך יעילה לסקור מידע זה מאוחר יותר. Cloud API שלנו מספק את היכולות להדגיש תוכן בתוך מסמכי PDF. להלן השלבים להוספת הערות הדגשה בקובץ PDF.

קודם כל, צור מופע של PdfApi תוך מתן פרטי ClientSecret ו-ClientId.
אנו יוצרים מופע File כדי לטעון קובץ PDF מהמערכת המקומית ולאחר מכן קוראים לשיטת uploadFile(…) של מחלקת PdfApi כדי להעלות את המסמך לאחסון בענן.
כעת צור מופע של המחלקה Rectangle כדי לציין את האזור המלבני שבו ניתן להוסיף הערה.
לאחר מכן צור ArrayList מסוג Point כדי להחזיק את המידע לגבי נקודות כדי לצייר את HighlightAnnotation.
צור אובייקט במחלקה HighlightAnnotation והגדר את תאריך שינוי שם, אזור מלבני, נושא, כותרת, QuadPoints, הערה.
השלב הבא הוא ליצור רשימה של סוג HighlightAnnotation ולהוסיף אובייקט HighlightAnnotation שנוצר לעיל לרשימה זו.
לבסוף, קרא לשיטת postPageHighlightAnnotations(…) של מחלקת PdfApi והעבר מקור PDF, מספר עמוד ורשימת הערות כארגומנטים.

הדגש את התצוגה המקדימה של הערות — תמונה 1:- הדגש הערה בקובץ PDF.

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

כיצד להוסיף הערת שורה

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

קודם כל, צור מופע של PdfApi תוך מתן פרטי ClientSecret ו-ClientId.
לחלופין, אנו יוצרים מופע File כדי לטעון קובץ PDF מהמערכת המקומית ולאחר מכן קוראים לשיטת uploadFile(…) של מחלקת PdfApi כדי להעלות את המסמך לאחסון בענן. במקרה שהקובץ כבר זמין באחסון בענן, נוכל להשתמש בו.
שאר מאפייני האתחול של האובייקט זהים לאלה שהוזכרו לעיל עבור HighlithAnnotation, אלא שעלינו ליצור אובייקט של מחלקה LineAnnotation ולהגדיר את נקודת ההתחלה והסיום של שורה באמצעות שיטות setStarting(…) ו-setEnding(…).

// קבל ClientID ו-ClientSecret מ-https://dashboard.aspose.cloud/
String clientId = "7042694c-5251-4aba-83c9-e81e7518724f";
String clientSecret = "db246d4742e8cd22e7266c9391992689";
				
// ליצור מופע PDFApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// הזנת מסמך PDF
String sourcePDF = "PdfWithTable.pdf";	        
			    
// טען את הקובץ מהמערכת המקומית
File file = new File("/Users/nayyershahbaz/Downloads/" + sourcePDF);

// העלה את הקובץ לאחסון בענן
FilesUploadResult uploadResponse = pdfApi.uploadFile(sourcePDF, file, null);

// מספר עמוד שבו יתווסף הערה				
int pageNumber = 1;

// צור אזור מלבני עבור הערות  
Rectangle rect = new Rectangle()
    .LLX(100.)
    .LLY(500.)
    .URX(400.)
    .URY(510.);

// צור אובייקט רשימה מסוג AnnotationFlags
List<AnnotationFlags> flags = new ArrayList<>();
flags.add(AnnotationFlags.DEFAULT);

// צור אובייקט הערות שורה
LineAnnotation annotation = new LineAnnotation();

annotation.setName("Name");
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setRichText("Rich Text");
annotation.setSubject("Subj");
annotation.setTitle("Title");

// להגדיר את נקודת ההתחלה של הקו
annotation.setStarting(new Point().X(100.).Y(100.));
// הגדר את נקודת הסיום של הקו
annotation.setEnding(new Point().X(20.).Y(680.));

// צור מופע צבע עבור staleblue
Color color = new Color();
color.setA(0x00);
color.setR(0x6A);
color.setG(0x5A);
color.setB(0xCD);
// הגדר צבע הערות
annotation.interiorColor(color);

// הגדר את תאריך שינוי ההערה			      
annotation.setModified("05/22/2021 00:00:00.000 AM");
			        
// צור מופע רשימה של הערות שורה
List<LineAnnotation> annotations = new ArrayList<>();
// הוסף אובייקט LineAnnotation לרשימת הערות שורה
annotations.add(annotation);

// התקשר לשיטת API כדי להוסיף הערת שורה לקובץ PDF
AsposeResponse response = pdfApi.postPageLineAnnotations(sourcePDF, pageNumber, annotations, null, null);

הוספת הערת מעגל ב-PDF

הערות עיגול משמשות בדרך כלל גם בתוך מסמכי PDF וה-API תומך היטב בסוג ההערה הזה. על מנת להוסיף הערות מעגל, נסה להשתמש בכיתה CircleAnnotation. ניתן להשתמש בקוד המצוין להלן כדי למלא את הדרישה הזו.

// קבל ClientID ו-ClientSecret מ-https://dashboard.aspose.cloud/
String clientId = "7042694c-5251-4aba-83c9-e81e7518724f";
String clientSecret = "db246d4742e8cd22e7266c9391992689";
				
// ליצור מופע PDFApi
PdfApi pdfApi = new PdfApi(clientSecret,clientId);
				
// הזנת מסמך PDF
String sourcePDF = "PdfWithTable.pdf";	        
			    
// טען את הקובץ מהמערכת המקומית
File file = new File("/Users/nayyershahbaz/Downloads/" + sourcePDF);

// העלה את הקובץ לאחסון בענן
FilesUploadResult uploadResponse = pdfApi.uploadFile(sourcePDF, file, null);
// מספר עמוד שבו יתווסף הערה				
int pageNumber = 1;

// צור אזור מלבני עבור הערות  
Rectangle rect = new Rectangle()
    .LLX(100.)
    .LLY(700.)
    .URX(300.)
    .URY(500.);

// צור אובייקט רשימה מסוג AnnotationFlags
List<AnnotationFlags> flags = new ArrayList<>();
flags.add(AnnotationFlags.DEFAULT);

// צור אובייקט סימון הערות
CircleAnnotation annotation = new CircleAnnotation();
annotation.setName("Name");
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setRichText("Rich Text");
annotation.setSubject("Subj");
annotation.setTitle("Title");

// צור מופע צבע עבור staleblue
Color color = new Color();
color.setR(0xC7);
color.setG(0xE2);
color.setB(0x6f);
// הגדר צבע הערות
annotation.interiorColor(color);

// הגדר את תאריך שינוי ההערה			      
annotation.setModified("05/22/2021 00:00:00.000 AM");
			        
// צור מופע רשימה של הערות סימון
List<CircleAnnotation> annotations = new ArrayList<>();

// הוסף אובייקט CircleAnnotation לרשימת הערות מעגל
annotations.add(annotation);

// התקשר לשיטת API כדי להוסיף הערת מעגל לקובץ PDF
AsposeResponse response = pdfApi.postPageCircleAnnotations(sourcePDF, pageNumber, annotations, null, null);

הערת עיגול ב-PDF — תמונה 2:- הערת עיגול בקובץ PDF.

ניתן להוריד את מסמך PDF הקלט וה-PDF שנוצר, כפי שמוצג לעיל, מהקישורים הבאים:

טיפ מהיר

השתמש בחינם באינטרנט אפליקציית הערות PDF כדי להסיר את כל ההערות מ-PDF שלך בלחיצה אחת.

מַסְקָנָה

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

אנא יידעו שאנו שואפים תמיד לשרת את הלקוחות בצורה הטובה ביותר ומודים על המשוב וההצעות שלהם. לכן, במקרה שאתה נתקל בבעיה כלשהי בזמן השימוש ב-API או שיש לך שאילתה קשורה כלשהי, אנא אל תהסס לפנות אלינו דרך [פורום התמיכה החינמית] שלנו22.

מאמרים קשורים

אנו ממליצים בחום לבקר בקישורים הבאים כדי ללמוד עוד על:

התקנה של SDK#

טקסט מחיק באמצעות Java#

הוסף הערת סימון#

כיצד להוסיף הערת שורה#

הוספת הערת מעגל ב-PDF#

טיפ מהיר#

מַסְקָנָה#

מאמרים קשורים#