ows_UIVersion oder wie SharePoint Versionen speichert

Standardmässig gibt SharePoint in einem SPQuery oder SPSiteDataQuery alle Listen-Elemente zurück geben, welche der jeweilge Benutzer aufgrund seiner Berechtigung sehen darf. Ist der Benutzer auf der Liste berechtigt, neue Elemente anzulegen respektive Elemente zu bearbeiten, so wird das SPQuery auch Elemente in Draft-Versionen zurück geben.

Dieses Verhalten kann z.B. in einem News-Szenario gefährlich sein: Stellen wir uns vor, dass eine brisante Nachricht erst zu einem bestimmten Zeitpunkt veröffentlicht werden soll. Der Editor/Publisher erstellt das entsprechende Listenelement (Seite, Dokument etc.) und stellt eine zeitgesteuerte Publikation ein. Die Version des Elements ist 0.x bis zum (timer-job gesteurten) Publikation. Ist aber irgendwo auf der SharePoint Seite ein WebPart vorhanden, welches über SPQuery die News aggregiert wird dieses für den Editor/Publisher bereits sichtbar sein. Eventuell unelegant - wenn an unerwarteter Stelle bereits eine noch nicht öffentliche News am Bildschirm erscheint...

Um in SPQuery einen Filter nach der Version der Listenelemente einzubauen muss man die Versionierung von SharePoint zuerst einmal verstehen. SharePoint verwendet 2 Felder um die Versionsnummer eines Listen-Elements zu speichern: "ows_UIVersion" (Zahl) und "ows_UIVersionString" (Zeichenkette):

• Der UIVersionString beinhaltet die aktuelle Version "0.5", allerdings ist eine Zeichenkette als Filter nicht sehr gut geeignet.
• UIVersion ist eine Zahl, als Filter gut geeignet und ist "5".

Soweit so gut, entscheiden wir uns also für UIVersion als Filter. Nun müssen wir herausfinden, wie SharePoint die gesamte Version eines Listenelements in diesem Feld speichert. Dies ist etwas für die Mathematiker unter uns:

• Die Major Version berechnet sich als Quotient aus UIVersion / 512
• Die Minor Version berechnet sich aus dem Rest, welcher sich aus dem obigen Quotienten ergibt.

Wem das zu mathematisch ist, hier eine kleine Tabelle:

UIVersionString	UIVersion
0.1	1
0.2	2
0.3	3
1.0	512
1.1	513
1.2	514
1.3	515
2.0	1024
2.1	1025
2.2	1026
2.3	1027
3.0	1536
4.0	2048
5.0	2560
6.0	3072
7.0	3584
8.0	4096
9.0	4608
10.0	5120

Mit folgendem Code können aus dem Feld "ows_UIVersion" die Major- und Minor-Versionen herausgelesen werden:

            long majorVersion = ows_UIVersion/ 512;
            long minorVersion = 0;
            Math.DivRem(ows_UIVersion, 512, out minorVersion);

Und nun endlich auch noch zum CAML-Query. Um sicherzuestellen, dass nur Listenelemente zurückgegeben werden, welche über mindestens eine Major-Version verfügen, also veröffentlicht wurden, kann man folgendes Query benutzen:

<Where>
</Where>

PS: Wäre interessant zu wissen, was passiert, wenn man mehr als 511 Draft-Versionen erstellt

Kommentar

Kommentar hinterlassen Name: Email: Ihre URL: Kommentare: Sicherheitscode eingeben: