Hinweise und optimale Vorgehensweisen für das Löschen von versionierten Dokumenten
Hinweise zum Löschen von Versionen
• Versionierter Inhalt kann Teil einer oder mehrerer Versionen eines ausgewählten Dokuments sein. Obwohl es möglich ist, jede Version zu löschen, werden versionierte Inhalte, die zu mehr als einer Version des Dokuments gehören, aus dem Löschvorgang ausgeschlossen. Durch solche Ausschlüsse werden die Daten und die strukturelle Integrität der versionierten Dokumente, die versionierte Inhalte gemeinsam nutzen, beibehalten. Solche Versionsinhalte werden in der API-Ausgabe des im deletesegment-Befehls mit der -- reportOnly-Option als ExcluedContents aufgelistet. Die versionierten Knoten, die in anderen versionierten Dokumenten verwendet werden, werden beibehalten. Wenn beispielsweise das Versionsdokument 1.1 den Inhalt 1.1 enthält und das Versionsdokument 1.2 ebenfalls den Inhalt 1.1 enthält, wird beim Löschen des Versionsdokuments 1.1 oder 1.2 der Inhalt 1.1 nicht gelöscht.
• Die versionierten Inhalte und die versionierten, gemeinsam genutzten Elemente, die von keinem anderen versionierten Dokument als dem zu löschenden referenziert werden, werden zusammen mit dem ausgewählten versionierten Dokument gelöscht.
• Die Elemente, die zu dem gelöschten versionierten Dokument bzw. Inhalt gehören, werden mit Anmerkungen gekennzeichnet, die die interne ID des gelöschten versionierten Dokuments bzw. des gelöschten versionierten Inhalts, den Benutzer, der den Löschvorgang ausgeführt hat, und den Zeitstempel der Operation angeben.
• Nach dem Löschen aller Versionen des Live-Dokuments erstellt die nachfolgende Versionierungsoperation erzwungene Versionen von Elementen, für die die Version gelöscht wurde. Dieser erzwungene Versionierungsoperation darf die Verfolgungen in den generierten Versionen des Live-Dokuments nicht kopieren.
• Ein versioniertes Dokument, das eingeschlossene oder eingefügte Inhalte oder Dokumente enthält, kann gelöscht werden.
Optimale Vorgehensweisen für das Löschen von Versionen
• Löschen Sie die versionierten Dokumente nur als Vorbedingung für das Löschen eines Live-Dokuments.
• Löschen Sie Versionsdokumente nicht willkürlich. Löschen Sie alle versionierten Dokumente der Reihenfolge nach, beginnend mit der letzten Version bis zur ersten.
• Nach dem Löschen eines oder mehrerer versionierter Dokumente sollten Sie es vermeiden, nachfolgende Versionierungsoperationen aufzurufen.
• Löschen Sie bei einem Dokument das Live-Dokument und alle zugehörigen Dokumentversionen in einer einzigen API-Sitzung. Dies verhindert eine Änderung des Live-Dokuments, der versionierten Dokumente oder spätere Versionierungsversuche des Dokuments durch Benutzer.
• Implementieren Sie einen genau definierten Prozess zum Löschen von Dokumenten gemäß Ihren Geschäftsanforderungen.
• Die Live-Dokumente und deren Versionen, die gelöscht werden, dürfen nicht aktiv in der Verwendung oder Entwicklung sein. Beispiel:
◦ Die Dokumente dürfen nicht angezeigt werden oder sich in Bearbeitung befinden oder versioniert werden.
◦ Sie sind nicht zum Erstellen von Verfolgungen und Hinzufügen von Beziehungen auf Segment- und Inhaltsebene verfügbar.
◦ Sie sind nicht Teil von Dokumenten und Inhalten, die für Berechnungen oder Änderungspakete verwendet werden. Zur Vermeidung von Inkonsistenzen in den berechneten Feldwerten sollte das Dokument oder sein Inhalt nicht direkt oder indirekt Teil der Formel für die Feldberechnung sein. Falls das für den Löschvorgang ausgewählte Dokument oder sein Inhalt Teil der Feldberechnungen ist, kommt es zu unterschiedlichen Feldberechnungswerten vor und nach dem Löschen.
Hinweise und optimale Vorgehensweisen für das Löschen von versionierten Testdokumenten
Wenn Excluded Contents zu den Testsitzungen hinzugefügt wurde, wobei eine Version des Testdokuments als Kontext verwendet wurde, wird Excluded Contents aus allen Testsitzungen entfernt, wenn eine Version des Testdokuments gelöscht wird. Die folgende Abbildung zeigt ein Beispiel.
Durch das Löschen der Testdokument-Version 123-1.0 wird ExcludedContent 124-1.0 aus beiden Testsitzungen, d.h. Testsitzung 1 und Testsitzung 2, entfernt.
Es empfiehlt sich, die Option Alle Inhaltselemente für alle nachfolgenden Eincheckoperation des Live-Testdokuments zu verwenden, damit versionierte Testfälle nicht aus allen zugehörigen Testsitzungen entfernt werden. Dies stellt sicher, dass jedes Mal, wenn das Live-Testdokument versioniert wird, auch die Inhaltselemente versioniert und somit nicht aus den Testsitzungen entfernt werden, wenn eine Version des Testdokuments gelöscht wird. Die folgende Abbildung zeigt ein Beispiel.
Durch das Löschen der Testdokument-Version 123-1.0 wird nur der Testfall aus der Testsitzung 1 entfernt.
Weitere Informationen zu ausgeschlossenen Inhalten finden Sie unter
im deletesegment.