Mithilfe der Funktion WR-Trigger können WebReports durch bestimmte Ereignisse in Content Server initiiert werden. Für Objekttypen, die mit der Funktion WR-Trigger aktiviert wurden, können WebReports-Entwickler einen WebReport für eine Vielzahl von Content Server-Ereignissen initiieren. Die Funktion WR-Trigger ist standardmäßig deaktiviert und kann auf den Verwaltungsseiten unter WR-Trigger verwalten pro Objekttyp aktiviert werden. Für folgende Content Server-Ereignisse können Sie einen WebReport initiieren:

  • Version hinzufügen

  • Aktualisierung der Kategorie

  • Erstellen

  • Löschen

  • Verschieben

  • Kopieren

  • Aktualisieren

Die Registerkarte WR-Trigger ist standardmäßig für alle Benutzer zugänglich, die über eine Berechtigung zum Ändern für einen Knoten verfügen, für den der WR-Trigger aktiviert ist. Administratoren können über die Seite Objekt- und Nutzungsberechtigungen verwaltenden im Bereich Systemverwaltung den Zugriff auf ausgewählte Benutzer und Gruppen beschränken. Der Bereich Nutzungsberechtigungen enthält einen Eintrag für die Registerkarte WR-Trigger, auf der Sie die Einschränkungen festlegen können.

Allgemeine Verwendung

Sie können auf die Funktion WR-Trigger über die neue Option WR-Trigger im Eigenschaftenbereich des Menüs Funktionen zugreifen. Die Funktion wird in einer neuen Registerkarte angezeigt. Auf das Menü und die Registerkarte kann nur für Untertypen zugegriffen werden, für die die Funktion WR-Trigger aktiviert ist. Trigger können für einzelne Objekte festgelegt werden oder für Container und damit durchgängig nach unten in einer Hierarchie. Letzteres ist hilfreich, wenn Trigger für eine Vielzahl von Objekten festzulegen sind.

 

Wichtig

Wichtig:
Ab Content Server 16 bestimmt der neue Papierkorbmechanismus, wie sich WR Trigger im Zusammenhang mit dem Trigger-Ereignis Löschen verhält. In den Versionen von Content Server vor Content Server 16 wird beim Senden eines Objekts an den Papierkorb ein Verschieben- anstelle eines Löschen-Ereignisses ausgelöst. Der Mechanismus in Content Server 16 und neueren Versionen sendet Objekte immer in den Papierkorb und löst daher immer ein Verschieben- anstelle eines Löschen-Ereignisses aus. Dies ist eine wichtige Änderung, wenn Sie ein Upgrade für ein System durchführen, bei dem das optionale Papierkorb-Modul installiert war. Kunden, die ein Upgrade auf Content Server 16 durchführen und die zuvor das Ereignis Verschieben genutzt haben, um ein Ereignis Löschen zu erfassen, das ein Objekt an den Papierkorb sendet, müssen ihre Trigger aktualisieren, um das Trigger-Ereignis Löschen in Content Server 16 verwenden zu können.

 

Wenn ein Ausgangsobjekt, d. h. ein Container mit anderen Objekten darin, kopiert, verschoben oder gelöscht wird, wird der Trigger nur für dieses Ausgangsobjekt ausgelöst. Für einzelne Unterobjekte wird kein WebReport initiiert. Wenn für jedes einzelne Objekt ein WebReport initiiert werden muss, können Sie eine Anfrage verwenden, die anhand des Objekts, das den Trigger ausgelöst hat, nach allen untergeordneten Objekten sucht. Anschließend wird das gewünschte Verhalten mit einem untergeordneten WebReport implementiert, z. B. das Auslösen eines Workflows.

Alle Trigger, mit Ausnahme von Löschen, werden ausgelöst, nachdem das Ereignis stattgefunden hat. Beispiel: Wenn [LL_REPTAG_TRIGGERID NODEINFO:PARENTID /] in einem WebReport verwendet wird, der von einem Verschieben-Trigger-Ereignis initiiert wurde, wird die Objekt-ID des neuen übergeordneten Objekts zurückgegeben. Weitere Informationen zum Zugriff auf das Original finden Sie unter TRIGGERDESTPARENTID in der dynamischen Tag-Anleitung. Weitere Informationen zur dynamischen Tag-Anleitung finden Sie unter So greifen Sie auf die dynamische Tag-Anleitung zu. Mit dem Löschen-Trigger wird das Ereignis kurz vor dem Löschvorgang ausgelöst, um ein Maximum an Metadaten verfügbar zu haben. Nachdem ein Objekt tatsächlich gelöscht wurde, ist es nicht mehr vorhanden und besitzt keine gültigen Metadaten mehr.

