צור PDF באופן מקוון באמצעות Java REST API

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

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

התקנה של SDK
הוסף הערת עיבוד באמצעות Java
קרא הערות לעיבוד דף
עדכן הערת עריכה קיימת

התקנה של SDK

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

ה-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 Dashboard ואם יש לך חשבון GitHub או Google, פשוט הירשם. אחרת, לחץ על הלחצן צור חשבון חדש וספק את המידע הנדרש. כעת היכנס ללוח המחוונים באמצעות אישורים והרחב את קטע היישומים. גלול מטה אל הקטע אישורי לקוח כדי לראות את פרטי זיהוי הלקוח ופרטי סוד הלקוח.

הוסף הערת עיבוד באמצעות Java

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

קודם כל, עלינו ליצור אובייקט של PdfApi תוך העברת פרטי ClientId ו-ClientSecret המתקבלים מלוח המחוונים של Aspose.Cloud.
שנית, צור אובייקט של מחלקה Rectangle כדי לציין את האזור בדף שבו יתווסף הערה.
שלישית, בחר את ערך ברירת המחדל מספירת AnnotationFlags והוסף אותו לרשימת דגלים מסוג AnnotationFlags.
כעת צור מופע של מחלקה RedactionAnnotation והגדר את האזור המלבני באמצעות שיטת setRect(…).
הגדר את היישור האופקי באמצעות שיטת setHorizontalAlignment(…) ובחר במרכז מתוך ספירת HorizontalAlignment.
על מנת למלא את הצבע בתוך Annotation, השתמשו בשיטת setFillColor(…) והעבירו את האובייקט Color.
הגדר את תאריך השינוי האחרון של ההערה באמצעות שיטת setModified(…).
הלפני אחרון, צור רשימה מסוג RedactionAnnotation והוסף אובייקט RedactAnnotation לרשימה זו.
לבסוף, קרא לשיטת postPageRedactionAnnotations(…) של PdfApi והעבר את שם קובץ המקור, מספר העמוד שבו יש להוסיף הערה. כמו כן, העבר את רשימת הערות Redaction כארגומנט כדי להתחיל את תהליך העריכה.

// קבל 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";

// דף PDF להצבת הערה
int pageNumber = 1;

// צור אובייקט מלבן כדי לציין את אזור ההערה לערוך
// האזור מחושב משמאל למטה בעמוד
Rectangle rect = new Rectangle()

// יחידת המדידה היא נקודה
  .LLX(100.)
  .LLY(700.)
  .URX(200.)
  .URY(600.);

// ליצור מערך AnnotationFlags
List<AnnotationFlags> flags = new ArrayList<>();

// הגדר את הדגל Annotation לברירת המחדל
flags.add(AnnotationFlags.DEFAULT);

// צור ArrayList של נקודות
List<Point> points = new ArrayList<>();
points.add(new Point().X(10.).Y(40.));
points.add(new Point().X(30.).Y(40.));

// צור אובייקט Redact Annotation
RedactionAnnotation annotation = new RedactionAnnotation();

// הגדר את שם ההערה. 
// זה שימושי כאשר יש לנו הערות מרובות במסמך
annotation.setName("Name");
// הגדר את האזור המלבני עבור הערת הערה
annotation.setRect(rect);
annotation.setFlags(flags);

// הגדר יישור אופקי כמרכז
annotation.setHorizontalAlignment(HorizontalAlignment.CENTER);

// הגדר את ZIndex ל-1. 
annotation.setZindex(1);

// הגדר צבע SlateBlue בקוד Hex
Color color = new Color();
color.setA(0x00);
color.setR(0x6A);
color.setG(0x5A);
color.setB(0xCD);
// ציין את צבע המילוי עבור הערה
annotation.setFillColor(color);

// התאריך והשעה שבהם ההערה שונה לאחרונה.
annotation.setModified("05/21/2021 12:00:00.000 AM");

// הגדר מערך של 8xN מספרים המציין את הקואורדינטות 
// של אזור התוכן שמיועד להסרה.
annotation.setQuadPoint(points);
			        
// צור אובייקט רשימה מסוג RedactAnnotation
List<RedactionAnnotation> annotations = new ArrayList<>();

