Belge Notlandırma Java Bulut REST API

GroupDocs.Annotation Cloud SDK for Java Java için bulut tabanlı Belge Notlandırma Uygulamaları oluşturmanıza yardımcı olur ve üçüncü taraf herhangi bir yazılım yüklemeden çalışır. Bu, GroupDocs.Annotation Cloud REST API’lerinin etrafında bir sarmalayıcıdır.

Belge Notlandırma Özellikleri

• Bulut belgelerine tek veya birden fazla not ekleyin.
• Notları doğrudan bulutta depolanan belgelere ekleyin.
• Metin, resimler ve şekiller gibi çeşitli not türleri için destek sağlar.
• Renk, boyut ve konum gibi not özelliklerini özelleştirin.
• PDF, Word, Excel, PowerPoint ve resimler gibi birden fazla belge formatını notlandırın.

Belge Yönetim Özellikleri

• Belgeleri Dönüştürme: Belgeleri görüntüleme veya yazdırma için PDF, resim veya HTML gibi formatlara dönüştürün.
• Belge Önizleme: Önizleme amacıyla belge sayfalarının görüntü temsillerini oluşturun.
• Notları Kaldırma: Belirli notları silin veya bir belgeden tüm notları kaldırın.
• Notları Çıkarma: Bir belgeden tüm notları JSON nesneleri listesi olarak alın.

Dosya ve Depolama Yönetimi

• Dosya API’si ile Çalışma: Bulut depolama alanına dosya yükleyin, indirin, kopyalayın, taşıyın ve silin.
• Klasör API’si ile Çalışma: Bulut depolamada klasörleri düzenleyin ve yönetin (oluşturma, taşıma, silme).
• Depolama API’si ile Çalışma: Depolama ayrıntılarını ve dosya bilgilerini alarak bulut depolama kaynaklarına erişin ve yönetin.
• Desteklenen Dosya Formatlarını Alın: Notlandırma için desteklenen dosya formatları listesini alın.
• Dosya Bilgisi: Buluttaki dosyalar hakkında boyut, format ve meta veriler gibi ayrıntılı bilgi edinin.

Belge Bilgisi ve İşleme

• Belge Bilgisini Alın: Meta veriler, metin içeriği ve notlar dahil olmak üzere ayrıntılı belge bilgisini edinin.
• Sayfaları Alın: Bir belgedeki sayfaların listesini boyut ve yön gibi ayrıntılarla birlikte erişin.
• Not Bilgisi: Not türü, konum ve içerik dahil olmak üzere notlar hakkında ayrıntılı bilgi edinin.
• Not Seçenekleri: Sayfa seçimi, konum ve stil dahil olmak üzere çeşitli not seçeneklerini yapılandırın.
• İleri Düzey Kullanım: Notları yönetmek için gruplama ve sıralama gibi ileri düzey özellikleri kullanın.

Desteklenen Not Türleri

• Alan Notu: Bulut belgesi içindeki belirli bir dikdörtgen alanı vurgulayın ve notlandırın.
• Ok Notu: Bulut belge sayfasındaki belirli bir içeriği işaret etmek için bir ok çizin.
• Mesafe Notu: Bir bulut belgesindeki iki nesne veya nokta arasındaki mesafeyi ölçün ve notlandırın.
• Elips Notu: Bir belge içindeki belirli bir içeriği vurgulamak ve notlandırmak için eliptik bir şekil kullanın.
• Resim Notu: Belge içeriğinin üzerine bir resim ekleyin.
• Bağlantı Notu: Dış bir kaynağa bağlantı veren bir hiperlink notu ekleyin.
• Nokta Notu: Ayrıntılı notlandırma için belge içinde belirli bir noktada bir not yerleştirin.
• Çoklu Çizgi Notu: İçeriği vurgulamak ve notlandırmak için serbest el çizgileri veya şekilleri çizin.
• Kaynaklar Düzenleme Notu: Siyah bir dikdörtgen ile hassas metni karartın.
• Metin Alanı Notu: Not olarak renkli bir çerçeve içinde bir metin yorumu ekleyin.
• Metin Vurgulama Notu: Belirli içeriği vurgulamak için metni vurgulayın ve yorumlar ekleyin.
• Metin Düzenleme Notu: Düzenleme için seçilen metni siyah bir dikdörtgenle gizleyin.
• Metin Değiştirme Notu: Orijinal metni yeni bir parça ile not aracılığıyla değiştirin.
• Metin Üstü Çizme Notu: Silinmesi gerektiğini belirtmek için metnin üstünü çizin.
• Metin Altı Çizme Notu: Vurgu için metnin altını çizin ve not ekleyin.
• Filigran Notu: Belge üzerine filigran metni notu ekleyin.
• Dalgalı Çizgi Notu: Metnin altını çizmek ve dikkat çekmek için dalgalı bir çizgi kullanın.

