Document Annotation Java Cloud REST API

GroupDocs.Annotation Cloud SDK untuk Java membantu Anda membangun aplikasi Annotator Dokumen Cloud Java yang bekerja tanpa menginstal perangkat lunak pihak ketiga apa pun. Ini adalah pembungkus di sekitar GroupDocs.Annotation Cloud REST APIs.

Fitur Anotasi Dokumen

• Tambahkan satu atau beberapa anotasi ke dokumen cloud.
• Tambahkan anotasi langsung ke dokumen yang disimpan di cloud.
• Dukungan untuk berbagai jenis anotasi termasuk teks, gambar, dan bentuk.
• Sesuaikan properti anotasi seperti warna, ukuran, dan posisi.
• Anotasi berbagai format dokumen seperti PDF, Word, Excel, PowerPoint, dan gambar.

Fitur Manajemen Dokumen

• Merender Dokumen: Konversi dokumen ke format seperti PDF, gambar, atau HTML untuk dilihat atau dicetak.
• Pratinjau Dokumen: Hasilkan representasi gambar halaman dokumen untuk tujuan pratinjau.
• Hapus Anotasi: Hapus anotasi tertentu atau hapus semua anotasi dari dokumen.
• Ekstrak Anotasi: Ambil semua anotasi dari dokumen sebagai daftar objek JSON.

Manajemen File & Penyimpanan

• Bekerja dengan File API: Unggah, unduh, salin, pindahkan, dan hapus file di penyimpanan cloud.
• Bekerja dengan Folder API: Atur dan kelola folder di penyimpanan cloud (buat, pindahkan, hapus).
• Bekerja dengan Storage API: Akses dan kelola sumber daya penyimpanan cloud, termasuk mengambil detail penyimpanan dan informasi file.
• Dapatkan Format File yang Didukung: Ambil daftar format file yang didukung untuk anotasi.
• Info File: Dapatkan informasi terperinci tentang file di cloud, seperti ukuran, format, dan metadata.

Informasi & Pemrosesan Dokumen

• Dapatkan Informasi Dokumen: Ambil informasi dokumen terperinci, termasuk metadata, konten teks, dan anotasi.
• Dapatkan Halaman: Akses daftar halaman dalam dokumen bersama dengan detail seperti ukuran dan orientasi.
• Info Anotasi: Akses informasi terperinci tentang anotasi, termasuk jenis, posisi, dan konten.
• Opsi Anotasi: Konfigurasi berbagai opsi anotasi, termasuk pemilihan halaman, posisi, dan gaya.
• Penggunaan Lanjutan: Manfaatkan fitur lanjutan untuk mengelola anotasi, seperti pengelompokan dan pengurutan.

Jenis Anotasi yang Didukung

• Area Annotation: Sorot dan anotasi area persegi panjang tertentu dalam dokumen cloud.
• Arrow Annotation: Gambar panah untuk menunjukkan konten tertentu pada halaman dokumen cloud.
• Distance Annotation: Ukur dan anotasi jarak antara dua objek atau titik dalam dokumen cloud.
• **[Ellipse Annotation](https://docs.groupdocs.cloud/annotation/

ellipse-annotation/):** Gunakan bentuk elips untuk menyorot dan anotasi konten tertentu dalam dokumen.

• Image Annotation: Overlay gambar sebagai anotasi di atas konten dokumen.
• Link Annotation: Tambahkan anotasi tautan yang menghubungkan ke sumber daya eksternal.
• Point Annotation: Letakkan catatan pada titik tertentu dalam dokumen untuk anotasi terperinci.
• Polyline Annotation: Gambar garis bebas tangan atau bentuk untuk anotasi dan sorotan konten.
• Resources Redaction Annotation: Redaksi teks sensitif dengan menutupinya dengan persegi panjang hitam.
• TextField Annotation: Tambahkan komentar teks dalam bingkai berwarna sebagai anotasi.
• TextHighlight Annotation: Sorot teks dan tambahkan komentar untuk menarik perhatian pada konten tertentu.
• TextRedaction Annotation: Sembunyikan teks yang dipilih dengan persegi panjang hitam untuk redaksi.
• TextReplacement Annotation: Ganti teks asli dengan fragmen baru melalui anotasi.
• TextStrikeout Annotation: Tandai teks dengan garis silang untuk menunjukkan penghapusan.
• TextUnderline Annotation: Garis bawahi dan anotasi teks untuk penekanan.
• Watermark Annotation: Tambahkan anotasi teks watermark di atas dokumen.
• Squiggly Annotation: Gunakan garis bergelombang untuk menggarisbawahi dan menarik perhatian pada teks.

