Die Funktion "Projekt importieren" in Document360 ermöglicht es Ihnen, eine zuvor exportierte ZIP-Datei in jedes Projekt einzuführen und Ihre Artikel, Kategorieseiten und Mediendateien in einem Schritt wiederherzustellen oder zu migrieren. Dies ist nützlich, wenn man Inhalte zwischen Projekten verschoben oder von einem Backup wiederherstellt. Der Importprozess validiert die ZIP-Datei, bevor Änderungen vorgenommen werden, sodass du vor dem Commit überprüfen kannst, was hinzugefügt wird.
Wann man die Import-Projekt-Funktion verwendet
Nutzen Sie diese Funktion, wenn Sie:
- Inhalte migrieren – Artikel und Kategorien von einem Document360-Projekt auf ein anderes übertragen.
- Wiederherstellen aus einem Backup – importieren Sie eine zuvor exportierte ZIP-Datei erneut, um verlorene oder überschriebene Inhalte wiederherzustellen.
- Arbeitsbereiche konsolidieren – Inhalte eines exportierten Projekts in einen bestehenden Arbeitsbereich zusammenführen, der denselben Slug teilt.
Bevor du anfängst
- Du musst die Rolle Editor Content haben, um ein Projekt zu importieren.
- Für benutzerdefinierte Inhaltsrollen muss dein Konto Zugriff auf Aktualisieren und Veröffentlichen auf die Funktion Project Import & Export haben.
- Die ZIP-Datei muss ein Document360-Projektexport sein. ZIP-Dateien von anderen Plattformen werden nicht unterstützt.
- Die maximal unterstützte ZIP-Dateigröße beträgt 1 GB.
- Wenn die ZIP-Datei Sprachen enthält, die im Zielarbeitsbereich nicht vorhanden sind, fügen Sie diese Sprachen vor dem Import dem Zielarbeitsbereich hinzu.
Wie man eine Projekt-ZIP-Datei importiert
- Fahren Sie mit der Maus über die Inhaltswerkzeuge in der linken Navigationsleiste.
- Im Untermenü navigieren Sie zu Import und Export > Projekt Importieren und exportieren.
- Klicken Sie auf die Schaltfläche Importieren .
Das Import-Projekt-Panel öffnet sich. - Ziehen Sie Ihre Projekt-ZIP-Datei in das Panel oder klicken Sie auf Hochladen , um die Datei aus Ihrem lokalen Speicher auszuwählen.
Document360 lädt die ZIP-Datei automatisch hoch und validiert sie. - Wenn du eine andere Datei verwenden musst, klicke auf Ersetzen.
- Nach erfolgreicher Validierung wird die Bestätigungsmeldung überprüft, die Folgendes anzeigt:
- Sprachen , die in der ZIP-Datei enthalten sind
- Anzahl der Kategorien
- Anzahl der Artikel
- Wählen Sie das Kästchen Artikel zum Veröffentlichen setzen , wenn Sie möchten, dass alle importierten Artikel sofort veröffentlicht werden. Wenn sie nicht aktiviert sind, werden alle importierten Artikel auf Entwurf gesetzt.
- Klicken Sie auf Importieren , um den Prozess abzuschließen.
Alle Artikel und Mediendateien aus der ZIP-Datei sind jetzt im Zielprojekt verfügbar.
Importiere Projekte mit demselben Workspace-Slug
Wenn der Workspace-Slug in der ZIP-Datei mit dem Workspace-Slug des Zielprojekts übereinstimmt, verschmelzen die importierten Artikel und Kategorien mit den vorhandenen Inhalten in diesem Workspace.
Import in ein Projekt mit einem anderen Workspace-Slug
Wenn sich der Workspace-Slug in der ZIP-Datei vom Slug des Zielprojekts unterscheidet, erstellt Document360 einen neuen Workspace mit dem Namen und dem Slug aus dem importierten Projekt. Alle importierten Inhalte werden diesem neuen Arbeitsbereich hinzugefügt.
Importieren einer ZIP-Datei in einen bestimmten Arbeitsbereich, ohne bestehende Inhalte zu überschreiben
Um Inhalte in einen bestimmten Arbeitsbereich zu importieren und dabei Konflikte mit bestehenden Artikeln oder Slug-Mismatches zu vermeiden, bearbeiten Sie die ZIP-Datei manuell vor dem Import.
- Exportiere die gewünschten Kategorien aus deinem Quell-Document360-Projekt als ZIP-Datei.
- Entpacke die ZIP-Datei auf deinem lokalen Rechner.
Der extrahierte Ordner enthält zwei Verzeichnisse:- Medien – alle Mediendateien aus dem Projekt.
- workspace_slug — enthält einen Artikelordner , einen Kategorien-Ordner und eine
workspace_slug_category_articlesJSON-Datei.
- Öffnen Sie die
workspace_slug_category_articlesDatei in einem Code-Editor. - Aktualisieren Sie den Namen des Arbeitsbereichs und den Slug, sodass sie mit dem Zielarbeitsbereich übereinstimmen.
- Speichere die Datei und benenne sie mit dem Ziel-Workspace-Slug-Format:
workspace_slug_category_articles.
Beispiel:v2_category_articles - Falls nötig, aktualisieren Sie die Slugs einzelner Artikel oder Kategorien und passen Sie den Sprachcode in den extrahierten Ordnern an.
- Komprimiere alle veränderten Dateien in eine neue ZIP-Datei, die nach dem Ziel-Arbeitsbereich-Slug benannt ist.
- Kehren Sie zu Ihrem Document360-Projekt zurück und importieren Sie die neu erstellte ZIP-Datei nach den Standard-Importschritten.
Die obige Bildschirmaufnahme zeigt, wie man den Arbeitsbereichs-Slug und -Namen von v1 auf v2 in den extrahierten Dateien ändert, sie neu komprimiert und die aktualisierte ZIP in das v2-Projekt importiert.
Häufige Gründe für das Importversagen
Wenn dein Import fehlschlägt, überprüfe Folgendes:
| Grund | Auflösung |
|---|---|
| Nicht unterstützte Funktionen | Die ZIP enthält Arbeitsbereiche, Sprachen oder Funktionen, die in Ihrem aktuellen Tarif nicht verfügbar sind. Mit der Maus über das Info-Symbol für Details. |
| Nicht zusammenpassende Slugs oder Arbeitsbereichsnamen | Stellen Sie sicher, dass der Name des Arbeitsbereichs und der Slug in der ZIP-Datei mit dem Zielprojekt übereinstimmen, bevor Sie ihn hochladen. |
| Falsches Dateiformat | Überprüfen Sie, dass die ZIP der erforderlichen Document360-Exportstruktur entspricht. |
| Fehlende Sprachen im Ziel | Füge die erforderlichen Sprachen vor dem Import dem Zielarbeitsbereich hinzu. |
| Workspace-Limit erreicht | Wenn Slugs unterschiedlich sind, versucht Document360, einen neuen Arbeitsbereich zu erstellen. Wenn das Projekt sein Arbeitsbereichslimit erreicht hat, löschen Sie entweder einen ungenutzten Arbeitsbereich oder aktualisieren Sie die ZIP-Datei so, dass sie mit einem bestehenden Arbeitsbereich übereinstimmt. |
Best Practices
- Validiere Workspace-Slugs vor dem Hochladen – ungleiche Slugs erstellen stillschweigend einen neuen Workspace, anstatt Inhalte zu verschmelzen. Bestätigen Sie, dass Quell- und Ziel-Slugs übereinstimmen, bevor Sie beginnen.
- Erstellen Sie Inhalte nach dem Import unmittelbar nach dem Import neu – Vorlagen, Variablen, Ausschnitte und Glossarbegriffe sind aus dem ZIP ausgeschlossen. Erstellen Sie sie sofort im Zielprojekt, um fehlerhafte Referenzen in neu importierten Artikeln zu vermeiden.
- Testen Sie zuerst mit einer einzelnen Kategorie – für große Projekte exportieren und importieren Sie eine Kategorie, bevor Sie den vollständigen Import ausführen. Das bestätigt, dass deine Slug-Konfiguration und das Arbeitsbereichsmapping korrekt sind, bevor du dich auf eine Massenoperation einlässt.
FAQ
Was passiert mit meinen vorhandenen Inhalten, wenn ich eine Document360-Projekt-ZIP-Datei importiere?
Das Ergebnis hängt davon ab, ob die Workspace-Slugs übereinstimmen. Wenn die Slugs übereinstimmen, fusionieren importierte Artikel und Kategorien mit bestehenden Inhalten in diesem Arbeitsbereich. Wenn die Slugs unterschiedlich sind, wird für den importierten Inhalt ein neuer Arbeitsbereich erstellt. Das Importieren beeinflusst deine Projekteinstellungen nicht, und Artikel, die nicht in der ZIP-Datei enthalten sind, bleiben unverändert.
Sind Vorlagen, Variablen, Ausschnitte und Glossar beim Import eines Projekts enthalten?
Nein. Elemente der Wiederverwendung von Inhalten – Vorlagen, Variablen, Ausschnitte und Glossarbegriffe – werden weder exportiert noch importiert. Es sind nur Artikel und Mediendateien enthalten. Sie müssen diese Elemente manuell im Zielprojekt neu erstellen.
Was passiert, wenn ich eine ZIP-Datei in dasselbe Projekt importiere, aus dem sie exportiert wurde?
Alle Artikel in der ZIP-Datei, die mit bestehenden Artikeln im Projekt übereinstimmen, werden mit der Version aus der ZIP-Datei überschrieben. Artikel, die im Projekt existieren, aber nicht in der ZIP-Datei sind, bleiben unverändert.
Wie finde ich den Workspace-Slug für mein Projekt?
- Navigiere zu Einstellungen () in der linken Navigationsleiste des Knowledge Base-Portals.
- Im linken Navigationsbereich gehen Sie zum Knowledge Base-Portal > Lokalisierung & Arbeitsbereiche.
- Fahren Sie mit der Maus über den gewünschten Arbeitsbereich und klicken Sie auf das Symbol Bearbeiten ().
- Im Arbeitsbereich bearbeiten finden Sie den Slug im Feld Slug-URL .
Kann ich ZIP-Dateien von anderen Plattformen in Document360 importieren?
Nein. Es werden nur ZIP-Dateien unterstützt, die von der Projektexportfunktion von Document360 generiert werden. ZIP-Dateien von anderen Wissensdatenbankplattformen können nicht importiert werden.
Wie hoch ist die maximale ZIP-Dateigröße, die ich hochladen kann?
Document360 unterstützt das Hochladen von Projekt-ZIP-Dateien bis zu einer maximalen Größe von 1 GB.