public BLCDictionary getDownOrgInfo(java.lang.String p_belongto,
                                  java.util.ArrayList p_attrlist,
                                  java.lang.String p_sortkey)
                           throws BLCException

指定した組織に属するすべての下位組織の情報を取得します。結果は，新しいBLCDictionaryクラスオブジェクトに格納されます。

p_belongto

組織IDを指定します。最上位組織の組織情報を取得する場合は，"$root"を指定してください。組織IDは，1〜128バイトで指定してください。

p_attrlist

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

属性名	意味
CDORG	組織コード
NMORG	組織略称
NMORGFULL	組織名
CDPARENTORG	上位組織コード
ユ−ザ追加カラム名	ユ−ザ追加情報

• ユ−ザ追加カラム名には，BLC_ORG_Vビューにユーザが追加した任意のカラムの名称を指定できます。BLC_ORG_Vビューに存在しないカラム名称を指定した場合，動作は保証されません。
• ユーザ追加カラム名は，（指定数＋各指定属性長）が500文字を超えない範囲で指定してください。500文字を超えた場合，SQL発行時にエラーになることがあります。
• ユーザ追加カラム名称は，大文字で指定してください。

p_sortkey

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

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

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

形式例

属性名△ソートモード[,属性名△ソートモード,・・・・]

注　△は半角スペースです。

• 指定可能な属性名は，データベースのBLC_ORG_Vビューに定義されているカラム名です。
• ソートモードは次のどちらかを指定してください。
  

  モード	意味
  ASC	昇順
  DESC	降順

注　指定できる形式は，ご使用になるRDBMSによって異なります。詳細は，ご使用になるRDBMSのORDER BY句に指定できる式を確認してください。

取得した組織情報。

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

キー名	意味	オブジェクト種別	備考
blc_org_total	取得情報数	Integer	取得属性の指定に関係なく取得できます。
blc_org_cd_$n	組織コード	String	取得属性の指定に関係なく取得できます。
blc_org_ab_$n	組織略称	String	取得属性にNMORGを指定した場合だけ取得できます。
blc_org_nmfull_$n	組織名	String	取得属性にNMORGFULLを指定した場合だけ取得できます。
blc_org_cdup_$n	上位組織コード	String	取得属性にCDPARENTORGを指定した場合だけ取得できます。 最上位組織の場合，"$root"が返却されます。
blc_org_"ユ−ザ追加カラム名"_$n	ユ−ザ追加情報	Object	取得属性に指定したカラム名だけ取得できます。
blc_org_cnt_"組織コード"	逆引き用情報番号	String	取得属性の指定に関係なく取得できます。
blc_org_abnm_"組織コード"	組織略称	String	取得属性にNMORGを指定していない場合は，空文字（""）が返却されます。

（凡例）

$n　取得情報番号（1〜取得数）。

指定した組織IDの組織がデータベース（BLC_ORG_Vビュー）に登録されていない場合でも，キー名「blc_org_total」に値が0のIntegerオブジェクトが設定されて，正常終了します。

指定した組織IDの組織下に組織が登録されていない場合でも，キー名「blc_org_total」に値が0のIntegerオブジェクトが設定されて，正常終了します。

BLCException

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

• パラメータ「p_belongto」で指定した各組織IDの指定長が，1バイト未満または128バイトより大きい。
• パラメータ「p_belongto」にnullオブジェクトを指定した。
• パラメータ「p_attrlist」で指定した各取得属性の指定長が1バイト未満である。または，取得属性としてStringオブジェクト以外を指定した。
• パラメータ「p_attrlist」に要素がないオブジェクトを指定した。
• パラメータ「p_attrlist」にnullオブジェクトを指定した。または，パラメータ「p_attrlist」の要素にnullオブジェクトを指定した。
• BLC_ORG_Vビューにパラメータ「p_attrlist」で指定した属性名に一致するカラムがない。
• BLC_ORG_Vビューにパラメータ「p_sortkey」で指定した属性名に一致するカラムがない。
• パラメータ「p_sortkey」で指定したソートモードの指定に誤りがある。
• パラメータ「p_sortkey」で指定したソート条件の形式に誤りがある。
• データベースアクセスクラスで例外が発生した。