Platzhalter und Ersetzer

Platzhalter

Atlas Software hat manchmal Eingabefelder, wo man Platzhalter verwenden kann, um flexibler zu werden. Diese sind immer in geschweiften Klammern anzugeben, zB. "{Name}". Das bedeutet, dass diese Passage durch einen Wert ersetzt werden soll, der aus dem aktuellen Kontext geholt wird, beispielsweise der Pfad oder Name der aktuell verarbeiteten Datei. Sonderwerte für die Namen sind:

• {Now}: Nimmt das aktuelle Datum und die aktuelle Uhrzeit
• {NewGuid}: Erzeugt eine neue GUID in Kleinbuchstaben ohne geschweifte Klammern, zB. 82da49af-9b6f-49b1-9d92-6d9ef5dd3e25
• {Random:10} bzw. {Random:10,A-Za-z0-9_}: Erzeugt eine zufällige Zeichenkette der Länge 10 unter Verwendung der angegebenen Zeichenbereiche oder ohne Zeichenbereiche beliebige Klein- und Großbuchstaben
• {AppTitle} fügt den Namen der Applikation ein (ohne ".exe")

Der geholte Wert kann optional durch eine Kaskade von Formatierungen umgeformt werden, die getrennt werden durch '&'. Die möglichen Formatzeichenfolgen sind entweder eine .NET-Formatzeichenfolge oder eine zusätzliche von Atlas definierte Erweiterung. Beispiel: "{NewGuid:ToLower&FirstCharToUpper}" macht sie zuerst klein und dann den ersten Buchstaben gross [in älteren Programmversionen wird nur eine einzige Formatierung unterstützt]. Die möglichen Formate hängen davon ab, welcher Datentyp der Wert des Platzhalters hat:

Ist der geholte Wert eine Zeichenkette, können folgende Formatierungen angewendet werden [versionsabhängig]:

• ToUpper: Alle Zeichen der Passage werden in Großbuchstaben geändert
• ToUpperInvariant: Alle Zeichen der Passage werden in Großbuchstaben geändert (invariant)
• FirstCharToUpper: Das erste Zeichen der Passage wird in Großbuchstaben geändert
• FirstCharToUpperInvariant: Das erste Zeichen der Passage wird in Großbuchstaben geändert (invariant)
• ToLower: Alle Zeichen der Passage werden in Kleinbuchstaben geändert
• ToLowerInvariant: Alle Zeichen der Passage werden in Kleinbuchstaben geändert (invariant)
• FirstCharToLower: Das erste Zeichen der Passage wird in Kleinbuchstaben geändert
• FirstCharToLowerInvariant: Das erste Zeichen der Passage wird in Kleinbuchstaben geändert (invariant)
• ToTitle: Eine Passage wie "schönerTag" wird in Wörter erweitert zu "Schöner Tag", das erste Zeichen wird gross gemacht.
• ToHtml: Eine Passage wie"a>b" wird escaped (spezielle Zeichen umgeformt) zu "a>b" mithilfe WebUtility.HtmlEncode
• FromHtml: Eine Passage wie "a>b" wird unescaped zurück zu "a>b" mithilfe von WebUtility.HtmlDecode
• ToUri: Eine Passage wie "My Webpage" wird escaped (spezielle Zeichen umgeformt) zu "My%20Webpage" mithilfe von Uri.EscapeDataString
• FromUri: Eine Passage wie "My%20Webpage" wird unescaped zurück zu "My Webpage" mithilfe von Uri.UnescapeDataString
• ToUrl: Eine Passage wie "My Webpage" wird escaped (spezielle Zeichen umgeformt) zu "My+Webpage" mithilfe von WebUtility.UrlEncode
• FromUrl: Eine Passage wie "My+Webpage" wird unescaped zurück zu "My Webpage" mithilfe von WebUtility.UrlDecode
• Quote: Die Passage wird in Anführungszeichen gesetzt, so wie für C# erforderlich. So wird beispielsweise '\' verdoppelt und spezielle Zeichen z.B. als "\n" geschrieben. Dies wird üblicherweise für die Angabe von Argumenten in einer C#-ähnlichen Syntax verwendet.
• QuoteDos: Die Passage wird in Anführungszeichen geklammert, wobei Anführungszeichen im Text verdoppelt werden. Dies wird üblicherweise für CSV-Werte oder Argumente auf der Kommandozeile (zB. Eingabeaufforderung) benutzt.
• ToBytes: Eine vorzeichenlose lange Zahl "123456789" wird in eine Byte-Bezeichnung umformatiert, in diesem Fall "117,7 MB"
• Left(x): Die ersten x Zeichen
• Mid(x, y): Die y Zeichen beginnend ab Zeichen Nummer x (0 ist das Erste)
• Right(x): Die letzten x Zeichen
• Rest(x): Die Zeichen ab Zeichen Nummer x bis zum Ende (0 ist das Erste).