// הוסף אובייקט Annotations שנוצר קודם לכן למערך RedactAnnotation
annotations.add(annotation);

// הוסף RedactAnnotation למסמך PDF
AsposeResponse response = pdfApi.postPageRedactionAnnotations(sourcePDF, pageNumber, annotations, null, null, true);
assertEquals(200, (int)response.getCode());

מסמך PDF שעבר עריכה — תמונה 1:- הערת תיקון נוספה לקובץ PDF.

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

קרא הערות לעיבוד דף

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

// קבל 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";

// קבל הערות לעיבוד מסמכים
RedactionAnnotationsResponse responseAnnotations = pdfApi.getPageRedactionAnnotations(sourcePDF,1, null, null);
assertEquals(200, (int)responseAnnotations.getCode());

// להדפיס את ספירת ההערות הזמינות במסמך
System.out.println(responseAnnotations.getAnnotations().getList().size());

עדכן הערת עריכה קיימת

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

צור מופע של PdfApi תוך העברת פרטי זיהוי לקוח ופרטי סוד לקוח כארגומנטים.
צור אובייקט מלבן כדי להגדיר את אזור ההערה. זה מחושב מהחלק התחתון-שמאלי של המסמך ויחידת ברירת המחדל היא נקודה.
צור רשימת AnnotationFlags והוסף ערך AnnotationFlags.DEFAULT לרשימה.
כעת עלינו ליצור את האובייקט RedactionAnnotation ולקרוא למתודה setRect(…) כדי להגדיר את האזור המלבני של ההערה.
השתמש בשיטת setModified(…) כדי להגדיר את תאריך השינוי האחרון של ההערה.
התקשר לשיטת getDocumentRedactionAnnotations(…) של קריאת PdfApi כדי לקרוא את רשימת ההערות מהמסמך.
השג אובייקט Annotation מסוים באמצעות responseAnnotations.getAnnotations().getList().get(0).getId().
לבסוף, קרא למתודה putRedactionAnnotation(…) של מחלקה PdfApi כדי לעדכן הערת Redaction קיימת בקובץ PDF.

// קבל 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";	        
			        
// צור אזור מלבני עבור הערות  
Rectangle rect = new Rectangle()
  .LLX(200.)
  .LLY(120.)
  .URX(150.)
  .URY(100.);

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

List<Point> points = new ArrayList<>();
points.add(new Point().X(10.).Y(40.));
points.add(new Point().X(30.).Y(40.));

// צור אובייקט הערת עיבוד
RedactionAnnotation annotation = new RedactionAnnotation();
// הגדר את השם להערה
annotation.setName("Name Updated");

// הגדר את האזור המלבני להערה
annotation.setRect(rect);
annotation.setFlags(flags);
annotation.setHorizontalAlignment(HorizontalAlignment.CENTER);
annotation.setZindex(1);
annotation.setModified("01/01/2018 12:02:03.000 AM");
annotation.setQuadPoint(points);

// הגדר צבע SlateBlue בקוד Hex
Color color = new Color();
color.setA(0x00);
color.setR(0x6A);
color.setG(0x5A);
color.setB(0xCD);

// ציין את צבע המילוי עבור הערה
annotation.setFillColor(color);

// קבל הערה קיימת ממסמך
RedactionAnnotationsResponse responseAnnotations = pdfApi.getDocumentRedactionAnnotations(sourcePDF, null, null);
assertEquals(200, (int)responseAnnotations.getCode());

// קבל את ההערה באינדקס 0
String annotationId = responseAnnotations.getAnnotations().getList().get(0).getId();

// עדכן את ההערה באינדקס 0
AsposeResponse response = pdfApi.putRedactionAnnotation(sourcePDF, annotationId, annotation, null, null, true);
assertEquals(200, (int)response.getCode());

עריכת הערה עודכנה — תמונה 2:- הערת הערה עודכנה.

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

מַסְקָנָה

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

התקנה של SDK#

הוסף הערת עיבוד באמצעות Java#

קרא הערות לעיבוד דף#

עדכן הערת עריכה קיימת#

מַסְקָנָה#

התקנה של SDK

הוסף הערת עיבוד באמצעות Java

קרא הערות לעיבוד דף

עדכן הערת עריכה קיימת

מַסְקָנָה