Zum Inhalt

Dokumente kopieren#

Das Kopier-Feature in Imperia CMS ermöglicht es Benutzern, Dokumente innerhalb des Content-Management-Systems mühelos zu duplizieren. Mit einer benutzerfreundlichen Oberfläche ist es möglich, ein oder mehrere Dokumente zu kopieren und sie in die gewünschte Rubrik einzufügen.

Das Kopierfeature in Imperia CMS ermöglicht es, ein Dokument zu duplizieren, indem es durch den konfigurierten Copy-Workflow geleitet wird. Als Administrator haben Sie die Möglichkeit, innerhalb dieses Workflows festzulegen, wie sich das System beim Kopieren eines Dokuments verhalten soll. Beispielsweise können Sie konfigurieren, ob das Dokument nur in den Workflow importiert werden soll oder ob der Prozess vollständig abgeschlossen werden soll. Dies bietet Ihnen eine hohe Flexibilität und Kontrolle darüber, wie kopierte Dokumente innerhalb des Content-Management-Systems gehandhabt werden.

Aktivierung der Kopieren/Einfügen-Funktion#

Konfiguration der Zielrubrik zum Einfügen#

  1. Gehen Sie zu den Einstellungen der Rubrik, in der Sie das Einfügen aktivieren möchten.
  2. Scrollen Sie zum Abschnitt "Kopieroptionen".
  3. Aktivieren Sie das Kontrollkästchen "Einfügen aktivieren".
  4. Wählen Sie den Kopier-Workflow aus (siehe Abschnitt: Kopier-Workflow)
  5. Speichern Sie die Einstellungen.

Verständnis der Berechtigungen#

Benutzer benötigen die Berechtigung Dokument erstellen, um in der Zielrubrik einzufügen, und die Berechtigung Dokument lesen, um das bzw. die Dokumente zum Kopieren auszuwählen.

Kopier-Workflow#

Der Kopier-Workflow ist ein spezieller Workflow in imperia, der aktiv wird, wenn ein Dokument in eine Rubrik eingefügt wird. Er bietet die Möglichkeit, das Verhalten des Kopierens zu steuern und zu modifizieren.

Grundlagen des Kopier-Workflows#

Der Kopier-Workflow verhält sich ähnlich wie ein normaler imperia Workflow, mit dem Unterschied, dass er nur einmal durchlaufen wird, wenn ein Dokument eingefügt wird. Nach dem Einfügen wird bei der Bearbeitung des Dokuments der reguläre Workflow der jeweiligen Rubrik verwendet.

Dieser Workflow kann zur automatisierten Anpassung von Dokumenteigenschaften, zur Konfliktlösung bei Namenskollisionen und zur Interaktion mit der Benutzeroberfläche während des Einfügevorgangs verwendet werden.

Neue Workflow-Plugins für den Kopier-Workflow#

Im Kopier-Workflow stehen drei neue Workflow-Plugins zur Verfügung, die speziell für diesen Workflow entwickelt wurden:

  1. SetupCopy: Dieses Plugin aktualisiert den Pfad und die nodeID des eingefügten Dokuments. Es enthält Einstellungen zur Behebung von Namenskollisionen. Wenn eine Kollision im Pfad auftritt, wird der Dateiname für MAM-Dokumente geändert, während bei Nicht-MAM-Dokumenten das Verzeichnis angepasst wird.

  2. MESSAGE: Dieses Plugin ermöglicht es, eine spezielle Metaschlüssel-Nachricht (__imperia_workflow_message) im Dokument zu hinterlegen. Diese Nachricht kann dazu verwendet werden, mit der Benutzeroberfläche zu kommunizieren und dem Benutzer Informationen oder Aufforderungen während des Einfügevorgangs anzuzeigen.

  3. NEWWF: Mit diesem Plugin wird der Standard-Workflow für die Zielkategorie neu gestartet und das eingefügte Dokument wird in diesen Workflow eingefügt. Dies ist nützlich, um sicherzustellen, dass das Dokument ordnungsgemäß in die Kategorie integriert wird und alle regulären Workflow-Schritte durchläuft.

Konfiguration des Kopier-Workflows#

  1. Starten Sie mit dem Beispiel-Kopier-Workflow unter site/sample/grid/imperia/workflow/data/copydoc.xml.
  2. Kopieren Sie ihn nach site/grid/imperia/workflow/data/copydoc.xml.
  3. Sie können diesen Workflow entsprechend Ihrer Anforderungen anpassen.

Um den Kopier-Workflow für eine Rubrik zu benutzen, gehen Sie zu den Rubrikeneinstellungen der jeweiligen Rubrik und wählen Sie den gewünschten Kopier-Workflow aus.

Einfügebeschränkungen#

Die Einfügebeschränkungen sind ein mächtiges Werkzeug für Administratoren, um zu kontrollieren, welche Dokumente in bestimmte Rubriken kopiert werden können. Durch das Anpassen eines Templates können Sie spezifische Bedingungen und Anforderungen festlegen, die erfüllt sein müssen, damit das Kopieren erfolgreich durchgeführt werden kann. Wenn Sie als Administrator keine spezifischen Anpassungen vornehmen, werden die Standardbedingungen des Templates angewendet.

Standardverhalten#

Wenn Sie als Administrator die Vorlage für Einfügebeschränkungen nicht konfigurieren, wird das Standard-Template verwendet. Dieses prüft, ob bestimmte Eigenschaften wie Template, Workflow, Metadatendatei und Dateiname zwischen dem zu kopierenden Dokument und der Zielrubrik übereinstimmen. Wenn eine dieser Bedingungen nicht erfüllt ist, wird das Kopieren nicht zugelassen und eine entsprechende Fehlermeldung wird angezeigt.

Standardverhalten überschreiben#

  1. Finden Sie das Standard-Template für Einfügebeschränkungen unter site/sample/templates/default_copyrestrictions.htms.
  2. Kopieren Sie es nach site/templates und passen Sie sie nach Ihren Anforderungen an.
  3. Setzen Sie die Variable COPYRESTRICTIONS_TEMPLATE in System.conf auf den Namen Ihrer benutzerdefinierten Vorlage. Zum Beispiel: COPYRESTRICTIONS_TEMPLATE = custom_template.htms.

Einfügebeschränkungen-Template Grundlagen#

Das Template für Einfügebeschränkungen verwendet eine vereinfachte Syntax, die es Ihnen ermöglicht, Bedingungen zu definieren, die erfüllt sein müssen, damit ein Dokument in eine bestimmte Kategorie kopiert werden kann. Wenn die Vorlage den Wert 1 zurückgibt, ist das Kopieren erlaubt. Wenn nicht, wird die Ausgabe der Vorlage als Fehlermeldung angezeigt, die dem Benutzer den Grund dafür mitteilt, dass das Kopieren nicht möglich ist.

Anpassung des Templates#

Das Template ermöglicht den Zugriff auf die bekannten imperia Variablen und Konstrukte wie IF/ELSE, um logische Bedingungen zu erstellen. Hier sind die wichtigsten Elemente:

  • XX und SECTION: Diese Variablen beziehen sich auf die Informationen des zu kopierenden Dokuments bzw. dessen Rubrik.

  • XX-TARGETSECTION: Diese Variable bezieht sich auf die Informationen der Zielkategorie.

Beispiel:#

#IF("<!--SECTION:template-->" NE "<!--XX-TARGETSECTION(template):ignored-->")
Template does not match

Dieser Codeabschnitt prüft, ob das Template des zu kopierenden Dokuments mit dem der Zielrubrik übereinstimmt. Wenn nicht, wird die Nachricht "Template does not match" angezeigt.