Berita bagus untuk pengembang! Semua GroupDocs.Annotation Cloud 19.5 baru diperkenalkan. Kami berkomitmen untuk mengembangkan GroupDocs.Annotation Cloud REST API agar lebih disederhanakan dan mudah digunakan. Dengan pemikiran ini, kami telah membuat perubahan yang diperlukan dalam versi ini. API baru lebih dioptimalkan dengan lebih sedikit metode dan opsi. Arsitektur internalnya diubah untuk pemrosesan yang cepat dan andal untuk membangun alat Anotasi Dokumen & Gambar dengan dukungan untuk operasi anotasi berbasis Teks & Gambar. Juga sekarang API menyertakan metode untuk bekerja dengan penyimpanan cloud. Jadi, Anda dapat melakukan operasi penyimpanan menggunakan GroupDocs.Annotation Cloud REST API secara langsung daripada menggunakan API terpisah.

Silakan periksa detail catatan rilis versi ini untuk mendapatkan gambaran tentang semua fitur/peningkatan baru yang dibuat dalam rilis ini.

Melanggar Perubahan

Versi API Baru

Memperkenalkan versi API V2 dalam versi 19.5, V1 akan tetap tersedia.

Autentikasi

Otentikasi JWT (JSON Web Token) diperkenalkan dalam rilis ini, sekarang metode otentikasi penandatanganan OAuth2 dan URL sudah usang sekarang.

API Anotasi

Metode API yang disederhanakan untuk menerapkan anotasi berbasis Teks dan Gambar ke dokumen & gambar dari semua format populer.

API Penyimpanan

File API – Metode yang diperkenalkan untuk mengunggah, mengunduh, menyalin, memindahkan, menghapus file : memasukkan dokumen dan hasil rendering, di penyimpanan cloud

Folder API - Metode yang diperkenalkan untuk membuat, menyalin, memindahkan, menghapus folder di penyimpanan cloud

Storage API - Metode yang diperkenalkan untuk mendapatkan informasi penyimpanan dan informasi file

Tambahkan Anotasi ke Dokumen

Di sini kami akan menunjukkan cara kerja versi GroupDocs.Annotation Cloud V2 API dan ini berbeda dari V1. Kami akan menambahkan anotasi dalam dokumen Word menggunakan GroupDocs.Annotation Cloud SDK for .NET dengan mengikuti langkah-langkah berikut:

• Unggah dokumen sumber ke Penyimpanan
• Tambahkan Annotition ke dokumen sumber

Kami perlu mengunggah dokumen sumber ke penyimpanan Cloud karena dalam contoh ini kami akan memproses dokumen dari penyimpanan Cloud. Dalam rilis kami memperkenalkan File API untuk operasi penyimpanan file. Kami akan menggunakan metode UploadFile versi Annotation V2 API alih-alih metode GroupDocs.Storage Cloud API untuk mengunggah file ke penyimpanan.

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

			try
			{
				// Buka file di IOStream dari local/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);
			}
		}
	}
}

Pada versi 19.5, metode PUT untuk mengimpor anotasi telah diubah menjadi metode POST, seperti yang ditunjukkan pada contoh kode berikut.

V1.1 Contoh

//TODO: Dapatkan AppSID dan AppKey Anda di https://dashboard.groupdocs.cloud (diperlukan pendaftaran gratis).
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,
        
    };
    // Sisipkan/Ekspor anotasi ke dokumen.
    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 Contoh

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
{
	// Posting/Tambahkan anotasi
	class Add_Annotation
	{
		public static void Run()
		{
			var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
			var apiInstance = new AnnotateApi(configuration);

			try
			{
				// Tetapkan permintaan.
				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);
			}
		}
	}
}

Bagikan Umpan Balik Anda

Umpan balik Anda penting! Jangan ragu untuk memberi kami komentar berbagi pemikiran Anda tentang versi baru GroupDocs.Annotation Cloud REST API. Ini membantu kami untuk terus meningkatkan dan menyempurnakan API kami.