Gestión de propiedades de documentos

Introducción

Microsoft Excel ofrece la posibilidad de agregar propiedades a los archivos de hojas de cálculo. Estas propiedades del documento brindan información útil y se dividen en 2 categorías, como se detalla a continuación.

• Propiedades definidas por el sistema (integradas): las propiedades integradas contienen información general sobre el documento, como el título del documento, el nombre del autor, las estadísticas del documento, etc.
• Propiedades definidas por el usuario (personalizadas): propiedades personalizadas definidas por el usuario final en forma de par nombre-valor.

El punto más importante que debe conocer acerca de las propiedades integradas y personalizadas es que se puede acceder a las propiedades integradas y modificarlas, pero no se pueden crear ni eliminar; sin embargo, se pueden crear y administrar las propiedades personalizadas de los documentos.

Administrar las propiedades del documento usando Microsoft Excel

Microsoft Excel permite administrar las propiedades de los documentos de los archivos de Excel de manera WYSIWYG. Siga los pasos a continuación para abrir elPropiedades cuadro de diálogo en Excel 2016.

1. Desde elArchivo menú, seleccioneInformación.

Selección del menú de información

1. Haga clic enPropiedadesencabezado y seleccione “Propiedades avanzadas”.

Hacer clic en Selección de propiedades avanzadas

1. Administre las propiedades del documento del archivo.

Diálogo de propiedades
En el cuadro de diálogo Propiedades, hay diferentes pestañas, como General, Resumen, Estadísticas, Contenido y Aduanas. Cada pestaña ayuda a configurar diferentes tipos de información relacionada con el archivo. La pestaña Personalizado se utiliza para administrar las propiedades personalizadas.

Trabajar con propiedades de documentos usando Aspose.Cells

Los desarrolladores pueden administrar dinámicamente las propiedades del documento utilizando las API Aspose.Cells. Esta función ayuda a los desarrolladores a almacenar información útil junto con el archivo, como cuándo se recibió, procesó, marcó la hora, etc.

Aspose.Cells for Java escribe directamente la información sobre API y el número de versión en los documentos de salida. Por ejemplo, al renderizar Documento a PDF, Aspose.Cells for Java se rellenaSolicitud campo con valor ‘Aspose.Cells’ yPDF Productor campo con el valor, por ejemplo, ‘Aspose.Cells for Java v17.9’.

Tenga en cuenta que no puede indicar al Aspose.Cells for Java que cambie o elimine esta información de los documentos de salida.

Acceso a las propiedades del documento

Aspose.Cells Las API admiten ambos tipos de propiedades de documentos, integradas y personalizadas. Aspose.Cells'Libro de trabajo clase representa un archivo de Excel y, como un archivo de Excel, elLibro de trabajo La clase puede contener varias hojas de trabajo, cada una representada por elHoja de cálculo mientras que la colección de hojas de trabajo está representada por elColección de hojas de trabajoclase.

Utilizar elColección de hojas de trabajopara acceder a las propiedades del documento del archivo como se describe a continuación.

• Para acceder a las propiedades del documento incorporado, utiliceWorksheetCollection.BuiltInDocumentProperties.
• Para acceder a las propiedades del documento personalizado, use elWorksheetCollection.CustomDocumentProperties.

AmbosWorksheetCollection.BuiltInDocumentProperties yWorksheetCollection.CustomDocumentProperties devolver una instancia deDocumentPropertyCollection . Esta colección contieneDocumentoPropiedadobjetos, cada uno de los cuales representa una única propiedad de documento integrada o personalizada.

Queda a criterio de la solicitud cómo acceder a un inmueble, es decir; utilizando el índice o el nombre de la propiedad de laDocumentPropertyCollectioncomo se demuestra en el siguiente ejemplo.

ÉlDocumentoPropiedadclass permite recuperar el nombre, valor y tipo de la propiedad del documento:

• Para obtener el nombre de la propiedad, utiliceDocumentoPropiedad.Nombre.
• Para obtener el valor de la propiedad, utiliceDocumentoPropiedad.Valor. DocumentoPropiedad.Valordevuelve el valor como un objeto.
• Para obtener el tipo de propiedad, useDocumentProperty.Type . Esto devuelve uno de losTipo de propiedadvalores de enumeración.

Adición o eliminación de propiedades de documentos personalizados

Como describimos anteriormente al comienzo de este tema, los desarrolladores no pueden agregar o quitar propiedades integradas porque estas propiedades están definidas por el sistema, pero es posible agregar o quitar propiedades personalizadas porque están definidas por el usuario.

Adición de propiedades personalizadas

Aspose.Cells Las API han expuesto elagregar método para elCustomDocumentPropertyCollection class para agregar propiedades personalizadas a la colección. Élagregar agrega la propiedad al archivo de Excel y devuelve una referencia para la propiedad del nuevo documento como unDocumentoPropiedadobjeto.

Configuración de la propiedad personalizada “Enlace al contenido”

Para crear una propiedad personalizada vinculada al contenido de un rango determinado, llame alCustomDocumentPropertyCollection.addLinkToContent método y pase el nombre de la propiedad y la fuente. Puede comprobar si una propiedad está configurada como vinculada a contenido utilizando elDocumentProperty.isLinkedToContent propiedad. Además, también es posible obtener el rango de fuente usando elFuente propiedad de laDocumentoPropiedadclase.

Usamos una plantilla simple Microsoft archivo de Excel en el ejemplo. El libro de trabajo tiene un rango con nombre definido etiquetadoMiRango que se refiere a un valor de celda.

Eliminación de propiedades personalizadas

Para eliminar propiedades personalizadas usando Aspose.Cells, llame alDocumentPropertyCollection.remove y pase el nombre de la propiedad del documento que se eliminará.