خبر عالی برای توسعه دهندگان! همه GroupDocs.Annotation Cloud 19.5 جدید معرفی شده است. ما متعهد به تکامل GroupDocs.Annotation Cloud REST API هستیم تا استفاده از آن را ساده‌تر و آسان‌تر کنیم. با در نظر گرفتن این موضوع، ما تغییرات لازم را در این نسخه ایجاد کرده ایم. API جدید با روش ها و گزینه های کمتری بهینه شده است. معماری داخلی آن برای پردازش سریع و قابل اعتماد برای ساخت ابزارهای حاشیه نویسی سند و تصویر با پشتیبانی از عملیات حاشیه نویسی مبتنی بر متن و شکل اصلاح شده است. همچنین اکنون API شامل روش هایی برای کار با ذخیره سازی ابری است. بنابراین می‌توانید به‌جای استفاده از API جداگانه، عملیات ذخیره‌سازی را با استفاده از GroupDocs.Annotation Cloud REST API انجام دهید.

لطفاً یادداشت‌های منتشرشده این نسخه را بررسی کنید تا درباره همه ویژگی‌ها/بهبودهای جدید ساخته شده در این نسخه ایده بگیرید.

شکستن تغییرات

نسخه جدید API

معرفی API نسخه V2 در نسخه 19.5، V1 در دسترس باقی خواهد ماند.

احراز هویت

احراز هویت JWT (JSON Web Token) در این نسخه معرفی شده است، اکنون روش‌های تأیید اعتبار OAuth2 و امضای URL در حال حاضر منسوخ شده‌اند.

Annotation API

روش‌های API ساده‌شده برای اعمال حاشیه‌نویسی‌های مبتنی بر متن و شکل در اسناد و تصاویر همه فرمت‌های محبوب.

API های ذخیره سازی

File API – روش‌های معرفی شده برای آپلود، دانلود، کپی، انتقال، حذف فایل‌ها: اسناد ورودی و نتایج رندر در فضای ذخیره‌سازی ابری

Folder API - روش‌هایی برای ایجاد، کپی، انتقال، حذف پوشه‌ها در فضای ذخیره‌سازی ابری معرفی شد.

Storage API - روش هایی برای دریافت اطلاعات ذخیره سازی و اطلاعات فایل معرفی شده است

اضافه کردن حاشیه نویسی به سند

در اینجا به شما نشان خواهیم داد که چگونه نسخه API GroupDocs.Annotation Cloud V2 کار می کند و با V1 متفاوت است. با دنبال کردن این مراحل، حاشیه نویسی را با استفاده از GroupDocs.Annotation Cloud SDK برای دات نت در یک سند Word اضافه می کنیم:

• سند منبع را در فضای ذخیره‌سازی بارگذاری کنید
• اضافه کردن حاشیه نویسی به سند منبع

ما باید سند منبع را در فضای ذخیره‌سازی ابری آپلود کنیم، زیرا در این مثال، سند را از فضای ذخیره‌سازی ابری پردازش می‌کنیم. در نسخه، File API را برای عملیات ذخیره سازی فایل معرفی کردیم. ما از روش UploadFile نسخه Annotation V2 API به جای روش 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
{
	// آپلود فایل
	class Upload_File
	{
		public static void Run()
		{
			var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
			var apiInstance = new FileApi(configuration);

			try
			{
				// فایل را در IOStream از محلی/دیسک باز کنید.
				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);
			}
		}
	}
}

در نسخه 19.5، روش PUT برای وارد کردن حاشیه نویسی، همانطور که در کد نمونه زیر نشان داده شده است، به روش POST تغییر یافته است.

V1.1 مثال

//TODO: AppSID و AppKey خود را در https://dashboard.groupdocs.cloud دریافت کنید (ثبت نام رایگان لازم است).
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,
        
    };
    // درج / صادرات حاشیه نویسی به سند.
    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

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
{
	// پست / اضافه کردن حاشیه نویسی
	class Add_Annotation
	{
		public static void Run()
		{
			var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
			var apiInstance = new AnnotateApi(configuration);

			try
			{
				// تنظیم درخواست
				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);
			}
		}
	}
}

بازخورد خود را به اشتراک بگذارید

بازخورد شما مهم است! لطفاً نظر خود را درباره نسخه جدید GroupDocs.Annotation Cloud REST API برای ما ارسال کنید یک نظر. این به ما کمک می کند تا به طور مداوم API خود را بهبود و اصلاح کنیم.