Tolle Neuigkeiten für Entwickler! Die brandneue GroupDocs.Annotation Cloud 19.5 wird eingeführt. Wir sind bestrebt, die GroupDocs.Annotation Cloud REST API weiterzuentwickeln, um sie einfacher und benutzerfreundlicher zu machen. Vor diesem Hintergrund haben wir in dieser Version die notwendigen Änderungen vorgenommen. Die neue API ist optimierter und verfügt über weniger Methoden und Optionen. Die interne Architektur wurde für eine schnelle und zuverlässige Verarbeitung überarbeitet, um Tools zur Dokument und Bildanmerkung mit Unterstützung für text und bildbasierte Anmerkungsvorgänge zu erstellen. Außerdem umfasst die API jetzt Methoden für die Arbeit mit Cloud-Speicher. So können Sie Speichervorgänge direkt mit der GroupDocs.Annotation Cloud REST API durchführen, anstatt eine separate API zu verwenden.

Bitte lesen Sie die detaillierten Versionshinweise zu dieser Version, um sich einen Überblick über alle neuen Funktionen/Verbesserungen dieser Version zu verschaffen.

Breaking Changes

Neue API-Version

API-Version V2 wurde in Version 19.5 eingeführt, V1 bleibt verfügbar.

Authentifizierung

In dieser Version wird die JWT-Authentifizierung (JSON Web Token) eingeführt. Die Authentifizierungsmethoden OAuth2 und URL-Signierung sind nun veraltet.

Anmerkungs-API

Vereinfachte API-Methoden zum Anwenden text und bildbasierter Anmerkungen auf Dokumente und Bilder aller gängigen Formate.

Speicher-APIs

Datei-API – Einführung von Methoden zum Hochladen, Herunterladen, Kopieren, Verschieben und Löschen von Dateien: Eingabedokumente und Rendering-Ergebnisse im Cloud-Speicher

Ordner-API – Einführung von Methoden zum Erstellen, Kopieren, Verschieben und Löschen von Ordnern im Cloud-Speicher

Speicher-API – Einführung von Methoden zum Abrufen von Speicherinformationen und Dateiinformationen

Anmerkungen zum Dokument hinzufügen

Hier zeigen wir Ihnen, wie die GroupDocs.Annotation Cloud V2-API-Version funktioniert und wie sie sich von V1 unterscheidet. Wir fügen Anmerkungen in einem Word Dokument mithilfe des GroupDocs.Annotation Cloud SDK für .NET hinzu, indem wir die folgenden Schritte ausführen:

• Laden Sie das Quelldokument in den Speicher hoch
• Anmerkung zum Quelldokument hinzufügen

Wir müssen das Quelldokument in den Cloud-Speicher hochladen, da wir in diesem Beispiel das Dokument aus dem Cloud-Speicher verarbeiten. In der Version haben wir die Datei-API für Dateispeichervorgänge eingeführt. Wir verwenden die Methode UploadFile der Annotation V2-API-Version anstelle der GroupDocs.Storage Cloud-API-Methode, um Dateien in den Speicher hochzuladen.

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
{
	// Datei hochladen
	class Upload_File
	{
		public static void Run()
		{
			var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
			var apiInstance = new FileApi(configuration);

			try
			{
				// Öffnen Sie die Datei in IOStream von lokal/disc.
				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);
			}
		}
	}
}

In der Version 19.5 wurde die PUT-Methode zum Importieren von Anmerkungen in die Methode POST geändert, wie im folgenden Beispielcode gezeigt.

Beispiel für V1.1

//TODO: Holen Sie sich Ihre AppSID und Ihren AppKey unter https://dashboard.groupdocs.cloud (kostenlose Registrierung erforderlich).
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,
        
    };
    // Anmerkungen in ein Dokument einfügen/exportieren.
    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);
}

V2.0-Beispiel

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
{
	// Anmerkungen posten/hinzufügen
	class Add_Annotation
	{
		public static void Run()
		{
			var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
			var apiInstance = new AnnotateApi(configuration);

			try
			{
				// Anfrage stellen.
				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);
			}
		}
	}
}

Teilen Sie Ihr Feedback

Ihr Feedback ist wichtig! Bitte zögern Sie nicht, uns einen Kommentar zu hinterlassen und uns Ihre Meinung zur neuen Version der GroupDocs.Annotation Cloud REST API mitzuteilen. Es hilft uns, unsere API kontinuierlich zu verbessern und zu verfeinern.