TextStrea モジュール

標準サブセットのエンジン->TextStream フォルダには、 TextStream エンジン3.0 の特定のタスクを実行するModulesが含まれています。

TextStreamのオープン/ロード
TextStreamの保存/閉じる
TextStreamブロックのテキスト操作
TextStreamテーブルのテキスト操作

TextStreamのオープン/ロード

TextStream Open/Load モジュールを使用すると、 TextStream を開くことができます。さらに、指定したTextStreamに外部ソースからコンテンツをロードすることもできます。

以下のモジュール属性があります。

ModuleAttribute	説明
Stream Name	コンテンツ情報を開く、またはロードしようとするTextStreamの名前。
Load Source Type	オプションで、このModuleAttributeを使って、指定したTextStreamに外部ソースからコンテンツをロードすることもできます。そのためには、以下のソースのいずれかを値として選択します。クリップボード：システムクリップボードからコンテンツをロードします。ファイル：指定したファイルからコンテンツをロードします。バッファ：指定したバッファからコンテンツをロードします。
Load Source Identifier	ModuleAttributeの Load Source Type にファイルまたはバッファという値を指定した場合は、これを使用してファイルまたはバッファ名への完全なパスを指定します。
Load Operation Type	TextStreamにコンテンツを読み込む場合に実行したい操作のタイプ。このModuleAttributeの値として、以下の操作タイプを指定できます。 Replace ：現在のTextStreamコンテンツを、指定されたソースのコンテンツに置き換えます。これはデフォルト値です。 Append ：新しい行を作成せずに、指定されたソースのコンテンツを現在のTextStreamの最後に追加します。 Append to New Line ：現在のTextStreamに新しい行を作成し、指定されたソースのコンテンツをその行に追加します。
Line Separator	TextStreamの行区切り記号の設定。テスト対象のオペレーティング・システム（OS）によって、以下の行区切り記号を指定できます。 Windows（デフォルト値） Unix レガシーMac OS
エンコーディング	ファイルを読み込む際に使用する文字エンコーディングを指定します。値を指定しない場合は、Tricentis Toscaは UTF-8 をデフォルトのエンコーディングとして使用します。

この例では、以下の操作を行います。

TestStream というTextStreamのコンテンツを開いて置き換えます。
新しいコンテンツのソースは、 C:∕Temp∕test.txt にある外部ファイルです。
ファイルのエンコーディングは Unicode (UTF-32) に指定します。
TextStreamのコンテンツを Windows の行区切り記号設定で置き換えます。

TextStreamを開き、外部ソースからコンテンツをロードします。

TextStreamの保存/閉じる

TextStream Save/Close モジュールを使用するとTextStreamを閉じることができ、オプションでそのコンテンツを外部の保存先に保存することができます。

以下のモジュール属性があります。

ModuleAttribute	説明
Stream Name	閉じる、または保存しようとするTextStreamの名前。
Destination Type	TextStreamの保存先。このModuleAttributeの値として、以下の宛先を指定できます。クリップボード：コンテンツをシステムのクリップボードに保存します。これはデフォルト値です。ファイル：指定したファイルにコンテンツを保存します。バッファ：指定したバッファにコンテンツを保存します。 None ：コンテンツを保存しません。
Destination Identifier	ModuleAttributeの Destination Type にファイルまたはバッファを指定した場合は、これを使用してファイルまたはバッファ名への完全なパスを指定します。
Encoding	ドロップダウンメニューからテキストエンコーディングオプションを選択します。デフォルト値は UTF-8 です。
Keep Stream Open	Tricentis ToscaではデフォルトでTextStreamは閉じています。保存後も開いたままにしたい場合は、この値を True に設定してください。

この例では、 TestStream というTextStreamを閉じずに、クリップボードに保存します。

TextStreamのコンテンツを外部ソースに保存する

TextStream Block Text Manipulation

TextStream Block Text Manipulation モジュールを使用すると、TextStreamのコンテンツを1つのテキストブロックとして操作できます。

以下のモジュール属性を持ちます。

