IM-ERP Real Connect スクリプト開発API

PurchaseReleaseControllerオブジェクト

コンポーネント情報
version8.0
since6.0
コンポーネント概要
伝票承認コントローラクラス。

機能は以下の通り
  • 伝票を承認します。

コンストラクタの概要

PurchaseReleaseController (String purchaseorder, String poRelCode, String useExceptions)
PurchaseReleaseのコンストラクタを呼び出し伝票承認情報を作成します。
PurchaseReleaseController (String purchaseorder, String poRelCode, String useExceptions, ConnectionManager connectionManager)
コンストラクタ。
PurchaseReleaseController (String purchaseorder, String poRelCode, String useExceptions, SapClient sapClient)
コンストラクタ。
PurchaseReleaseController (String purchaseorder, String poRelCode, String useExceptions, String noCommit)
PurchaseReleaseのコンストラクタを呼び出し伝票承認情報を作成します。
PurchaseReleaseController (String purchaseorder, String poRelCode, String useExceptions, String noCommit, ConnectionManager connectionManager)
コンストラクタ。
PurchaseReleaseController (String purchaseorder, String poRelCode, String useExceptions, String noCommit, SapClient sapClient)
コンストラクタ。

メソッドの概要

返却値の型 メソッド名
Object executeBapi ()
BapiControllerにより伝票の承認処理を実行します。
String getBapiReturnErrMessage ()
ＢＡＰＩの実行結果のエラーメッセージを取得します。
String getBapiReturnMessage ()
プロパティファイルでオートコミット条件に設定されたType情報に一致したメッセージ情報を全て返します。
Object getRelIndicatorNew ()
伝票承認の新規承認区分を取得します。
Object getRelStatusNew ()
伝票承認の新承認状況を取得します。
Object getRetCode ()
リターン値、ABAP 命令後のリターン値を取得します。
String toString ()
デバッグ用のメソッドです。

コンストラクタの詳細

PurchaseReleaseController (String purchaseorder, String poRelCode, String useExceptions)
PurchaseReleaseのコンストラクタを呼び出し伝票承認情報を作成します。
パラメータ
purchaseorder : String
購買発注番号
poRelCode : String
承認コード
useExceptions : String
例外メッセージ設定とエラーメッセージ出力
PurchaseReleaseController (String purchaseorder, String poRelCode, String useExceptions, ConnectionManager connectionManager)
コンストラクタ。

ConnectionManagerを使用することで、ConnectionManagerからトランザクションを制御でき、 たとえば同一トランザクション内で複数の更新処理を実行することができます。
なお、PurchaseReleaseController#executeBapi()実行後に 必ずConnectionManager#commit()またはConnectionManager#rollback()を 実行してください。
上記2メソッド内でSAPへのコネクションの開放も実行されるので確実にどちらかの メソッドを呼ぶようにコーディングする必要があります。

【注意】このAPIが使用する標準のBAPI(BAPI_PO_RELEASE)では、BAPI実行時にコミット処理が実行されます。 つまり、PurchaseReleaseController#executeBapi()実行後に ここまでのコネクションマネージャーで実行したすべての処理がコミットされます。
※ただし、コネクションはリリースされませんので、リリースされるようにConnectionManager#commit()または ConnectionManager#rollback()を実行してください。
この振る舞いを変更するには、BAPI自体をカスタマイズする必要があります。
パラメータ
purchaseorder : String
購買発注番号
poRelCode : String
承認コード
useExceptions : String
例外メッセージ設定とエラーメッセージ出力
connectionManager : ConnectionManager
コネクションマネージャー
PurchaseReleaseController (String purchaseorder, String poRelCode, String useExceptions, SapClient sapClient)
コンストラクタ。

SapClientを使用することで、任意の接続先のコネクションを取得します。
パラメータ
purchaseorder : String
購買発注番号
poRelCode : String
承認コード
useExceptions : String
例外メッセージ設定とエラーメッセージ出力
sapClient : SapClient
Sapクライアント
PurchaseReleaseController (String purchaseorder, String poRelCode, String useExceptions, String noCommit)
PurchaseReleaseのコンストラクタを呼び出し伝票承認情報を作成します。

SapClientを使用することで、任意の接続先のコネクションを取得します。
noCommit(コミットワーク)の設定方法は以下のとおりです。
指定しない：コミット処理が実行されます。
「X」を指定：コミット処理が実行されません。
パラメータ
purchaseorder : String
購買発注番号
poRelCode : String
承認コード
useExceptions : String
例外メッセージ設定とエラーメッセージ出力
noCommit : String
コミットワーク はい/いいえ
PurchaseReleaseController (String purchaseorder, String poRelCode, String useExceptions, String noCommit, ConnectionManager connectionManager)
コンストラクタ。

