TeamWARE Office 200X V2.0 管理者ガイド
目次 索引 前ページ次ページ
付録B Directoryユーティリティ

B.7 グループ情報ファイル

グループ情報ファイルの形式について説明します。

グループ情報ファイルのコード系は、シフトJISコードです。各行の行末にキャリッジリターン<CR>とラインフィード<LF>が必要です。グループ情報ファイルには、以下の情報を記述します。

なお、上記の情報以外に、コメント行を記述できます。コメント行は、行頭に "/*" を記述します。

グループ情報ファイルを、ftpによって別のコンピュータにファイル転送する場合は、バイナリモードで行ってください。

◆グループアカウント行

グループアカウント行は、グループアカウント情報で構成されます。グループアカウント行は、スラッシュ文字"/"から始まり、空白行で終了する複数テキスト行です。なお、グループアカウント情報は、グループ情報ファイル1行目の空白行（改行のみの行）よりも、うしろに設定する必要があります。

グループアカウント情報は、グループに関する複数の属性から構成されます。各属性は、1行に"=<属性名> <属性値>"の形式で記述します。グループアカウント1件の属性をすべて記述するごとに、空白行を挿入します。

属性値に空白文字を含む場合、アポストロフィ（'）で囲みます。そのほかの属性値も、アポストロフィで囲むことができます。

グループ一括移入では、グループアカウント情報の1行目に指定するグループアカウント操作（"=op"）の値によって、以下の3つの処理が行われます。

それぞれの機能について説明します。

◆登録

登録では、グループ情報ファイルのグループ情報を基に、Directoryデータベースにグループ／私用グループを作成します。

新規のグループ／私用グループの登録は、グループ情報ファイルの"op"属性に"add"を記述することで行います。

ただし、グループ情報ファイルに記述したグループ／私用グループの名前によって、以下のような処理を行います。

◆更新

更新では、グループ情報ファイルの内容にそって、Directoryデータベースのグループ／私用グループ情報を修正します。なお、グループ／私用グループ情報のリスト機能と組み合わせることにより、グループ／私用グループ内のメンバーのゴミ掃除（ゴミメンバーを削除する）を行うことが可能です。ゴミ掃除の手順としては、まず、グループ／私用グループ情報のリスト機能で、グループ／私用グループをリストします。このグループ／私用グループ情報には、ゴミメンバーは含まれません。このグループ／私用グループ情報を使用して、グループ／私用グループを更新すれば、グループ／私用グループ内のゴミメンバーが削除されます。メンバーのゴミ掃除だけを行いたい場合は、リスト時のパラメータファイルに、"has_garbage_only=yes"パラメータを指定してください。

グループ／私用グループ情報の更新は、グループ情報ファイルの"op"属性に"modify"を記述することで行います。

グループ／私用グループ情報で、更新ではなく削除したい属性については、属性名のみ記述し、属性値を記述しないことにより削除を行うことができます。

なお、表B.3に記述されていない属性については、更新することはできません。

◆削除

削除では、グループ情報ファイルで指定したグループをDirectoryデータベースから削除します。

グループの削除は、グループ情報ファイルの"op"属性に"delete"を記述することで行います。

グループ一括移入において使用するグループアカウント属性の詳細については、以下に示す"表B.3 グループ属性一覧"を参照してください。

  • グループの登録／削除時に、属性値の省略はできません。
  • 表中のリスト列の○は当該属性が表示され、×は表示されないことを示します。
  • "descr(n)"、"street(n)"、および"doctype(n)"属性以外を複数指定した場合、最後の値が採用されます。

[表B.3 グループ属性一覧]

属性名

登録

更新

削除

リスト

最大長

注 釈

op

必須

必須

必須

○

6

add、modify、deleteのいずれかを指定します。
新規グループを登録する場合、addを指定します。
すでに登録されているグループ情報を変更する場合、modifyを指定します。
登録されているグループを削除する場合、deleteを指定します。
リストの場合は、必ず"add"になります。
更新の場合、属性値の省略はできません。

group
privategroup

必須

必須

必須

○

64,
490
(注1)

登録／更新／削除を行うグループ識別子を識別名を含めた形式で指定します。
新規にグループを登録する場合、すでに存在するオブジェクト（テンプレート、ユーザ、グループ）の名前と、識別子を含めて重複しない名前を指定します。
私用グループの登録・更新・削除を行う場合、privategroupで私用グループ名を指定します。新規に私用グループを登録する場合、既に存在するオブジェクト（私用エントリ、簡略名、私用グループ）の名前と重複しない名前を指定します。
更新の場合、属性値の省略はできません。
注意：登録の場合は、私用グループ名の前後の半角空白は除去されます。

owner

オプション

オプション

オプション

○

64,
490
(注1)

privategroupの場合、登録／更新／削除を行う私用グループのオーナ識別名を指定します。
登録／更新／削除時は、ここで指定されたオーナ識別名が、パラメータファイルで指定されたオーナ識別名より優先します。どちらも未指定の場合は、ログインユーザをオーナと見なします。リストの場合は、私用グループのオーナの識別名が出力されます。
なお、本属性で指定したオーナーがディレクトリに存在してない場合、本属性は無視されます。