API’ye Özgü Özellikler

• Notları Doğrudan Ekleyin: Belgeleri indirmeden notları ekleyin.
• Herkese Açık API Örnekleri: API özelliklerini kullanma hakkında örnek kod ve belgeler erişin.

Desteklenen Bulut Notlandırma Belge Formatları

• 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
• Resimler: DJVU, JPEG, TIFF, BMP, GIF (animasyonsuz statik resimler)
• Tıbbi Görüntüleme: DICOM
• İşaretleme: HTML, MHTML
• Sabit Düzen: PDF
• Meta Dosyalar: EMF, WMF

Gereksinimler

• Java Sürümü: API istemci kitaplığını oluşturmak için Java 1.7+ gereklidir.
• Yapı Aracı: Maven, bağımlılıkları yönetmek ve projeyi oluşturmak için gereklidir.

Ön Koşullar

• GroupDocs Bulut Hesabı: GroupDocs.Annotation Cloud SDK for Java’yı kullanmak için GroupDocs Bulut ile bir hesap oluşturmanız gerekmektedir.
• Müşteri Kimliği & Müşteri Sırrı: Kaydolduktan sonra, Bulut Panosundan Müşteri Kimliğinizi ve Müşteri Sırrınızı bulmanız veya oluşturmanız gerekecektir.
• Ücretsiz Kota: GroupDocs Bulut, yeni kullanıcılar için ücretsiz bir kota sunar. Daha fazla bilgi için GroupDocs Bulut Fiyatlandırması kontrol edilmelidir.

Maven’den GroupDocs.Annotation-Cloud’u Yükleme

GroupDocs.Annotation Cloud SDK for Java’yı yüklemek için, GroupDocs Bulut deposunu uygulamanızın pom.xml dosyasına eklemeniz gerekir:

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

Kaynaktan Yükleme

API istemci kitaplığını kaynak koddan yüklemek için şu adımları izleyin:

• Yerel Maven Deposuna Yükleyin: Kitaplığı yerel Maven deposuna yüklemek için terminalde şu komutu yürütün:

mvn clean install

• Uzak Maven Deposuna Dağıtın: Eğer uzak bir Maven deposuna dağıtmak istiyorsanız, depo ayarlarını yapılandırın ve şu komutu yürütün:

mvn clean deploy

Uzak bir depoya dağıtma hakkında daha fazla bilgi için OSSRH Kılavuzu başvurulmalıdır.

Maven Kullanıcıları

Maven kullanıcısıysanız, GroupDocs.Annotation Cloud SDK for Java’yı projenizin pom.xml dosyasına bağımlılık olarak ekleyebilirsiniz:

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

Başlangıç

GroupDocs.Annotation Cloud SDK for Java ile başlamak için şu adımları izleyin:

1. SDK’yı Yükleyin: Maven kullanarak veya kaynaktan yükleyerek yukarıda belirtilen adımları izleyin.
2. Yapılandırma: GroupDocs Bulut Panosu’ndan aldığınız Müşteri Kimliği ve Müşteri Sırrınızı kullanarak yapılandırmayı ayarlayın.
3. Örnek Kod: Uygulamanızda notlar eklemek, belge bilgilerini çıkarmak veya dosyaları ve klasörleri yönetmek için örnek kodu uygulayın.
4. Dokümantasyon: Detaylı kullanım örnekleri ve ek bilgiler için Hızlı Başlangıç talimatlarına ve API dokümantasyonuna başvurun.

