<repositories>
<repository>
<id>repository.groupdocs.com</id>
<name>GroupDocs Repository</name>
<url>https://releases.groupdocs.com/java/repo/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-annotation</artifactId>
<version>24.6</version>
</dependency>
</dependencies>
repositories {
maven {
url 'https://releases.groupdocs.com/java/repo/'
}
}
compile(group: 'com.groupdocs', name: 'groupdocs-annotation', version: '24.6')
<ivysettings>
<settings defaultResolver="chain"/>
<resolvers>
<chain name="chain">
<ibiblio name="GroupDocs Repository" m2compatible="true" root="https://releases.groupdocs.com/java/repo/"/>
</chain>
</resolvers>
</ivysettings>
<dependency org="com.groupdocs" name="groupdocs-annotation" rev="24.6">
<artifact name="groupdocs-annotation" ext="jar"/>
</dependency>
resolvers += Resolver.url("GroupDocs Repository", url("https://releases.groupdocs.com/java/repo/"))
libraryDependencies += "com.groupdocs" % "groupdocs-annotation" % "24.6"
API de Alta Codificación para Anotaciones de Documentos en Java
GroupDocs.Annotation para Java es una robusta API local diseñada para desarrolladores de Java para anotar, agregar marcas de agua y gestionar documentos en varios formatos como PDF, Word®, Excel®, PowerPoint® e imágenes. Ofrece características avanzadas que incluyen anotaciones de texto, área e imagen, soporte OLE, gestión de metadatos y compatibilidad entre plataformas.
Características de la API Local de Anotación de Documentos en Java
Soporte de Documentos y Formatos
- Soporte para Múltiples Formatos de Documentos: Anote varios formatos de documentos, incluidos PDF, Word®, Excel®, PowerPoint®, Visio® e imágenes (JPG, PNG, BMP, etc.).
- Anotaciones Específicas de PDF: Soporte para notas adhesivas, campos de texto y otros tipos de anotaciones específicas de PDF.
- Soporte para Formatos de Imagen: Anote formatos de imagen populares, incluidos JPG, PNG, BMP y más.
- Formatos de Exportación de Anotaciones: Exporte anotaciones en diferentes formatos para interoperabilidad.
- Soporte OLE: Soporte para objetos OLE dentro de los documentos anotados.
- Compatibilidad con otras APIs de GroupDocs: Integración sin problemas con otros productos de GroupDocs para funcionalidad extendida.
Tipos de Anotaciones y Herramientas
- Anotaciones de Texto: Añadir anotaciones de texto como resaltar, subrayar y tachar.
- Anotaciones de Área: Resaltar y comentar en áreas específicas usando anotaciones de rectángulo, polígono y punto.
- Anotaciones de Marcado: Aplicar anotaciones de marcado como redacción para ocultar contenido sensible.
- Medición de Distancias: Medir distancias dentro de los documentos, útil para dibujos técnicos y archivos CAD.
- Marcas de Agua: Añadir marcas de agua de texto e imagen para propósitos de marca o seguridad.
- Anotaciones de Imágenes: Anotar archivos de imagen, con soporte para múltiples formatos de imagen.
Gestión de Anotaciones
- Respuestas a Anotaciones: Permitir que múltiples usuarios respondan a anotaciones, habilitando la revisión colaborativa de documentos.
- Apariencia Personalizada de Anotaciones: Personalizar la apariencia de las anotaciones, incluidos los ajustes de color, fuente y opacidad.
- Exportación/Importación de Anotaciones: Exportar anotaciones a archivos externos e importarlos nuevamente para compartir o colaborar.
- Capas de Anotaciones: Controlar la superposición de anotaciones, permitiendo que se superpongan o permanezcan separadas.
- Manejo de Anotaciones: Capacidad para crear, editar y eliminar anotaciones programáticamente.
- Metadatos de Anotaciones: Anotar documentos mientras se preserva la integridad de los metadatos.
- Soporte para Deshacer/Rehacer: Implementar funcionalidad de deshacer/rehacer para operaciones de anotación.
Colaboración y Revisión
- Características Colaborativas: Permitir que múltiples usuarios anoten, comenten y colaboren en el mismo documento.
- Comparación de Documentos: Comparar documentos o imágenes lado a lado para resaltar diferencias.
- Respuestas a Anotaciones: Permitir que múltiples usuarios respondan a anotaciones, habilitando la revisión colaborativa de documentos.
Seguridad e Integridad de Documentos
- Seguridad de Documentos: Aplicar anot
aciones que puedan ocultar información sensible, como redacciones.
- Gestión de Metadatos: Gestionar y preservar los metadatos dentro de los documentos anotados.
Búsqueda y Navegación
- Capacidades Avanzadas de Búsqueda: Buscar dentro de documentos anotados, incluida la capacidad de buscar dentro de las anotaciones.
Rendimiento y Escalabilidad
- Procesamiento por Lotes: Manejar anotaciones en múltiples documentos a la vez para aumentar la eficiencia.
- Escalabilidad: Diseñado para manejar grandes volúmenes de documentos y anotaciones de manera eficiente.
- Alto Rendimiento: Optimizado para un procesamiento rápido de anotaciones y manejo de documentos.
Compatibilidad e Integración entre Plataformas
- Compatibilidad entre Plataformas: Utilizar en múltiples sistemas operativos, incluidos Windows, macOS y Linux.
- Integración Flexible: Integrar fácilmente en aplicaciones Java con un conjunto rico de funcionalidades de API.
Salida y Presentación
- Impresión y Guardado de Anotaciones: Incluir o excluir anotaciones al imprimir o guardar documentos.
Formatos de Documentos Soportados
Para algunos tipos de archivos, GroupDocs.Annotation guarda el resultado en un formato diferente. En este caso, el tipo de archivo de salida se especifica después de *
. Si no se especifica dicho símbolo, GroupDocs.Annotation guarda el resultado en el tipo de archivo original.
Formato | Descripción | Anotar |
---|---|---|
DOC | Documento de Microsoft Word® 97-2003 | ✔ |
DOCX | Documento de Microsoft Word® | ✔ |
DOCM | Documento con Macros Habilitadas de Microsoft Word® | ✔ |
DOT | Plantilla de Microsoft Word® 97-2003 | ✔ |
DOTX | Plantilla de Microsoft Word® | ✔ |
DOTM | Plantilla con Macros Habilitadas de Microsoft Word® | ✔ |
RTF | Documento de Texto Enriquecido | ✔ |
ODT | Texto de Documento Abierto | ✔ |
XLS | Hoja de Cálculo de Microsoft Excel® 97-2003 | ✔ |
XLSX | Hoja de Cálculo de Microsoft Excel® | ✔ |
XLSM (*xlsx) | Hoja de Cálculo con Macros Habilitadas de Microsoft Excel® | ✔ |
XLSB (*xlsx) | Hoja de Cálculo Binaria de Microsoft Excel® | ✔ |
ODS (*xlsx) | Hoja de Cálculo de Documento Abierto | ✔ |
PPT | Presentación de Microsoft PowerPoint® 97-2003 | ✔ |
PPTX | Presentación de Microsoft PowerPoint® | ✔ |
PPS | Presentación de Diapositivas de Microsoft PowerPoint® 97-2003 | ✔ |
PPSX (*pptx) | Presentación de Diapositivas de Microsoft PowerPoint® | ✔ |
ODP | Presentación de Documento Abierto | ✔ |
TIF, TIFF | Formato de Archivo de Imagen Etiquetada (TIFF) | ✔ |
JPG, JPEG | Grupo Conjunto de Expertos Fotográficos (JPEG) | ✔ |
PNG | Gráficos de Red Portátil (PNG) | ✔ |
BMP | Imagen de Mapa de Bits (BMP) | ✔ |
DWG (*png) | Formatos de Datos de Diseño de Autodesk® | ✔ |
DXF (*png) | Formato de Intercambio de Dibujos | ✔ |
PDF (PDF/A-1a,PDF/A-1b,PDF/A-2a) | Formato de Documento Portátil de Adobe (PDF) | ✔ |
HTM (*html) | Lenguaje de Marcado de Hipertexto (HTM) | ✔ |
HTML | Lenguaje de Marcado de Hipertexto (HTML) | ✔ |
EML | Mensaje de Correo Electrónico (EML) | ✔ |
EMLX (*eml) | Mensaje de Correo Electrónico (EMLX) | ✔ |
VSD (*vsdx) | Dibujo de Microsoft Visio® 2003-2010 | ✔ |
VSDX | Dibujo de Microsoft Visio® | ✔ |
VSDM (*vsdx) | Formato de Archivo de Dibujo de Microsoft Visio® | ✔ |
VSS (*vsdx) | Plantilla de Microsoft Visio® 2003-2010 | ✔ |
VSSX (*vsdx) | Formato de Archivo de Plantilla de Visio® | ✔ |
VST (*vsdx) | Plantilla de Microsoft Visio® 2013 | ✔ |
VSTM (*vsdx) | Formato de Archivo de Plantilla de Microsoft Visio® | ✔ |
Tipos de Anotaciones Soportados
Anotaciones Gráficas
- Área: Marca un área con un rectángulo y añade notas.
- Flecha: Dibuja una flecha en un documento.
- Distancia: Mide la distancia entre objetos en un documento.
- Elipse: Dibuja una anotación elíptica en un documento.
- Punto: Añade comentarios a cualquier punto de un documento.
- Polilínea: Dibuja formas y líneas a mano alzada.
- Redacción: Llena un rectángulo negro en una posición fija (utilizado para ocultar texto).
- Campo de Texto: Añade un rectángulo con texto dentro.
Anotaciones de Texto
- Resaltar: Resalta y comenta sobre el texto seleccionado.
- Reemplazo: Reemplaza el texto original con el texto del usuario.
- Tachado: Marca el texto con un estilo de tachado.
- Subrayado: Marca el texto con un estilo de subrayado.
Anotaciones de Marca de Agua
- Marca de Agua Horizontal: Añade una marca de agua de texto horizontal.
- Marca de Agua Diagonal: Añade una marca de agua de texto diagonal.
Requisitos del Sistema
GroupDocs.Annotation para Java soporta los siguientes Sistemas Operativos, Frameworks y Gestores de Paquetes:
Opciones Soportadas | |
---|---|
Sistemas Operativos | Microsoft Windows® de Escritorio |
Microsoft Windows® Servidor | |
Linux | |
MacOS | |
Frameworks Soportados | Java 7 (1.7) y superior |
Entornos de Desarrollo | NetBeans |
IntelliJ IDEA | |
Eclipse | |
Herramienta de Automatización de Construcción | Maven |
GroupDocs.Annotation para Java no requiere ningún software externo o herramienta de terceros para ser instalado. Simplemente siga una de las formas descritas en Instalación y Configuración.
Comenzar
GroupDocs aloja todas las APIs de Java en el Repositorio de GroupDocs. Puede usar fácilmente la API de GroupDocs.Annotation para Java directamente en sus proyectos Maven con configuraciones simples.
Paso 1: Especifique la Configuración del Repositorio de GroupDocs
Para empezar, debe especificar la configuración del repositorio de GroupDocs en su archivo Maven pom.xml
de la siguiente manera:
<repositories>
<repository>
<id>GroupDocs Artifact Repository</id>
<name>GroupDocs Artifact Repository</name>
<url>https://releases.groupdocs.com/java/repo/</url>
</repository>
</repositories>
Paso 2: Defina la Dependencia de la API de GroupDocs.Annotation para Java
A continuación, defina la dependencia de la API de GroupDocs.Annotation para Java en su archivo pom.xml
de la siguiente manera:
<dependencies>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-annotation</artifactId>
<version>23.10</version>
</dependency>
</dependencies>
Ejemplos de Código
Ejemplo de Código 1: Añadir una Anotación de Texto a un Documento PDF
Este fragmento de código demuestra cómo usar GroupDocs.Annotation para Java para añadir una anotación de texto a un documento PDF. La anotación de texto incluye un comentario o nota que aparece como una ventana emergente cuando el usuario pasa el cursor sobre el área anotada. Esta característica es
particularmente útil para revisar y comentar documentos PDF.
// Importar clases necesarias
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.models.Annotation;
import com.groupdocs.annotation.models.annotationtypes.TextAnnotation;
import com.groupdocs.annotation.options.export.AnnotationOptions;
import java.awt.Color;
import java.nio.file.Paths;
public class AddTextAnnotationToPDF {
public static void main(String[] args) {
// Ruta al documento PDF de entrada
String inputFilePath = "input.pdf";
// Ruta al documento PDF de salida
String outputFilePath = "output.pdf";
// Inicializar objeto Annotator para el documento PDF
Annotator annotator = new Annotator(inputFilePath);
// Crear una nueva anotación de texto
TextAnnotation textAnnotation = new TextAnnotation();
textAnnotation.setPageNumber(1); // Establecer número de página
textAnnotation.setMessage("Esta es una anotación de texto"); // Establecer mensaje de anotación
textAnnotation.setBox(new Rectangle(100, 100, 200, 50)); // Establecer posición y tamaño de la anotación
textAnnotation.setBackgroundColor(Color.yellow); // Establecer color de fondo de la anotación
textAnnotation.setFontColor(Color.black); // Establecer color de fuente para el texto de la anotación
// Añadir la anotación de texto al documento
annotator.add(textAnnotation);
// Guardar el documento PDF anotado
annotator.save(outputFilePath, new AnnotationOptions());
// Cerrar el annotator
annotator.dispose();
System.out.println("Anotación de texto añadida con éxito al documento PDF.");
}
}
Ejemplo de Código 2: Eliminar Anotaciones de un Documento Word
Este fragmento de código ilustra cómo eliminar todas las anotaciones de un documento Microsoft Word (DOCX) usando GroupDocs.Annotation para Java. Esto es especialmente útil cuando necesita limpiar un documento eliminando comentarios, notas u otros tipos de anotaciones.
// Importar clases necesarias
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.options.remove.RemoveOptions;
public class RemoveAnnotationsFromWordDocument {
public static void main(String[] args) {
// Ruta al documento Word de entrada
String inputFilePath = "input.docx";
// Ruta al documento Word de salida
String outputFilePath = "output.docx";
// Inicializar objeto Annotator para el documento Word
Annotator annotator = new Annotator(inputFilePath);
// Definir opciones de eliminación para eliminar todas las anotaciones
RemoveOptions removeOptions = new RemoveOptions();
// Eliminar todas las anotaciones del documento
annotator.remove(removeOptions);
// Guardar el documento Word limpio
annotator.save(outputFilePath);
// Cerrar el annotator
annotator.dispose();
System.out.println("Todas las anotaciones eliminadas con éxito del documento Word.");
}
}
Ejemplo de Código 3: Extraer Comentarios de una Hoja de Cálculo Excel
Este fragmento de código muestra cómo extraer comentarios y anotaciones de una hoja de cálculo Excel (XLSX) usando GroupDocs.Annotation para Java. Esta característica es beneficiosa para revisar y resumir retroalimentación o notas dejadas en un documento Excel.
// Importar clases necesarias
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.models.AnnotationBase;
import com.groupdocs.annotation.options.export.AnnotationOptions;
import java.util.List;
public class ExtractCommentsFromExcel {
public static void main(String[] args) {
// Ruta al documento Excel de entrada
String inputFilePath = "input.xlsx";
// Inicializar objeto Annotator para el documento Excel
Annotator annotator = new Annotator(inputFilePath);
// Extraer todas las anotaciones del documento
List<AnnotationBase> annotations = annotator.get();
// Iterar a través de las anotaciones extraídas y mostrar sus mensajes
for (AnnotationBase annotation : annotations) {
System.out.println("Tipo de Anotación: " + annotation.getAnnotationType());
System.out.println("Mensaje de Anotación: " + annotation.getMessage());
}
// Cerrar el annotator
annotator.dispose();
System.out.println("Comentarios extraídos con éxito de la hoja de cálculo Excel.");
}
}
Version | Release Date |
---|---|
24.6 | 30 de junio de 2024 |
23.10 | 9 de octubre de 2023 |
23.8 | 28 de agosto de 2023 |
23.6 | 23 de junio de 2023 |
23.4 | 17 de abril de 2023 |
23.2 | 16 de abril de 2023 |
21.7.2 | 25 de enero de 2022 |
21.7.1 | 25 de enero de 2022 |
2.0.0 | 25 de enero de 2022 |
19.2 | 25 de enero de 2022 |
17.10 | 25 de enero de 2022 |
17.10.3 | 25 de enero de 2022 |
1.5.0 | 25 de enero de 2022 |
21.7 | 21 de julio de 2021 |
19.7 | 19 de febrero de 2020 |
20.2 | 13 de febrero de 2020 |
19.5 | 30 de mayo de 2019 |
19.4 | 15 de abril de 2019 |
18.1 | 16 de octubre de 2018 |
18.10 | 16 de octubre de 2018 |
1.4.0 | 18 de abril de 2018 |
1.6.0 | 18 de abril de 2018 |
1.7.0 | 18 de abril de 2018 |
1.7.1 | 18 de abril de 2018 |
1.8.0 | 18 de abril de 2018 |
1.8.1 | 18 de abril de 2018 |
1.8.2 | 18 de abril de 2018 |
1.9.0 | 18 de abril de 2018 |
17.1.0 | 18 de abril de 2018 |
17.10.1 | 18 de abril de 2018 |
17.10.2 | 18 de abril de 2018 |
17.5.0 | 18 de abril de 2018 |
17.6.0 | 18 de abril de 2018 |
18.4 | 18 de abril de 2018 |
3.1.0 | 18 de abril de 2018 |
GroupDocs.Annotation Java API Anotación de Documentos Marcado de Agua Gestión de Documentos Anotación de PDF Anotación de Word Anotación de Excel Anotación de PowerPoint Anotación de Imágenes Soporte OLE Gestión de Metadatos Compatibilidad entre Plataformas Anotaciones de Texto Anotaciones de Área Anotaciones de Marcado Medición de Distancias Redacción Apariencia de Anotación Personalizada Revisión Colaborativa de Documentos Seguridad de Documentos Preservación de Metadatos Procesamiento por Lotes Alto Rendimiento Escalabilidad Compatibilidad entre Plataformas Impresión de Anotaciones Microsoft Word Microsoft Excel Microsoft PowerPoint PDF JPG PNG BMP DWG DXF Visio Formato de Documento Portátil de Adobe Lenguaje de Marcado de Hipertexto Mensaje de Correo Electrónico Herramientas de Anotación Java Maven Integración de API API Local Comparación de Documentos Integridad de Documentos