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)

See Also