Dependencies-Service: Unterschied zwischen den Versionen

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen
 
(25 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
 +
''Ab Version 2.1.0''
 +
 +
==Beschreibung==
 
Der Dependencies-Service hat die Aufgabe alle Änderungen des Systems zu überwachen und alle Artikel, die von den Änderungen betroffen sind, neu zu generieren.
 
Der Dependencies-Service hat die Aufgabe alle Änderungen des Systems zu überwachen und alle Artikel, die von den Änderungen betroffen sind, neu zu generieren.
  
Um entscheiden zu können welche Artikel neu generiert werden müssen, wird während der Generierung ermittelt welche Daten das Template anfordert. Gespeichert werden ID und Feldname der angeforderten Daten. Diese gepeicherte ID-Feldname Kombination wird dann auf Änderungen überwacht. Für denen Publikationsbereich diese Daten separat gespeichert.
+
Um entscheiden zu können welche Artikel neu generiert werden müssen, wird während der Generierung ermittelt welche Daten das Template anfordert. Gespeichert werden ID und Feldname der angeforderten Daten. Diese gepeicherte ID-Feldname Kombination wird dann auf Änderungen überwacht. Für jeden Publikationsbereich werden diese Daten separat gespeichert.
 +
 
  
 
===Auf Änderungen reagieren===
 
===Auf Änderungen reagieren===
 +
<div class="note">''Die Überwachung der Felder <code>elements</code> und <code>allElements</code> ist im Standard-Fall deaktiviert, da in alt-Systemen eine zu hohe Anzahl an Abhängigkeiten existieren könnten.''</div>
  
 
* '''Neues Element'''
 
* '''Neues Element'''
Zeile 16: Zeile 21:
 
** Enthält das neue Element / der neue Pool Verknüpfungen wird geprüfen ob die Verknüpfungsziele Suchabfragen besitzen. In diesem Fall werden die Suchabfragen der Artikels ausführen. Bei Änderungen von Suchergebnissen werden die entsprechenden Verknüpfungsziele neu generiert.
 
** Enthält das neue Element / der neue Pool Verknüpfungen wird geprüfen ob die Verknüpfungsziele Suchabfragen besitzen. In diesem Fall werden die Suchabfragen der Artikels ausführen. Bei Änderungen von Suchergebnissen werden die entsprechenden Verknüpfungsziele neu generiert.
 
** Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
 
** Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
 +
** Existieren Verknüpfungen auf andere Elemente, werden alle Artikel neu generiert auf die verlinkt wurde und die das Feld <code>referrerLinks</code> verwendet haben.
  
 
* '''Element geändert'''
 
* '''Element geändert'''
 
** Wenn sich der Dateiname geändert hat, werden alle Artikel neu generiert, für die das Feld <code>filename</code> oder <code>url</code> des geänderten Elementes überwacht wird.
 
** Wenn sich der Dateiname geändert hat, werden alle Artikel neu generiert, für die das Feld <code>filename</code> oder <code>url</code> des geänderten Elementes überwacht wird.
 
** Wenn sich der originale Dateiname geändert hat, werden alle Artikel neu generiert, für die das Feld <code>originalFilename</code> des geänderten Elementes überwacht wird.
 
** Wenn sich der originale Dateiname geändert hat, werden alle Artikel neu generiert, für die das Feld <code>originalFilename</code> des geänderten Elementes überwacht wird.
 +
 +
* '''Template-Suffix geändert'''
 +
** Wenn sich der Suffix eines Template geändert hat, werden alle Artikel neu generiert, für die das Feld <code>suffix</code> des geänderten Templates überwacht wird. Weiter werden alle Artikel neu generiert bei denen sie der Dateiname der Seite aufgrund des geänderten Suffix ändert. Alle so generierten Artikel besitzen dadurch eine neue URL, so das anschließend alle Artikel neu generiert werden, für die das Feld <code>url</code> der generierten Artikel überwacht wird.
  
 
* '''Pool geändert'''
 
* '''Pool geändert'''
Zeile 29: Zeile 38:
 
** Es werden alle Artikel generiert, für die die neuen, geänderten oder gelöschten Content-Felder des geänderten Elementes/Pools überwacht werden.
 
** Es werden alle Artikel generiert, für die die neuen, geänderten oder gelöschten Content-Felder des geänderten Elementes/Pools überwacht werden.
 
** Enthält das Element / der Pool neue Verknüpfungen wird geprüfen ob die Verknüpfungsziele Suchabfragen besitzen. In diesem Fall werden die Suchabfragen der Artikels ausführen. Bei Änderungen von Suchergebnissen werden die entsprechenden Verknüpfungsziele neu generiert.
 
** Enthält das Element / der Pool neue Verknüpfungen wird geprüfen ob die Verknüpfungsziele Suchabfragen besitzen. In diesem Fall werden die Suchabfragen der Artikels ausführen. Bei Änderungen von Suchergebnissen werden die entsprechenden Verknüpfungsziele neu generiert.
** Wurden bestehende Verknüpfungen des Elementes / des Pools gelöscht wird geprüfen, ob bisherige Verknüpfungsziele Suchabfragen besitzen und der geänderte Artikel Treffer einer dieser Suchabfragen war. In diese Fall wird das bisherige Verknüpfungsziele neu generiert.
+
** Wurden bestehende Verknüpfungen des Elementes / des Pools gelöscht wird geprüfen ob die Verknüpfungsziele Suchabfragen besitzen. In diesem Fall werden die Suchabfragen der Artikels ausführen. Bei Änderungen von Suchergebnissen werden die entsprechenden Verknüpfungsziele neu generiert.
 +
** Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
 +
** Sind Verknüpfungen erzeugt, geändert oder gelöscht worden, werden alle Artikel neu generiert auf die verlinkt wird/wurde und die das Feld <code>referrerLinks</code> verwendet haben.
 +
 
 +
* '''Artikel publiziert'''
 +
** Es werden alle Artikel neu generiert, für die das Feld <code>url</code> des publizierten Artikels überwacht wird.
 +
** Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
 +
 
 +
* '''Artikel depubliziert'''
 +
** Es werden alle Artikel neu generiert, für die das Feld <code>url</code> des depublizierten Artikels überwacht wird.
 
** Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
 
** Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
  
 
* '''Element gelöscht'''
 
* '''Element gelöscht'''
** Es werden alle Artikel neu generiert, für die das Feld <code>elements</code> des übergeordneten Pools des gelöschten Elementes überwacht wird. Existierten Symlinks auf das Element werden auch die Artikel neu generiert, für die das Feld <code>elements</code> der Pools der Symlinks überwacht wird.
+
** Es werden alle Artikel neu generiert, für die das Feld <code>elements</code> des übergeordneten Pools des gelöschten Elementes überwacht wird.
** Es werden alle Artikel neu generiert, für die das Feld <code>allElements</code> aller übergeordneten Pools des gelöschten Elementes überwacht wird. Existierten Symlinks auf das Element werden auch die Artikel neu generiert, für die das Feld <code>allElements</code> aller übergeordneten Pools des gelöschten Elementes überwacht wird.
+
** Es werden alle Artikel neu generiert, für die das Feld <code>allElements</code> aller übergeordneten Pools des gelöschten Elementes überwacht wird.
  
 
* '''Pool gelöscht'''
 
* '''Pool gelöscht'''
 
** Es werden alle Artikel neu generiert, für die das Feld <code>pools</code> des übergeordneten Pools des gelöschten Pools überwacht wird.
 
** Es werden alle Artikel neu generiert, für die das Feld <code>pools</code> des übergeordneten Pools des gelöschten Pools überwacht wird.
 
** Es werden alle Artikel neu generiert, für die das Feld <code>allPools</code> aller übergeordneten Pools des gelöschten Pools überwacht wird.
 
** Es werden alle Artikel neu generiert, für die das Feld <code>allPools</code> aller übergeordneten Pools des gelöschten Pools überwacht wird.
 +
** Es werden alle Artikel neu generiert, die noch die Personalisierungsdaten des Pools verwenden.
  
 
* '''Element / Pool gelöscht'''
 
* '''Element / Pool gelöscht'''
Zeile 52: Zeile 71:
 
** Es werden alle Artikel neu generiert, für die das Feld <code>allElements</code> aller ursprünglichen übergeordneten Pools überwacht wird.
 
** Es werden alle Artikel neu generiert, für die das Feld <code>allElements</code> aller ursprünglichen übergeordneten Pools überwacht wird.
 
** Es werden alle Artikel neu generiert, für die das Feld <code>allElements</code> aller neuen übergeordneten Pools überwacht wird.
 
** Es werden alle Artikel neu generiert, für die das Feld <code>allElements</code> aller neuen übergeordneten Pools überwacht wird.
 +
** Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
  
 
* '''Pool verschoben'''
 
* '''Pool verschoben'''
Zeile 61: Zeile 81:
 
** Es werden alle Artikel neu generiert, für die das Feld <code>allPools</code> aller neuen übergeordneten Pools überwacht wird.
 
** Es werden alle Artikel neu generiert, für die das Feld <code>allPools</code> aller neuen übergeordneten Pools überwacht wird.
 
** Wenn sich der Verzeichnispfad des neue übergeordneten Pools von dem des ursprünglichen übergeordneten Pools unterscheidet, werden alle Artikel des Pools und alle Artikel aller Unterpools neu generiert. Alle so generierten Artikel besitzen dadurch eine neue URL, so das anschließend alle Artikel neu generiert werden, für die das Feld <code>url</code> der generierten Artikel überwacht wird.
 
** Wenn sich der Verzeichnispfad des neue übergeordneten Pools von dem des ursprünglichen übergeordneten Pools unterscheidet, werden alle Artikel des Pools und alle Artikel aller Unterpools neu generiert. Alle so generierten Artikel besitzen dadurch eine neue URL, so das anschließend alle Artikel neu generiert werden, für die das Feld <code>url</code> der generierten Artikel überwacht wird.
 +
** Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
  
 
* '''Neuer Symlink'''
 
* '''Neuer Symlink'''
Zeile 78: Zeile 99:
 
** Es werden alle Artikel neu generiert, für die das Feld <code>allElements</code> aller ursprünglichen übergeordneten Pools überwacht wird.
 
** Es werden alle Artikel neu generiert, für die das Feld <code>allElements</code> aller ursprünglichen übergeordneten Pools überwacht wird.
 
** Es werden alle Artikel neu generiert, für die das Feld <code>allElements</code> aller neuen übergeordneten Pools überwacht wird.
 
** Es werden alle Artikel neu generiert, für die das Feld <code>allElements</code> aller neuen übergeordneten Pools überwacht wird.
 
 
  
 
===Zu überwachende Felder protokollieren===
 
===Zu überwachende Felder protokollieren===
Zeile 85: Zeile 104:
 
Bestimmte Feldnamen, die auf Änderungen identisch reagieren müssen werden zu einem symbolischen Feldnamen zusammengefasst. Z.B. wird <code>url</code>, <code>absoluteUrl</code> und <code>relativeUrl</code> zu dem Feldnamen <code>url</code> zusammengefasst. Auch Funktionsaufrufe wie <code>url(publisher)</code> werden überwacht.
 
Bestimmte Feldnamen, die auf Änderungen identisch reagieren müssen werden zu einem symbolischen Feldnamen zusammengefasst. Z.B. wird <code>url</code>, <code>absoluteUrl</code> und <code>relativeUrl</code> zu dem Feldnamen <code>url</code> zusammengefasst. Auch Funktionsaufrufe wie <code>url(publisher)</code> werden überwacht.
  
Es gibt Felder, bei denen auf jeder Änderung die Seite neu generiert werden muß. Für diese Felder wird der Feldname <code>*</code> protokolliert.
+
Es gibt Felder, bei denen auf jede Änderung die Seite neu generiert werden muß. Für diese Felder wird der Feldname <code>*</code> protokolliert.
  
 
Hier die vollständige Liste aller überwachten Felder
 
Hier die vollständige Liste aller überwachten Felder
 
{| class="prettytable sortable"
 
{| class="prettytable sortable"
 
|- class="hintergrundfarbe1"
 
|- class="hintergrundfarbe1"
! Feldnamen || protokollierter Feldnamen || neu Generierung || Bemerkung
+
! Feldnamen || protokollierter Feldnamen || neu Generierung
 
|-
 
|-
 
|<code>name</code>
 
|<code>name</code>
Zeile 96: Zeile 115:
 
|
 
|
 
* Name des Elements wurde geändert
 
* Name des Elements wurde geändert
|
 
 
|-
 
|-
 
|<code>comment</code>
 
|<code>comment</code>
Zeile 102: Zeile 120:
 
|
 
|
 
* Kommentar des Elements wurde geändert
 
* Kommentar des Elements wurde geändert
|
 
 
|-
 
|-
 
|<code>type</code>
 
|<code>type</code>
Zeile 108: Zeile 125:
 
|
 
|
 
* Typ des Elements wurde geändert
 
* Typ des Elements wurde geändert
|
 
 
|-
 
|-
 
|<code>version</code>
 
|<code>version</code>
Zeile 114: Zeile 130:
 
|
 
|
 
* jede Änderung
 
* jede Änderung
|
 
 
|-
 
|-
 
|<code>changedBy</code>
 
|<code>changedBy</code>
Zeile 120: Zeile 135:
 
|
 
|
 
* jede Änderung
 
* jede Änderung
|
 
 
|-
 
|-
 
|<code>changed</code>
 
|<code>changed</code>
Zeile 126: Zeile 140:
 
|
 
|
 
* jede Änderung
 
* jede Änderung
|
 
 
|-
 
|-
 
|<code>url</code>
 
|<code>url</code>
Zeile 143: Zeile 156:
 
* Verzeichnis eines übergeordneten Pools geändert
 
* Verzeichnis eines übergeordneten Pools geändert
 
* Übergeordneter Pool verschoben
 
* Übergeordneter Pool verschoben
 +
* Artikel publiziert
 +
* Artikel depubliziert
 +
Dieses Feld wird auch protokolliert wenn nicht direkt die URL des Artikels, sondern die URL eines Mediums des Artikels verwendet wird.
 +
|-
 +
|<code>referrerLinks</code>
 +
|<code>referrerLinks</code>
 
|
 
|
 +
* Neue Verknüpfung auf das Element
 +
* Verknüpfung auf das Element wurde gelöscht
 
|-
 
|-
 
|<code>publicationStates</code>
 
|<code>publicationStates</code>
Zeile 149: Zeile 170:
 
|
 
|
 
* jede Änderung
 
* jede Änderung
|
 
 
|-
 
|-
 
|Content-Felder
 
|Content-Felder
Zeile 155: Zeile 175:
 
|
 
|
 
* Änderung des entsprechenden Feldes (nur erste Ebene)
 
* Änderung des entsprechenden Feldes (nur erste Ebene)
| Für die frei definierbaren Content-Felder wird dessen Feldname protokolliert. Feldnamen werden nur für die erste Ebene protokolliert. Wird z.B. in einem Template das Feld <code>${article}.mylist[0].mytext</code> abgefragt, so der Feldname <code>mylist</code> protokolliert. Die Seite wird dann auch generiert, wenn sich etwas unterhalb von <code>mylist</code> ändert.
+
:Für die frei definierbaren Content-Felder wird dessen Feldname protokolliert. Feldnamen werden nur für die erste Ebene protokolliert. Wird z.B. in einem Template das Feld <code>${article}.mylist[0].mytext</code> abgefragt, so der Feldname <code>mylist</code> protokolliert. Die Seite wird dann auch generiert, wenn sich etwas unterhalb von <code>mylist</code> ändert.
 
|-
 
|-
! colspan="4" align="left"| Artikel-Felder
+
! colspan="3" align="left"| Artikel-Felder
 
|-
 
|-
 
|<code>filename</code>
 
|<code>filename</code>
Zeile 163: Zeile 183:
 
|
 
|
 
* Dateiname des Elements wurde geändert
 
* Dateiname des Elements wurde geändert
|
 
 
|-
 
|-
 
|<code>originalFilename</code>
 
|<code>originalFilename</code>
Zeile 169: Zeile 188:
 
|
 
|
 
* Originaler Dateiname des Elements wurde geändert
 
* Originaler Dateiname des Elements wurde geändert
|
 
 
|-
 
|-
! colspan="4" align="left"| Medien-Artikel-Felder
+
! colspan="3" align="left"| Medien-Artikel-Felder
 
|-
 
|-
 
|<code>filesize</code>
 
|<code>filesize</code>
Zeile 177: Zeile 195:
 
|
 
|
 
* jede Änderung
 
* jede Änderung
|
 
 
|-
 
|-
 
|<code>filename</code>
 
|<code>filename</code>
Zeile 183: Zeile 200:
 
|
 
|
 
* jede Änderung
 
* jede Änderung
|
 
 
|-
 
|-
 
|<code>mime</code>
 
|<code>mime</code>
Zeile 189: Zeile 205:
 
|
 
|
 
* jede Änderung
 
* jede Änderung
|
 
 
|-
 
|-
 
|<code>format</code>
 
|<code>format</code>
Zeile 195: Zeile 210:
 
|
 
|
 
* jede Änderung
 
* jede Änderung
|
 
 
|-
 
|-
 
|<code>isImage</code>
 
|<code>isImage</code>
Zeile 201: Zeile 215:
 
|
 
|
 
* jede Änderung
 
* jede Änderung
|
 
 
|-
 
|-
 
|<code>width</code>
 
|<code>width</code>
Zeile 207: Zeile 220:
 
|
 
|
 
* jede Änderung
 
* jede Änderung
|
 
 
|-
 
|-
 
|<code>height</code>
 
|<code>height</code>
Zeile 213: Zeile 225:
 
|
 
|
 
* jede Änderung
 
* jede Änderung
|
 
 
|-
 
|-
 
|<code>media</code>
 
|<code>media</code>
Zeile 219: Zeile 230:
 
|
 
|
 
* jede Änderung
 
* jede Änderung
|
 
 
|-
 
|-
! colspan="4" align="left"| Template-Felder
+
! colspan="3" align="left"| Template-Felder
 
|-
 
|-
 
|<code>source</code>
 
|<code>source</code>
Zeile 227: Zeile 237:
 
|
 
|
 
* Änderungen im Template-Quelltext
 
* Änderungen im Template-Quelltext
|
 
 
|-
 
|-
 
|<code>suffix</code>
 
|<code>suffix</code>
Zeile 233: Zeile 242:
 
|
 
|
 
* Änderung des Template-Suffix
 
* Änderung des Template-Suffix
|
 
 
|-
 
|-
! colspan="4" align="left"| Artikel-Pool-Felder
+
! colspan="3" align="left"| Artikel-Pool-Felder
 
|-
 
|-
 
|<code>dir</code>
 
|<code>dir</code>
Zeile 241: Zeile 249:
 
|
 
|
 
* Änderung des Verzeichnisses
 
* Änderung des Verzeichnisses
|
 
 
|-
 
|-
! colspan="4" align="left"| Pool-Felder
+
! colspan="3" align="left"| Pool-Felder
 
|-
 
|-
 
|<code>parent</code>
 
|<code>parent</code>
Zeile 249: Zeile 256:
 
|
 
|
 
* Element wurde in einen anderen Pool verschoben
 
* Element wurde in einen anderen Pool verschoben
|
 
 
|-
 
|-
 
|<code>stepParents</code>
 
|<code>stepParents</code>
Zeile 255: Zeile 261:
 
|
 
|
 
* Für das Element wurde ein Symlink angelegt oder gelöscht
 
* Für das Element wurde ein Symlink angelegt oder gelöscht
|
 
 
|-
 
|-
 
|<code>path</code>
 
|<code>path</code>
Zeile 261: Zeile 266:
 
|
 
|
 
* Übergeordneter Pool wurde in einen anderen Pool verschoben
 
* Übergeordneter Pool wurde in einen anderen Pool verschoben
|
 
 
|-
 
|-
 
|<code>elements</code>
 
|<code>elements</code>
 +
<code>sortedElements</code>
 
<code>hasChildren</code>
 
<code>hasChildren</code>
 
|<code>elements</code>
 
|<code>elements</code>
 
|
 
|
 +
<div class="note">''Die Überwachung dieses Feldes ist im Standard-Fall deaktiviert, da in alt-Systemen eine zu hohe Anzahl an Abhängigkeiten existieren könnten.''</div>
 
* In dem Pool wurde ein Element angelegt
 
* In dem Pool wurde ein Element angelegt
 
* In dem Pool wurde ein Element gelöscht
 
* In dem Pool wurde ein Element gelöscht
Zeile 272: Zeile 278:
 
* Ein Symlink wurde in dem Pool erzeugt
 
* Ein Symlink wurde in dem Pool erzeugt
 
* Ein Symlink wurde in dem Pool gelöscht
 
* Ein Symlink wurde in dem Pool gelöscht
|
 
 
|-
 
|-
 
|<code>allElements</code>
 
|<code>allElements</code>
 
|<code>allElements</code>
 
|<code>allElements</code>
 
|
 
|
 +
<div class="note">''Die Überwachung dieses Feldes ist im Standard-Fall deaktiviert, da in alt-Systemen eine zu hohe Anzahl an Abhängigkeiten existieren könnten.''</div>
 
* In dem Pool oder einem untergeordnetem Pool wurde ein Element angelegt
 
* In dem Pool oder einem untergeordnetem Pool wurde ein Element angelegt
 
* In dem Pool oder einem untergeordnetem Pool wurde ein Element gelöscht
 
* In dem Pool oder einem untergeordnetem Pool wurde ein Element gelöscht
Zeile 282: Zeile 288:
 
* Ein Symlink wurde in dem Pool oder einem untergeordnetem Pool erzeugt
 
* Ein Symlink wurde in dem Pool oder einem untergeordnetem Pool erzeugt
 
* Ein Symlink wurde in dem Pool oder einem untergeordnetem Pool gelöscht
 
* Ein Symlink wurde in dem Pool oder einem untergeordnetem Pool gelöscht
|
 
 
|-
 
|-
 
|<code>pools</code>
 
|<code>pools</code>
 +
<code>sortedPools</code>
 
<code>hasChildren</code>
 
<code>hasChildren</code>
 
|<code>pools</code>
 
|<code>pools</code>
Zeile 291: Zeile 297:
 
* In dem Pool wurde ein Pool gelöscht
 
* In dem Pool wurde ein Pool gelöscht
 
* Ein Pool wurde in den Pool verschoben
 
* Ein Pool wurde in den Pool verschoben
|
 
 
|-
 
|-
 
|<code>allPools</code>
 
|<code>allPools</code>
Zeile 299: Zeile 304:
 
* In dem Pool oder einem untergeordnetem Pool wurde ein Pool gelöscht
 
* In dem Pool oder einem untergeordnetem Pool wurde ein Pool gelöscht
 
* Ein Pool wurde in den Pool oder einem untergeordnetem Pool verschoben
 
* Ein Pool wurde in den Pool oder einem untergeordnetem Pool verschoben
|
 
 
|}
 
|}
 +
 +
<noinclude>
 +
[[Category:Dienste]]
 +
</noinclude>

Aktuelle Version vom 1. September 2009, 10:01 Uhr

Ab Version 2.1.0

Beschreibung

Der Dependencies-Service hat die Aufgabe alle Änderungen des Systems zu überwachen und alle Artikel, die von den Änderungen betroffen sind, neu zu generieren.

Um entscheiden zu können welche Artikel neu generiert werden müssen, wird während der Generierung ermittelt welche Daten das Template anfordert. Gespeichert werden ID und Feldname der angeforderten Daten. Diese gepeicherte ID-Feldname Kombination wird dann auf Änderungen überwacht. Für jeden Publikationsbereich werden diese Daten separat gespeichert.


Auf Änderungen reagieren

Die Überwachung der Felder elements und allElements ist im Standard-Fall deaktiviert, da in alt-Systemen eine zu hohe Anzahl an Abhängigkeiten existieren könnten.
  • Neues Element
    • Es werden alle Artikel neu generiert, für die das Feld elements des übergeordneten Pools des neuen Elementes überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld allElements aller übergeordneten Pools des neuen Elementes überwacht wird.
  • Neuer Pool
    • Es werden alle Artikel neu generiert, für die das Feld pools des übergeordneten Pools des neuen Pools überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld allPools aller übergeordneten Pools des neuen Pools überwacht wird.
  • Neues Element / Neuer Pool
    • Enthält das neue Element / der neue Pool Verknüpfungen wird geprüfen ob die Verknüpfungsziele Suchabfragen besitzen. In diesem Fall werden die Suchabfragen der Artikels ausführen. Bei Änderungen von Suchergebnissen werden die entsprechenden Verknüpfungsziele neu generiert.
    • Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
    • Existieren Verknüpfungen auf andere Elemente, werden alle Artikel neu generiert auf die verlinkt wurde und die das Feld referrerLinks verwendet haben.
  • Element geändert
    • Wenn sich der Dateiname geändert hat, werden alle Artikel neu generiert, für die das Feld filename oder url des geänderten Elementes überwacht wird.
    • Wenn sich der originale Dateiname geändert hat, werden alle Artikel neu generiert, für die das Feld originalFilename des geänderten Elementes überwacht wird.
  • Template-Suffix geändert
    • Wenn sich der Suffix eines Template geändert hat, werden alle Artikel neu generiert, für die das Feld suffix des geänderten Templates überwacht wird. Weiter werden alle Artikel neu generiert bei denen sie der Dateiname der Seite aufgrund des geänderten Suffix ändert. Alle so generierten Artikel besitzen dadurch eine neue URL, so das anschließend alle Artikel neu generiert werden, für die das Feld url der generierten Artikel überwacht wird.
  • Pool geändert
    • Wenn sich das Verzeichnis geändert hat, werden alle Artikel neu generiert, für die das Feld dir des geänderten Pools überwacht wird. Weiter werden alle Artikel des geänderten Pools und alle Artikel aller Unterpools neu generiert. Alle so generierten Artikel besitzen dadurch eine neue URL, so das anschließend alle Artikel neu generiert werden, für die das Feld url der generierten Artikel überwacht wird.
    • Bei Änderung von Personalisierungsdaten werden alle Artikel neu generiert, die diese Personalisierungsdaten verwendet.
  • Element / Pool geändert
    • Es werden alle Artikel neu generiert, für die das Feld * des geänderten Elementes/Pools überwacht wird.
    • Es werden alle Artikel generiert, für die die neuen, geänderten oder gelöschten Content-Felder des geänderten Elementes/Pools überwacht werden.
    • Enthält das Element / der Pool neue Verknüpfungen wird geprüfen ob die Verknüpfungsziele Suchabfragen besitzen. In diesem Fall werden die Suchabfragen der Artikels ausführen. Bei Änderungen von Suchergebnissen werden die entsprechenden Verknüpfungsziele neu generiert.
    • Wurden bestehende Verknüpfungen des Elementes / des Pools gelöscht wird geprüfen ob die Verknüpfungsziele Suchabfragen besitzen. In diesem Fall werden die Suchabfragen der Artikels ausführen. Bei Änderungen von Suchergebnissen werden die entsprechenden Verknüpfungsziele neu generiert.
    • Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
    • Sind Verknüpfungen erzeugt, geändert oder gelöscht worden, werden alle Artikel neu generiert auf die verlinkt wird/wurde und die das Feld referrerLinks verwendet haben.
  • Artikel publiziert
    • Es werden alle Artikel neu generiert, für die das Feld url des publizierten Artikels überwacht wird.
    • Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
  • Artikel depubliziert
    • Es werden alle Artikel neu generiert, für die das Feld url des depublizierten Artikels überwacht wird.
    • Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
  • Element gelöscht
    • Es werden alle Artikel neu generiert, für die das Feld elements des übergeordneten Pools des gelöschten Elementes überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld allElements aller übergeordneten Pools des gelöschten Elementes überwacht wird.
  • Pool gelöscht
    • Es werden alle Artikel neu generiert, für die das Feld pools des übergeordneten Pools des gelöschten Pools überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld allPools aller übergeordneten Pools des gelöschten Pools überwacht wird.
    • Es werden alle Artikel neu generiert, die noch die Personalisierungsdaten des Pools verwenden.
  • Element / Pool gelöscht
    • Alle Artikel, die das gelöschte Element / den gelöschten Pool verwendet haben werden neu generiert.
    • Alle Suchabfragen dessen Treffer das gelöschte Elemente / den gelöschten Pool enthalten, werden ausgeführt und Artikel, die diese Suchabfragen verwenden werden neu generiert.
    • Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
  • Element verschoben
    • Es werden alle Artikel neu generiert, für die das Feld parent des verschobenen Elementes überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld path des verschobenen Elementes überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld elements des ursprünglichen übergeordneten Pools überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld elements des neuen übergeordneten Pools überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld allElements aller ursprünglichen übergeordneten Pools überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld allElements aller neuen übergeordneten Pools überwacht wird.
    • Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
  • Pool verschoben
    • Es werden alle Artikel neu generiert, für die das Feld parent des verschobenen Pools überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld path des verschobenen Pools und seinen Unterpools und Unterelementen überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld pools des ursprünglichen übergeordneten Pools überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld pools des neuen übergeordneten Pools überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld allPools aller ursprünglichen übergeordneten Pools überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld allPools aller neuen übergeordneten Pools überwacht wird.
    • Wenn sich der Verzeichnispfad des neue übergeordneten Pools von dem des ursprünglichen übergeordneten Pools unterscheidet, werden alle Artikel des Pools und alle Artikel aller Unterpools neu generiert. Alle so generierten Artikel besitzen dadurch eine neue URL, so das anschließend alle Artikel neu generiert werden, für die das Feld url der generierten Artikel überwacht wird.
    • Suchergebnisse beliebiger Suchabfragen können sich geändert haben. Diese Abhängigkeiten werden durch regelmäßiges ausführen der Suchabfragen und Prüfung von Änderungen der Suchergebnisse erkannt. Es werden die Artikel neu generiert die eine Suchabfrage verwenden, dessen Suchergebnis sich geändert hat.
  • Neuer Symlink
    • Es werden alle Artikel neu generiert, für die das Feld stepParent des originalen Elementes überwacht wird, für den der Symlink angelegt wurde.
    • Es werden alle Artikel neu generiert, für die das Feld elements des übergeordneten Pools des neuen Symlink überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld allElements aller übergeordneten Pools des neuen Symlink überwacht wird.
  • Symlink gelöscht
    • Es werden alle Artikel neu generiert, für die das Feld stepParent des originalen Elementes überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld elements des übergeordneten Pools des gelöschten Symlink überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld allElements aller übergeordneten Pools des gelöschten Symlink überwacht wird.
  • Symlink verschoben
    • Es werden alle Artikel neu generiert, für die das Feld stepParent des originalen Elementes überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld elements des ursprünglichen übergeordneten Pools überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld elements des neuen übergeordneten Pools überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld allElements aller ursprünglichen übergeordneten Pools überwacht wird.
    • Es werden alle Artikel neu generiert, für die das Feld allElements aller neuen übergeordneten Pools überwacht wird.

Zu überwachende Felder protokollieren

Bestimmte Feldnamen, die auf Änderungen identisch reagieren müssen werden zu einem symbolischen Feldnamen zusammengefasst. Z.B. wird url, absoluteUrl und relativeUrl zu dem Feldnamen url zusammengefasst. Auch Funktionsaufrufe wie url(publisher) werden überwacht.

Es gibt Felder, bei denen auf jede Änderung die Seite neu generiert werden muß. Für diese Felder wird der Feldname * protokolliert.

Hier die vollständige Liste aller überwachten Felder

Feldnamen protokollierter Feldnamen neu Generierung
name name
  • Name des Elements wurde geändert
comment comment
  • Kommentar des Elements wurde geändert
type type
  • Typ des Elements wurde geändert
version *
  • jede Änderung
changedBy *
  • jede Änderung
changed *
  • jede Änderung
url

absoluteUrl

relativeUrl

isPublished

hasValidUrl

external(für Resource-Artikel)

url
  • Dateiname geändert
  • Verzeichnis eines übergeordneten Pools geändert
  • Übergeordneter Pool verschoben
  • Artikel publiziert
  • Artikel depubliziert

Dieses Feld wird auch protokolliert wenn nicht direkt die URL des Artikels, sondern die URL eines Mediums des Artikels verwendet wird.

referrerLinks referrerLinks
  • Neue Verknüpfung auf das Element
  • Verknüpfung auf das Element wurde gelöscht
publicationStates *
  • jede Änderung
Content-Felder Name des Feldes
  • Änderung des entsprechenden Feldes (nur erste Ebene)
Für die frei definierbaren Content-Felder wird dessen Feldname protokolliert. Feldnamen werden nur für die erste Ebene protokolliert. Wird z.B. in einem Template das Feld ${article}.mylist[0].mytext abgefragt, so der Feldname mylist protokolliert. Die Seite wird dann auch generiert, wenn sich etwas unterhalb von mylist ändert.
Artikel-Felder
filename filename
  • Dateiname des Elements wurde geändert
originalFilename originalFilename
  • Originaler Dateiname des Elements wurde geändert
Medien-Artikel-Felder
filesize *
  • jede Änderung
filename *
  • jede Änderung
mime *
  • jede Änderung
format *
  • jede Änderung
isImage *
  • jede Änderung
width *
  • jede Änderung
height *
  • jede Änderung
media *
  • jede Änderung
Template-Felder
source source
  • Änderungen im Template-Quelltext
suffix suffix
  • Änderung des Template-Suffix
Artikel-Pool-Felder
dir dir
  • Änderung des Verzeichnisses
Pool-Felder
parent parent
  • Element wurde in einen anderen Pool verschoben
stepParents stepParents
  • Für das Element wurde ein Symlink angelegt oder gelöscht
path path
  • Übergeordneter Pool wurde in einen anderen Pool verschoben
elements

sortedElements hasChildren

elements
Die Überwachung dieses Feldes ist im Standard-Fall deaktiviert, da in alt-Systemen eine zu hohe Anzahl an Abhängigkeiten existieren könnten.
  • In dem Pool wurde ein Element angelegt
  • In dem Pool wurde ein Element gelöscht
  • Ein Element wurde in den Pool verschoben
  • Ein Symlink wurde in dem Pool erzeugt
  • Ein Symlink wurde in dem Pool gelöscht
allElements allElements
Die Überwachung dieses Feldes ist im Standard-Fall deaktiviert, da in alt-Systemen eine zu hohe Anzahl an Abhängigkeiten existieren könnten.
  • In dem Pool oder einem untergeordnetem Pool wurde ein Element angelegt
  • In dem Pool oder einem untergeordnetem Pool wurde ein Element gelöscht
  • Ein Element wurde in den Pool oder einem untergeordnetem Pool verschoben
  • Ein Symlink wurde in dem Pool oder einem untergeordnetem Pool erzeugt
  • Ein Symlink wurde in dem Pool oder einem untergeordnetem Pool gelöscht
pools

sortedPools hasChildren

pools
  • In dem Pool wurde ein Pool angelegt
  • In dem Pool wurde ein Pool gelöscht
  • Ein Pool wurde in den Pool verschoben
allPools allPools
  • In dem Pool oder einem untergeordnetem Pool wurde ein Pool angelegt
  • In dem Pool oder einem untergeordnetem Pool wurde ein Pool gelöscht
  • Ein Pool wurde in den Pool oder einem untergeordnetem Pool verschoben