uCosminexus 電子フォームワークフロー APIリファレンス

[目次][用語][索引][前へ][次へ]

getTargetInfo

形式

public BLCDictionary getTargetInfo(java.lang.String p_uid,
                                java.util.ArrayList p_attrlist,
                                java.lang.String p_sortkey)
                         throws BLCException

機能

指定したユーザの宛先情報を取得します。結果は,新しいBLCDictionaryクラスオブジェクトに格納されます。

パラメータ

p_uid

宛先情報を取得するユーザのユーザIDを指定します。ユーザIDは,1〜128バイトで指定してください。

p_attrlist

取得属性を指定します。1個以上指定してください。指定できる属性名を次に示します。

属性名 意味
CDUSER ユーザID
CDTARGET 宛先ユーザID
NMBELONGTO 宛先の所属組織略称
CDJOBTITLE 宛先の役職コード
NMJOBTITLE 宛先の役職略称
NMLASTNAME 宛先の名字
NMFIRSTNAME 宛先の名前
ユ−ザ追加カラム名 ユ−ザ追加情報

p_sortkey

ソート条件を,ご使用になるRDBMSのORDER BY句に指定できる式で指定します。500文字以内で指定してください。500文字を超えた場合,SQL発行時にエラーになることがあります。

ソートしない場合は,nullオブジェクトまたは空文字("")を指定してください。

ソート条件の指定形式例を次に示します。

形式例
属性名△ソートモード[,属性名△ソートモード,・・・・]
注 △は半角スペースです。
  • 指定可能な属性名は,データベースのBLC_TARGET_USER_Vビューに定義されているカラム名です。
  • ソートモードは次のどちらかを指定してください。
    モード 意味
    ASC 昇順
    DESC 降順
注 指定できる形式は,ご使用になるRDBMSによって異なります。詳細は,ご使用になるRDBMSのORDER BY句に指定できる式を確認してください。

戻り値

宛先情報。

キーの意味とオブジェクト種別について,次に示します。

キー名 意味 オブジェクト種別 備考
blc_target_total 取得情報数 Integer 取得属性の指定に関係なく取得できます。
blc_target_userid_$n ユーザID String 取得属性にCDUSERを指定した場合だけ取得できます。
blc_target_id_$n 宛先ユーザID String 取得属性の指定に関係なく取得できます。
blc_target_aborg_$n 宛先の所属する組織略称 String 取得属性にNMBELONGTOを指定した場合だけ取得できます。
blc_target_cdjob_$n 宛先の役職コード String 取得属性にCDJOBTITLEを指定した場合だけ取得できます。
blc_target_abjob_$n 宛先の役職略称 String 取得属性にNMJOBTITLEを指定した場合だけ取得できます。
blc_target_nmlast_$n 宛先の氏名漢字名字 String 取得属性にNMLASTNAMEを指定した場合だけ取得できます。
blc_target_nmfirst_$n 宛先の氏名漢字名前 String 取得属性にNMFIRSTNAMEを指定した場合だけ取得できます。
blc_target_nmfull_$n 宛先の氏名漢字 String 取得属性にNMLASTNAMEとNMFIRSTNAMEの両方を指定した場合以外は,空文字("")が返却されます。
blc_target"ユーザ追加カラム名"_$n ユーザ追加情報 Object 取得属性に指定したカラム名だけ取得できます。
blc_target_cnt_"宛先ユーザID" 逆引き用情報番号 String 取得属性の指定に関係なく取得できます。
blc_target_nm_"宛先ユーザID" 宛先の氏名漢字 String 取得属性にNMLASTNAMEとNMFIRSTNAMEの両方を指定した場合以外は,空文字("")が返却されます。

(凡例)

$n 取得情報番号(1〜取得数)。


指定したユーザIDのユーザの宛先がデータベース(BLC_TARGET_USER_Vビュー)に登録されていない場合でも,キー名「blc_target_total」に値が0のIntegerオブジェクトが設定されて,正常終了します。

指定したユーザIDのユーザがデータベース(BLC_TARGET_USER_Vビュー)に登録されていない場合でも,キー名「blc_target_total」に値が0のIntegerオブジェクトが設定されて,正常終了します。

例外

BLCException

BLC内で次のどれかの原因のエラーが発生しました。