Die Seite wurde neu angelegt: „{{Box Note|boxtype=note|Note text=Diese Funktion ist Bestandteil von BlueSpice Farm ab Version 3.2.}} Die Funktion "Push & Merge" in einer Wiki Farm ermöglic…“ |
Keine Bearbeitungszusammenfassung |
||
| (11 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
Die Funktion "Push & Merge" in einer Wiki Farm ermöglicht es, | Die Funktion "Push & Merge" in einer Wiki Farm ermöglicht es, Wikiseiten von einer Wiki-Instanz in eine andere Wiki-Instanz zu kopieren. | ||
== | == Farm-Instanzen vorbereiten == | ||
Bevor Inhalte übertragen werden können, müssen die entsprechenden Farm-Instanzen über den [[Handbuch:Erweiterung/BlueSpiceWikiFarm|Farm-Manager]] erstellt worden sein. | |||
[[ | |||
=== | === Namensräume abgleichen === | ||
Wenn die Farm-Instanzen mit Namensräumen arbeiten, müssen im Quell- und Zielwiki die gleichen Namensräume existieren. Dies muss unbedingt vor dem Seitentransfer geprüft werden. | |||
{{Textbox|boxtype=important|header=Keine nachträgliche Erstellung von Namensräumen im Zielwiki!|text=Ein nachträgliches Einrichten der Namensräume im Zielwiki ist schwierig, falls bereits Seiten aus einem Namensraum ins Zielwiki übertragen wurden und derselbe Namensraum dort nicht existiert. | |||
In diesem Fall wird das Anlegen eines Namensraums zu einer Fehlermeldung führen, da es bereits im Hauptnamensraum Seiten mit dem gleichen Präfix gibt. Diese Seiten müssen dann entsprechend umbenannt werden, um das Präfix wieder "freizugeben".|icon=yes}} | |||
=== Inhaltsplanung === | |||
Über das Wurzelwiki werden die Inhaltswikis erstellt. Technisch kann aus jedem Inhaltswiki (Wiki-Instanz) in jedes andere Wiki übertragen werden. Häufig dient jedoch ein Wiki als Quellwiki für die Übertragung in ein oder mehrere andere Wikis. Es kann auch Wikis geben, in die nichts übertragen wird. | |||
* ''' | Eine Übertragung aus dem Wurzelwiki ist zwar technisch möglich, sollte allerdings zur Vereinfachung eventueller späterer Migrationen der Inhalte vermieden werden. | ||
{{Textbox|boxtype=note|header=Konflikte mit Übersetzungsübertragungen vermeiden:|text=Falls in der Farmumgebung Instanznamen existieren, die einem ISO-639 Sprachkürzel entsprechen, wird dies automatisch von der Erweiterung TranslationTransfer als Sprachinstanz behandelt. | |||
Die italienische Sprachinstanz hat z.B den Namen "IT". In einer Farm mit Übersetzungsmechanismus ist dieser Name daher "reserviert" und kann nicht für eine Instanz der IT-Abteilung genutzt werden. Diese könnte dann zum Beispiel als "IT-Wiki" angelegt werden.|icon=yes}} | |||
<drawio filename="ContentTransfer_farm_instances" alt="example of subwikis in a wiki farm that participate in content transfer"> | |||
</drawio> | |||
== Seiten übertragen ==<!-- Admin Rolle logisch? --> | |||
Der Inhaltstransfer erfolgt über die Spezialseite <code>Spezial:ContentTransfer</code> des Wikis, von dem aus die Seiten übertragen werden. | |||
Für den Inhaltstransfer benötigt ein Benutzer die nötigen Übertragungsrechte, die standardmäßig der Rolle admin zugewiesen sind. | |||
[[Datei:farm-transferpages.png|verweis=https://bs3-de.wiki.bluespice.com/wiki/Datei:farm-transferpages.png|zentriert|mini|650x650px|Benutzeroberfläche zum Übertragen von Inhalten]] | |||
=== Auswahl von Ziel- und Quell-Wiki === | |||
* '''Empfangen:''' Auswahl des Wikis, in das die Inhalte kopiert werden. Das Ziel-Wiki befindet sich immer in derselben Wiki-Farm wie das Quell-Wiki. | |||
* '''Verwandte Inhalte einschließen:''' Inhalte, die von den ausgewählten Seiten verlinkt sind (verlinkte Seiten, Dateien, Vorlagen), können in die Übertragung einbezogen oder ausgeschlossen werden. | |||
=== Zu übertragende Seiten === | |||
Der Filter zur Auswahl von Seiten wird über das Filter-Chevron (Screenshot Anmerkung 1) ausgeklappt. Folgende Suchfilter können zur Anzeige der im Quellwiki existierenden Seiten kombiniert werden werden: | |||
[[Datei:contentTransfer Seitenfilter.png|alternativtext=Übertragungsfilter auf der Seite ContentTransfer|zentriert|mini|650x650px|Übertragungsfilter (1) Auswahlumschalter (2)]] | |||
* '''Modifiziert seit:''' zeigt nur Quellseiten an, die seit diesem Datum geändert wurden, unabhängig vom letzten Transfer | |||
* '''Geändert seit der letzten Übertragung:''' zeigt nur Quellseiten an, die seit dem letzten Transfer geändert wurden. Das betrifft auch verlinkte Inhalte. | |||
* '''Seitenname''': Filtersuche nach bestimmten Seitentiteln | |||
* '''Namensraum:''' zeigt Quellseiten aus einem bestimmten Namensraum an | * '''Namensraum:''' zeigt Quellseiten aus einem bestimmten Namensraum an | ||
* '''Kategorie:''' zeigt Quellseiten aus einer bestimmten Kategorie an | * '''Kategorie:''' zeigt Quellseiten aus einer bestimmten Kategorie an | ||
Die durch die Filtereinstellungen angezeigten Seiten können nun für den Transfer gewählt oder ausgeschlossen werden. Standardmäßig sind alle Seiten ausgewählt. Die Auswahl kann über den Umschalter ''Alle Auswählen'' (Screenshot Anmerkung 2) auf alle oder auf manuell ausgewählte Seiten gestellt werden. | |||
=== Transfer starten === | === Transfer starten === | ||
Über die Schaltfläche '' | Über die Schaltfläche ''Übertragen'' wird der Transfermechanismus gestartet. | ||
* '''Maximale Anzahl der transferierten Seiten:''' Es können 200 Seiten pro Transfer kopiert werden. Wenn mehr Seiten kopiert werden sollen, müssen die Seiten über entsprechende Filterkriterien in mehrfachen Schritten kopiert werden. | * '''Maximale Anzahl der transferierten Seiten:''' Es können 200 Seiten pro Transfer kopiert werden. Wenn mehr Seiten kopiert werden sollen, müssen die Seiten über entsprechende Filterkriterien in mehrfachen Schritten kopiert werden. | ||
* '''Namensraum erstellen:''' Wenn der Namensraum der ausgewählten Seiten nicht im Zielwiki existiert, wird beim Transfer | * '''Namensraum erstellen:''' Wenn der Namensraum der ausgewählten Seiten nicht im Zielwiki existiert, wird beim Transfer ein entsprechender Hinweis angezeigt. Der Namensraum muss vor dem Transfer manuell im Zielwiki erstellt werden. | ||
=== Kopieren der Seiten === | === Kopieren der Seiten === | ||
Über die Schaltfläche "Push" wird der Transfer anschließend ausgeführt. Der Transfermechanismus | Über die Schaltfläche "Push" wird der Transfer anschließend ausgeführt. Der Transfermechanismus überträgt die ausgewählten Seiten und folgende mit den Seiten verbundene Seiten und Dateien: | ||
* Kategorienseiten | * Kategorienseiten | ||
* Bücher | * Bücher | ||
| Zeile 40: | Zeile 66: | ||
'''Schreibgeschützte Seiten:''' Wenn eine Seite nicht kopiert werden kann - zum Beispiel, weil eine Entwurfsseite durch einen Begutachtungsprozess schreibgeschützt ist - werden Sie darüber informiert. Sie können dann entscheiden, ob Sie die Seite trotzdem überschreiben möchten. | '''Schreibgeschützte Seiten:''' Wenn eine Seite nicht kopiert werden kann - zum Beispiel, weil eine Entwurfsseite durch einen Begutachtungsprozess schreibgeschützt ist - werden Sie darüber informiert. Sie können dann entscheiden, ob Sie die Seite trotzdem überschreiben möchten. | ||
Nachdem die Auswahl der Seiten im Quellwiki abgeschlossen ist, öffnet sich ein neues Dialogfenster für den Transfer mit folgenden Informationen: | Nachdem die Auswahl der Seiten im Quellwiki abgeschlossen ist, öffnet sich ein neues Dialogfenster für den Transfer mit folgenden Informationen: | ||
* Name des Zielwikis | |||
* Eventuell ein Hinweis, dass in den Entwurfs-Namensraum übertragen wird (konfigurationsabhängig) | |||
* Liste der Inhalte, die transferiert werden. | |||
Anschließend werden der Fortschritt des Transfers und danach der Abschlussreport angezeigt. | Anschließend werden der Fortschritt des Transfers und danach der Abschlussreport angezeigt. | ||
Alle transferierten Seiten und Dateien bestehen weiterhin im Quellwiki und | Alle transferierten Seiten und Dateien bestehen weiterhin im Quellwiki und können manuell gelöscht werden, falls dies gewünscht ist. | ||
== Seiteninhalte zusammenführen == | |||
Übertragene Seiten und damit verbundene übertragene Ressourcen sind sofort als neue Revision im Ziel-Wiki verfügbar. | |||
Es ist jedoch in der [[Referenz:MergeArticles|Serverkonfiguration]] einstellbar, ob die Seiten und Elemente zunächst in einem Entwurfs-Namensraum landen und manuell geprüft und auf die Zieladresse "publiziert" werden. | |||
{{Icon|bi bi-arrow-right-circle|||}} Siehe Dokumentation zur Funktion [[Handbuch:Erweiterung/MergeArticles|MergeArticles]]. | |||
== | == Seiten mit Freigabemechanismus == | ||
Wenn eine Seite in einen Namenraum mit [[Handbuch:Erweiterung/ContentStabilization|Freigabemechanismus]] übertragen wird, muss die übertragene Seite von einem Benutzer mit Freigaberechten freigegeben werden. | |||
== Übertragungsfehler == | |||
* Wenn Seiten im Zielnamensraum bereits existieren und für das Bearbeiten gesperrt sind (zum Beispiel durch einen laufenden [[Handbuch:Erweiterung/Workflows|Workflow]]), können sie nicht übertragen werden. Dies wird über eine entpsrechende Fehlermeldung angezeigt. Alle anderen Seiten des gleichen Transfers werden übertragen. | |||
{{Box Links|Thema1=[[ | {{Box Links|Thema1=[[Handbuch:Erweiterung/MergeArticles]]}} | ||
{{translation}} | |||
Aktuelle Version vom 4. Juni 2025, 09:49 Uhr
Die Funktion "Push & Merge" in einer Wiki Farm ermöglicht es, Wikiseiten von einer Wiki-Instanz in eine andere Wiki-Instanz zu kopieren.
Farm-Instanzen vorbereiten[Bearbeiten | Quelltext bearbeiten]
Bevor Inhalte übertragen werden können, müssen die entsprechenden Farm-Instanzen über den Farm-Manager erstellt worden sein.
Namensräume abgleichen[Bearbeiten | Quelltext bearbeiten]
Wenn die Farm-Instanzen mit Namensräumen arbeiten, müssen im Quell- und Zielwiki die gleichen Namensräume existieren. Dies muss unbedingt vor dem Seitentransfer geprüft werden.
Ein nachträgliches Einrichten der Namensräume im Zielwiki ist schwierig, falls bereits Seiten aus einem Namensraum ins Zielwiki übertragen wurden und derselbe Namensraum dort nicht existiert.
In diesem Fall wird das Anlegen eines Namensraums zu einer Fehlermeldung führen, da es bereits im Hauptnamensraum Seiten mit dem gleichen Präfix gibt. Diese Seiten müssen dann entsprechend umbenannt werden, um das Präfix wieder "freizugeben".
Inhaltsplanung[Bearbeiten | Quelltext bearbeiten]
Über das Wurzelwiki werden die Inhaltswikis erstellt. Technisch kann aus jedem Inhaltswiki (Wiki-Instanz) in jedes andere Wiki übertragen werden. Häufig dient jedoch ein Wiki als Quellwiki für die Übertragung in ein oder mehrere andere Wikis. Es kann auch Wikis geben, in die nichts übertragen wird.
Eine Übertragung aus dem Wurzelwiki ist zwar technisch möglich, sollte allerdings zur Vereinfachung eventueller späterer Migrationen der Inhalte vermieden werden.
Falls in der Farmumgebung Instanznamen existieren, die einem ISO-639 Sprachkürzel entsprechen, wird dies automatisch von der Erweiterung TranslationTransfer als Sprachinstanz behandelt.
Die italienische Sprachinstanz hat z.B den Namen "IT". In einer Farm mit Übersetzungsmechanismus ist dieser Name daher "reserviert" und kann nicht für eine Instanz der IT-Abteilung genutzt werden. Diese könnte dann zum Beispiel als "IT-Wiki" angelegt werden.
Seiten übertragen[Bearbeiten | Quelltext bearbeiten]
Der Inhaltstransfer erfolgt über die Spezialseite Spezial:ContentTransfer des Wikis, von dem aus die Seiten übertragen werden.
Für den Inhaltstransfer benötigt ein Benutzer die nötigen Übertragungsrechte, die standardmäßig der Rolle admin zugewiesen sind.
Auswahl von Ziel- und Quell-Wiki[Bearbeiten | Quelltext bearbeiten]
- Empfangen: Auswahl des Wikis, in das die Inhalte kopiert werden. Das Ziel-Wiki befindet sich immer in derselben Wiki-Farm wie das Quell-Wiki.
- Verwandte Inhalte einschließen: Inhalte, die von den ausgewählten Seiten verlinkt sind (verlinkte Seiten, Dateien, Vorlagen), können in die Übertragung einbezogen oder ausgeschlossen werden.
Zu übertragende Seiten[Bearbeiten | Quelltext bearbeiten]
Der Filter zur Auswahl von Seiten wird über das Filter-Chevron (Screenshot Anmerkung 1) ausgeklappt. Folgende Suchfilter können zur Anzeige der im Quellwiki existierenden Seiten kombiniert werden werden:
- Modifiziert seit: zeigt nur Quellseiten an, die seit diesem Datum geändert wurden, unabhängig vom letzten Transfer
- Geändert seit der letzten Übertragung: zeigt nur Quellseiten an, die seit dem letzten Transfer geändert wurden. Das betrifft auch verlinkte Inhalte.
- Seitenname: Filtersuche nach bestimmten Seitentiteln
- Namensraum: zeigt Quellseiten aus einem bestimmten Namensraum an
- Kategorie: zeigt Quellseiten aus einer bestimmten Kategorie an
Die durch die Filtereinstellungen angezeigten Seiten können nun für den Transfer gewählt oder ausgeschlossen werden. Standardmäßig sind alle Seiten ausgewählt. Die Auswahl kann über den Umschalter Alle Auswählen (Screenshot Anmerkung 2) auf alle oder auf manuell ausgewählte Seiten gestellt werden.
Transfer starten[Bearbeiten | Quelltext bearbeiten]
Über die Schaltfläche Übertragen wird der Transfermechanismus gestartet.
- Maximale Anzahl der transferierten Seiten: Es können 200 Seiten pro Transfer kopiert werden. Wenn mehr Seiten kopiert werden sollen, müssen die Seiten über entsprechende Filterkriterien in mehrfachen Schritten kopiert werden.
- Namensraum erstellen: Wenn der Namensraum der ausgewählten Seiten nicht im Zielwiki existiert, wird beim Transfer ein entsprechender Hinweis angezeigt. Der Namensraum muss vor dem Transfer manuell im Zielwiki erstellt werden.
Kopieren der Seiten[Bearbeiten | Quelltext bearbeiten]
Über die Schaltfläche "Push" wird der Transfer anschließend ausgeführt. Der Transfermechanismus überträgt die ausgewählten Seiten und folgende mit den Seiten verbundene Seiten und Dateien:
- Kategorienseiten
- Bücher
- Vorlagen
- Dateien
Schreibgeschützte Seiten: Wenn eine Seite nicht kopiert werden kann - zum Beispiel, weil eine Entwurfsseite durch einen Begutachtungsprozess schreibgeschützt ist - werden Sie darüber informiert. Sie können dann entscheiden, ob Sie die Seite trotzdem überschreiben möchten.
Nachdem die Auswahl der Seiten im Quellwiki abgeschlossen ist, öffnet sich ein neues Dialogfenster für den Transfer mit folgenden Informationen:
- Name des Zielwikis
- Eventuell ein Hinweis, dass in den Entwurfs-Namensraum übertragen wird (konfigurationsabhängig)
- Liste der Inhalte, die transferiert werden.
Anschließend werden der Fortschritt des Transfers und danach der Abschlussreport angezeigt.
Alle transferierten Seiten und Dateien bestehen weiterhin im Quellwiki und können manuell gelöscht werden, falls dies gewünscht ist.
Seiteninhalte zusammenführen[Bearbeiten | Quelltext bearbeiten]
Übertragene Seiten und damit verbundene übertragene Ressourcen sind sofort als neue Revision im Ziel-Wiki verfügbar.
Es ist jedoch in der Serverkonfiguration einstellbar, ob die Seiten und Elemente zunächst in einem Entwurfs-Namensraum landen und manuell geprüft und auf die Zieladresse "publiziert" werden.
Siehe Dokumentation zur Funktion MergeArticles.
Seiten mit Freigabemechanismus[Bearbeiten | Quelltext bearbeiten]
Wenn eine Seite in einen Namenraum mit Freigabemechanismus übertragen wird, muss die übertragene Seite von einem Benutzer mit Freigaberechten freigegeben werden.
Übertragungsfehler[Bearbeiten | Quelltext bearbeiten]
- Wenn Seiten im Zielnamensraum bereits existieren und für das Bearbeiten gesperrt sind (zum Beispiel durch einen laufenden Workflow), können sie nicht übertragen werden. Dies wird über eine entpsrechende Fehlermeldung angezeigt. Alle anderen Seiten des gleichen Transfers werden übertragen.
