Fl-era diġitali tal-lum, PDFs saru format popolari għall-qsim ta’ informazzjoni, dokumenti u rapporti. Madankollu, sempliċiment tara PDF jista ‘ma jkunx biżżejjed għal ħafna utenti. Xi drabi, l-utenti jistgħu jkunu jridu jenfasizzaw jew iżidu noti għal partijiet speċifiċi tal-PDF biex jipprovdu kuntest jew feedback addizzjonali. Fortunatament, hemm diversi annotaturi PDF b’xejn disponibbli li jippermettu lill-utenti jżidu kummenti faċilment, jenfasizzaw it-test, u aktar. Madankollu, f’dan l-artikolu, se nesploraw kif tuża l-API REST biex tappoġġja l-annotazzjonijiet PDF, u nuruk kif tenfasizza, tikkummenta, u żżid noti mad-dokumenti PDF tiegħek.
- REST API għal Annotazzjoni PDF
- Żid Kummenti fil-PDF billi tuża C#
- Żid Annotazzjoni tat-Test Ħieles fil-PDF billi tuża Kmandi tal-cURL
REST API għal Annotazzjoni PDF
Aspose.PDF Cloud jipprovdi soluzzjoni komprensiva u faċli biex tużah biex iżżid annotazzjonijiet mad-dokumenti PDF b’mod programmatiku. B’Aspose.PDF Cloud, tista ‘żżid diversi tipi ta’ annotazzjonijiet ma’ dokumenti PDF, inklużi test, immaġni, timbru, u diversi annotazzjonijiet ta ‘markup. Tista ‘wkoll timmodifika annotazzjonijiet eżistenti, bħall-bdil tal-pożizzjoni, id-daqs, il-kulur, jew kwalunkwe proprjetajiet oħra.
Annotazzjonijiet appoġġjati jinkludu Test, Circle, Polygon, PolyLine, Line, Square, FreeText, Highlight, Underline, Squiggly, StrikeOut, Caret, Ink, Link, Popup, FileAttachment, Sound, Movie, Screen, Widget, Watermark, TrapNet, PrinterMark, Redazzjoni, Timbru, RichMedia u PDF3D.
Issa, sabiex iżżid l-SDK fil-proġett tiegħek, jekk jogħġbok fittex Aspose.PDF-Cloud
fil-maniġer tal-pakketti NuGet u kklikkja l-buttuna Żid Pakkett. Il-pass importanti li jmiss huwa li tirreġistra kont fuq Cloud dashboard u tikseb il-kredenzjali personali tal-klijent tiegħek. Jekk jogħġbok agħti ħarsa lejn il-gwida Quick Start għal aktar dettalji.
Żid Kummenti fil-PDF billi tuża C#
Ejja nagħtu ħarsa fuq is-snippet tal-kodiċi C# .NET li jintuża biex iżżid Annotazzjoni ma’ dokument PDF.
// Għal eżempji kompluti u fajls tad-dejta, jekk jogħġbok mur
https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet
// Ikseb kredenzjali tal-klijent minn https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";
// toħloq oġġett ta' PdfApi
PdfApi api = new PdfApi(clientSecret, clientID);
// oħloq oġġett Lista fihom FreeTextAnnotations
List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>
{
new FreeTextAnnotation(
// speċifika r-reġjun rettangolari li jżomm FreeTextAnnotation
// tiddefinixxi wkoll id-dettalji tal-ifformattjar tat-test
Rect: new Rectangle(100, 800, 350, 830),
TextStyle:new TextStyle(
FontSize: 26, Font: "Arial",
ForegroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0, 0xFF, 0),
BackgroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0xFF, 0, 0)
))
{
// Kontenut li għandu jintwera ġewwa FreeTextAnnotation
Contents = "Confidential !",
Color = new Aspose.Pdf.Cloud.Sdk.Model.Color(0, 0, 0, 0),
Id = "id1",
Name = "Test Free Text",
Flags = new List<AnnotationFlags> {AnnotationFlags.Default},
HorizontalAlignment = HorizontalAlignment.Center,
Intent = FreeTextIntent.FreeTextTypeWriter,
RichText = "Rich Text",
Subject = "Text Box Subj",
ZIndex = 1,
Justification = Justification.Center,
Title = "Title",
PageIndex = 1
}
};
var response = api. PostPageFreeTextAnnotations("Binder1.pdf", 1, annotations);
Issa, ejja nifhmu s-snippet tal-kodiċi f’aktar dettalji.
PdfApi api = new PdfApi(clientSecret, clientID);
Oħloq eżempju tal-klassi PdfApi li tieħu l-kredenzjali tal-klijent bħala argumenti fil-kostruttur tagħha.
List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>
Peress li l-API tappoġġja l-kapaċità li żżid Annotazzjoni waħda jew aktar ta ’tip simili fl-istess ħin, għalhekk għandna bżonn noħolqu oġġett Lista tat-tip FreeTextAnnnotation.
new FreeTextAnnotation(
Rect: new Rectangle(100, 800, 350, 830),
TextStyle:new TextStyle(
FontSize: 26, Font: "Arial",
ForegroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0, 0xFF, 0),
BackgroundColor: new Aspose.Pdf.Cloud.Sdk.Model.Color(0xFF, 0xFF, 0, 0)
))
Oħloq oġġett ta ‘FreeTextAnnotation fejn niddefinixxu r-reġjun rettangolari għall-Annotazzjoni u d-dettalji tal-ifformattjar tat-test.
Contents = "Confidential !"
Hawnhekk niddefinixxu l-kontenut għal FreeTextAnnotation.
var response = api. PostPageFreeTextAnnotations("Binder1.pdf", 1, annotations);
Ċempel l-API REST biex iżżid FreeTextAnnotation fl-ewwel paġna tad-dokument PDF diġà disponibbli fil-ħażna Cloud.
Mogħtija hawn taħt huma l-valuri possibbli li jistgħu jiġu assenjati lill-proprjetajiet użati fis-snippet tal-kodiċi ta ‘hawn fuq.
- AnnotationFlags - Il-valuri appoġġjati jistgħu jkunu
[Default, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents]
.- Dawwar - Angolu ta ‘rotazzjoni għat-test. Valuri possibbli jistgħu jkunu “[Xejn, on90, on180, on270]”.
- AnnotationFlags - Sett ta’ bnadar li jispeċifikaw diversi karatteristiċi tal-annotazzjoni. Il-valur possibbli jista’ jkun “[Default, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents]”.
- FreeTextIntent - Jenumera l-intenzjonijiet tal-annotazzjoni tat-test ħieles. Il-valuri possibbli jistgħu jkunu
[ Undefined, FreeTextCallout, FreeTextTypeWriter]
.
Żid Annotazzjoni tat-Test Ħieles mal-PDF billi tuża Kmandi tal-cURL
L-użu ta ‘kmandi cURL biex isejjaħ Aspose.PDF Cloud API huwa approċċ tajjeb biex jintlaħaq dan ir-rekwiżit. Huwa tajjeb ukoll jekk inti familjari ma ‘għodod tal-linja tal-kmand jew tippreferi tużahom. Allura, bl-għodda tal-linja tal-kmand cURL, tista ’tagħmel talbiet HTTP u twettaq diversi operazzjonijiet dwar l-ipproċessar tal-fajl PDF.
Issa, sabiex iżżid annotazzjonijiet għal dokument PDF bl-użu ta’ kmandi tal-cURL, l-ewwel irridu niġġeneraw token ta’ awtentikazzjoni billi nibagħtu talba lill-endpoint tat-token bl-App SID u l-App Key tiegħek. Jekk jogħġbok wettaq il-kmand li ġej biex tiġġenera l-accessToken.
curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=ee170169-ca49-49a4-87b7-0e2ff815ea6e&client_secret=7f098199230fc5f2175d494d48f2077c" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"
Ladarba l-accessToken jiġi ġġenerat, jekk jogħġbok wettaq il-kmand li ġej li jżid il-FreeTextAnnotation mad-dokument PDF. Il-fajl PDF Annotat imbagħad jiġi aġġornat fuq il-ħażna tas-Cloud.
curl -v "https://api.aspose.cloud/v3.0/pdf/{inputPDF}/pages/1/annotations/freetext" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "[ { \"Color\": { \"A\": 0, \"R\": 0, \"G\": 0, \"B\": 0 }, \"Contents\": \"Confidential !\", \"Modified\": \"01/05/2023 12:00:00.000 PM\", \"Id\": \"id0\", \"Flags\": [ \"Default\" ], \"Name\": \"comment\", \"Rect\": { \"LLX\": 100, \"LLY\": 800, \"URX\": 350, \"URY\": 830 }, \"PageIndex\": 0, \"ZIndex\": 1, \"HorizontalAlignment\": \"Center\", \"VerticalAlignment\": \"Center\", \"CreationDate\": \"03/05/2023 16:00:00.000 PM\", \"Subject\": \"Subj.\", \"Title\": \"Main Heading\", \"RichText\": \"Hello world...\", \"Justification\": \"Left\", \"Intent\": \"FreeTextTypeWriter\", \"Rotate\": \"None\", \"TextStyle\": { \"FontSize\": 26, \"Font\": \"Arial\", \"ForegroundColor\": { \"A\": 10, \"R\": 10, \"G\": 100, \"B\": 120 }, \"BackgroundColor\": { \"A\": 0, \"R\": 0, \"G\": 50, \"B\": 80 } } }]"
Ibdel
{inputPDF}
bl-isem tal-fajl PDF input diġà disponibbli fuq Cloud storage,{accessToken}
b’token ta’ aċċess JWT iġġenerat hawn fuq.
Id-dokument PDF użat fl-eżempju ta’ hawn fuq jista’ jitniżżel minn din il-link.
Konklużjoni
Bħala konklużjoni, iż-żieda ta’ annotazzjonijiet ma’ PDFs tista’ ttejjeb ħafna l-utilità u l-funzjonalità tagħhom. Kemm jekk qed tfittex li tenfasizza test importanti, iżżid kummenti, jew tieħu noti direttament fid-dokument, allura Aspose.PDF Cloud hija għażla aqwa biex tikseb dan. Tgħallimna wkoll li Aspose.PDF Cloud SDK għall-kmandi .NET u cURL joffru soluzzjonijiet b’saħħithom għall-annotazzjoni tal-PDFs, li jagħtuk il-ħila li toħloq flussi tax-xogħol personalizzati u proċessi ta ‘awtomazzjoni. Għalhekk, b’dawn l-għodod, tista ‘malajr u faċilment iżżid annotazzjonijiet mal-PDFs, filwaqt li tiffranka l-ħin u żżid il-produttività.
Links Utli
Artikoli Relatati
Nirrakkomandaw ħafna li tgħaddi mill-blogs li ġejjin: