TextStream-Module

Der Ordner TBox XEngines->TextStream in der Standard-Untermenge enthält Module, die bestimmte Aufgaben für die TextStream Engine 3.0 ausführen.

TextStream Open/Load

Das Modul TextStream Open/Load ermöglicht es Ihnen, einen TextStream zu öffnen. Darüber hinaus können Sie Inhalte aus einer externen Quelle in den von Ihnen angegebenen TextStream laden.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Stream Name

Der Name des TextStreams, den Sie öffnen oder in den Sie Inhalte laden möchten.

Load Source Type

Optional können Sie dieses Modulattribut verwenden, um Inhalte aus einer externen Quelle in den angegebenen TextStream zu laden. Wählen Sie dazu eine der folgenden Quellen als Wert aus:

  • Clipboard: Lädt Inhalte aus der Zwischenablage des Systems.

  • File: Lädt Inhalte aus einer von Ihnen angegebenen Datei.

  • Buffer: Lädt Inhalte aus einem von Ihnen angegebenen Buffer.

Load Source Identifier

Wenn Sie den Wert File oder Buffer für das Modulattribut Load Source Type angegeben haben, geben Sie hier den vollständigen Pfad zur Datei oder den Buffernamen an.

Load Operation Type

Der Typ der Operation, die Sie ausführen möchten, wenn Sie Inhalte in den TextStream laden. Sie können die folgenden Operationstypen als Wert für dieses Modulattribut angeben:

  • Replace: Ersetzt den aktuellen TextStream-Inhalt durch den Inhalt der angegebenen Quelle. Dies ist der Standardwert.

  • Append: Hängt den Inhalt der angegebenen Quelle an das Ende des aktuellen TextStreams an, ohne eine neue Zeile zu erstellen.

  • Append to New Line: Erstellt eine neue Zeile im aktuellen TextStream und hängt den Inhalt der angegebenen Quelle an sie an.

Line Separator

Einstellung des Zeilentrennzeichens für den TextStream. Sie können die folgenden Zeilentrennzeichen angeben, die vom zu testenden Betriebssystem (OS) abhängen:

  • Windows (Standardwert)

  • Unix

  • Legacy Mac OS

In diesem Beispiel führen Sie die folgenden Aktionen durch:

  • Sie öffnen und ersetzen den Inhalt eines TextStream namens TestStream.

  • Die Quelle des neuen Inhalts ist eine externe Datei, die sich unter C:\Temp\test.txt befindet.

  • Sie ersetzen den Inhalt des TextStream durch die Einstellung Windows (CR-LF) für Zeilentrennzeichen.

TextStream öffnen und Inhalte aus einer externen Quelle laden

TextStream Save/Close

Mit dem Modul TextStream Save/Close können Sie einen TextStream schließen und optional seinen Inhalt an einem externen Ziel speichern.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Stream Name

Der Name des TextStreams, den Sie schließen oder speichern möchten.

Destination Type

Das Ziel, an dem Sie Ihren TextStream speichern möchten. Sie können die folgenden Ziele als Wert für dieses Modulattribut angeben:

  • Clipboard: Speichert den Inhalt in der Zwischenablage des Systems. Dies ist der Standardwert.

  • File: Speichert den Inhalt in einer von Ihnen angegebenen Datei.

  • Buffer: Speichert den Inhalt in einem von Ihnen angegebenen Buffer.

  • None: Speichert den Inhalt nicht.

Destination Identifier

Wenn Sie den Wert File oder Buffer für das Modulattribut Destination Type angegeben haben, geben Sie hier den vollständigen Pfad zur Datei oder den Buffernamen an.

Encoding

Wählen Sie eine Textcodierungsoption aus dem Aufklappmenü. Der Standardwert ist UTF-8.

Keep Stream Open

Tricentis Tosca schließt den TextStream standardmäßig. Wenn Sie ihn nach dem Speichern geöffnet lassen möchten, setzen Sie diesen Wert auf True.

In diesem Beispiel speichern Sie den TextStream namens TestStream in der Zwischenablage des Systems, ohne ihn zu schließen.

Inhalt eines TextStream in einer externen Quelle speichern

TextStream Block Text Manipulation

Mit dem Modul TextStream Block Text Manipulation können Sie den Inhalt eines TextStream als einen einzelnen Textblock bearbeiten.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Stream Name

Der Name des TextStreams, den Sie bearbeiten möchten.

