Geliştiriciler için harika bir haber! Yepyeni GroupDocs.Annotation Cloud 19.5 kullanıma sunuldu. GroupDocs.Annotation Cloud REST API’yi daha basit ve kullanımı kolay hale getirmek için geliştirmeye kararlıyız. Bunu göz önünde bulundurarak, bu sürümde gerekli değişiklikleri yaptık. Yeni API, daha az yöntem ve seçenekle daha fazla optimize edilmiştir. Dahili mimarisi, Metin ve Şekil tabanlı açıklama işlemleri desteğiyle Belge ve Görüntü Açıklama araçları oluşturmak için hızlı ve güvenilir işleme için yenilendi. Ayrıca artık API, bulut depolamayla çalışmak için yöntemler içeriyor. Böylece depolama işlemlerini ayrı bir API kullanmak yerine doğrudan GroupDocs.Annotation Cloud REST API kullanarak gerçekleştirebilirsiniz.

Bu sürümde yapılan tüm yeni özellikler/geliştirmeler hakkında fikir edinmek için lütfen ayrıntılı bu sürümün sürüm notlarını kontrol edin.

Son Dakika Değişiklikleri

Yeni API Sürümü

19.5 sürümünde tanıtılan API sürümü V2, V1 kullanılabilir durumda kalacaktır.

kimlik doğrulama

JWT(JSON Web Token) kimlik doğrulaması bu sürümde tanıtılmıştır, artık OAuth2 ve URL imzalama kimlik doğrulama yöntemleri artık kullanılmamaktadır.

Açıklama API’sı

Tüm popüler biçimlerdeki belgelere ve resimlere Metin ve Şekil tabanlı açıklamaları uygulamak için basitleştirilmiş API yöntemleri.

Depolama API’leri

Dosya API – Dosya yükleme, indirme, kopyalama, taşıma, silme yöntemleri tanıtıldı: bulut depolama alanında belgeler girin ve sonuçları oluşturun

Folder API - Bulut depolama alanında klasör oluşturma, kopyalama, taşıma ve silme yöntemleri tanıtıldı

Storage API - Depolama bilgilerini ve dosya bilgilerini almak için sunulan yöntemler

Belgeye Ek Açıklamalar Ekleyin

Burada size GroupDocs.Annotation Cloud V2 API sürümünün nasıl çalıştığını ve V1’den farklı olduğunu göstereceğiz. Şu adımları izleyerek GroupDocs.Annotation Cloud SDK for .NET’i kullanarak bir Word belgesine ek açıklama ekleyeceğiz:

• Kaynak belgeyi Storage’a yükleyin
• Kaynak belgeye Ek Açıklama ekleyin

Bu örnekte Bulut depolamadan belge işleyeceğimiz için kaynak belgeyi Bulut depolamaya yüklememiz gerekiyor. Sürümde, dosya depolama işlemleri için Dosya API’sini tanıttık. Dosyayı depolamaya yüklemek için GroupDocs.Storage Cloud API yöntemi yerine Annotation V2 API sürümünün UploadFile yöntemini kullanacağız.

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

			try
			{
				// Dosyayı IOStream'de yerel/diskten açın.
				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 sürümünde, ek açıklamanın içe aktarılması için PUT yöntemi, aşağıdaki örnek kodda gösterildiği gibi POST yöntemi olarak değiştirilmiştir.

V1.1 Örneği

//YAPILACAKLAR: AppSID'nizi ve AppKey'inizi https://dashboard.groupdocs.cloud adresinden alın (ücretsiz kayıt gereklidir).
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,
        
    };
    // Ek açıklamaları belgeye ekleyin/dışa aktarın.
    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 Örneği

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
{
	// Ek açıklamalar yayınla/ekle
	class Add_Annotation
	{
		public static void Run()
		{
			var configuration = new Configuration(Common.MyAppSid, Common.MyAppKey);
			var apiInstance = new AnnotateApi(configuration);

			try
			{
				// İsteği ayarlayın.
				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);
			}
		}
	}
}

Geri Bildiriminizi Paylaşın

Görüşleriniz önemlidir! Lütfen GroupDocs.Annotation Cloud REST API’nin yeni sürümü hakkındaki düşüncelerinizi bizimle yorum paylaşmaktan çekinmeyin. API’mizi sürekli iyileştirmemize ve hassaslaştırmamıza yardımcı olur.