!

تفخر GroupDocs بالإعلان عن الإصدار العام لـ Next Generation GroupDocs.Annotation Cloud 17.12. وهو مبني على GroupDocs.Annotation لـ .NET ، لذلك يقدم نفس النتائج التي يمكن التنبؤ بها لوظيفة التعليقات التوضيحية في Cloud. GroupDocs.Annotation Cloud هي واجهة برمجة تطبيقات RESTful تتعامل مع التعليقات التوضيحية في جميع تنسيقات ملفات الأعمال الشائعة. يسمح للمطورين بإدارة التعليقات التوضيحية التفاعلية والتفسيرية لكلمات وعبارات ومناطق معينة من محتوى المستندات في أي تطبيق عبر النظام الأساسي. وهو يدعم جميع التعليقات التوضيحية النصية والشكلية الرئيسية ، وفوق كل ذلك ، يوفر ميزات التعليقات التوضيحية هذه دون الحاجة إلى تثبيت أي برنامج تابع لجهة خارجية. يرجى مراجعة ملاحظات الإصدار للحصول على قائمة كاملة بميزات الإصدار الأول من GroupDocs.Annotation Cloud. تصف الأقسام التالية بعض التفاصيل المتعلقة بهذه الميزات.

استيراد التعليقات التوضيحية

أثناء معالجة التعليقات التوضيحية ، يعد استيراد التعليقات التوضيحية من المستندات شرطًا أساسيًا للتطبيق. يمكنك بسهولة استيراد التعليقات التوضيحية باستخدام واجهة برمجة تطبيقات REST التالية ، فهي تسرد التعليقات التوضيحية على أنها 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 لإضافة الشكل والتعليق التوضيحي النصي في المستند المدعوم. يمكنك استخدام واجهة برمجة التطبيقات التالية لإضافة (تصدير) تعليق توضيحي إلى المستند. يتوقع كائن AnnotationInfo في نص الطلب. يرجى الاطلاع على معرّف 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

يأتي GroupDocs لـ Cloud REST APIs مع API Explorer على شبكة الإنترنت أيضًا. إنها أسهل طريقة لتجربة API الخاصة بنا على الفور في متصفحك. إنها مجموعة من وثائق Swagger لواجهات برمجة تطبيقات GroupDocs Cloud. ببساطة ، تحتاج أولاً إلى التسجيل باستخدام GroupDocs Cloud ، الحصول على مفتاح APP و SID والبدء في اختبار GropuDocs.Annotation Cloud Rest API في متصفحك المفضل بشكل تفاعلي.

GroupDocs.Annotation Cloud Resources

فيما يلي روابط لبعض الموارد المفيدة التي قد تحتاجها لإنجاز مهامك.

ابدأ تجربة مجانية اليوم

ابدأ إصدارًا تجريبيًا مجانيًا اليوم - كل ما تحتاجه هو الاشتراك في خدمة GroupDocs Cloud. بمجرد التسجيل ، ستكون جاهزًا لتجربة ميزات معالجة الملفات القوية التي تقدمها GroupDocs Cloud.