GroupDocs с гордостью объявляет об общедоступном выпуске следующего поколения GroupDocs.Annotation Cloud 17.12.. Он основан на GroupDocs.Annotation для .NET, поэтому обеспечивает такие же проверенные и предсказуемые результаты для функций аннотаций в облаке. Облако GroupDocs.Annotation — это RESTful API, который управляет аннотациями во всех распространенных форматах бизнес-файлов. Это позволяет разработчикам управлять интерактивными и пояснительными аннотациями к определенным словам, фразам и областям содержимого документов в любом кросс-платформенном приложении. Он поддерживает все основные текстовые и графические аннотации и, самое главное, предоставляет эти функции аннотаций без необходимости установки какого-либо стороннего программного обеспечения. Полный список функций первой версии GroupDocs.Annotation Cloud см. в примечаниях к выпуску. В следующих разделах описаны некоторые подробности, касающиеся этих функций.

Импорт аннотаций

При работе с аннотациями импорт аннотаций из документов является основным требованием приложения. Вы можете легко импортировать аннотацию, используя следующий REST API, он перечисляет аннотацию как Объект AnnotationInfo. Для этого см. следующий 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”

Пример пакета SDK для .NET

//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);
}

Экспорт аннотации

REST API GroupDocs.Annotation Cloud для добавления рисунка и текстовой аннотации в поддерживаемый документ. Вы можете использовать следующий 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”

Пример пакета SDK для .NET

//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 for Cloud REST API также поставляется с веб-интерфейсом API Explorer. Это самый простой способ опробовать наш API прямо в браузере. Это коллекция документации Swagger для облачных API GroupDocs. Итак, сначала вам нужно зарегистрироваться в GroupDocs Cloud, получить ключ APP и SID и начать интерактивно тестировать GropuDocs.Annotation Cloud Rest API в своем любимом браузере.

Облачные ресурсы GroupDocs.Annotation

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

Начните бесплатную пробную версию сегодня

Начните бесплатную пробную версию сегодня — все, что вам нужно, это зарегистрироваться в облачной службе GroupDocs. После регистрации вы готовы попробовать мощные функции обработки файлов, предлагаемые GroupDocs Cloud.