Wenn Content Server ein Dokument hinzugefügt wird, werden die Trigger Löschen und Version hinzufügen ausgelöst. Das liegt daran, dass diese Vorgänge von Content Server als getrennte Aktionen angesehen werden. Zuerst findet die Objekterstellung statt und anschließend wird diesem Objekt eine neue Version hinzugefügt, in diesem Fall Version 1. Wird ein Ordner hinzugefügt, wird nur der Erstellen-Trigger ausgelöst.

 

Hinweis

Hinweise:

  • Sie können die Einstellung Nur dieses Objekt für Aktionen wie Kategorieaktualisierungen oder Aktualisierungen verwenden. Diese Einstellung gilt jedoch nicht für die Triggererstellung. Um die WR-Triggervererbung sowohl auf das Objekt als auch auf seine direkten Nachfahren anzuwenden, können Sie die Option Dieses Objekt und alle untergeordneten Objekte verwenden und eine RUNIF-Anweisung hinzufügen, um den übergeordneten Ordner zu überprüfen. Beispiel:

    [LL_WEBREPORT_RUNIF "[LL_REPTAG_TRIGGERID NODEINFO:PARENTID /]" == "[LL_REPTAG_$FOLDER /]" /]

  • [LL_REPTAG_$FOLDER /] ist eine Konstante, die auf den Trigger-Stammordner verweist.

  • Weitere Informationen zu Konstanten finden Sie unter WebReports-Konstanten.

 

Benutzer- oder Gruppen-Trigger

Die Funktion WR-Trigger unterstützt auch Trigger für Benutzer- oder Gruppenereignisse. Diese Trigger können auf den Verwaltungsseiten unter Benutzer/Gruppen-WR-Trigger verwalten konfiguriert werden. Weitere Informationen zum Verwalten von WR-Triggern finden Sie unter WR-Trigger verwalten. WebReports-Entwickler können basierend auf den folgenden Benutzer-/Gruppenereignissen einen WebReport initiieren:

  • Benutzer zur Gruppe hinzufügen

  • Benutzer/Gruppe erstellen

  • Benutzer/Gruppe löschen

  • Benutzer/Gruppe aktualisieren

  • Benutzeranmeldung

Wenn das Kontrollkästchen Global aktiviert ist, wird bei jedem Auslösen eines ausgewählten Triggers in Content Server unabhängig vom Aufrufer der angegebene WebReport ausgeführt. Wenn Sie jedoch einen Benutzer oder eine Gruppe angeben, wird das Kontrollkästchen Global deaktiviert, und der WebReport wird nur ausgeführt, wenn das Trigger-Ereignis innerhalb der Gruppe oder für den Benutzer ausgelöst wird. Wenn z. B. das Erstellen, Löschen oder Hinzufügen usw. in der Gruppe stattfindet und nicht ausdrücklich für die Gruppe an sich, wird der WebReport initiiert. Bei einem Benutzer muss das Trigger-Ereignis für den Benutzer stattfinden. Nicht alle Trigger-Ereignisse sind für Benutzer relevant und werden daher ignoriert.

WR-Trigger-Tags

WR-Trigger unterstützt die folgenden funktionsspezifischen Datentags, die in der dynamischen Tag-Anleitung näher erläutert werden. Weitere Informationen zur dynamischen Tag-Anleitung finden Sie unter So greifen Sie auf die dynamische Tag-Anleitung zu.

  • [LL_REPTAG_TRIGGER /]

  • [LL_REPTAG_TRIGGERDESTPARENTID /]

  • [LL_REPTAG_TRIGGERID /]

  • [LL_REPTAG_TRIGGERNEWID /]

  • [LL_REPTAG_TRIGGERNEWNAME /]

  • [LL_REPTAG_TRIGGEROLDNAME /]

  • [LL_REPTAG_TRIGGERSOURCEPARENTID /]

  • [LL_REPTAG_TRIGGERADDEDCATEGORIES /]

  • [LL_REPTAG_TRIGGERCATEGORYVALUECHANGES /]

  • [LL_REPTAG_TRIGGERDELETEDCATEGORIES /]

