GroupDocs مفتخر است که انتشار عمومی نسل بعدی GroupDocs.Annotation Cloud 17.12. بر اساس GroupDocs.Annotation برای دات نت است، بنابراین همان نتایج قابل پیش بینی اثبات شده را برای عملکرد حاشیه نویسی در Cloud ارائه می دهد. GroupDocs.Annotation Cloud یک API RESTful است که حاشیه نویسی ها را در همه فرمت های رایج فایل های تجاری دستکاری می کند. این به توسعه دهندگان اجازه می دهد تا حاشیه نویسی های تعاملی و توضیحی را برای کلمات، عبارات و مناطق خاصی از محتوای اسناد در هر برنامه کاربردی متقابل پلتفرم مدیریت کنند. از تمام حاشیه نویسی های متن و شکل اصلی پشتیبانی می کند و بالاتر از همه، این ویژگی های حاشیه نویسی را بدون نیاز به نصب نرم افزار شخص ثالث ارائه می دهد. لطفاً یادداشت‌های انتشار را برای فهرست کامل ویژگی‌های نسخه اول GroupDocs.Annotation Cloud بررسی کنید. بخش های زیر برخی از جزئیات در مورد این ویژگی ها را شرح می دهد.

وارد کردن حاشیه نویسی

در حین دستکاری حاشیه نویسی ها، وارد کردن حاشیه نویسی از اسناد نیاز اساسی یک برنامه کاربردی است. شما به راحتی می توانید حاشیه نویسی را با استفاده از REST API زیر وارد کنید، آن حاشیه نویسی را به عنوان AnnotationInfo Object فهرست می کند. لطفاً URI، دستور REST (Curl) و .NET SDK زیر را برای این منظور ببینید. URI

https://api.groupdocs.cloud/v1/annotation/{filename}/annotations

نمونه بقیه (cURL)

curl -v "https://api.groupdocs.cloud/v1/annotation/Annotated.pdf/annotations" \
-X GET \
-H "Content-Type: application/json" \
-H "authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx” 

مثال NET SDK

//TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
var configuration = new Configuration
{
    AppSid = Sid,
    AppKey = Key
};

var apiInstance = new AnnotationApi(configuration);

try
{
    var request = new GetImportRequest()
    {
        Name = "Annotated.pdf",
        Folder = null,
        Password = null
    };

    // Import annotations from document
    var response = apiInstance.GetImport(request);
    foreach (var entry in response)
        Debug.Print("Box :" + entry.Box);
}
catch (Exception e)
{
    Debug.Print("Exception when getting Annotation Information: " + e.Message);
} 

صادرات حاشیه نویسی

GroupDocs.Annotation Cloud REST API برای اضافه کردن تصویر و حاشیه نویسی متن در سند پشتیبانی شده. می توانید از API زیر برای اضافه کردن (صادرات) حاشیه نویسی به سند استفاده کنید. انتظار دارد AnnotationInfo Object در بدنه درخواست باشد. لطفاً URI، داده‌های درخواست JSON، دستور REST (Curl) و NET SDK را برای این منظور ببینید. URI

https://api.groupdocs.cloud/v1/Annotation/{filename}/html/pdf

درخواست داده

[{"creatorName":"Anonym A.","box":{ "x":173.0, "y":154.89, "width":142.5, "height":9.0 },"pageNumber":0,"annotationPosition":{ "x":173.0, "y":154.88999938964844 },"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":0,"replies":[{ "userName":"Admin", "message":"reply text", "repliedOn":"2017-03-16T18:19:14" },{ "userName":"Commentator", "message":"reply2 text", "repliedOn":"2017-03-16T18:19:14" }]}] 

نمونه بقیه (cURL)

curl -v "https://api.groupdocs.cloud/v1/annotation/Annotated.pdf/annotations" \
-X PUT \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d "[{"creatorName":"Anonym A.","box":{ "x":173.0, "y":154.89, "width":142.5, "height":9.0 },"pageNumber":0,"annotationPosition":{ "x":173.0, "y":154.88999938964844 },"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":0,"replies":[{ "userName":"Admin", "message":"reply text", "repliedOn":"2017-03-16T18:19:14" },{ "userName":"Commentator", "message":"reply2 text", "repliedOn":"2017-03-16T18:19:14" }]}]" \
-H "authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx” 

مثال NET SDK

//TODO: Get your AppSID and AppKey at https://dashboard.groupdocs.cloud (free registration is required).
var configuration = new Configuration
{
    AppSid = Sid,
    AppKey = Key
};

var apiInstance = new AnnotationApi(configuration);

try
{
    List annotations = new List();
    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,
        
    };
    // Insert/Export annotations to document.
    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);
} 

API Explorer

GroupDocs برای Cloud REST APIهای مبتنی بر وب API Explorer نیز ارائه می‌شود. این ساده ترین راه برای آزمایش API ما فوراً در مرورگر شما است. این مجموعه ای از اسناد Swagger برای APIهای Cloud GroupDocs است. بنابراین، ابتدا باید با GroupDocs Cloud ثبت نام کنید، کلید APP و SID را دریافت کنید و شروع به آزمایش GropuDocs.Annotation Cloud Rest API در مرورگر مورد علاقه خود به صورت تعاملی کنید.

GroupDocs.Annotation Cloud Resources

در زیر پیوندهایی به برخی از منابع مفیدی که ممکن است برای انجام وظایف خود به آن نیاز داشته باشید آورده شده است.

امروز یک آزمایش رایگان را شروع کنید

امروز یک دوره آزمایشی رایگان را شروع کنید – تنها چیزی که نیاز دارید این است که با سرویس GroupDocs Cloud ثبت نام کنید. پس از ثبت نام، آماده هستید تا ویژگی های پردازش فایل قدرتمند ارائه شده توسط GroupDocs Cloud را امتحان کنید.