Target Line

Gibt an, welche Textzeile aus dem TextStream geladen werden soll. Sie können einen der folgenden Werte angeben:

  • Eine ganze Zahl <n>: Lädt die angegebene Zeile. Der Wert 2 lädt beispielsweise die zweite Zeile des Textes.

  • Eine oder mehrere Zeichenfolgen, die durch ein Semikolon (;) getrennt sind - <Zeichenfolge1>;<Zeichenfolge2>;<...>: Lädt die erste Zeile, die alle von Ihnen angegebenen Zeichenfolgen enthält.

Wenn Sie keinen Wert für Target Line angeben, verwendet Tricentis Tosca eine der folgenden Standardeinstellungen, die auf dem Input Operation Type basieren:

  • 1 für Replace und Append.

  • #last für Append to New Line.

Input Operation Type

Wenn Sie die Aktion Verify für das Modulattribut Content verwenden, lassen Sie den Wert dieses Modulattributs leer.

Wenn Sie die Aktion Input für das Modulattribut Content verwenden, wählen Sie einen Vorgang aus, der ausgeführt werden soll, wenn Sie den angegebenen Inhalt in den TextStream einfügen.

Sie können die folgenden Operationstypen als Wert für dieses Modulattribut angeben:

  • Replace: Ersetzt den aktuellen TextStream-Inhalt durch den angegebenen Inhalt.

  • Append: Hängt den angegebenen Inhalt an das Ende der angegebenen Target Line an. Dies ist der Standardwert.

  • Append to New Line: Erstellt eine neue Zeile im aktuellen TextStream und hängt den angegebenen Inhalt an sie an.

Field Separator

Gibt das Zeichen an, das Ihre Werte in Ihrer Target Line trennt. Ein Semikolon (;) ist beispielsweise das Trennzeichen des folgenden Beispiels: <Name>;<Alter>;<Land>.

Dieses Modulattribut ist optional.

Line Length

Gibt die maximale Anzahl von Zeichen der Target Line an.

Dieses Modulattribut ist optional.

Total Field Count

Gibt die Anzahl der Felder in Ihrem TextStream basierend auf dem Modulattribut Field Separator an.

Dieses Modulattribut ist optional.

Content

Gibt den Textinhalt an, den Sie steuern möchten. Beachten Sie Folgendes, wenn Sie den Inhalt Ihres TextStreams angeben:

  • Sie können mehrere Content-Modulattribute in demselben Modul haben. Kopieren Sie dazu dieses Modulattribut und fügen Sie es so oft wie erforderlich in das Modul ein.

  • Dieses Modulattribut ist standardmäßig eine TextBox. Um es als ListBox zu verwenden, können Sie den Standardparameter BusinessType dieses Modulattributs zu ListBox ändern. Dies ist besonders hilfreich, wenn Sie mehrere Textfelder als Liste steuern möchten.

Optional können Sie diesem Modulattribut die folgenden Konfigurationsparameter hinzufügen:

  • AlignToRight: Setzen Sie diesen Konfigurationsparameter auf True, um Zeichen nach rechts auszurichten. Tricentis Tosca richtet Textfelder standardmäßig nach links aus.

  • Length: Gibt die maximale Anzahl von Zeichen für dieses Modulattribut an.

  • Offset: Gibt die Anzahl der Zeichen für den Offset ab dem ersten Zeichen der Target Line an.

  • Position: Gibt die Position dieses Content (als Ganzzahl) im Verhältnis zu den anderen Feldern an, wenn Sie einen Field Separator verwenden. Wenn Sie beispielsweise den Wert 2 angeben, findet Tricentis Tosca den angegebenen Content im zweiten verfügbaren Feld der angegebenen Target Line.

In diesem Beispiel hängen Sie neuen Inhalt an die letzte Zeile eines TextStream namens TestStream an. Er hat vier verschiedene Felder, die ein Semikolon als Trennzeichen verwenden.

