Gestión de Propiedades del Documento
Introducción
Microsoft Excel proporciona la capacidad de agregar propiedades a los archivos de hojas de cálculo. Estas propiedades del documento proporcionan información útil y se dividen en 2 categorías como se detalla a continuación.
- Propiedades predeterminadas del sistema (integradas): Las propiedades integradas contienen información general sobre el documento, como el título del documento, el nombre del autor, estadísticas del documento, entre otros.
- Propiedades definidas por el usuario (personalizadas): Propiedades personalizadas definidas por el usuario final en forma de par nombre-valor.
Gestión de Propiedades del Documento Utilizando Microsoft Excel
Microsoft Excel permite gestionar las propiedades del documento de los archivos de Excel de manera WYSIWYG. Sigue los siguientes pasos para abrir el diálogo de Propiedades en Excel 2016.
- Desde el menú Archivo, seleccione Información.
| Seleccionar menú Información |
|---|
 |
- Haga clic en el encabezado Propiedades y seleccione “Propiedades avanzadas”.
| Haciendo clic en la selección de Propiedades avanzadas |
|---|
 |
- Administre las propiedades del documento del archivo.
| Cuadro de propiedades |
|---|
 |
| En el cuadro de propiedades, hay pestañas diferentes, como General, Resumen, Estadísticas, Contenidos y Aduanas. Cada pestaña ayuda a configurar diferentes tipos de información relacionada con el archivo. La pestaña Aduanas se usa para gestionar propiedades personalizadas. |
Trabajando con las propiedades del documento usando Aspose.Cells
Los desarrolladores pueden gestionar dinámicamente las propiedades del documento usando las APIs de Aspose.Cells. Esta característica ayuda a los desarrolladores a almacenar información útil junto con el archivo, como cuándo se recibió el archivo, se procesó, se marcó con la hora, y así sucesivamente.
Aspose.Cells for Java escribe directamente la información sobre la API y el número de versión en los documentos de salida. Por ejemplo, al representar un documento a PDF, Aspose.Cells for Java rellena el campo Aplicación con el valor ‘Aspose.Cells’ y el campo Productor de PDF con el valor, por ejemplo, ‘Aspose.Cells for Java v17.9’.
Tenga en cuenta que no puede instruir a Aspose.Cells for Java para cambiar o eliminar esta información de los Documentos de salida.
Accediendo a las propiedades del documento
Las APIs de Aspose.Cells admiten tanto tipos de propiedades de documentos integrados como personalizados. La clase Workbook de Aspose.Cells representa un archivo de Excel y, al igual que un archivo de Excel, la clase Workbook puede contener múltiples hojas de cálculo, cada uno representado por la clase Worksheet, mientras que la colección de hojas de cálculo es representada por la clase WorksheetCollection.
Utilice el WorksheetCollection para acceder a las propiedades del documento del archivo como se describe a continuación.
- Para acceder a las propiedades de documento integradas, use WorksheetCollection.BuiltInDocumentProperties.
- Para acceder a propiedades de documento personalizadas, utiliza el WorksheetCollection.CustomDocumentProperties.
Tanto el WorksheetCollection.BuiltInDocumentProperties como el WorksheetCollection.CustomDocumentProperties devuelven una instancia de DocumentPropertyCollection. Esta colección contiene objetos DocumentProperty, cada uno de los cuales representa una única propiedad de documento incorporada o personalizada.
Depende de los requisitos de la aplicación cómo acceder a una propiedad, es decir; utilizando el índice o el nombre de la propiedad de DocumentPropertyCollection como se demuestra en el ejemplo a continuación.
La clase DocumentProperty permite recuperar el nombre, valor y tipo de la propiedad del documento:
- Para obtener el nombre de la propiedad, use DocumentProperty.Name.
- Para obtener el valor de la propiedad, use DocumentProperty.Value. DocumentProperty.Value devuelve el valor como un Objeto.
- Para obtener el tipo de propiedad, use DocumentProperty.Type. Esto devuelve uno de los valores de enumeración PropertyType.
Agregar o Quitar Propiedades de Documentos Personalizadas
Como hemos descrito anteriormente al principio de este tema, los desarrolladores no pueden agregar o eliminar propiedades integradas porque estas propiedades están definidas por el sistema, pero es posible agregar o eliminar propiedades personalizadas porque estas son definidas por el usuario.
Agregar Propiedades Personalizadas
Las APIs de Aspose.Cells han expuesto el método add para la clase CustomDocumentPropertyCollection con el fin de agregar propiedades personalizadas a la colección. El método add agrega la propiedad al archivo de Excel y devuelve una referencia para la nueva propiedad del documento como un objeto DocumentProperty.
Configurar la Propiedad Personalizada “Vincular al Contenido”
Para crear una propiedad personalizada vinculada al contenido de un rango dado, llame al método CustomDocumentPropertyCollection.addLinkToContent y pase el nombre de la propiedad y la fuente. Puede verificar si una propiedad está configurada como vinculada con el contenido usando la propiedad DocumentProperty.isLinkedToContent. Además, también es posible obtener el rango de origen utilizando la propiedad Source de la clase DocumentProperty
Utilizamos un archivo de plantilla simple de Microsoft Excel en el ejemplo. El libro de trabajo tiene un rango con nombre definido etiquetado como MiRango que se refiere a un valor de celda.
Eliminar Propiedades Personalizadas
Para eliminar propiedades personalizadas mediante Aspose.Cells, llame al método DocumentPropertyCollection.remove y pase el nombre de la propiedad del documento que se va a eliminar.