利益センタ 取得 API (ProfitCenterController)¶

var validTo;
var pctrName;
var inCharge;
var listResult;
var listCount;

function init(request) {
    var objCon;
    var code;

    //インスタンス生成 
    objCon = new ProfitCenterController("JP10");    // 説明1

    // コンストラクタでのエラーチェック 
    if (objCon.getErrCode() != "0"){ 
        //エラーメッセージ出力 
        Debug.browse(objCon.getErrMsg()); 
    }

    //利益センタの一覧を取得 
    list = objCon.getProfitCenterList();       // 説明2 

    //利益センタの一覧から１件目の「利益センタコード」を取得 
    code =  list[0]["PROFIT_CTR"]; 

    //１件目のデータの有効終了日を取得 
    validTo = objCon.getValidTo(code);      // 説明3

    //１件目のデータの一般名称を取得 
    pctrName = objCon.getPctrName(code);      // 説明4

    //１件目のデータの責任者を取得 
    inCharge = objCon.getInCharge(code);         // 説明5

    //一覧の件数を取得 
    listCount = list.length;    // 説明6

}

• 利益センタ取得 API のインスタンス生成(説明1)

  ProfitCenterController クラスのインスタンスを生成します。

  インスタンスは、以下の３つのいずれかの方法で生成することができます。

  インスタンスを生成すると、BAPI を呼出して利益センタを取得する処理が実行されます。

  サンプルプログラム内では、管理領域コード「JP10」を直接記述していますが、管理領域取得APIにて取得した管理領域コードがセットされた変数を引数に用いれば、より効率的なプログラムを作成することが可能です。
  1. システム日付時点で有効な利益センタを取得する場合

  インスタンス（第1引数あり）を生成します。

  第1引数で「管理領域コード」を指定します。

  objCon = new ProfitCenterController (“JP10”)は、管理領域コード「JP10」に紐付けられている利益センタの情報の内、システム日付時点で有効な情報のみを取得する、となります。

  2. 引数で指定した日付時点で有効な利益センタを取得する場合

  インスタンス（第1、2引数あり）を生成します。

  第1引数で「管理領域コード」、第2引数で「日付（YYYYMMDD）」を指定します。

  もし、objCon = new ProfitCenterController (“JP10”,”20040930”)とした場合は、管理領域コード「JP10」に紐付けられている利益センタの情報の内、2004年9月30日時点で有効な情報のみを取得する、となります。

  3. 引数で指定した管理領域、利益センタ責任者、利益センタに責任のあるユーザ、日付時点で、有効な利益センタを取得する場合

  インスタンス（第1～4引数あり）を生成します。

  第1引数で「管理領域コード」、第2引数で「利益センタ責任者」、第3引数で「利益センタに責任のあるユーザ」、第４引数で「日付（YYYYMMDD）」を指定します。

  もし、objCon = new ProfitCenterController (“JP10”,”ERP002”,”ERP003”,”20070930”)とした場合は、管理領域コード「JP10」に紐付けられている利益センタの情報の内、2007年9月30日時点で有効な情報かつ利益センタ責任者「ERP002」、利益センタに責任のあるユーザ「ERP003」に紐づく情報を取得する、となります。

• 利益センタの一覧を取得

  ProfitCenterController クラスの getProfitCenterList メソッドを使用すると、利益センタの一覧を取得することが可能です。

  ただし、ProfitCenterController クラスのインスタンスを生成する際に、引数で指定した管理領域コードに紐付けられている利益センタのみ一覧に含まれます（引数で指定した日付（またはシステム日付）時点で有効でない利益センタは対象外）。

• 1件目のデータの一般名称を取得

  ProfitCenterController クラスの getPctrName メソッドを使用すると、引数に指定した利益センタコードに対応する一般名称を取得することが可能です。

  該当するデータが存在しない場合は、何も返却されません。

• 1件目のデータの責任者を取得

  ProfitCenterController クラスのgetInChargeメソッドを使用すると、引数に指定した利益センタコードに対応する責任者を取得することが可能です。

  該当するデータが存在しない場合は、何も返却されません。

• 一覧の件数を取得

  ProfitCenterController クラスの getProfitCenterList メソッドで取得した利益センタの一覧は、length で件数を取得することが可能です。