READ_TEXT 官方介绍（日语）

READ_TEXT  

READ_TEXT は、アプリケーションプログラム用のテキストを、指定された作業領域で使用できるようにします。

汎用モジュールは、指定されたテキストをテキストファイル、テキストメモリ、またはアーカイブから読み込みます。 OBJECT 、 NAME 、 ID 、および LANGUAGE を使用して、完全にテキストの指定を行わなければなりません。内部作業領域で使用できるテキストは 1 つだけなので、これらのオプションに一般的な指定はできません。

読み込みが完了すると、 HEADER と LINES で指定された作業領域に、ヘッダ情報とテキスト行が登録されます。

参照テキストを使用した場合、 SAPscript が自動的に参照チェーンを処理し、テキスト内で検索したテキスト行をチェーンの最後に配置します。エラーが発生すると、汎用モジュールは終了し、例外 REFERENCE_CHECK がトリガされます。

 

汎用モジュール呼び出し :

 

CALL FUNCTION 'READ_TEXT'

EXPORTING CLIENT = SY-MANDT

OBJECT = ?...

NAME = ?...

ID = ?...

LANGUAGE = ?...

ARCHIVE_HANDLE = 0

IMPORTING HEADER =

TABLES LINES = ?...

EXCEPTIONS ID =

LANGUAGE =

NAME =

NOT_FOUND =

OBJECT =

REFERENCE_CHECK =

WRONG_ACCESS_TO_ARCHIVE =

 

エクスポートパラメータ :

 

CLIENT	テキスト保存時のクライアントを指定します。このパラメータを使用しない場合、現在のクライアントがデフォルト値として自動的に指定されます。 参照項目 : SY-MANDT デフォルト値 : SY-MANDT
OBJECT	テキスト割り当て先のテキストオブジェクト名を入力します。テーブル TTXOB に有効オブジェクトが含まれます。 参照項目 : THEAD-TDOBJECT
NAME	テキストモジュール名を入力します。テキストモジュール名は 70 文字までです。その内部の構造は、使用するテキストオブジェクトによって異なります。 参照項目 : THEAD-TDNAME
ID	テキストモジュールのテキスト ID です。テーブル TTXID に、テキストオブジェクト別に有効なテキスト ID が登録されます。 参照項目 : THEAD-TDID
LANGUAGE	テキストモジュールの言語キーを入力します。テーブル T002 に定義されている言語のみが使用可能です。 参照項目 : THEAD-TDSPRAS
ARCHIVE_HANDLE	アーカイブからテキストを読み込むには、ここでハンドルを入力してください。アーカイブにアクセスするためにこのハンドルが必要です。汎用モジュール ARCHIVE_OPEN_FOR_READ を使用してハンドルを登録することができます。 値 '0' はアーカイブからテキストを読み込まない指定です。 参照項目 : SY-TABIX デフォルト値 : 0

 

インポートパラメータ :

 

HEADER

システムが該当するテキストを検索すると、このパラメータにテキストヘッダを返します。 構造 : THEAD

 

テーブルパラメータ :

 

LINES

テーブルには、読み込まれたテキストに属するすべてのテキスト行が含まれます。 構造 : TLINE

 

例外 :

 

ID	パラメータ ID に指定されているテキスト ID がテーブル TTXID に登録されていません。テキストモジュールのオブジェクトと共に定義する必要があります。
LANGUAGE	パラメータ LANGUAGE に、テーブル T002 に登録されていない言語キーが指定されています。
NAME	パラメータ NAME に、 SAPscript 規則に対応しないテキストモジュール名が指定されています。 発生する可能性のあるエラー : 項目が空白のみになっている。 項目に、無効文字 '*' または ',' が含まれている。
OBJECT	パラメータ OBJECT に、テーブル TTXOB に登録されていないテキストオブジェクト名が指定されています。
NOT_FOUND	指定されたテキストモジュールが見つかりません。
REFERENCE_CHECK	読み込むテキストモジュールにテキスト行がないため、他のテキストモジュールの行を参照します。この参照チェーンは複数のレベルを含むことができます。現在のテキストでは、チェーンが中断されます。これは、チェーン内の参照されるテキストモジュールのいずれかが存在しないためです。
WRONG_ACCESS_ TO_ARCHIVE	アーカイブが不適切または存在しないアーカイブハンドルを使用してアクセスされるか、または不適切なモード ( つまり、アーカイブが書き込みのためにオープンされているのに読み込まれる、または読み込みのためにオープンされているのに書き込まれる ) でアクセスされた場合に、例外 WRONG_ACCESS_TO_ARCHIVE がトリガされます。