Аннотация к документу Java Cloud REST API

Product Page | Docs | Live Demos | Swagger UI | Code Samples | Blog | Free Support | Free Trial

GroupDocs.Annotation Cloud SDK for Java помогает создавать облачные Java-приложения Document Annotator, которые работают без установки какого-либо стороннего программного обеспечения. Это оболочка для GroupDocs.Annotation Cloud REST APIs.

Функции аннотирования облачных документов

• Create & add одна или несколько аннотаций к облачным документам.
• {{ГИПЕРССЫЛКА1}}.
• Extract all annotations from a cloud document в виде списка объектов JSON.
• Загрузите документ в облако, get it annotated and download.
• Возможность remove all the cloud file annotations за один раз.
• С помощью cloud document preview создайте графическое представление всех страниц облачного документа.
• Remove all the pages from the cloud storage, чтобы уменьшить потребление облачного пространства.

Поддерживаемые типы облачных аннотаций

– Area Annotation: отметьте область с помощью прямоугольника на странице в облачном документе.

• Distance Annotation: расстояние между двумя точками на прямой линии, помеченной как аннотация в облачном документе.
• Ellipse Annotation: отметить часть документа эллиптической аннотацией.
• Image Annotation: аннотация наложения изображения для аннотации желаемого содержимого страницы облачного документа.
• Link Annotation: аннотация гиперссылки, указывающая на удаленный ресурс.
• Multiple Annotation: добавляет несколько аннотаций в один и тот же облачный документ.
• Point Annotation: добавляет аннотацию/заметку в нужное место в облачном документе.
• Polyline Annotation: аннотация, которую можно рисовать с помощью фигур или линий от руки.
• Resource Redaction Annotation: черный прямоугольник с фиксированной позицией, который вы можете добавить, чтобы скрыть/редактировать любой текст в облачном документе.
• Squiggly Annotation: добавляет волнистую линию под текстом, на который вы хотите обратить внимание.

Поддерживаемые форматы облачных аннотаций

Microsoft Word®: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, TXT
OpenOffice Writer®: ODT, OTT
Microsoft Excel®: XLS, XLSX, XLSB
Microsoft PowerPoint®: PPT, PPTX, PPSX
OpenOffice Impress®: ODP, OTP
Microsoft Visio®: VSD, VDX, VSS, VSDM
Microsoft Outlook®: MSG, EML, EMLX
Автокад: САПР
Изображения: DJVU, JPEG, TIFF, BMP, GIF (статические изображения без анимации)
Медицинская визуализация: DICOM
Разметка: HTML, MHTML
Фиксированный макет: PDF
Метафайлы: EMF, WMF

Требования

Для создания клиентской библиотеки API требуется:

1. Ява 1.7+
2. Мавен

Предпосылки

Чтобы использовать GroupDocs.Annotation Cloud SDK для Java, вам необходимо зарегистрировать учетную запись в GroupDocs Cloud и найти/создать идентификатор клиента и секрет клиента в Cloud Dashboard. Есть бесплатная квота. Дополнительные сведения см. в разделе GroupDocs Cloud Pricing.

Установите GroupDocs.Annotation-Cloud из Maven

Добавьте облачный репозиторий GroupDocs в ваше приложение pom.xml.

<repository>
    <id>repository.groupdocs.cloud</id>
    <name>repository.groupdocs.cloud</name>
    <url>https://releases.groupdocs.cloud/java/repo/</url>
</repository>

Установить из исходников

Чтобы установить клиентскую библиотеку API в локальный репозиторий Maven, просто выполните:

mvn clean install

Чтобы вместо этого развернуть его в удаленном репозитории Maven, настройте параметры репозитория и выполните:

mvn clean deploy

Обратитесь к OSSRH Guide для получения дополнительной информации.

пользователи Maven

Добавьте эту зависимость в POM вашего проекта:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-annotation-cloud</artifactId>
    <version>22.2</version>
    <type>pom</type>
</dependency>

Другие

Сначала сгенерируйте JAR, выполнив:

mvn clean package

Затем вручную установите следующие JAR-файлы:

• target/groupdocs-annotation-cloud-22.2.jar
• цель/библиотека/*.jar

Начать

Следуйте Quick Start инструкциям.

Пример кода Java для добавления аннотации точки

// For complete examples and data files, please go to https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Get AppKey and AppSID from https://dashboard.groupdocs.cloud
  
Configuration configuration = new Configuration(MyAppSid, MyAppKey);
  
AnnotateApi apiInstance = new AnnotateApi(configuration);
 
// Create annotation/s.
AnnotationInfo[] annotations = new AnnotationInfo[1];
annotations[0] = new AnnotationInfo();
 
Point pt = new Point();
pt.setX(1.0);
pt.setY(1.0);
annotations[0].setAnnotationPosition(pt);
 
Rectangle r = new Rectangle();
r.setX(100.0);
r.setY(100.0);
r.setWidth(200.0);
r.setHeight(100.0);
 
annotations[0].setBox(r);
annotations[0].setPageNumber(0);
annotations[0].setType(TypeEnum.POINT);
annotations[0].setText("This is point annotation");
annotations[0].setCreatorName("Anonym A.");
 
// Create request object.
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("Annotationdocs\\one-page.docx");
 
AnnotateOptions options = new AnnotateOptions();
options.setFileInfo(fileInfo);
options.setAnnotations(Arrays.asList(annotations));
options.setOutputPath("Output/one-page-annotated.docx");
 
AnnotateRequest request = new AnnotateRequest(options);
 
// Executing api method.
AnnotationApiLink result = apiInstance.annotate(request);
 
System.out.println("AddPointAnnotation: Point Annotation added: " + result.getTitle());

Авторизация и аутентификация

Authentication schemes определено для API следующим образом:

JWT

• Тип: OAuth 2.0
• Поток: приложение
• URL-адрес авторизации:https://api.groupdocs.cloud/connect/token
• Срок жизни токена: 1 день (по умолчанию)

Product Page | Docs | Live Demos | Swagger UI | Code Samples | Blog | Free Support | Free Trial