أخبار سارة للمطورين! تم تقديم جميع GroupDocs.Annotation Cloud 19.5 الجديدة. نحن ملتزمون بتطوير GroupDocs.Annotation Cloud REST API لجعلها أكثر بساطة وسهولة في الاستخدام. مع وضع ذلك في الاعتبار ، أجرينا التغييرات الضرورية في هذا الإصدار. تم تحسين واجهة برمجة التطبيقات الجديدة بشكل أكبر باستخدام أساليب وخيارات أقل. تم تجديد بنيته الداخلية للمعالجة السريعة والموثوقة لإنشاء أدوات التعليقات التوضيحية للصور والمستندات مع دعم عمليات التعليقات التوضيحية القائمة على النص والأشكال. تتضمن واجهة برمجة التطبيقات الآن أيضًا طرقًا للعمل مع التخزين السحابي. لذلك يمكنك تنفيذ عمليات التخزين باستخدام GroupDocs.Annotation Cloud REST API مباشرة بدلاً من استخدام واجهة برمجة تطبيقات منفصلة.

يرجى مراجعة الإصدارات الجديدة من هذا الإصدار للحصول على فكرة حول جميع الميزات / التحسينات الجديدة التي تم إجراؤها في هذا الإصدار.

كسر التغييرات

إصدار API الجديد

تم تقديم إصدار API V2 في إصدار 19.5 ، وسيظل V1 متاحًا.

المصادقة

تم تقديم مصادقة JWT (JSON Web Token) في هذا الإصدار ، والآن أصبحت طرق مصادقة OAuth2 وتوقيع URL قديمة الآن.

واجهة برمجة تطبيقات التعليقات التوضيحية

طرق واجهة برمجة التطبيقات المبسطة لتطبيق التعليقات التوضيحية المستندة إلى النص والأشكال على المستندات والصور بجميع التنسيقات الشائعة.

واجهات برمجة تطبيقات التخزين

File API - طرق مقدمة لتحميل الملفات وتنزيلها ونسخها ونقلها وحذفها: مستندات الإدخال ونتائج العرض ، في التخزين السحابي

Folder API - طرق مقدمة لإنشاء المجلدات ونسخها ونقلها وحذفها في التخزين السحابي

واجهة برمجة تطبيقات التخزين - طرق مقدمة للحصول على معلومات التخزين ومعلومات الملف

إضافة التعليقات التوضيحية إلى المستند

هنا سنوضح لك كيف يعمل إصدار GroupDocs.Annotation Cloud V2 API وهو مختلف عن V1. سنضيف تعليقًا توضيحيًا في مستند Word باستخدام GroupDocs.Annotation Cloud SDK for .NET باتباع الخطوات التالية:

• تحميل وثيقة المصدر إلى التخزين
• أضف تعليقًا توضيحيًا إلى المستند المصدر

نحتاج إلى تحميل المستند المصدر إلى التخزين السحابي كما في هذا المثال ، سنقوم بمعالجة المستند من التخزين السحابي. في الإصدار ، قدمنا 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: احصل على معرف التطبيق ومفتاح التطبيق على 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. إنها تساعدنا على التحسين المستمر لواجهة برمجة التطبيقات الخاصة بنا وصقلها.