revision_number property

BuiltInDocumentProperties.revision_number property

Gets or sets the document revision number.

@property
def revision_number(self) -> int:
    ...

@revision_number.setter
def revision_number(self, value: int):
    ...

Remarks

Aspose.Words does not update this property.

Examples

Shows how to work with document properties in the “Origin” category.

# Open a document that we have created and edited using Microsoft Word.
doc = aw.Document(MY_DIR + "Properties.docx")
properties = doc.built_in_document_properties

# The following built-in properties contain information regarding the creation and editing of this document.
# We can right-click this document in Windows Explorer and find
# these properties via "Properties" -> "Details" -> "Origin" category.
# Fields such as PRINTDATE and EDITTIME can display these values in the document body.
print(f"Created using {properties.name_of_application}, on {properties.created_time}")
print("Minutes spent editing:", properties.total_editing_time)
print("Date/time last printed:", properties.last_printed)
print("Template document:", properties.template)

# We can also change the values of built-in properties.
properties.company = "Doe Ltd."
properties.manager = "Jane Doe"
properties.version = 5
properties.revision_number += 1

# Microsoft Word updates the following properties automatically when we save the document.
# To use these properties with Aspose.Words, we will need to set values for them manually.
properties.last_saved_by = "John Doe"
properties.last_saved_time = datetime.utcnow()

# We can right-click this document in Windows Explorer and find these properties in "Properties" -> "Details" -> "Origin".
doc.save(ARTIFACTS_DIR + "DocumentProperties.origin.docx")

Shows how to work with REVNUM fields.

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.write("Current revision #")

# Insert a REVNUM field, which displays the document's current revision number property.
field = builder.insert_field(aw.fields.FieldType.FIELD_REVISION_NUM, True).as_field_rev_num()

self.assertEqual(" REVNUM ", field.get_field_code())
self.assertEqual("1", field.result)
self.assertEqual(1, doc.built_in_document_properties.revision_number)

# This property counts how many times a document has been saved in Microsoft Word,
# and is unrelated to tracked revisions. We can find it by right clicking the document in Windows Explorer
# via Properties -> Details. We can update this property manually.
doc.built_in_document_properties.revision_number += 1
field.update()

self.assertEqual("2", field.result)

revision_number property

BuiltInDocumentProperties.revision_number property

Remarks

Examples

See Also