У данашњем дигиталном добу, ПДФ-ови су постали популаран формат за дељење информација, докумената и извештаја. Међутим, једноставно гледање ПДФ-а можда неће бити довољно за многе кориснике. Понекад ће корисници можда желети да истакну или додају белешке одређеним деловима ПДФ-а како би пружили додатни контекст или повратне информације. На срећу, постоји неколико бесплатних ПДФ анотатора који омогућавају корисницима да лако додају коментаре, истакну текст и још много тога. Међутим, у овом чланку ћемо истражити како да користите РЕСТ АПИ за подршку ПДФ напоменама и показаћемо вам како да истакнете, коментаришете и додате белешке у своје ПДФ документе.
- РЕСТ АПИ за ПДФ анотацију
- Додајте коментаре у ПДФ користећи Ц#
- Додајте бесплатну текстуалну напомену у ПДФ користећи цУРЛ команде
РЕСТ АПИ за ПДФ анотацију
Аспосе.ПДФ Цлоуд пружа једноставно за коришћење и свеобухватно решење за програмско додавање напомена у ПДФ документе. Помоћу Аспосе.ПДФ Цлоуд-а можете додати различите типове напомена у ПДФ документе, укључујући текст, слику, печат и разне напомене за означавање. Такође можете да измените постојеће напомене, као што је промена положаја, величине, боје или било које друге особине.
Подржане напомене обухватају текст, круг, полигон, полилинија, линија, квадрат, слободни текст, истицање, подвучено, вијугаво, прецртано, карет, мастило, линк, искачући прозор, прилог датотеке, звук, филм, екран, виџет, водени жиг, ТрапНет, ПринтерМарк, Редакција, печат, РицхМедиа и ПДФ3Д.
Сада, да бисте додали СДК у свој пројекат, потражите Аспосе.ПДФ-Цлоуд
у НуГет менаџеру пакета и кликните на дугме Додај пакет. Следећи важан корак је да региструјете налог преко Цлоуд контролне табле и добијете своје личне клијентске акредитиве. За додатне детаље погледајте водич за Брзи почетак.
Додајте коментаре у ПДФ користећи Ц#
Хајде да погледамо Ц# .НЕТ исечак кода који се користи за додавање напомена у ПДФ документ.
// За комплетне примере и датотеке са подацима, идите на
https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet
// Преузмите акредитиве клијента са https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";
// креирајте објекат ПдфАпи
PdfApi api = new PdfApi(clientSecret, clientID);
// цреате Лист објекат садржи ФрееТектАннотатионс
List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>
{
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)
))
{
// Садржај који ће се приказати унутар ФрееТектАннотатион
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);
Сада, хајде да детаљније разумемо исечак кода.
PdfApi api = new PdfApi(clientSecret, clientID);
Креирајте инстанцу класе ПдфАпи која узима акредитиве клијента као аргументе у свом конструктору.
List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>
Како АПИ подржава могућност додавања једне или више напомена сличног типа у исто време, морамо да креирамо Лист објекат типа ФрееТектАнннотатион.
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)
))
Креирајте објекат ФрееТектАннотатион где дефинишемо правоугаони регион за детаље о анотацији и форматирању текста.
Contents = "Confidential !"
Овде дефинишемо садржај за ФрееТектАннотатион.
var response = api. PostPageFreeTextAnnotations("Binder1.pdf", 1, annotations);
Позовите РЕСТ АПИ да бисте додали ФрееТектАннотатион на прву страницу ПДФ документа који је већ доступан у складишту у облаку.
У наставку су дате могуће вредности које се могу доделити својствима која се користе у горњем исечку кода.
- АннотатионФлагс - Подржане вредности могу бити
[Дефаулт, Инвисибле, Хидден, Принт, НоЗоом, НоРотате, НоВиев, РеадОнли, Лоцкед, ТогглеНоВиев, ЛоцкедЦонтентс]
.- Ротате - Угао ротације за текст. Могуће вредности могу бити
[Ноне, он90, он180, он270]
.- АннотатионФлагс - Скуп заставица који специфицирају различите карактеристике напомене. Могућа вредност може бити
[Дефаулт, Инвисибле, Хидден, Принт, НоЗоом, НоРотате, НоВиев, РеадОнли, Лоцкед, ТогглеНоВиев, ЛоцкедЦонтентс]
.- ФрееТектИнтент - Набраја намере напомене слободног текста. Могуће вредности могу бити
[ Ундефинед, ФрееТектЦаллоут, ФрееТектТипеВритер]
.
Додајте бесплатну текстуалну напомену у ПДФ користећи цУРЛ команде
Употреба цУРЛ команди за позивање Аспосе.ПДФ Цлоуд АПИ-ја је добар приступ за постизање овог захтева. Такође је добро ако сте упознати са алатима командне линије или више волите да их користите. Дакле, помоћу алата командне линије цУРЛ, можете постављати ХТТП захтеве и обављати различите операције у вези са обрадом ПДФ датотека.
Сада, да бисмо додали напомене у ПДФ документ помоћу цУРЛ команди, прво морамо да генеришемо токен за аутентификацију слањем захтева крајњој тачки токена са вашим СИД-ом апликације и кључем апликације. Извршите следећу команду да бисте генерисали аццессТокен.
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"
Када се приступни токен генерише, извршите следећу команду која додаје ФрееТектАннотатион у ПДФ документ. ПДФ датотека са коментарима се затим ажурира у складишту у облаку.
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 } } }]"
Замените
{инпутПДФ}
именом улазне ПДФ датотеке која је већ доступна у складишту у облаку,{аццессТокен}
са ЈВТ приступним токеном генерисаним изнад.
ПДФ документ који се користи у горњем примеру може се преузети са ове везе.
Закључак
У закључку, додавање напомена у ПДФ-ове може знатно побољшати њихову корисност и функционалност. Без обзира да ли желите да истакнете важан текст, додате коментаре или правите белешке директно у документу, Аспосе.ПДФ Цлоуд је невероватан избор да то постигнете. Такође смо сазнали да Аспосе.ПДФ Цлоуд СДК за .НЕТ и цУРЛ команде нуде моћна решења за означавање ПДФ-ова, дајући вам могућност да креирате прилагођене токове посла и процесе аутоматизације. Због тога, помоћу ових алата, можете брзо и лако да додате напомене у ПДФ-ове, уз уштеду времена и повећање продуктивности.
Корисни линкови
повезани чланци
Топло препоручујемо да погледате следеће блогове: