PDF anotācijas Word dokumenti

Kā pievienot anotācijas PDF failam, izmantojot C#.NET

Mūsdienu digitālajā laikmetā PDF ir kļuvuši par populāru informācijas, dokumentu un pārskatu apmaiņas formātu. Tomēr daudziem lietotājiem var nepietikt tikai ar PDF faila skatīšanu. Dažkārt lietotāji var vēlēties izcelt vai pievienot piezīmes konkrētām PDF faila daļām, lai sniegtu papildu kontekstu vai atsauksmes. Par laimi, ir pieejami vairāki bezmaksas PDF anotatori, kas ļauj lietotājiem viegli pievienot komentārus, izcelt tekstu un daudz ko citu. Tomēr šajā rakstā mēs izpētīsim, kā izmantot REST API, lai atbalstītu PDF anotācijas, un parādīsim, kā izcelt, komentēt un pievienot piezīmes jūsu PDF dokumentiem.

REST API PDF anotācijai

Aspose.PDF Cloud nodrošina viegli lietojamu un visaptverošu risinājumu, lai programmatiski pievienotu anotācijas PDF dokumentiem. Izmantojot Aspose.PDF Cloud, PDF dokumentiem varat pievienot dažāda veida anotācijas, tostarp tekstu, attēlu, zīmogu un dažādas iezīmēšanas anotācijas. Varat arī mainīt esošās anotācijas, piemēram, mainīt pozīciju, izmēru, krāsu vai citus rekvizītus.

Atbalstītās anotācijas ietver tekstu, apli, daudzstūri, daudzlīniju, līniju, kvadrātu, brīvo tekstu, izcēlumu, pasvītrojumu, svītru, izsvītrot, tinte, saiti, uznirstošo logu, faila pielikumu, skaņu, filmu, ekrānu, logrīku, ūdenszīmi, traptīklu, printera atzīmi, Rediģēšana, zīmogs, RichMedia un PDF3D.