ConnectionManagerを使用することで、ConnectionManagerからトランザクションを制御でき、 たとえば同一トランザクション内で複数の更新処理を実行することができます。
なお、PurchaseReleaseController#executeBapi()実行後に 必ずConnectionManager#commit()またはConnectionManager#rollback()を 実行してください。
上記2メソッド内でSAPへのコネクションの開放も実行されるので確実にどちらかの メソッドを呼ぶようにコーディングする必要があります。

【注意】このAPIが使用する標準のBAPI(BAPI_PO_RELEASE)では、BAPI実行時にコミット処理が実行されます。 つまり、PurchaseReleaseController#executeBapi()実行後に ここまでのコネクションマネージャーで実行したすべての処理がコミットされます。
※ただし、コネクションはリリースされませんので、リリースされるようにConnectionManager#commit()または ConnectionManager#rollback()を実行してください。
この振る舞いを変更するには、BAPI自体をカスタマイズする必要があります。

noCommit(コミットワーク)の設定方法は以下のとおりです。
指定しない：コミット処理が実行されます。
「X」を指定：コミット処理が実行されません。
パラメータ
purchaseorder : String
購買発注番号
poRelCode : String
承認コード
useExceptions : String
例外メッセージ設定とエラーメッセージ出力
noCommit : String
コミットワーク はい/いいえ
connectionManager : ConnectionManager
コネクションマネージャー
PurchaseReleaseController (String purchaseorder, String poRelCode, String useExceptions, String noCommit, SapClient sapClient)
コンストラクタ。

SapClientを使用することで、任意の接続先のコネクションを取得します。
noCommit(コミットワーク)の設定方法は以下のとおりです。
指定しない：コミット処理が実行されます。
「X」を指定：コミット処理が実行されません。
パラメータ
purchaseorder : String
購買発注番号
poRelCode : String
承認コード
useExceptions : String
例外メッセージ設定とエラーメッセージ出力
noCommit : String
コミットワーク はい/いいえ
sapClient : SapClient
Sapクライアント

メソッドの詳細

Object executeBapi ()
BapiControllerにより伝票の承認処理を実行します。
返却値
Object
Object エラー情報オブジェクト

エラーオブジェクトの構成は以下のとおりです。
エラー情報
オブジェクト
(Object)
ERR_CODE エラーコード (String)
1： 認証系システムエラー
2： 認証系アプリケーションエラー
3： 汎用系システムエラー
4： 汎用系アプリケーションエラー
7： 購買発注システムエラー
8： 購買発注アプリケーションエラー
詳細はjp.co.intra_mart.system.javascript.sapapi.ErrorJSHandler# をご覧ください。
ERR_MSG エラーメッセージ (String)
ERR_DESC システム例外のメッセージ詳細 (String)
String getBapiReturnErrMessage ()
ＢＡＰＩの実行結果のエラーメッセージを取得します。

ＢＡＰＩ実行結果であるBapiReturnのType情報が正常(デフォルト値: "S" / "")以外のBapiReturn オブジェクトのメッセージ情報を全て返します。 全て正常の場合はnullが返却されます｡
返却値
String
String BAPI実行結果エラーとなった全てのメッセージ情報
String getBapiReturnMessage ()
プロパティファイルでオートコミット条件に設定されたType情報に一致したメッセージ情報を全て返します。

ＢＡＰＩ実行結果であるBapiReturnのType情報が正常(デフォルト値: "S" / "")と 判断されたType情報のメッセージ情報を全て返します。 メッセージが存在しない場合はnullが返却されます｡
返却値
String
String プロパティファイルでオートコミット条件に一致したType情報のメッセージ情報
Object getRelIndicatorNew ()
伝票承認の新規承認区分を取得します。
返却値
Object
Object 新規承認区分
Object getRelStatusNew ()
伝票承認の新承認状況を取得します。
返却値
Object
Object 新承認状況
Object getRetCode ()
リターン値、ABAP 命令後のリターン値を取得します。
返却値
Object
Object リターン値、ABAP 命令後のリターン値
(成功時の返却値は String になります。)

(失敗時)　エラー情報オブジェクト

エラー情報オブジェクトの構成は以下のとおりです。
エラー情報
オブジェクト
(Object)
ERR_CODE エラーコード (String)
1:　認証系システムエラー
2:　認証系アプリケーションエラー
3:　汎用系システムエラー
4:　汎用系アプリケーションエラー
7： 購買発注システムエラー
8： 購買発注アプリケーションエラー
詳細はjp.co.intra_mart.system.javascript.sapapi.ErrorJSHandler# をご覧ください。
ERR_MSG アプリケーション例外(システム例外)のメッセージ概要 (String)
ERR_DESC システム例外のメッセージ詳細 (String)

String toString ()
デバッグ用のメソッドです。
返却値
String
String すべての属性の値

Copyright © 2013 NTT DATA INTRAMART CORPORATION