リソース情報取得

MailAddress

形式

String[] MailAddress(Resource resource)
String[] MailAddress(Resource[] resource)

説明

resourceで指定されたリソースのメールアドレスを返します。リソースがグループ、ユーザーロールの場合、(再帰的に)メンバーを展開し、すべてのメールアドレスを返します。

パラメーター

resource

リソース

戻り値

メールアドレスのリスト

DisplayName

形式

String DisplayName(Resource res)
String DisplayName(Resource res,String locale)
String DisplayName(Resource res,Boolean additional)
String DisplayName(Resource res,String locale,Boolean additional)
String[] DisplayName(Resource[] res)
String[] DisplayName(Resource[] res,String locale)
String[] DisplayName(Resource[] res,Boolean additional)
String[] DisplayName(Resource[] res,String locale,Boolean additional)

説明

resで指定されたリソースのロケールlocaleにおける表示名を返します。
localeが省略された場合は、定義のロケールを使用します。
指定されたロケールの表示名が存在しない場合、または、localeにdefalutが指定された場合は、ロケールなしのデフォルトの表示名を返します。
additionalが省略された場合は、trueを使用します。

パラメーター

res

リソース(ja|en|zh-cn|zh-tw|ko|default)

locale

表示名のロケール(ja|en)

additional

表示名に(ふりがな)または[グループ][ロール]をつけるかどうか

戻り値

リソースの表示名

リソース1が富士太郎というユーザー、リソース2が経理部というグループの場合
DisplayName(${リソース1},”en”,false)
→ FujiTaro
DisplayName(${リソース2})
→ [グループ]経理部

ResourceName

形式

String[] ResourceName(Resource res,String name)
String[] ResourceName(Resource res,String name,String lang)
String[] ResourceName(Resource[] res,String name)
String[] ResourceName(Resource[] res,String name,String lang)

説明

resourceで指定されたリソースのnameで指定された属性を返します。
取得できる属性は、DN、uidまたはcn、識別子(RmsId)、リソースのタイプ、メールアドレス、役職、組織名です。
resourceにグループまたはロールが指定され、かつメールアドレス、役職、組織名の取得が指定された場合は、グループまたはロール内のユーザーを全員展開し、各人の属性値を多値の値として返します。
nameの値は大文字・小文字を区別しません。nameの値がdn、id、rmsId、type、mail、title、ouの値のどれでもない場合はエラーになります。nameにidが指定された場合、指定したリソースがユーザーの場合はuidを、そうでない場合はcnを返します。
langが指定されなかった場合は、定義のロケールの属性値を取得します。定義のロケールの属性値が空であった場合は、ロケールなしのデフォルト属性値を取得します。
指定されたロケールの属性値が存在しない場合、または、langにdefaultが指定された場合は、ロケールなしのデフォルト属性値を取得します。

パラメーター

resource

リソース

name

属性(dn|id|RmsID|type|mail|title|ou)

langc

属性値のロケール(ja|en|zh-cn|zh-tw|ko|default)

戻り値

リソースの属性

リソース1が富士太郎というユーザー。Dnがuid=fujiで
ou=users、役職が部長の場合
ResourceName(${リソース1},”dn”)
→ uid=fuji,ou=users
ResourceName(${リソース1},”title”)
→ 部長

ResourceAttribute

形式

String[] ResourceAttribute(Resource res,String name)
String[] ResourceAttribute(Resource res,String name,String defaultValue)
String[] ResourceAttribute(Resource res,String name,String defaultValue,String lang)
String[] ResourceAttribute(Resource[] res,String name)
String[] ResourceAttribute(Resource[] res,String name,String defaultValue)
String[] ResourceAttribute(Resource[] res,String name,String defaultValue,String lang)

説明

resourceで指定されたリソースのnameで指定された属性を返します。
取得できる属性と指定するnameの値は、次のとおりです。

resourceにグループまたはロールが指定された場合は、グループまたはロール自身の属性値を返します。指定するリソースの種類ごとに取得できる値は次の表のとおりです。○は取得できる属性、×は取得できない属性を表します。×となる属性を指定した場合はエラーになります。

表: リソースの種類ごとに取得できる値

nameの値 ユーザー グループ ロール
rmsId
uid × ×
cn
sn × ×
givenName × ×
pronunciation × ×
displayName
employeeNumber × ×
ou
location × ×
title × ×
emploeeType × ×
telephoneNumber × ×
mobile × ×
mail × ×
mobileMail × ×
labeledURI × ×
description
digestNotifyTime × ×
preferredLanguage × ×
timeZone × ×
mailable × ×


