---
title: "Actualizando campos Python"
---

Normalmente, un campo insertado en Microsoft Word ya contiene un valor actualizado. Por ejemplo, si el campo es una fórmula o un número de página, contendrá el valor calculado correcto para la versión dada del documento. Pero si tiene una aplicación que genera o modifica un documento con campos, como fusionar dos documentos o completarlo con datos, lo ideal es que todos los campos se actualicen para que el documento sea útil.

## Cómo actualizar campos

Cuando se carga un documento, Aspose.Words imita el comportamiento de Microsoft Word con la opción de actualizar campos automáticamente desactivada. El comportamiento se puede resumir de la siguiente manera:

- cuando abres/guardas un documento, los campos permanecen intactos
- puede actualizar explícitamente todos los campos de un documento (por ejemplo, reconstruir TOC) cuando lo necesite
- cuando imprime/renderiza en PDF o XPS, los campos relacionados con la numeración de páginas en encabezados/pies de página se actualizan
- cuando ejecuta Mail Merge todos los campos se actualizan automáticamente

### Actualizar campos mediante programación

Para actualizar explícitamente los campos en todo el documento, simplemente llame a [update_fields](https://reference.aspose.com/words/python-net/aspose.words/document/update_fields/). Para actualizar campos contenidos en parte de un documento, obtenga un objeto [Range](https://reference.aspose.com/words/python-net/aspose.words/range/) y llame al método [update_fields](https://reference.aspose.com/words/python-net/aspose.words/range/update_fields/). En Aspose.Words, puede obtener un **Range** para cualquier nodo del árbol del documento, como [Section](https://reference.aspose.com/words/python-net/aspose.words/section/), [HeaderFooter](https://reference.aspose.com/words/python-net/aspose.words/headerfooter/), [Paragraph](https://reference.aspose.com/words/python-net/aspose.words/paragraph/), etc., utilizando la propiedad [Node.range](https://reference.aspose.com/words/python-net/aspose.words/node/range/). Puede actualizar el resultado de un solo campo llamando al método [update](https://reference.aspose.com/words/python-net/aspose.words.fields/field/update/).

### Actualización automática de campos relacionados con la página durante el renderizado

Cuando ejecuta la conversión de un documento a un formato de página fija, por ejemplo, a PDF o XPS, Aspose.Words actualizará automáticamente los campos `PAGE` relacionados con el diseño de página y `PAGEREF` se encuentra en los encabezados y pies de página del documento. Este comportamiento imita el comportamiento de Microsoft Word al imprimir un documento.

Si desea actualizar todos los demás campos del documento, debe llamar a [update_fields](https://reference.aspose.com/words/python-net/aspose.words/document/update_fields/) antes de procesar el documento.

El siguiente ejemplo de código muestra cómo actualizar todos los campos antes de representar un documento:

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-working_with_fields-UpdateDocFields.py" >}}

```

Puede descargar el archivo de muestra de este ejemplo desde [Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-Python-via-.NET/blob/master/Examples/Data/Rendering.docx).

```

### Actualización automática de campo durante Mail Merge

Cuando ejecuta un mail merge, todos los campos del documento se actualizarán automáticamente. Esto se debe a que el Mail Merge es un caso de actualización de campo. El programa encuentra un campo Mail Merge y necesita actualizar su resultado, lo que implica tomar el valor de la fuente de datos e insertarlo en el campo. Por supuesto, la lógica es más complicada, por ejemplo, cuando se llega al final del documento/región Mail Merge pero todavía hay más datos por fusionar, entonces es necesario duplicar la región y actualizar el nuevo conjunto de campos.

## Actualizar campos que tienen atributos sucios

w:dirty es un atributo a nivel de campo que actualizará solo el campo que especifique cuando se abra el documento. Le indica a MS Word que solo actualice este campo la próxima vez que se abra el documento. Puede utilizar la propiedad [update_dirty_fields](https://reference.aspose.com/words/python-net/aspose.words.loading/loadoptions/update_dirty_fields/) para especificar si se actualizan los campos con el atributo sucio. Cuando el valor de **actualizar_campos_sucios** se establece en `True`, todos los campos que tienen un valor `True` para la propiedad [Field.is_dirty](https://reference.aspose.com/words/python-net/aspose.words.fields/field/is_dirty/) o [FieldChar.is_dirty](https://reference.aspose.com/words/python-net/aspose.words.fields/fieldchar/is_dirty/) se actualizan al cargar el documento.

El siguiente ejemplo de código muestra cómo actualizar campos que tienen el atributo sucio:

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-File Formats and Conversions-Load Options-working_with_load_options-UpdateDirtyFields.py" >}}

## Actualizar la propiedad LastSavedTime antes de guardar

Puede utilizar la propiedad [SaveOptions.update_last_saved_time_property](https://reference.aspose.com/words/python-net/aspose.words.saving/saveoptions/update_last_saved_time_property/) para actualizar la propiedad [last_saved_time](https://reference.aspose.com/words/python-net/aspose.words.properties/builtindocumentproperties/last_saved_time/) del documento incorporado correspondiente al guardar el documento.

El siguiente ejemplo de código muestra cómo actualizar esta propiedad:

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-File Formats and Conversions-Save Options-working_with_ooxml_save_options-UpdateLastSavedTimeProperty.py" >}}