Read from Text File

Read from Text File アクションステップでは、テキストファイルを読み取ることができます。また、[Read Mode (読み取りモード)] を使用して、ファイルのどの部分を読み取るかを指定できます。ワークフロー内のボタンには [Read Mode (読み取りモード)] と表示されています。現在、これはアクションステップの名前の後の括弧内でアクティブになっています (上記の例では WholeFile)。読み取り後にテキストを削除する必要があるかどうかを決定するオプションがあります。

正しい結果を得るには、読み取るテキストファイルが UTF-8 でエンコードされている必要があります。

プロパティ

ファイル操作の設定:

Delete line(s) after read (読み取り後に行を削除) 読み取り後にテキストを削除する必要があるかどうかを指定します。
Directory path (ディレクトリパス) 読み取るファイルが保存されているディレクトリへのパスを入力します。絶対パスまたは相対パスを指定できます。相対パスを使用する場合、パスは [Base Path (ベースパス)] 変数に関連します。
File name (ファイル名) 読み取るファイルの名前をここに入力します。
Line count (行数) 読み取る行数を入力します。[Read file check mode (ファイルの読み取り確認モード)] で複数行 ([Range of lines (行範囲)]) を読み取るように指定した場合、このオプションを使用できます。
Number of first or Single Line (最初の行または単一行の番号) 読み取る行の番号をここで指定します。[Read file check mode (ファイルの読み取り確認モード)] で、[Range of lines (行範囲)] など、複数行を読み取るように選択した場合、読み取りを開始する行番号をここで選択します。

テキストファイルの最初の行の行番号は 1 です!

Read file check mode (ファイルの読み取り確認モード) [Read file check mode (ファイルの読み取り確認モード)] を使用して、ファイルのどの部分を読み取るかを指定します。
- Read whole file (ファイル全体を読み取り) ファイル全体を読み取ります。
- Last line (最終行) ファイルの最後の最新の行のみを読み取ります。
- Single line (単一行) 1 行のみを読み取ります ([Number of first or single line (最初の行または単一行の番号)] 設定も参照してください)。
- Range of lines (行範囲) 一連の行を読み取ります ([Number of first or single line (最初の行または単一行の番号)] 設定も参照してください)。
Read to end (最後まで読み取る) ファイルの最後まで読み取るかどうかを指定します。[Read file check mode (ファイルの読み取り確認モード)] で複数行 ([Range of lines (行範囲)]) を読み取るように指定した場合、このオプションを使用できます。[Line count (行数)] オプションと比較した場合のこのオプションの利点は、[Range of lines (行範囲)] モードの場合に読み取る行数を定義する必要がないことです。

すべてのアクションステップで同じである他のプロパティについては、「共通プロパティ」のセクションで説明します。これらのプロパティは、わかりやすくするためにここには表示していません。

インバウンド変数

Directory path (ディレクトリパス) 読み取るファイルが保存されているディレクトリへのパスを入力します。絶対パスまたは相対パスを指定できます。相対パスを使用する場合、パスは [Base Path (ベースパス)] 変数に関連します。

アウトバウンド変数

Read text (テキストを読み取り) Read from Text File.Read text 変数では、選択した読み取りモード ([Read file check mode (ファイルの読み取り確認モード)]) が提供されます。

IsRead Read from Text File.IsRead 変数は、ファイルを読み取ることができたかどうか (True/False) を示します。

Line Count (行数) Read from Text File.Line Count 変数では、読み取る行数が提供されます。

File name (ファイル名) Read from Text File.File Name 変数では、読み取るファイルの名前が提供されます。

Directory path (ディレクトリパス) Read from Text File.Directory Path 変数では、使用されたパスが提供されます。

ウィザード

Directory path (ディレクトリパス) 読み取るファイルへのパスを指定します。絶対パスまたは [Base Path (ベースパス)] を基準とする相対パスを作成できます。初期値は %STWS_BASEPATH% です。既存のパスを選択します。 ワークフローからの変数を挿入して、パスを作成することもできます。これを行うには、ピンをクリックして、使用可能な変数のいずれかを選択します。

File name (ファイル名) 読み取るファイルの名前をここに入力します。ワークフローからの変数を [File Name (ファイル名)] として挿入することもできます。これを行うには、ピンをクリックして、使用可能な変数のいずれかを選択します。
Read mode (読み取り確認モード) [Read mode (読み取りモード)] を使用して、ファイルのどの部分を読み取るかを指定します。選択した設定に応じて他の項目が表示されます。
- Entire file (ファイル全体) ファイル全体を読み取ります。
- Last line (最終行) ファイルの最後の最新の行のみを読み取ります。
- Single line (単一行) 1 行のみを読み取ります。読み取る行の行番号を [Line Number (行番号)] 項目に入力します。
- Range of lines (行範囲) 行の範囲を読み取ります。読み取る最初の行の行番号を [First line to read (読み取る最初の行)] 項目に入力します。読み取る行数を [Line count (行数)] 項目に入力します。ファイルの最後まで読み取りを実行するように指定するには、[Read to end of file (ファイルの末尾まで読み取る)] オプションを使用します。[Line count (行数)] の詳細と比較した場合のこのオプションの利点は、読み取る行数を定義する必要がないことです。