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オブジェクトまたは空文字("")を指定してください。
ソート条件の指定形式例を次に示します。
属性名△ソートモード[,属性名△ソートモード,・・・・]
モード | 意味 |
---|---|
ASC | 昇順 |
DESC | 降順 |
戻り値
宛先情報。
キーの意味とオブジェクト種別について,次に示します。
キー名 | 意味 | オブジェクト種別 | 備考 |
---|---|---|---|
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オブジェクトが設定されて,正常終了します。
例外
BLC内で次のどれかの原因のエラーが発生しました。