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ユーザIDString取得属性にCDUSERを指定した場合だけ取得できます。
blc_target_id_$n宛先ユーザIDString取得属性の指定に関係なく取得できます。
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内で次のどれかの原因のエラーが発生しました。