Skvělá zpráva pro vývojáře! Je představen celý nový GroupDocs.Annotation Cloud 19.5. Zavázali jsme se vyvíjet GroupDocs.Annotation Cloud REST API, aby bylo jednodušší a snadněji použitelné. S ohledem na to jsme v této verzi provedli nezbytné změny. Nové API je více optimalizované s menším počtem metod a možností. Jeho vnitřní architektura je přepracována pro rychlé a spolehlivé zpracování pro vytváření nástrojů pro anotaci dokumentů a obrázků s podporou operací anotací založených na textu a obrázku. API nyní také obsahuje metody pro práci s cloudovým úložištěm. Takže můžete provádět operace úložiště pomocí GroupDocs.Annotation Cloud REST API přímo namísto použití samostatného API.
Podívejte se prosím na podrobné poznámky k vydání této verze, abyste získali představu o všech nových funkcích/vylepšeních provedených v této verzi.
Překonání změn
Nová verze API
Zavedena verze API V2 ve verzi 19.5, V1 zůstane k dispozici.
Autentizace
V této verzi je zavedena autentizace JWT (JSON Web Token), nyní jsou metody ověřování OAuth2 a podepisování URL zastaralé.
Anotace API
Zjednodušené metody API pro použití textových a obrazových anotací na dokumenty a obrázky všech oblíbených formátů.
Rozhraní API úložiště
File API – Zavedené metody pro nahrávání, stahování, kopírování, přesouvání, mazání souborů: vkládání dokumentů a výsledků vykreslování v cloudovém úložišti
Folder API – Zavedené metody pro vytváření, kopírování, přesouvání a mazání složek v cloudovém úložišti
Storage API – Zavedené metody pro získávání informací o úložišti a souborech
Přidat poznámky k dokumentu
Zde vám ukážeme, jak funguje GroupDocs.Annotation Cloud V2 API verze a je jiná než V1. Přidáme anotaci do dokumentu aplikace Word pomocí sady GroupDocs.Annotation Cloud SDK for .NET podle následujících kroků:
- Nahrajte zdrojový dokument do úložiště
- Přidejte anotaci do zdrojového dokumentu
Potřebujeme nahrát zdrojový dokument do cloudového úložiště, protože v tomto příkladu budeme zpracovávat dokument z cloudového úložiště. Ve verzi jsme zavedli File API pro operace ukládání souborů. K nahrání souboru do úložiště použijeme metodu UploadFile verze Annotation V2 API místo metody GroupDocs.Storage Cloud API.
using System;
using System.IO;
using GroupDocs.Annotation.Cloud.Sdk.Api;
using GroupDocs.Annotation.Cloud.Sdk.Client;
using GroupDocs.Annotation.Cloud.Sdk.Model.Requests;
namespace GroupDocs.Annotation.Cloud.Examples.CSharp
{
// Nahrát soubor
class Upload_File
{
public static void Run()
{
var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
var apiInstance = new FileApi(configuration);
try
{
// Otevřete soubor v IOStream z místního disku/disku.
var fileStream = File.Open("..\\..\\..\\Data\\Annotationdocs\\one-page.docx", FileMode.Open);
var request = new UploadFileRequest("Annotationdocs/one-page1.docx", fileStream, Common.MyStorage);
var response = apiInstance.UploadFile(request);
Console.WriteLine("Expected response type is FilesUploadResult: " + response.Uploaded.Count.ToString());
}
catch (Exception e)
{
Console.WriteLine("Exception while calling FileApi: " + e.Message);
}
}
}
}
Ve verzi 19.5 byla metoda PUT pro import anotace změněna na metodu POST, jak ukazuje následující ukázkový kód.
Příklad V1.1
//TODO: Získejte své AppSID a AppKey na https://dashboard.groupdocs.cloud (je nutná bezplatná registrace).
var configuration = new Configuration
{
AppSid = Sid,
AppKey = Key
};
var apiInstance = new AnnotationApi(configuration);
try
{
List<AnnotationInfo> annotations = new List<AnnotationInfo>();
AnnotationInfo annotation = new AnnotationInfo
{
AnnotationPosition = new Point(852, 154.31),
Replies = new[]
{
new AnnotationReplyInfo {Message = "reply text", RepliedOn = DateTime.Now, UserName = "Admin"},
new AnnotationReplyInfo
{
Message = "reply2 text",
RepliedOn = DateTime.Now,
UserName = "Commentator"
}
},
Box = new Rectangle((float)173.29, (float)154.31, (float)142.5, 9),
PageNumber = 0,
SvgPath =
"[{\"x\":173.2986,\"y\":687.5769},{\"x\":315.7985,\"y\":687.5769},{\"x\":173.2986,\"y\":678.5769},{\"x\":315.7985,\"y\":678.5769}]",
Type = AnnotationType.Text,
CreatorName = "Anonym A."
};
annotations.Add(annotation);
PutExportRequest request = new PutExportRequest()
{
Name ="Annotated.pdf",
Folder=null,
Password=null,
Body=annotations,
};
// Vložit/exportovat anotace do dokumentu.
var response = apiInstance.PutExport(request);
Debug.Print("Document Processsed and stream length: " + response.Length);
}
catch (Exception e)
{
Debug.Print("Exception when inserting Annotation to document: " + e.Message);
}
Příklad V2.0
using System;
using GroupDocs.Annotation.Cloud.Sdk.Api;
using GroupDocs.Annotation.Cloud.Sdk.Client;
using GroupDocs.Annotation.Cloud.Sdk.Model;
using GroupDocs.Annotation.Cloud.Sdk.Model.Requests;
namespace GroupDocs.Annotation.Cloud.Examples.CSharp
{
// Přidat/přidat anotace
class Add_Annotation
{
public static void Run()
{
var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
var apiInstance = new AnnotateApi(configuration);
try
{
// Nastavit požadavek.
var request = new PostAnnotationsRequest()
{
filePath = "Annotationdocs\\ten-pages.docx",
annotations = new System.Collections.Generic.List<AnnotationInfo>() {
new AnnotationInfo
{
AnnotationPosition = new Point { X = 852, Y = 59.388262910798119 },
Box = new Rectangle { X = 375.89276123046875, Y = 59.388263702392578, Width = 88.7330551147461, Height = 37.7290153503418 },
PageNumber = 0,
PenColor = 1201033,
PenStyle = 0,
PenWidth = 1,
Type = AnnotationInfo.TypeEnum.Area,
CreatorName = "Anonym A."
}
}
};
apiInstance.PostAnnotations(request);
Console.WriteLine("Expected response type is void: Annotation added.");
}
catch (Exception e)
{
Console.WriteLine("Exception while calling Annotation AnnotateApi: " + e.Message);
}
}
}
}
Podělte se o svůj názor
Vaše zpětná vazba je důležitá! Neváhejte a napište nám komentář a podělte se o své názory na novou verzi GroupDocs.Annotation Cloud REST API. Pomáhá nám to naše API neustále vylepšovat a zdokonalovat.