Fitur Khusus API

• Tambahkan Anotasi Secara Langsung: Tambahkan anotasi ke dokumen tanpa mengunduhnya.
• Contoh API Publik: Akses contoh kode dan dokumentasi untuk memanfaatkan fitur API.

Format Dokumen Anotasi Cloud yang Didukung

• 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
• AutoCAD®: CAD
• Gambar: DJVU, JPEG, TIFF, BMP, GIF (gambar statis tanpa animasi)
• Pencitraan Medis: DICOM
• Markup: HTML, MHTML
• Tata Letak Tetap: PDF
• MetaFiles: EMF, WMF

Persyaratan

• Versi Java: Membangun pustaka klien API memerlukan Java 1.7+.
• Alat Pembangun: Maven diperlukan untuk mengelola ketergantungan dan membangun proyek.

Prasyarat

• Akun GroupDocs Cloud: Untuk menggunakan GroupDocs.Annotation Cloud SDK untuk Java, Anda perlu mendaftar akun dengan GroupDocs Cloud.
• ID Klien & Rahasia Klien: Setelah mendaftar, Anda perlu mencari atau membuat ID Klien dan Rahasia Klien di Dashboard Cloud.
• Kuota Gratis: GroupDocs Cloud menawarkan kuota gratis untuk pengguna baru. Untuk informasi lebih lanjut, Anda harus memeriksa Harga GroupDocs Cloud.

Instal GroupDocs.Annotation-Cloud dari Maven

Untuk menginstal GroupDocs.Annotation Cloud SDK untuk Java, Anda perlu menambahkan repositori GroupDocs Cloud ke file pom.xml aplikasi Anda:

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

Instal dari Sumber

Untuk menginstal pustaka klien API dari kode sumber, ikuti langkah-langkah berikut:

• Instal ke Repositori Maven Lokal: Untuk menginstal pustaka ke repositori Maven lokal Anda, cukup jalankan perintah berikut di terminal:

mvn clean install

• Deploy ke Repositori Maven Jarak Jauh: Jika Anda ingin mendistribusikannya ke repositori Maven jarak jauh, konfigurasikan pengaturan repositori dan jalankan perintah berikut:

mvn clean deploy

Untuk informasi lebih lanjut tentang penerapan ke repositori jarak jauh, lihat Panduan OSSRH.

Pengguna Maven

Jika Anda adalah pengguna Maven, Anda dapat menambahkan GroupDocs.Annotation Cloud SDK untuk Java sebagai dependensi dalam file pom.xml proyek Anda:

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

Memulai

Untuk memulai dengan GroupDocs.Annotation Cloud SDK untuk Java, ikuti langkah-langkah berikut:

1. Instal SDK: Instal SDK dengan mengikuti langkah-langkah yang diuraikan di atas (menggunakan Maven atau menginstal dari sumber).
2. Konfigurasi: Atur konfigurasi menggunakan ID Klien dan Rahasia Klien yang diperoleh dari Dashboard GroupDocs Cloud.
3. Kode Contoh: Implementasikan kode contoh dalam aplikasi Anda untuk menambahkan anotasi, mengekstrak informasi dokumen, atau mengelola file dan folder.
4. Dokumentasi: Rujuk ke petunjuk Memulai Cepat dan dokumentasi API untuk contoh penggunaan terperinci dan informasi tambahan.

Otorisasi & Otentikasi