Yetkilendirme ve Kimlik Doğrulama

GroupDocs.Annotation Cloud SDK for Java, yetkilendirme ve kimlik doğrulama için OAuth 2.0 kullanır. Aşağıdaki detaylar sağlanmıştır:

• Yetkilendirme Türü: OAuth 2.0
• Akış: Uygulama tabanlı yetkilendirme
• Yetkilendirme URL’si: https://api.groupdocs.cloud/connect/token
• Token Süresi: 1 gün (varsayılan olarak)

JWT

GroupDocs.Annotation Cloud SDK, API’ye güvenli erişim sağlamak için JSON Web Token’leri (JWT) kullanır:

• Token Türü: OAuth 2.0 JWT (JSON Web Token)
• Yetkilendirme URL’si: Token’ler https://api.groupdocs.cloud/connect/token uç noktası kullanılarak oluşturulur.
• Token Geçerlilik Süresi: Varsayılan token süresi 1 gündür, bu da API’ye güvenli, zaman sınırlı erişim sağlar.

Bu detaylar, GroupDocs.Annotation Cloud SDK for Java’nın kurulumu ve kullanımı hakkında kapsamlı bir rehber sunar, temel gereksinimleri, kurulum adımlarını ve güvenlik yapılandırmalarını kapsar.

İşte sağlanan içerikten alınmış, en çok satan iki kod snippet’i. Bu snippet’ler, uygulamalarına not ekleme yeteneklerini entegre etmek isteyen potansiyel kullanıcılara hitap edecek temel işlevselliği sergiler.

Nokta Notu Eklemek için Örnek Bulut Java Kodu

Bu snippet, GroupDocs.Annotation Cloud SDK for Java kullanarak bir belgeye nokta notu eklemenin nasıl yapılacağını gösterir. Nokta notları, belgede belirli noktaları yorumlar veya notlarla işaretlemek için kullanışlıdır.

// Tam örnekler ve veri dosyaları için lütfen https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples adresine gidin  
String MyAppKey = ""; // AppKey ve AppSID'i https://dashboard.groupdocs.cloud adresinden alın  
String MyAppSid = ""; // AppKey ve AppSID'i https://dashboard.groupdocs.cloud adresinden alın

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

// Notları oluşturun.  
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("Bu bir nokta notudur");  
annotations[0].setCreatorName("Anonym A.");

// İstek nesnesini oluşturun.  
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);

// API yöntemini yürütme.  
AnnotationApiLink result = apiInstance.annotate(request);  
System.out.println("AddPointAnnotation: Nokta Notu eklendi: " + result.getTitle());

Metin Vurgulama Notu Eklemek için Örnek Bulut Java Kodu

Bu kod snippet’i, bir belgeye metin vurgulama notu eklemenin nasıl yapılacağını gösterir. Metni vurgulamak, özellikle inceleme süreçlerinde yaygın bir notlandırma görevidir ve bu snippet, bunun programlı olarak nasıl yapılabileceğini gösterir.

// Tam örnekler ve veri dosyaları için lütfen https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples adresine gidin  
String MyAppKey = ""; // AppKey ve AppSID'i https://dashboard.groupdocs.cloud adresinden alın  
String MyAppSid = ""; // AppKey ve AppSID'i https://dashboard.groupdocs.cloud adresinden alın

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

// Notları oluşturun.  
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("Bu metin vurgulanmıştır");  
annotations[0].setCreatorName("Anonym A.");

// İstek nesnesini oluşturun.  
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);

// API yöntemini yürütme.  
AnnotationApiLink result = apiInstance.annotate(request);  
System.out.println("AddTextHighlightAnnotation: Metin Vurgulama Notu eklendi: " + result.getTitle());