Um einem Packaging-Projekt eine TXT-Änderungsaufgabe hinzuzufügen, wechseln Benutzer in die TXT-Änderungs-Ansicht des Modus Visual Designer.
Mit einem Klick auf die Schaltfläche Create new... wird der Assistent zur Aufgabenerstellung aufgerufen.
Arbeiten Sie sich durch die Schritte des Assistenten, um alle erforderlichen Eigenschaften für die neue Aufgabe zu definieren.
Jederzeit können Benutzer mithilfe der Schaltflächen Next oder Back, die am unteren Rand des Assistentendialogs angezeigt werden, innerhalb der bereits bearbeiteten Schritte navigieren.
Um den Assistenten zu verlassen, ohne ein neues Objekt zu erstellen, verwenden Sie die Schaltfläche Cancel, die sich ebenfalls am unteren Rand des Assistentendialogs befindet.
Schritt 1: Beschreibung
Der Name der Aufgabe muss als eindeutige alphanumerische Zeichenkette angegeben werden. Sonderzeichen (z. B. Leerzeichen, Gleichheitszeichen (=), Ausrufezeichen (!), Plus (+), Minus (-) oder Sternchen (*)) sind nicht erlaubt.
Da die Beschreibung die Eigenschaft ist, die in der Aufgabenliste der TXT-Änderungs-Ansicht angezeigt wird, wird empfohlen, einen selbsterklärenden Wert zu verwenden. Dadurch ist es einfacher, schnell auf eine bestimmte Aufgabe aus einer langen Liste zuzugreifen.
Solange das Eingabefeld mit rotem Hintergrund markiert ist, ist der Wert noch nicht gültig. Bewegen Sie den Mauszeiger über das Eingabefeld, um die Meldung anzuzeigen, die angibt, was getan werden muss, um eine gültige Aufgabenbeschreibung zu erhalten.
Schritt 2: Komponente
Jede Änderungsaufgabe muss einer bestimmten Komponente zugeordnet sein. Um die Komponente aus dem vorhandenen Satz des aktuellen Packaging-Projekts auszuwählen, erweitern Benutzer das Auswahlsteuerelement und klicken auf die gewünschte Komponente.
Wenn eine neue Komponente erstellt werden muss, klicken Benutzer auf die Schaltfläche [...] auf der rechten Seite des Komponentenauswahlsteuerelements. Der Komponentenauswahl-Dialog wird angezeigt. Weitere Details finden Sie im entsprechenden Common Dialogs-Thema.
Schritt 3: Textänderungstyp
Zwei grundlegende TXT-Änderungstypen stehen zur Verfügung:
Find & Replace
Sucht nach einer bestimmten Zeichenkette oder einer dem angegebenen Muster entsprechenden Zeichenkette und ersetzt den ursprünglichen Inhalt.
Find & Append
Sucht nach einer bestimmten Zeichenkette oder einer dem angegebenen Muster entsprechenden Zeichenkette und fügt zusätzlichen Text an.
Diese Option wird hauptsächlich verwendet, wenn beim Suchalgorithmus ein regulärer Ausdruck ausgewertet wird und die variierenden ursprünglichen Textphrasen, die tatsächlich dem Suchmuster entsprechen, nicht durch eine gemeinsame neue Phrase ersetzt werden sollen.
Um eine der beiden Optionen auszuwählen, klicken Sie auf die entsprechende Kachel. Die aktuell aktive Option ist mit einem Häkchensymbol in der oberen rechten Ecke der Typkachel markiert.
Schritt 4: Suchen und Ersetzen
Entsprechend dem ausgewählten Änderungstyp werden die in dieser Ansicht eingegebenen Werte zur Ausführung der Textänderung interpretiert:
Suchen nach
Die Definition der eigentlichen Zeichenkette oder des Musters, nach dem gesucht wird.
|
Hinweis: Wenn der eingegebene Wert als reguläres Ausdrucksmuster ausgewertet werden soll, muss die Suchoption Regulärer Ausdruck aktiviert werden. |
Ersetzen/Anfügen durch
Der neue Inhalt, der als Ersatz oder Ergänzung verwendet wird. Der hier angegebene Wert muss der tatsächliche Text sein; reguläre Ausdrücke werden nicht ausgewertet.
|
Hinweis: Wie durch die eckigen Klammern ("[]") auf der rechten Seite der Eingabefelder für Suchen und Ersetzen/Anfügen angegeben, ist es möglich, Syntaxvorschläge zur Definition der Suchzeichenkette zu verwenden. Geben Sie einfach eine öffnende eckige Klammer ("[") ein, um die Liste der verfügbaren Vorschläge für Eigenschafts- und Pfadwerte anzuzeigen. Wählen Sie den gewünschten Wert aus der Liste aus, um ihn zur bereits eingegebenen Suchzeichenkette hinzuzufügen. Der tatsächliche Wert zur Laufzeit wird für die Aufgabenausführung verwendet. |
Groß-/Kleinschreibung beachten
Wenn dieses Kontrollkästchen aktiviert ist, muss die Groß-/Kleinschreibung der in der Suchzeichenkette verwendeten Buchstaben mit der Groß-/Kleinschreibung der Treffer im durchsuchten Dateiinhalt übereinstimmen. Diese Option gilt nur für exakte Suchen, nicht für Suchen mit regulären Ausdrücken.
Nur ganzes Wort suchen
Das Aktivieren dieses Kontrollkästchens deaktiviert das Standardverhalten von RayPack, nach jedem Vorkommen der Suchzeichenkette zu suchen. Wenn das Kontrollkästchen aktiviert ist, wird die Zeichenkette nur als Treffer gewertet, wenn sie als vollständiges Wort gefunden wird, d. h. es muss ein Leerzeichen vor der Zeichenkette stehen.
Diese Option muss aktiviert werden, wenn der Suchbegriff für die Suche mit regulären Ausdrücken vorgesehen ist. Auch wenn der Suchbegriff ein regulärer Ausdruck ist, wird er nicht vom Auflösungsmodul ausgewertet, solange die Suchoption "Regulärer Ausdruck" inaktiv ist.
|
WARNUNG Reguläre Ausdrücke sind sehr leistungsfähige Werkzeuge, die für äußerst komplexe Manipulationsanforderungen eingesetzt werden können. Jedoch kann jedes leistungsfähige Werkzeug bei falscher Anwendung erheblichen Schaden anrichten. Daher wird dringend empfohlen, reguläre Ausdrücke nur auf klar definierte Zieldateigruppen anzuwenden. Verantwortliche Packaging-Ingenieure sollten sicherstellen, dass wichtige Ressourcen der Betriebssysteme auf den Zielrechnern nicht durch ihre Pakete beschädigt werden. |
Nur einmal ersetzen
Textersetzungen werden normalerweise für alle übereinstimmenden Zeichenketten innerhalb der angegebenen Pfad- und Dateitypspezifikation ausgeführt (siehe nächster Schritt: Dateien und Ordner). Wenn dieses Kontrollkästchen aktiviert ist, wird nur das erste Vorkommen ersetzt.
Schritt 5: Dateien und Ordner
In diesem Schritt müssen die Dateien definiert werden, die von der Änderungsaufgabe berücksichtigt werden sollen:
Zielordner
Der Ordner auf dem Zielrechner, der nach passenden Dateien durchsucht wird.
Wie durch die eckigen Klammern ("[]") auf der rechten Seite des Eingabefelds angegeben, ist es möglich (und empfohlen), Syntaxvorschläge zur Definition des Zielordners zu verwenden. Geben Sie einfach eine öffnende eckige Klammer ("[") ein, um die Liste der verfügbaren Vorschläge für Eigenschafts- und Pfadwerte anzuzeigen. Wählen Sie den gewünschten Wert aus der Liste aus, um ihn zum bereits eingegebenen Text im Eingabefeld hinzuzufügen. Der tatsächliche Eigenschafts- oder Pfadwert zur Laufzeit wird für die Aufgabenausführung verwendet.
|
Achtung: Die Definition des Zielordners kann ganze Systemlaufwerke abdecken, z. B. das Laufwerk C: des Zielrechners. Wenn die Option "Unterordner einschließen" aktiviert ist, durchsucht die Änderungsaufgabe jedes Verzeichnis auf dem definierten Laufwerk nach Dateien mit übereinstimmendem Inhalt. Abhängig von der Systemleistung und der Anzahl der Dateien auf diesem Laufwerk können solche globalen Zieldefinitionen während der Installations- und/oder Deinstallationssequenzen des Softwarepakets zu schwerwiegenden Problemen führen. Daher wird dringend empfohlen, die Zielordnerdefinition auf den kleinstmöglichen erforderlichen Bereich zu beschränken. |
Das Feld für den Zielordner darf nicht leer bleiben.
Unterordner einschließen
Das Standardverhalten bei Änderungsaufgaben ist, alle Dateien im definierten Zielordner auf den Suchbegriff zu prüfen – Dateien in Unterordnern werden nicht berücksichtigt. Das Aktivieren dieses Kontrollkästchens richtet eine Suchaufgabe ein, die alle Dateien unterhalb des Zielordners berücksichtigt, unabhängig von der Verschachtelungstiefe.
Bitte beachten Sie, dass das Einbeziehen von Unterordnern die Ausführungsleistung der Sequenz des Zielpakets erheblich beeinträchtigen kann.
Dateien einschließen
Die Dateien im definierten Zielordner, die von der Änderungsaufgabe berücksichtigt werden sollen. Die Dateiliste ist eine kommagetrennte Liste von entweder tatsächlichen Dateinamen (z. B. "file1.txt,file2.htm") oder Dateierweiterungen (z. B. "*.txt,*.htm"). Kombinationen beider Werttypen sind ebenfalls gültig.
Der Platzhalteroperator Sternchen ("*") kann verwendet werden, um benutzerdefinierte Dateigruppen über Dateierweiterungen hinaus abzudecken, z. B. mit Definitionen wie AnyFile*.ini, um eine Gruppe von Dateien mit einem Indexzähler im Dateinamen zu erfassen.
Das Feld für einzuschließende Dateien darf nicht leer bleiben.
Dateien ausschließen
Jede Regel ist nur so gut wie ihre beste Ausnahme. Daher ist es möglich, die Liste der eingeschlossenen Dateien zu reduzieren, um z. B. System- oder Lizenzdateien vor unerwünschter Manipulation zu schützen. Alle in dieser kommaseparierten Liste aufgeführten Dateien werden von der Änderungsaufgabe nicht betroffen, selbst wenn Zielordner, Einschränkung der einzuschließenden Dateien und Suchbegriffdefinition übereinstimmen würden.
Während die Liste der einzuschließenden Dateien normalerweise eine Kombination von Dateitypen nach Dateierweiterung ist (z. B. "*.xml"), ist die Liste der auszuschließenden Dateien in der Regel eine Liste spezifischer Dateien. Auch hier kann der Platzhalteroperator Sternchen ("*") zur Erweiterung der Definition verwendet werden.
Schritt 6: Ausführungstyp
Textmanipulationen können während der Laufzeit der Paketinstallation und/oder -deinstallation ausgeführt werden. Aktivieren Sie den gewünschten Ausführungstyp durch Klicken auf die entsprechende Optionskachel. Die aktuell aktive Option ist mit einem Häkchen in der Mitte der Kachel markiert. Der Standard-Ausführungstyp ist INSTALL, der die Änderungsaufgabe nur während der Paketinstallationssequenzen ausführt.
Schritt 7: Zusammenfassung
Verwenden Sie die Zusammenfassungsseite, um die Korrektheit der in den vorherigen Schritten definierten Aufgabeneigenschaften zu überprüfen.
•Wenn alle Eigenschaften wie gewünscht eingestellt sind, klicken Sie auf Process, um das Objekt final zu erstellen.
•Wenn Änderungen erforderlich sind, klicken Sie auf Back, bis der Assistentenschritt mit der fehlerhaften Eigenschaftsdefinition angezeigt wird, und nehmen Sie die erforderlichen Änderungen vor.
Bitte beachten Sie, dass Änderungen in einem frühen Schritt zu anderen Standardwerten oder Optionen in späteren Schritten führen können. Überprüfen Sie daher beim Weiterblättern zur Zusammenfassungsseite, dass alle Schritte die gewünschten Einstellungen enthalten.
Schritt 8: Abgeschlossen
Nachdem die neue TXT-Änderungsaufgabe erstellt wurde, kann der Assistent durch die Schaltfläche Finish in der unteren rechten Ecke geschlossen werden. Die TXT-Änderungs-Ansicht wird aktualisiert und die Liste der vorhandenen Aufgaben enthält das neu erstellte Objekt an der untersten Position der Ausführungsreihenfolge.