Beispiel

So initiieren Sie einen Workflow und hängen ein Dokument an, wenn ein neues Objekt erstellt wird:

  1. Legen Sie als Ziel für den WebReport den Workflow fest, den Sie initiieren möchten. Klicken Sie dazu auf das Symbol WebReport-Funktionen, und wählen Sie Eigenschaften > Ziel aus.

  2. Klicken Sie einen Ordner über der Ebene, auf der Sie das Objekt erstellen möchten, auf das Menü Funktionen, und wählen Sie Eigenschaften > WR-Trigger aus. Wählen Sie auf der Registerkarte WR-Trigger den auszuführenden WebReport aus, und wählen Sie dann das Erstellen-Ereignis als Trigger aus.

  3. Legen Sie im WebReport das Objekt fest, mit dem das Ereignis eingeleitet wird, das Sie zum Workflow anhängen möchten. Bearbeiten Sie dazu die Berichtsansicht wie folgt:

    [LL_REPTAG_TRIGGERID SETWFATTACH:COPY:INHERITATTRS:MERGED /]

    TRIGGERID ist die ID des Objekts, das das Ereignis initiiert hat. SETWFATTACH:COPY:INHERITATTRS:MERGED kopiert dieses Objekt in den Anlagen-Ordner, wobei die Kategorien des Objekts mit denen des Anlagen-Ordners zusammengeführt werden. Weitere Informationen zum Untertag SETWFATTACH finden Sie in der dynamischen Tag-Anleitung. Weitere Informationen zur dynamischen Tag-Anleitung finden Sie unter So greifen Sie auf die dynamische Tag-Anleitung zu.

     

    Hinweis

    Hinweise:

    • Anstatt einen Workflow zu starten, können Sie auf der Registerkarte Ziel von WebReports auch den E-Mail-Versand konfigurieren. Verwenden Sie [LL_REPTAG_TRIGGERID /], um das Objekt anzufügen, das das Ereignis für das E-Mail-Ziel auslöst. Sie können SETWFATTACH und SETEMAILATTACH mehrmals verwenden, um verschiedene Objekte für das Ziel anzufügen. Weitere Informationen zum Untertag SETEMAILATTACH finden Sie in der dynamischen Tag-Anleitung. Weitere Informationen zur dynamischen Tag-Anleitung finden Sie unter So greifen Sie auf die dynamische Tag-Anleitung zu.

    • Aktivieren Sie die Option WebReport anzeigen auf der Registerkarte WR-Trigger nur, wenn das Ereignis von einem Content Server-Benutzer manuell ausgelöst wird. Wenn das Ereignis durch einen WebReport wie z. B. NODEACTION ausgelöst wird, sollten Sie diese Option deaktivieren, da WebReport anzeigen in diesem Fall nicht anwendbar ist. Weitere Informationen zum NODEACTION-Untertag finden Sie in der dynamischen Tag-Anleitung. Weitere Informationen zur dynamischen Tag-Anleitung finden Sie unter So greifen Sie auf die dynamische Tag-Anleitung zu.

    • Erstellen Sie nach Möglichkeit keine Ordner-Trigger, in denen das Triggerereignis Version hinzufügen ausgewählt ist, und der initiierende WebReport ein neues Content Server-Dokument mit Ausgabeziel =Content Server in den gleichen Ordner ausgibt. Hierdurch wird der Trigger auf dem Ordner rekursiv gelöscht und es kommt zu einem Content Server-Fehler.

    • Wenn Sie einen WR-Trigger auf einen Container anwenden, um einen WebReport auf Grundlage eines Objekts auszulösen, das gerade in diesen Container verschoben, kopiert oder darin erstellt wird, müssen Sie darauf achten, dass sowohl der Untertyp des Objekts als auch der Untertyp des Containers auf der Verwaltungsseite WR-Trigger ausgewählt sind.