汎用M SAP Scriptテキスト読込

READ_TEXT

概要

ロングテキストを取得する汎用モジュールです。伝票やマスタ等に登録したテキストは普通のSQLでは取得できないため、当汎用モジュールでデータを取得します。

パラメータ

読込テキストのオブジェクト(OBJECT)、テキストID(ID)、テキスト名(NAME)のパラメータがキー項目です。取得したテキストデータは読込テキスト行(LINES)に格納されます。
パラメータ一覧
種別パラメータ説明
インポートCLIENTクライアント
ID読込テキストのテキストID
LANGUAGE読込テキストの言語
NAME読込テキスト名
OBJECT読込テキストのオブジェクト
ARCHIVE_HANDLEアーカイブハンドル
LOCAL_CATローカルテキストカタログ
エクスポートHEADER読込テキストのヘッダ
OLD_LINE_COUNTER行カウンタ
テーブルLINES読込テキスト行
例外ID無効なテキストID
LANGUAGE無効な言語
NAME無効なテキスト名
NOT_FOUNDテキストがありません
OBJECT無効なテキストオブジェクト
REFERENCE_CHECK参照チェーン中断
WRONG_ACCESS_TO_ARCHIVEアーカイブハンドルへのアクセスが無効

インポートパラメータを設定する

読込テキストのオブジェクト(OBJECT)、テキストID(ID)、テキスト名(NAME)の設定は必須です。テキスト名にはテキストオブジェクトごとに決まっている伝票番号などの値を設定します。取得するテキストの言語もパラメータに指定する必要があります。
設定例:インポートパラメータ
項目項目名称設定値
LANGUAGE読込テキストの言語J
OBJECTテキストのオブジェクトEKKO
IDテキストIDF01
NAME読込テキスト名4500000001

サンプルコード

購買伝票のテキストの情報を取得する例です。取得したテキスト情報はLINESパラメータに格納されます。取得したテキストはSAP Script形式で格納されるため特殊文字はエスケープされた状態となります。
DATA: LV_OBJECT           TYPE THEAD-TDOBJECT,
      LV_ID               TYPE THEAD-TDID,
      LV_NAME             TYPE THEAD-TDNAME,
      LS_HEADER           TYPE THEAD,
      LV_OLD_LINE_COUNTER TYPE THEAD-TDTXTLINES,
      LT_LINES            TYPE TABLE OF TLINE.

* パラメータに値を設定する
LV_OBJECT    = 'EKKO'.       " テキストオブジェクト
LV_ID        = 'F01'.        " テキストID
LV_NAME      = '4500000001'. " テキスト名

CALL FUNCTION 'READ_TEXT'
  EXPORTING
    ID                      = LV_ID
    LANGUAGE                = SY-LANGU
    NAME                    = LV_NAME
    OBJECT                  = LV_OBJECT
  IMPORTING
    HEADER                  = LS_HEADER
    OLD_LINE_COUNTER        = LV_OLD_LINE_COUNTER
  TABLES
    LINES                   = LT_LINES
  EXCEPTIONS
    ID                      = 1
    LANGUAGE                = 2
    NAME                    = 3
    NOT_FOUND               = 4
    OBJECT                  = 5
    REFERENCE_CHECK         = 6
    WRONG_ACCESS_TO_ARCHIVE = 6
    OTHERS                  = 7
  .

* エラーの場合
IF SY-SUBRC <> 0.
*  エラー処理
ELSE.
*  正常処理
ENDIF.
関連記事

コメントの投稿

非公開コメント

プロフィール

Z*

Author:Z*

このブログではSAPの技術情報について解説をしていきます。

2017年:ブログをリニューアルしました。(旧Zの高速道路)

カテゴリ
最新記事
最新コメント
月別アーカイブ
検索フォーム
リンク