GroupDocs.Annotation Cloud SDK untuk Java menggunakan OAuth 2.0 untuk otorisasi dan otentikasi. Detail berikut disediakan:

• Jenis Otorisasi: OAuth 2.0
• Alur: Otorisasi berbasis aplikasi
• URL Otorisasi: https://api.groupdocs.cloud/connect/token
• Masa Berlaku Token: 1 hari (secara default)

JWT

GroupDocs.Annotation Cloud SDK menggunakan JSON Web Tokens (JWT) untuk akses API yang aman:

• Jenis Token: OAuth 2.0 JWT (JSON Web Token)
• URL Otorisasi: Token dihasilkan menggunakan endpoint https://api.groupdocs.cloud/connect/token.
• Kedaluwarsa Token: Masa berlaku token default adalah 1 hari, memastikan akses yang aman dan terikat waktu ke API.

Detail ini memberikan panduan komprehensif untuk menyiapkan dan menggunakan GroupDocs.Annotation Cloud SDK untuk Java, mencakup persyaratan penting, langkah-langkah instalasi, dan konfigurasi keamanan.

Berikut adalah dua cuplikan kode paling dapat dijual yang diekstrak dari konten yang disediakan. Cuplikan ini menunjukkan fungsionalitas penting yang akan menarik bagi calon pengguna yang ingin mengintegrasikan kemampuan anotasi ke dalam aplikasi mereka.

Kode Contoh Cloud Java untuk Menambahkan Anotasi Titik

Cuplikan ini menunjukkan cara menambahkan anotasi titik ke dokumen menggunakan GroupDocs.Annotation Cloud SDK untuk Java. Anotasi titik berguna untuk menandai titik tertentu dalam dokumen dengan komentar atau catatan.

// Untuk contoh lengkap dan file data, silakan kunjungi https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Dapatkan AppKey dan AppSID dari https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Dapatkan AppKey dan AppSID dari https://dashboard.groupdocs.cloud

Configuration configuration = new Configuration(MyAppSid, MyAppKey);
AnnotateApi apiInstance = new AnnotateApi(configuration);

// Buat anotasi.
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("Ini adalah anotasi titik");
annotations[0].setCreatorName("Anonym A.");

// Buat objek perm

intaan.
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);

// Menjalankan metode API.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddPointAnnotation: Anotasi Titik ditambahkan: " + result.getTitle());

Kode Contoh Cloud Java untuk Menambahkan Anotasi TextHighlight

Cuplikan kode ini menunjukkan cara menambahkan anotasi sorotan teks ke dokumen. Menyoroti teks adalah tugas anotasi umum, terutama dalam proses tinjauan, dan cuplikan ini mengilustrasikan bagaimana hal itu dapat dilakukan secara programatis.

// Untuk contoh lengkap dan file data, silakan kunjungi https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Dapatkan AppKey dan AppSID dari https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Dapatkan AppKey dan AppSID dari https://dashboard.groupdocs.cloud

Configuration configuration = new Configuration(MyAppSid, MyAppKey);
AnnotateApi apiInstance = new AnnotateApi(configuration);

// Buat anotasi.
AnnotationInfo[] annotations = new AnnotationInfo[1];
annotations[0] = new AnnotationInfo();

Rectangle r = new Rectangle();
r.setX(100.0);
r.setY(100.0);
r.setWidth(300.0);
r.setHeight(50.0);

annotations[0].setBox(r);
annotations[0].setPageNumber(0);
annotations[0].setType(TypeEnum.TEXT_HIGHLIGHT);
annotations[0].setText("Teks ini disorot");
annotations[0].setCreatorName("Anonym A.");

// Buat objek permintaan.
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("Annotationdocs\\sample.docx");

AnnotateOptions options = new AnnotateOptions();
options.setFileInfo(fileInfo);
options.setAnnotations(Arrays.asList(annotations));
options.setOutputPath("Output/sample-annotated.docx");

AnnotateRequest request = new AnnotateRequest(options);

// Menjalankan metode API.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddTextHighlightAnnotation: Anotasi Sorotan Teks ditambahkan: " + result.getTitle());