Aufbau der Excel-Dateien für das Taxonomie-und Dokumenttyp-Management

Beim Ausführen des Transformationsszenarios Taxonomie-Management 1 - Taxonomie-Werte in CSV-Datei exportieren (auf Rahmendatei anwenden) wird das XQuery-Skript export_current_taxonomie_values.xquery (zu finden unter V:\ContentManagement\EP\Tools\Oxygen-Konfiguration\taxonomie-management\xquery\) auf die aktuell in Oxygen ausgewählte Rahmendatei angewendet. Das Skript extrahiert aus allen Instanzdateien, die sich im gleichen Ordner wie die Rahmendatei befinden, die ID des betreffenden <esv.instanz>-Elements, die aktuell diesem Element zugewiesenen Taxonomie- und Dokumenttypwerte sowie weitere, vom Lektorat/Produktmanagement zur Bearbeitung der Excel-Datei benötigte Metadaten in eine CSV-Datei.

Der Name der CSV-Datei ist nach folgendem Schema aufgebaut:

Aktuell_verwendete_Taxonomien_Produkt-ID der Rahmendatei.csv

Der Aufbau der CSV-Datei erfolgt nach den folgenden Prinzipien:
  • Pro Taxonomie-Eintrag vom Typ ESV-Digital-Taxonomie (<taxonomie name="ESV-Digital-Taxonomie" .../>), der einem Element <esv.instanz> einer Instanzdatei zugewiesen ist, wird eine Zeile in der CSV-Datei erzeugt. Wenn einem <esv.instanz>-Element also mehrere Taxonomie-Einträge zugewiesen sind, enthält die CSV-Datei eine entsprechende Anzahl an Zeilen für dieses Instanz-Element.
  • Ist einem <esv.instanz>-Element (noch) kein ESV-Digital-Taxonomie-Eintrag zugewiesen, wird trotzdem eine Zeile für dieses <esv.instanz>-Element in der CSV-Datei erzeugt, um dem Lektorat/Produktmanagement später zu ermöglichen, bei Bedarf passende Taxonomie-Werte für dieses Element zu vergeben.
  • Jede Zeile enthält die folgenden, jeweils durch drei Rauten-Symbole (###) getrennten Informationen:
    • Titel des Werks, zu dem die Instanzdatei gehört
    • Publikationsdatum der Instanz (esv_instanz/@publikationsdatum) (sofern vorhanden)
    • Kennzahl der Instanz (sofern vorhanden)
    • Lieferungsangabe (sofern vorhanden) der Instanz als kommagetrennte Liste (esv.instanz//seitenbeginn/@lfg)
    • Titel der Abschnitte, die der Instanz übergeordnet sind (sofern vorhanden)
    • Titel der Instanz
    • ID der Instanz
    • URL der Seite der Instanz auf Preview
      Anmerkung:
      Der URL wird automatisch anhand der Instanz-ID erzeugt; eine Prüfung auf Gültigkeit der URL oder Vorhandensein der Seite auf Preview findet nicht statt.
    • Dokumenttyp der Instanz, abgeleitet aus /esv.instanz/meta/metaeintrag[@name="esv-digital-instanztyp] (sofern vorhanden)
      Anmerkung:
      Die aus dem Instanztyp ableitbaren ESV-Dokumenttypen werden hier nicht ausgegeben, sondern nur die Spezialfälle, deren Werte über /esv.instanz/meta/metaeintrag[@name="esv-digital-instanztyp] explizit angegeben werden müssen.
    • Bestandteile des Taxonomie-Eintrags. Das Skript splittet hierzu den Wert von <taxonomie name="ESV-Digital-Taxonomie" .../> anhand der Tilden-Symbole auf maximal drei separate Werte für die Taxonomie-Ebenen 1 bis 3 auf.
      Anmerkung:
      ESV-Digital kann Taxonomien mit maximal drei Hierarchie-Ebenen verarbeiten. Falls in den Bestanddaten Taxonomiewerte enthalten sein sollten, die irrtümlich vier oder mehr Hierarchie-Ebenen abbilden, werden diese zusätzlichen Hierarchie-Ebenen beim Export ignoriert.