Durchsuchbare Dokumentation aufrufen

Zurück zur Dokumentationsübersicht

Texte ersetzen

Hinweis: Diese Dokumentation bezieht sich auf die aktuellste Version des agorum core template managers. Aktualisieren Sie ggf. das hier beschriebene Plug-in, um die Dokumentation verwenden zu können.

Mit dieser Aktion ersetzen Sie Texte innerhalb von Textdateien.

Achtung: Datenverlust von Inhalten / Texten durch falsche Codierung. Wenn Sie eine andere Codierung als UTF-8 verwenden, können Dateien / Texte beschädigt werden und nicht mehr nutzbar sein. Verwenden Sie für Ihre eigenen Dateien, in denen Sie Text ersetzt möchten, stets die UTF-8-Codierung.

Dateien, die innerhalb agorum core mit den mitgelieferten Editoren erstellt werden, sind UTF-8 kodiert.

Das Ersetzen starten

Sie starten das Ersetzen mit verschiedenen Aktionen je nach Dokumentart:

Nachdem Sie eine dieser Aktionen durchgeführt haben, öffnet sich die Ersetzungsoberfläche oder Sie sehen den Dialog Es sind noch Undo-Files vorhanden.

Das Ersetzen bei der Dokumenart „*.dfdl“ starten

Bei dieser Dokumentart handelt es sich um docform-Trainings, die automatisch UTF-8 codiert sind.


Aktion

agorum core template manager > Replace in dfdl (DocForm - Training)

Das Ersetzen bei der Dokumentart „*.* (ohne *.dfdl)“ starten

Bei dieser Dokumentart handelt es sich um alle Dateien, die nicht UFT-8-codiert sind. Sie erhalten eine Warnung, dass die Dateien UTF-8 codiert sein müssen.


Aktion

agorum core template manager > Replace in Text

Die Ersetzungsoberfläche

Über die Ersetzungsoberfläche steuern Sie die Ersetzung der gewünschten Texte.

Die Ersetzungsoberfläche

 

  1. Eingabebereich
    Im Eingabebereich geben Sie verschiedene Dinge an.
  2. Liste der Dokumente
    In diesem Bereich sehen Sie alle für die Ersetzung gewählten Dokumente. Mit einem Klick auf ein Dokument sehen Sie dieses im Bereich 3.
  3. Aktuelles Dokument
    In diesem Bereich sehen Sie das aktuell gewählte Dokument.
  4. Undo-File des Dokuments
    In diesem Bereich vergleicht das System das aktuelle Dokument aus Bereich 3 mit dem Undo-File des Dokuments, der den Stand vor dem Start des Vergleichs repräsentiert.

    Das System erstellt das Undo-File vor dem ersten Ersetzen eines Dokuments. Auf diesem Undo-File können Sie wieder zurückfahren, wenn Sie die durchgeführten Ersetzungen nicht übernehmen möchten.

Der Eingabebereich

Eingabebereich der Ersetzungsoberfläche


Beschreibung der Elemente im Eingabereich

Element Beschreibung
ACHTUNG
  • Diese Warnung erscheint nur bei Dokumenten, die die Dateiendung .dfdl nicht besitzen.
  • Die Warnung erscheint nicht, wenn es noch unbestätigte Ersetzungen gibt.
Änderung OK - Undo-Files löschen Bestätigt eine Ersetzung.
  • Das System löscht alle Undo-Files.
  • Die Schaltfläche erscheint nur, wenn es Undo-Files gibt, die Sie nicht bestätigt haben.
  • Wenn Sie die Ersetzung bestätigen, können Sie diese nur noch über die History der Dokumente rückgängig machen.
Load csv Lädt eine vom Benutzer gespeicherte CSV-Datei, die dann die Liste mit alten und neuen Werten belegt.
  • Am Anfang existieren keine CSV-Dateien. Diese müssen Sie zuerst speichern (siehe Element Ersetzungen speichern als csv).
  • Wenn Sie Ihre Eingabe als CSV-Datei speichern, übernimmt das System diese gespeicherte CSV in dieses Feld und zeigt sie an.
"Nicht eindeutig" erlaubt Erlaubt ein nicht eindeutiges Ersetzen.
Zu ersetzender Text

Erfasst Wertepaare, die aus Alter Wert und Neuer Wert bestehen.

  • Die Reihenfolge ist für die Eingabe unwichtig.
  • Das System sortiert die Wertepaare vor dem Ersetzen der Länge nach und ersetzt sie dann von lang nach kurz.
  • Über erstellen Sie weitere Listenfelder, die Sie befüllen können.
Ersetzungen speichern als csv Erlaubt die Eingabe einer beliebigen Datei.
  • Das System speichert Ihre Eingabe in der Liste als CSV-Datei, wenn Sie Speichern rechts neben dem Eingabefeld anklicken.
  • Geben Sie die Datei ohne Endung .csv an.
Änderung rückgängig machen Macht eine Änderung rückgängig. 

Das System:
  • erstellt eine Historie
  • schreibt den Inhalt des Undo-Files in die Originaldatei
  • löscht das Undo-File

Nicht eindeutiges Ersetzen

Wenn Sie in einem Dokument Worte ersetzen und diese Ersetzung durch nochmaliges Ersetzen wieder rückgängig machen, erhalten Sie am Ende nicht mehr dasselbe Dokument.


Beispiel
Sie wollen das Wort Rechnungsnummer in Rechnungs-Nr ersetzen. Vor dem Ersetzen prüft das System, ob das Wort Rechnungs-Nr in dem Dokument vorkommt. Ist dies der Fall, bricht es das Ersetzen ab, weil das Ersetzen nicht mehr eindeutig ist und weil eine Rückübersetzung jetzt mehr Werte (Rechnungs-Nr in Rechnungsnummer) ersetzen würde.

Möchten Sie dies zulassen, aktivieren Sie diese Option.

Dialog „Es sind noch Undo-Files vorhanden“

Der Dialog Es sind noch Undo-Files vorhanden öffnet sich, wenn Sie die Ersetzung starten wollen und noch Undo-Files vorhanden sind.