Tagad, lai pievienotu SDK savam projektam, NuGet pakotņu pārvaldniekā meklējiet “Aspose.PDF-Cloud” un noklikšķiniet uz pogas Pievienot pakotni. Nākamais svarīgais solis ir konta reģistrēšana Cloud informācijas panelī un personīgo klienta akreditācijas datu iegūšana. Lai iegūtu plašāku informāciju, lūdzu, skatiet [Ātrās darbības] (https://docs.aspose.cloud/words/getting-started/quickstart/) rokasgrāmatu.

Pievienojiet komentārus PDF failam, izmantojot C#

Apskatīsim C# .NET koda fragmentu, ko izmanto, lai PDF dokumentam pievienotu anotāciju.

// Lai iegūtu pilnus piemērus un datu failus, lūdzu, dodieties uz 
https://github.com/aspose-pdf-cloud/aspose-pdf-cloud-dotnet

// Iegūstiet klienta akreditācijas datus vietnē https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

// izveidot PdfApi objektu
PdfApi api = new PdfApi(clientSecret, clientID);

// izveidot Saraksts objekts satur FreeTextAnnotations
List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>
{
new FreeTextAnnotation(
    // norādiet taisnstūra apgabalu, kurā ir FreeTextAnnotation
    // definējiet arī teksta formatēšanas detaļas
    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)
        ))
    {
    // Saturs, kas jāparāda 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);

Tagad izprast koda fragmentu sīkāk.

PdfApi api = new PdfApi(clientSecret, clientID);

Izveidojiet PdfApi klases gadījumu, kas savā konstruktorā izmanto klienta akreditācijas datus kā argumentus.

List<FreeTextAnnotation> annotations = new List<FreeTextAnnotation>

Tā kā API atbalsta iespēju vienlaikus pievienot vienu vai vairākas līdzīga veida anotācijas, mums ir jāizveido FreeTextAnnotation tipa saraksta objekts.

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

Izveidojiet FreeTextAnnotation objektu, kurā mēs definējam taisnstūrveida reģionu anotācijas un teksta formatēšanas informācijai.

Contents = "Confidential !"

Šeit mēs definējam FreeTextAnnotation saturu.

var response = api. PostPageFreeTextAnnotations("Binder1.pdf", 1, annotations);

Zvaniet uz REST API, lai mākoņkrātuvē jau pieejamā PDF dokumenta pirmajā lapā pievienotu FreeTextAnnotation.

Tālāk ir norādītas iespējamās vērtības, kuras var piešķirt iepriekš koda fragmentā izmantotajiem rekvizītiem.

  • Annotation Flags - Atbalstītās vērtības var būt [Noklusējums, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents]. — Pagriezt — teksta pagriešanas leņķis. Iespējamās vērtības var būt “[Nav, on90, on180, on270]”. — AnnotationFlags — karogu kopa, kas norāda dažādus anotācijas raksturlielumus. Iespējamā vērtība var būt [Noklusējums, Invisible, Hidden, Print, NoZoom, NoRotate, NoView, ReadOnly, Locked, ToggleNoView, LockedContents]. — FreeTextIntent — uzskaita brīvā teksta anotācijas nolūkus. Iespējamās vērtības var būt `[ Undefined, FreeTextCallout, FreeTextTypeWriter].

Pievienojiet PDF failam brīvā teksta anotāciju, izmantojot cURL komandas

CURL komandu izmantošana, lai izsauktu Aspose.PDF Cloud API, ir laba pieeja šīs prasības izpildei. Ir arī labi, ja esat iepazinies ar komandrindas rīkiem vai vēlaties tos izmantot. Tātad, izmantojot cURL komandrindas rīku, varat veikt HTTP pieprasījumus un veikt dažādas darbības saistībā ar PDF failu apstrādi.

Tagad, lai pievienotu anotācijas PDF dokumentam, izmantojot cURL komandas, vispirms mums ir jāģenerē autentifikācijas pilnvara, nosūtot pieprasījumu marķiera galapunktam ar jūsu lietotnes SID un lietotnes atslēgu. Lūdzu, izpildiet šo komandu, lai ģenerētu 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"

Kad AccessToken ir ģenerēts, lūdzu, izpildiet šo komandu, kas PDF dokumentam pievieno FreeTextAnnotation. Pēc tam anotētais PDF fails tiek atjaunināts mākoņkrātuvē.

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      }    }  }]"

Aizstājiet “{inputPDF}” ar ievades PDF faila nosaukumu, kas jau ir pieejams mākoņkrātuvē (“{accessToken}”) ar iepriekš ģenerētu JWT piekļuves pilnvaru.

PDF anotācijas priekšskatījums

Attēls: - bezmaksas teksta anotācijas priekšskatījums PDF failā.

Iepriekš minētajā piemērā izmantoto PDF dokumentu var lejupielādēt no šīs saites.

Secinājums

Visbeidzot, anotāciju pievienošana PDF failiem var ievērojami uzlabot to lietderību un funkcionalitāti. Neatkarīgi no tā, vai vēlaties izcelt svarīgu tekstu, pievienot komentārus vai veikt piezīmes tieši dokumentā, Aspose.PDF Cloud ir lieliska izvēle, lai to panāktu. Esam arī uzzinājuši, ka Aspose.PDF Cloud SDK for .NET un cURL komandas piedāvā jaudīgus risinājumus PDF failu anotēšanai, sniedzot iespēju izveidot pielāgotas darbplūsmas un automatizācijas procesus. Tādēļ, izmantojot šos rīkus, varat ātri un vienkārši pievienot PDF failiem anotācijas, vienlaikus ietaupot laiku un palielinot produktivitāti.

Noderīgas saites

Saistītie raksti

Mēs ļoti iesakām apmeklēt šādus emuārus: