5.6. Querying message revisions of existing IDERI note messages
In chapter 5.5 we modified some existing IDERI note messages which resulted in the creation fo new IDERI note message revisions. Now we will learn how we can query these revisions for further information processing.
5.6.1. Querying message revisions
To get full information about all existing revisions of an IDERI note message
we can use the Get-iNoteMessageRevision CmdLet.
PS> Get-iNoteMessageRevision -Index 4 | Sort-Object `
RevisionIndex -Descending | Format-Table
Index Revis... Text StartTime EndTime Recipient
----- -------- ---- --------- ------- ---------
4 2 My changed... 8/3/2023 8:38... 8/3/2023 10:38... {NOTE\ev..
4 1 This is a ... 8/3/2023 8:15... 8/3/2023 2:30:... {NOTE\ev..
The command in the example above queries all existing revisions of the IDERI note message with index 4, sorts them based on the property RevisionIndex and shows the object properties in a table view.
5.6.2. Querying for a certain message revision
To query only for a specific message revision of an IDERI note message we must use
the parameter -RevisionIndex with the Get-iNoteMessageRevsion CmdLet.
PS> Get-iNoteMessageRevision -Index 4 -RevisionIndex 2
Index : 4
RevisionIndex : 2
Text : My changed text for the new revision.
Priority : Information
StartTime : 8/3/2023 8:38:11 AM
EndTime : 8/3/2023 10:38:11 AM
LinkText : A link to iderinote.com
LinkTarget : https://www.iderinote.com
ShowLinkMaximized : False
Recipient : {NOTE\eva.smith, NOTE\albert.tross, NOTE\Arno.Nym}
Exclude : {}
AddressingMode : UserOnly
ShowPopup : True
ShowTicker : False
ShowFullscreen : False
ShowFullscreenAndLock : False
NotifyReceive : True
NotifyAcknowledge : False
ShowOnWinLogon : False
ShowOnWinLogonOnly : False
HomeOfficeUsersOnly : False
HomeOfficeUsersExclude : False
RevisionCreated : 8/3/2023 8:38:24 AM
RevisionUpdater : NOTE\adam.sam
With the command in the example above we have queried for the second revision of the IDERI note message with index 4.