ModuleAttribute	説明
Stream Name	操作するTextStreamの名前。
Target Line	TextStreamをロードする元のテキスト行を指定します。以下のいずれかの値を指定できます。整数 : 指定された行をロードします。<n>例えば、 2 という値は、テキストの2行目を読み込みます。セミコロン（;）で区切られた1つ以上の文字列 <string1>;<string2>;<...> は、指定されたすべての文字列を含む最初の行を読み込みます。ターゲット行の値を指定しない場合、Tricentis Toscaは入力操作タイプに基づいて以下のいずれかのデフォルトを使用します。 Replace と Append には1 。 Append to New Line には#last 。
Input Operation Type	コンテンツ ModuleAttributeに ActionMode Verify を使用する場合は、このModuleAttributeの値は空のままにします。コンテンツ ModuleAttributeに ActionMode Input を使用する場合は、指定されたコンテンツをTextStreamに挿入するときに実行する操作を選択します。このModuleAttributeの値として、以下の操作タイプを指定できます。 Replace ：現在のTextStreamコンテンツを、指定されたコンテンツで置き換えます。 Append ：指定されたコンテンツを指定されたターゲット行の末尾に追加します。これはデフォルト値です。 Append to New Line ：現在のTextStreamに新しい行を作成し、指定されたコンテンツをそこに追加します。
Field Separator	ターゲット行で値を区切る文字を指定します。例えば、次の例ではセミコロン(;) が区切り文字になります: <Name> <Age> <Country> このModuleAttributeはオプションです。
Line Length	ターゲット行の最大文字数を指定します。このModuleAttributeはオプションです。
Total Field Count	ModuleAttributeの Field Separator に基づいて、TextStreamのフィールドの数を指定します。このModuleAttributeはオプションです。
Content	操作したいテキストのコンテンツを指定します。TextStreamのコンテンツを指定する際には、以下の点に注意してください。同じモジュールでコンテンツ ModuleAttributeを複数、持つことができます。そのためには、このModuleAttributeをコピーして、必要な回数だけモジュールに貼り付けてください。デフォルトでは、このModuleAttributeはテキストボックスです。これを ListBox として使用するには、このModuleAttribute のデフォルトのパラメータ BusinessType を ListBox に変更します。これは複数のテキストフィールドをリストとして処理したい場合に特に便利です。希望する場合は、このModuleAttributeに以下の設定パラメータを追加できます。 AlignToRight ：文字を右揃えにするには、この設定パラメータを True にします。デフォルトでは、Tricentis Toscaはテキストフィールドを左寄せにします。 Length ：このModuleAttributeの最大文字数を指定します。 Offset ：ターゲット行の最初の文字から、オフセットする文字数を指定します。 Position ： Field Separator を使用する場合、他のフィールドに対するこのコンテンツの位置を整数で指定します。たとえば、値 2 を指定した場合、Tricentis Tosca は指定されたコンテンツを指定されたターゲット行の2番目の使用可能なフィールドで検索します。

この例では、 TestStream というTextStreamの最後の行に新しい内容を追加します。セミコロンを区切りとして使用する4つの異なるフィールドがあります。

テストステップの Block Text Manipulation - 入力では、以下のアクションを実行します。

Student ID TRIC102-X をTextStreamに挿入します。対応するModuleAttributeには、以下の追加設定パラメータがあります。

AlignToRight は True に設定

Length は 15 に設定

Position は 1 に設定
Student Name Jane Doe をTextStreamに挿入します。対応するModuleAttributeには、以下の追加設定パラメータがあります。

Length は 15 に設定

Offset は 21 に設定

Position は 2 に設定
Course Name プログラミングをTextStreamに挿入します。対応するModuleAttributeには、以下の追加設定パラメータがあります。

Length は 20 に設定

Offset は 37 に設定

Position は 3 に設定
Course Start Date 01/02/2019 をTextStreamに挿入します。対応するModuleAttributeには、以下の追加設定パラメータがあります。

Length は 10 に設定

Offset は 58 に設定

Position は 4 に設定

以上の手順で、以下のようなTextStreamが生成されます。

操作後のTestStream

テストステップ Block Text Manipulation - Verify では、前のテストステップで挿入したすべてのフィールドの内容を確認します。

TextStreamのコンテンツを操作する

TextStream Table Text Manipulation

TextStream Table Text Manipulation モジュールを使用すると、テーブルとしてフォーマットされたTextStreamのコンテンツを操作することができます。

以下のモジュール属性があります。

ModuleAttribute	説明
Stream Name	操作するTextStreamの名前。
Start Line	TextStreamからロードしたいテキストの最初の行の行番号。このModuleAttributeはオプションです。
End Line	TextStreamからロードしたいテキストの最終行の行番号。このModuleAttributeはオプションです。
Input Operation Type	もし ModuleAttribute コンテンツに ActionMode Verify を使用する場合は、このModuleAttributeの値は空のままにしてください。 ModuleAttribute コンテンツに ActionMode Input を使用する場合は、指定されたコンテンツをTextStreamに挿入するときに実行する操作を選択します。このModuleAttributeの値として、以下の操作タイプを指定できます。 Replace ：現在のTextStreamコンテンツを、指定したコンテンツに置き換えます。これはデフォルト値です。 Append ：指定されたコンテンツを現在のTextStreamの末尾に追加します。Start Line または End Line を指定した場合、指定されたコンテンツが利用可能な最後の行の末尾に追加されます。
Column Definition Value	表形式のテキストコンテンツの列を指定する値。このModuleAttributeの値として、以下の列区切り文字を指定できます。 <SPACE> と <TAB> ：ホワイトスペースに相当する特殊な列区切り値。デフォルト値は <SPACE> です。 0 以上の整数：各列に対してその文字数に固定の列幅を指定します。オプションで、角括弧（[]）内にオフセットを指定することができます。<offset>オフセットの参照は、読み込まれた行の内容の最初の文字です。例： 15 または 15[21] セミコロン (;) で区切られた 0 以上の整数のセット：各列の列幅を個別に指定します。オプションで、角括弧（[ ]）でオフセットを指定することもできます。<offset>オフセットの参照は、読み込まれた行コンテンツの最初の文字です。例： 3;15;15;10 または 3[13];15[21];15[44];10[59 ] 0 よりも大きい整数以外の文字または文字列は、可変の列幅を指定します。例えば、 # のような文字を指定すると、Tricentis Toscaはそれをそれぞれ列として解釈します。
Content	操作したいテーブルコンテンツ。

この例では、以下の操作を行います。

スペース文字を使用して列を区切る TestStream と呼ばれるTextStreamの表形式のコンテンツを置き換えます。
1行目から4行目までのコンテンツを読み込み、2列目の3行目のテキストを置き換えます。

TextStreamの表形式コンテンツを操作する