• ShortDate: In Deutschland wäre das "23.09.17"
• LongDate: In Deutschland "Samstag, 23. September 2017"
• ShortTime: In Deutschland "12:34"
• LongTime: Enthält Sekunden, "12:34:56"
• DateAndTime: Kurzes Datum mit vollem Jahr plus Zeit mit Sekunden, in Deutschland "23.09.2017 12:34:56"
• ShortDateAndShortTime: Kurze Version, in Deutschland "23.09.2017 12:34"
• ShortDateAndLongTimeWithMs: Kurze Version mit Millisekungen, in Deutschland "23.09.2017 12:34.567"
• ShortDateAndLongTimeWithTicks : Kurze Version mit Ticks, in Deutschland "23.09.2017 12:34.2984938"
• RelShortDateAndShortTime: Enthält einen relativen Tagesnamen, falls vorhanden, zB. "Gestern, 23.09.2017 12:34"
• RelShortDateAndLongTime: Enthält einen relativen Tagesnamen, falls vorhanden, zB. "Morgen, 23.09.2017 12:34:56"
• RelLongDateAndShortTime: Enthält einen relativen Tagesnamen, falls vorhanden, zB. "Gestern, Samstag 23. September 2017 12:34"
• RelLongDateAndLongTime: Enthält einen relativen Tagesnamen, falls vorhanden, zB. "Morgen, Samstag 23. September 2017 12:34:56"
• ShortDateIfNotTodayAndShortTime: Dasselbe wie 'ShortDateAndShortTime' aber das Datum wird weggelassen falls es heute ist
• IsoDate: 2017-09-23
• IsoDateTime: 2017-09-23 12:34:56
• IsoDateTimeFull: 2017-09-23 12:34:56.1234567
• IsoDate&Left(4): 2017
• IsoDate&Mid(5,2): 09
• IsoDate&Right(2): 23
• IsoDate&Rest(5): 09-23

Wenn ein vollständiger Pfadnamen geholt wurde, können diese Formate verwendet werden, um Teile davon herauszupicken:

• Folder: Der vollständige Pfad des übergeordneten Ordners der Datei oder des Ordners. Ergibt eine leere Zeichenfolge, wenn es auf ein Stammverzeichnis angewendet wird.
• FolderOrRoot: Der vollständige Pfad des übergeordneten Ordners der Datei bzw. Ordners. Bei Anwendung auf ein beliebiges Stammverzeichnis (zB. "C:\") wird statt einer leeren Zeichenfolge das Stammverzeichnis ("C:\") zurückgegeben.
• FolderName: Der Name des übergeordneten Ordners ohne Pfad
• FileName: Der Name der Datei einschließlich der Erweiterung, aber ohne Ordnerpfad
• PureName: Der Name der Datei ohne die letzte Erweiterung und ohne Pfad
• Extension: Die letzte Erweiterung des Pfadnamens
• BeforePureName: Der Name der Datei ohne die letzten beiden Erweiterungen und ohne Pfad
• BeforeExtension: Die vorletzte Erweiterung des Pfadnamens
• Root: Das Stammverzeichnis (z. B. "C:\") oder UNC-Stammverzeichnis ("\\Device\Share")
• UncRoot: Die UNC-Pfadwurzel zu einem gegebenen Nicht-UNC-Pfad wie "Y:\Folder\File". Wenn das Laufwerk nicht in der UNC-Registrierung abgebildet ist, wird eine leere Zeichenkette zurückgegeben.

Ganzzahlige Werte (Int) : Zeichenketten im Ganzzahlformat für .NET. Zum Beispiel würde "{Name:000}" zu zwei Vorlaufnullen führen.

Dezimalwert (Decimal): Zeichenketten im Dezimalformat für .NET

Atlas-Zeitspanne (AtlasTimeSpan): Zusätzliche Atlas-Formatzeichenfolgen sind "SecondPrecise" und "MinutePrecise" und "MillisecondPrecise". Optionales "+". Die Minmal- und Maximalwerte werden in "Min" und "Max" umgewandelt.

Um die entsprechende .NET-Format-Dokumentation zu finden, können Sie einfach nach "dataType.ToString(String) C#" googeln. Ersetzen Sie "dataType" durch das Wort, nach dem Sie suchen.

Der Inhalt innerhalb der Platzhalterklammern ist auf 200 Zeichen begrenzt.

Ersetzer

Eine weiteres Format, sind die sog. Ersetzer, zB. "{Name:von->nach}". Es kann nur auf Zeichenketten angewendet werden (oder vorher formatiertes Datum). Dies startet einen Ersetzungsvorgang, der jedes Vorkommen von 'von' im Text in 'nach' ersetzt.

Als Beispiel nehmen wir hier einmal Multimedia Xpert. Sie könnten eine Ausgabespezifikation für eine Konversion von H.264 zu H.265 erstellen und "{n:x264->x265&H.264->HEVC}" zum Muster der Ausgabedatei hinzufügen. So würde jedes Mal, wenn Sie diese Spezifikation verwenden, um eine Mediendatei zu konvertieren, der Dateiname automatisch mitumgewandelt.

Bitte beachten Sie, dass diese Notationen mit der Zeit mehr werden, so dass Sie möglicherweise Ihre Atlas-Software auf den neuesten Stand bringen müssen.