What is the best way to update the page only if change in the content is detected?

Question

We have several automation scripts that run every day and generate confluence pages with various data.

What is the best way to avoid having a new page history version in case nothing has changed on the page when the script run?

* I was thinking about comparing two last page versions and if there is no change in the content, drop the newest one. But that needs Space admin privilege which is no go.
* I was thinking about caching the last processed content in the script itself and comparing it with the page content before updating. But thanks to various confluence markdown features (like _emphasis_ converts to emphasis etc) this isn't an option
* ???

So probably what I need is the option to simulate how the confluence HTML code would look like when the processed content is published and compare it with the existing one grabbed from the confluence page?

PS: I need an API approach because of the automation

PPS: Why Confluence creates a new page history version even though nothing has changed? Can this behavior be modified?

Ondrej Šebela · Answer

We have several generated confluence pages, but in general, I grab some data (like Active Directory groups), convert them to HTML via the official PowerShell command ConvertTo-ConfluenceStorageFormat which returns HTML string

So I guess I should compare it to the HTML retrieved via GET webrequest mentioned in previous post right?

Andrii Maliuta · Answer

@Ondrej Šebela ,

Could you please elaborate on what and how this script works in general?

So, if you have some HTML data from other source and when you get it you just get the BODY ('view' representation) of the page via REST API (in your example .NET/C#/PShell, I suppose) and compare the String of the page body and the String of the HTML you have. If they are equal , you do not create new version of the page by updating it (HTTP 'PUT').

Ondrej Šebela · Answer

So you mean retrieving current page content via:

((Invoke-WebRequest -Method GET -Headers $header -Uri "$baseUri/rest/api/content/$pageID`?expand=body.storage").Content | ConvertFrom-Json).body.storage.valueAnd compare it with the new content:"somenewcontent" | ConvertTo-ConfluenceStorageFormat