nameの値は大文字・小文字を区別しません。nameの値が上記の値のどれでもない場合はエラーとなります。メール通知の値は、falseまたはtrueのどれかの文字列を返します。
defaultValueは、指定した属性値が設定されていなかった場合のデフォルト値です。
langが指定されなかった場合は、定義のロケールの属性値を取得します。定義のロケールの属性値が空であった場合は、ロケールなしのデフォルト属性値を取得します。
指定されたロケールの属性値が存在しない場合、または、langにdefaultが指定された場合は、ロケールなしのデフォルト属性値を取得します。

パラメーター

resource

リソース

name

属性(上記の値のどれか)

defaultValue

デフォルト値

lang

属性値のロケール(ja|en|zh-cn|zh-tw|ko|default)

戻り値

リソースの属性

リソース1が富士太郎というユーザー。Dnがuid=fujiでou=users、役職が部長の場合
ResourceAttribute(${リソース1},"dn")
→uid=fuji,ou=users
ResourceAttribute(${リソース1},"title")
→部長

Expand

形式

Resource[] Expand(Resource res)
Resource[] Expand(Resource res,String type)
Resource[] Expand(Resource res,Boolean recursive)
Resource[] Expand(Resource res,String type,Boolean recursive)
Resource[] Expand(Resource[] r)
Resource[] Expand(Resource[] r,String type)
Resource[] Expand(Resource[] r,Boolean recursive)
Resource[] Expand(Resource[] r,String type,Boolean recursive)

説明

resで指定されたリソースのメンバーで、タイプがtypeであるものを取得します。
typeが省略された場合は、userを使用します。
recursiveが省略された場合は、trueを使用します。

パラメーター

res

リソース

type

取得するリソースのタイプ(user|group|userRoleName)

recursive

取得した値にグループが含まれていた場合、そのグループの中身も再帰的に展開するかどうか

戻り値

展開されたリソースのリスト

リソース2が経理部というグループで配下に経理課、さらにその下に経理グループという構成の場合
Expand(${リソース2},”user”,false)
→ 経理部直下のユーザーリスト
Expand(${リソース2},”group”)
→ 経理課、経理グループ

Parent

形式

Resource[] Parent(Resource res)
Resource[] Parent(Resource res, String type)
Resource[] Parent(Resource res, Boolean recursive)
Resource[] Parent(Resource res, String type, Boolean recursive)
Resource[] Parent(Resource[] res)
Resource[] Parent(Resource[] res, String type)
Resource[] Parent(Resource[] res, Boolean recursive)
Resource[] Parent(Resource[] res, String type, Boolean recursive)

説明

resで指定されたリソースの親で、タイプがtypeであるものを取得します。
typeが省略された場合はgroupを使用します。
recursiveが省略された場合はtrueを使用します。

リソースの親は、次のように定義されます

パラメーター

res

リソース

type

取得するリソースのタイプ(user|group|userRoleName)

recursive

間接的な親も取得するか

戻り値

親リソースのリスト

経理部というグループの配下に経理課、さらにその下に経理グループという構成の場合
Parent(ToGroup(“経理グループ”),”group”,false)
→ 経理課,経理グループ
Parent(ToGroup(“経理グループ”),”group”,true)
→ 経理部,経理課,経理グループ

IsParent

形式

Boolean IsParent(Resource resource, Resource parent)
Boolean IsParent(Resource resource, Resource[] parent)
Boolean IsParent(Resource resource, Resource parent, Boolean recursive)
Boolean IsParent(Resource resource, Resource[] parent, Boolean recursive)
Boolean[] IsParent(Resource[] resource, Resource parent)
Boolean[] IsParent(Resource[] resource, Resource[] parent)
Boolean[] IsParent(Resource[] resource, Resource parent, Boolean recursive)
Boolean[] IsParent(Resource[] resource, Resource[] parent, Boolean recursive)

説明

parentで指定されたリソースがresourceの親であるか判定します。
parentが複数指定された場合、parentに1つでも親が含まれれば、trueを返します。
recursiveが省略された場合はtrueを使用します。

パラメーター

resource

判定するリソース

parent

親リソース

recursive

間接的な親も親であると判定するか

戻り値

parentがresourceの親であった場合true,それ以外はfalse

経理部というグループの配下に経理課、さらにその下に経理グループという構成の場合
IsParent(ToGroup(“経理グループ”),ToGroup(“経理部”,false)
→ false
IsParent(ToGroup(“経理グループ”),ToGroup(“経理部”,true)
→ true

ページの先頭へ