Im Testschritt Block Text Manipulation - Input führen Sie die folgenden Aktionen aus:

  • Sie fügen die Student ID TRIC102-X in den TextStream ein. Das entsprechende Modulattribut verfügt über folgende zusätzliche Konfigurationsparameter:

    AlignToRight mit dem Wert True

    Length mit dem Wert 15

    Position mit dem Wert 1

  • Sie fügen den Student Name Jane Doe in den TextStream ein. Das entsprechende Modulattribut verfügt über folgende zusätzliche Konfigurationsparameter:

    Length mit dem Wert 15

    Offset mit dem Wert 21

    Position mit dem Wert 2

  • Sie fügen den Course Name programming in den TextStream ein. Das entsprechende Modulattribut verfügt über folgende zusätzliche Konfigurationsparameter:

    Length mit dem Wert 20

    Offset mit dem Wert 37

    Position mit dem Wert 3

  • Sie fügen das Course Start Date 01/02/2019 in den TextStream ein. Das entsprechende Modulattribut verfügt über folgende zusätzliche Konfigurationsparameter:

    Length mit dem Wert 10

    Offset mit dem Wert 58

    Position mit dem Wert 4

Die obigen Schritte ergeben den folgenden TextStream:

TestStream nach Bearbeitung

Im Testschritt Block Text Manipulation - Verify überprüfen Sie den Inhalt aller Felder, die Sie mit dem vorherigen Testschritt eingefügt haben.

Inhalt eines TextStream bearbeiten

TextStream Table Text Manipulation

Mit dem Modul TextStream Table Text Manipulation können Sie den Inhalt eines TextStream bearbeiten, der als Tabelle formatiert ist.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Stream Name

Der Name des TextStreams, den Sie bearbeiten möchten.

Start Line

Zeilennummer der ersten Textzeile, die Sie aus dem TextStream laden möchten.

Dieses Modulattribut ist optional.

End Line

Zeilennummer der letzten Textzeile, die Sie aus dem TextStream laden möchten.

Dieses Modulattribut ist optional.

Input Operation Type

Wenn Sie die Aktion Verify für das Modulattribut Content verwenden, lassen Sie den Wert dieses Modulattributs leer.

Wenn Sie die Aktion Input für das Modulattribut Content verwenden, wählen Sie einen Vorgang aus, der ausgeführt werden soll, wenn Sie den angegebenen Inhalt in den TextStream einfügen.

Sie können die folgenden Operationstypen als Wert für dieses Modulattribut angeben:

  • Replace: Ersetzt den aktuellen TextStream-Inhalt durch den von Ihnen angegebenen Inhalt. Dies ist der Standardwert.

  • Append: Hängt den angegebenen Inhalt an das Ende des aktuellen TextStream an. Wenn Sie eine Start Line oder eine End Line angegeben haben, wird der angegebene Inhalt an das Ende der letzten verfügbaren Zeile angehängt.

Column Definition Value

Der Wert, der die Spalten des tabellarischen Textinhalts angibt. Sie können die folgenden Spaltentrennzeichen als Wert für dieses Modulattribut angeben:

  • <SPACE> und <TAB>: Spezielle Werte für Spaltentrennzeichen, die ihre Leerraumäquivalente darstellen. Der Standardwert ist <SPACE>.

  • Eine Ganzzahl größer als 0: Gibt eine feste Spaltenbreite dieser Anzahl von Zeichen für jede Spalte an.

    Sie können optional einen Offset in eckigen Klammern ([<Offset>]) angeben. Die Referenz für den Offset ist das erste Zeichen des geladenen Zeileninhalts.

    Beispiele: 15 oder 15[21]

  • Ein Satz von ganzen Zahlen größer als 0, die durch ein Semikolon (;) getrennt sind: Gibt die Spaltenbreite für jede Spalte einzeln an.

    Sie können optional einen Offset in eckigen Klammern ([<Offset>]) angeben. Die Referenz für den Offset ist das erste Zeichen des geladenen Zeileninhalts.

    Beispiele: 3;15;15;10 oder 3[13];15[21];15[44];10[59]

  • Alle Zeichen oder Zeichenfolgen außer einer Ganzzahl größer als 0 geben eine variable Spaltenbreite an. Wenn Sie beispielsweise ein Zeichen wie # angeben, interpretiert Tricentis Tosca es jeweils als Spalte.

Content

Der Inhalt der Tabelle, den Sie steuern möchten.

In diesem Beispiel führen Sie die folgenden Aktionen durch:

  • Sie ersetzen den tabellarischen Inhalt eines TextStream namens TestStream, dessen Spalten mit einem Leerzeichen getrennt werden.

  • Sie laden den Inhalt aus den Zeilen 1 bis 4 und ersetzen den Text in der dritten Zeile der zweiten Spalte.

Tabellarischen Inhalt in einem TextStream bearbeiten