newgroup
newprivategroup

×

オプション

×

○

64,
490
(注1)

新グループ識別子を識別名を含めた形式で指定します。
グループ識別子の変更に使用します。group属性で指定したグループ識別子が、ここで指定した値に置き換えられます。属性値の省略はできません。
privategroupの場合、newprivategroupで、新私用グループ名を指定します。私用グループ名の変更に使用します。newprivategroup属性で指定した私用グループ名が、ここで指定した値に置き換えられます。属性値の省略はできません。
注意：新私用グループ名の前後の半角空白は除去されます。

parent
parentprivategroup

オプション

オプション

×

×

64,
490
(注1)

groupの場合、parentで、所属したい親グループ識別名を指定します。
privategroupの場合、parentprivategroupで、所属したい親私用グループ名を指定します。
同時に複数のグループに所属したい場合は、複数記述します。
登録の場合は、指定されたすべてのグループに所属します。
更新の場合は、現在所属するすべてのグループから、ここで指定されたすべてのグループに所属するように変更されます。属性値を省略した場合は、現在所属する全グループからの所属から抜けます。なお、属性値を省略する場合は、複数行の指定はできません。現在所属しているグループから抜けたくない場合は、パラメータファイルに"remove_from_parent=no"を指定します。
登録／変更しようとするグループ／私用グループ自身を本属性値に指定した場合、グループ／私用グループに自分自身がメンバーとして登録されますが、Directoryアプリケーションなどで参照した場合は、メンバーとして表示されません。

type

オプション

オプション

×

○

6

groupの場合、グループのタイプを指定します。
以下の値を指定します。
　NORMAL：通常のグループ
　ACG：アクセス制御グループ
登録時にこの属性を省略した場合、NORMALが指定されたものとします。
なお、私用グループの場合は、本属性名は出力されません。
注意：グループのタイプをNORMALからACGに変更すると、そのグループに含まれていた通常のグループ、外部エントリ、および設備カレンダがメンバから取り除かれますので注意が必要です。

sortgroup

オプション

オプション

×

○

64

一覧表示のソートキーを記述します。

descr(n)

オプション

オプション

×

○

180
[指定値の合計]

ユーザのコメントを記述します。
複数行の指定が可能です。
複数行の指定は以下のように記述します。
descr(1), descr(2), ..., descr(n)
指定した文字列の合計が180バイト以内である必要があります(注2)。
なお、更新を指定した場合は、設定済みの値を、すべて指定した値に置き換えます。
更新時に、既定値を削除する場合には、1行目のみ、属性値無しで指定してください。
nの値が同一の属性を複数指定した場合、最後に指定した文字列から最初に指定した文字列の順番に結合されて設定されますので、注意してください。

listmethod

オプション

オプション

×

○

1

グループに所属するメンバーの表示順序を指定します。
以下の値を指定します。
　0：標準設定
　1：ユーザ定義
登録時にこの属性を省略した場合は、0が指定されたものとします。
更新時に本属性の属性値を省略した場合、0が指定されたものとします。

telnr(n)

オプション

オプション

×

○

64

電話／FAX番号を指定します。
複数指定が可能です。
複数指定は以下のように記述します。
telnr(1),telnr(2),...,telnr(n)
nには、1からの数字を入れてください。nの値は、Directoryクライアントで指定できる最大値である30までの数を指定してください。
なお、更新を指定した場合は、現在設定されている値をすべて指定した値に置き換えます。
更新時に、既定値を削除する場合には、1行目のみ、属性値無しで指定してください。

teldescr(n)

オプション

オプション

×

○

180

同一の修飾子(n)を持つ電話／FAX番号に対する説明を記述します。
telnr(n)と対応しています。
nには、1からの数字を記述します。
nの値は、Directoryクライアントで指定できる最大値である30までの数を指定してください。
teldescr(1),teldescr(2),...,teldescr(n)
のように複数行に記述することもできます。なお、更新を指定した場合は、現在設定されている値をすべて指定した値に置き換えます。
更新時に、既定値を削除する場合には、1行目のみ、属性値無しで指定してください。

localuser

オプション

オプション

×

○

64,
490
(注1)

メンバーとして登録するローカルユーザ識別名を指定します。
(注3)

externaluser

オプション

オプション

×

○

64,
490
(注1)

メンバーとして登録する外部エントリ識別名を指定します。(注3)

groupmember

オプション

オプション

×

○

64,
490
(注1)

メンバーとして登録するグループ識別名を指定します。(注3)

resourcecalendar

オプション

オプション

×

○

64,
490
(注1)

メンバーとして登録する設備カレンダー識別名を指定します。(注3)

localuseraliasmember

オプション

オプション

×

○

64

privategoupの場合、私用グループにメンバーとして登録するユーザ簡略名を指定します。(注3)

privateusermember

オプション

オプション

×

○

64

privategoupの場合、私用グループにメンバーとして登録する私用エントリ名を指定します。(注3)

privategroupmember

オプション

オプション

×

○

64

