GroupDocs з гордістю повідомляє про публічний випуск наступного покоління GroupDocs.Annotation Cloud 17.12., який базується на GroupDocs.Annotation для .NET, тому забезпечує ті самі перевірені передбачувані результати для функції анотацій у хмарі. GroupDocs.Annotation Cloud — це RESTful API, який маніпулює анотаціями в усіх поширених форматах бізнес-файлів. Це дозволяє розробникам керувати інтерактивними та пояснювальними анотаціями до певних слів, фраз і областей вмісту документів у будь-якій міжплатформній програмі. Він підтримує всі основні анотації тексту та малюнків і, насамперед, надає ці функції анотацій без необхідності інсталювати стороннє програмне забезпечення. Перегляньте примітки до випуску, щоб отримати повний список функцій першої версії 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 у тілі запиту. Перегляньте наведений нижче 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 for Cloud REST API також постачається з веб-програмою API Explorer. Це найпростіший спосіб випробувати наш API одразу у вашому браузері. Це збірка документації Swagger для API GroupDocs Cloud. Отже, спочатку вам потрібно зареєструватися в GroupDocs Cloud, отримати ключ APP і SID і почати інтерактивне тестування GropuDocs.Annotation Cloud Rest API у вашому улюбленому браузері.

Хмарні ресурси GroupDocs.Annotation

Нижче наведено посилання на деякі корисні ресурси, які можуть знадобитися для виконання ваших завдань.

Почніть безкоштовну пробну версію сьогодні

Розпочніть безкоштовну пробну версію сьогодні – все, що вам потрібно, це зареєструватися в хмарній службі GroupDocs. Зареєструвавшись, ви готові спробувати потужні функції обробки файлів, які пропонує GroupDocs Cloud.