privategoupの場合、私用グループにメンバーとして登録する私用グループ名を指定します。(注3)

externaluseraliasmember

オプション

オプション

×

○

64

privategoupの場合、私用グループにメンバーとして登録する外部エントリ簡略名を指定します。(注3)

groupaliasmember

オプション

オプション

×

○

64

privategoupの場合、私用グループにメンバーとして登録するグループ簡略名を指定します。(注3)

resourcecalendaraliasmember

オプション

オプション

×

○

64

privategoupの場合、私用グループにメンバーとして登録する設備カレンダー簡略名を指定します。(注3)
(注1)：ディレクトリの名前部分の最大長は64バイト、識別名全体の最大長は490バイトです。たとえば、属性名groupの識別名が"cn=group名,l=location,o=organization,c=jp"の場合、全体の最大長は490バイトで、group名部分の最大長は64バイトです。
(注2)：複数行が指定された場合、最終行を除く各行には改行文字のバイト数（CR+LFの2バイト）が含まれます。
(注3)：localuser、externaluser、groupmember、およびresourcecalendarには、他サイトのディレクトリエントリも指定可能です。
同時に複数のメンバーを登録したい場合は、複数記述します。
更新で指定されなかったメンバーはそのグループから削除されるため注意してください。たとえば、localuser、externaluser、groupmember、およびresourcecalendarをメンバーとしているグループに対してlocaluser属性のみを指定すると、当該グループのメンバーは、指定されたlocaluserのみになり、指定されなかったlocaluserと、すべてのexternaluser、すべてのgroupmember、およびすべてのresourcecalendarは削除されます。
属性値を省略したlocaluser属性のみを指定した場合は、すべてのメンバーを削除します。なお、属性値を省略する場合は、複数行の指定はできません。
export_listで出力するグループのメンバーがすべてゴミメンバーの場合は、ローカルユーザ識別子なしの"=localuser"行のみが出力されます。

以下に、グループ情報ファイルの作成例を示します。

/* 新しく"のりこグループ"を登録。
/* "のりこグループ"は、"矢橋プロジェクト"、"開発担当"グループ
/* に属する。
/ =OP           add
=GROUP          'cn=のりこグループ,ou=東京開発センター,l=東京,o=(株)ＡＢＣ,c=jp'
=PARENT          'cn=矢橋プロジェクト,ou=東京開発センター,l=東京,o=(株)ＡＢＣ,c=jp'
=PARENT         'cn=開発担当,l=東京,o=(株)ＡＢＣ,c=jp'
=TYPE           NORMAL
=SORTGROUP      TeamWARE
=DESCR          'TeamWARE Server Framework Group'
=LISTMETHD       1
=TELNR(1)       123-456-7890
=TELNR(2)       098-765-4321
=TELDESCR(1)    代表
=TELDESCR(2)    直通

/* "グループＡ"を、"数字グループ"に移動。
/* 同時にグループ識別子を"グループ1"に変更。
/ =OP           modify
=GROUP          'cn=グループＡ,l=東京,o=(株)ＡＢＣ,c=jp'
=NEWGROUP         'cn=グループ1,l=東京,o=(株)ＡＢＣ,c=jp'
=PARENT         'cn=数字グループ,l=東京,o=(株)ＡＢＣ,c=jp'

/* "TWグループ"を削除
/ =OP           delete
=GROUP          'cn=TWグループ,l=東京,o=(株)ＡＢＣ,c=jp'

また、以下に、私用グループ更新時の、グループ情報ファイルの作成例を示します。

/ =OP            modify
=PRIVATEGROUP    '私用グループ１'
=OWNER           'cn=富士通太郎,ou=東京開発センター,l=東京,o=(株)ＡＢＣ,c=jp'
=SORTGROUP       TeamWARE
=DESCR(1)        '富士通太郎用の私用グループ１です。'
=LISTMETHOD       1
=TELNR(1)        123-456-7890
=TELNR(2)        098-765-4321
=TELDESCR(1)     代表
=TELDESCR(2)     直通
=LOCALUSER       'cn=富士通花子,l=東京,o=(株)ＡＢＣ,c=jp'
=EXTERNALUSER    'cn=Test User,l=東京-External,o=(株)ＡＢＣ,c=jp'
=GROUPMEMBER     'cn=太郎グループ,ou=東京開発センター,l=東京,o=(株)ＡＢＣ,c=jp'
=RESOURCECALENDAR             'cn=D314会議室, l=東京,o=(株)ＡＢＣ,c=jp'
=PRIVATEUSERMEMBER            '東京太郎'
=PRIVATEGROUPMEMBER           '私用グループ１−１'
=PRIVATEGROUPMEMBER           '私用グループ１−２'
=LOCALUSERALIASMEMBER         '富士通花子'
=EXTERNALUSERALIASMEMBER      'Test User1'
=GROUPALIASMEMBER             '太郎グループ
=RESOURCECALENDARALIASMEMBER  'D314会議室'
目次 索引 前ページ次ページ
Copyright(C) TeamWARE Group Oy 2007 and Fujitsu Limited 2007 and/or their licensors.