TeamWARE Office 200X V2.0 管理者ガイド

B.4 外部エントリの登録／更新／削除

TeamWARE Officeサーバに対し、外部エントリの登録／変更／削除を行うことができます。

ユーザは、以下に示す形式のパラメータファイルと、外部エントリ情報ファイルを作成し、todirmovコマンドを実行することにより外部エントリの登録、登録済みの外部エントリ情報の変更、外部エントリの削除を一括して行うことができます。

この機能は、サイト内のデータベース情報を操作するためのものです。ほかのサイトへの外部エントリの登録、ほかのサイトへの外部エントリの移動など、サイトを越えた処理は行えません。また、他サイトから移入されたユーザの変更・削除も行うことはできません。

◆コマンドの形式

TeamWARE Officeサーバに対し、外部エントリの登録／変更／削除を行うには、サーバインストールディレクトリで、以下のコマンドを実行します。

todirmov <パラメータファイル名>

• [todirmov]コマンドは、TeamWARE Officeサーバをインストールしたディレクトリで実行してください。
• パラメータファイルを ftp によって別マシンにファイル転送する場合は、バイナリモードで行ってください。

◆パラメータファイルの形式

パラメータファイルは、以下に示す形式で作成します。なお、パラメータファイルのコード系にはシフトJISコードを使用します。

オプションのパラメータは角かっこ（[ ]）でくくられています。

パラメータ“file”には、外部エントリ情報ファイルを指定します。

utility=IMPORT
what=EXTERNAL_ENTRY
org=<組織の識別名>
file=<外部エントリ情報ファイル名>
user=<ログイン名>
[password=<ログインユーザのパスワード>]
tp_number=<トランスポート番号>
tp_address=<トランスポートアドレス>

パラメータ値を省略した場合は、コンソールメッセージが出力されます。

◆パラメータの説明

utility

“IMPORT”と指定します。

what

“EXTERNAL_ENTRY”と指定します。

org

登録する外部エントリの組織の識別名を指定します。指定した識別名に属する外部エントリとして登録を行います。

file

移入する外部エントリ情報ファイル名を指定します。

user

ログイン名を指定します。ログイン名は、最長で48文字までです。ログインユーザには、システム管理者の権限が必要です。

password

ログインユーザのパスワードを指定します。パスワードは、最長で48文字までです。ログインユーザがパスワードを持っていない場合は省略します。

tp_number

ログイン時に使用するトランスポート番号を指定します。TeamWARE Officeをインストールしたディレクトリ配下の初期化ファイル（to.ini）の[TOSERVER]セクションのtransportsフィールドに記述されています。

以下に示す例の場合、tp_numberは1になります。

（例）
[TRANSPORT]
1 = tcpip,240,0,

tp_address

ログイン時に使用するディレクトリサーバのトランスポートアドレスを指定します。このサーバのディレクトリが、移出元ディレクトリサーバとして使用されます。tp_addressは、最長で128文字までです。

パラメータファイルの例を、以下に示します。

utility=IMPORT
what=EXTERNAL_ENTRY
org='o=fujitsu,c=JP'
user=ADMIN
password=PASSWORD
file=external.txt
tp_number=1
tp_address=199.199.199.199

ユーザ情報のうち、更新ではなく削除したい属性については、属性名だけを記述します。ただし、現在ユーザが持っていない属性値を省略することはできません。なお、表B.2で更新が×になっている属性や、記述されていない属性については、更新することはできません。

◆外部エントリ情報ファイル

ファイルの形式は、基本的に“ローカルユーザ情報ファイル”と同様です。

ファイル形式の詳細については、“B.3 ローカルユーザ情報ファイル”を参照してください。

使用可能な属性値について、以下に示します。

[表B.2 アカウント属性一覧]

属性名	登録	更新	削除	最大長	注 釈
op	必須	必須	必須	6	以下の3種類から選択して記述します。 add :新規外部エントリ登録 modify:既存の外部エントリ情報を更新 delete :既存の外部エントリ情報を削除
user	必須	必須	必須	64	外部エントリ名を記述します。 なお、同名の外部エントリ名を登録することはできません。
sortuser	オプション	オプション	×	64	一覧表示のソートキーを記述します。 通常、ユーザ名をローマ字読みにしたカナ文字で記述します。
sur	オプション	オプション	×	40	ユーザの姓を記述します。
giv	オプション	オプション	×	16	ユーザの名を記述します。
system	オプション	×	×	16	ユーザのシステム名。 省略した場合、“TW”となります。 “TW”、または“TeamWARE”を指定した場合、“TeramWARE”ユーザとなります。 他の値を指定した場合、“TeramWARE”ユーザ以外のユーザとなります。
title	オプション	オプション	×	64	ユーザの肩書を記述します。
descr(n)	オプション	オプション	×	180- ((n-1)*2) [1〜nまでの指定値合計]	ユーザのコメントを記述します。 nには、1から60までの数字を記述します。 　descr(1), descr(2), ..., descr(n) のように記述すれば、複数行に記述することもできます。なお、更新を指定した場合は、設定されている値をすべて指定した値に置き換えます。更新時に属性値を省略する場合は1行目のみ指定してください。 nの値が同一の属性を複数指定した場合、最後の指定文字列から先頭の指定文字列の順番に結合されて設定されますので注意してください。
prefnet	必須	オプション	×	4	ユーザの好みの配達方法を指定します。 指定する値には、以下のものがあります。 7　インターネット 4097　X.400簡易記述アドレス インターネットアドレス、またはX.400簡易記述アドレスを指定して登録する場合は必須です。
Custom(n)	オプション	オプション	×	128	カスタム属性を設定します。 カスタム属性は、組織情報などに利用します。nには、1からの数字を記述します。 custom(1), custom(2), ..., custom(n)のように複数記述することもでき、最大16まで指定できます。また、nは連続している数字である必要はありません。 ローカルユーザ情報登録／削除でcustom(n)を使用する場合は、あらかじめ共用ディレクトリ内にカスタム属性、カスタムIDを設定しておく必要があります。 サーバに設定されたカスタムIDとcustom(n)との関係は、サーバに設定されたカスタムIDの最小のIDがcustom(1)と対応し、サーバに指定されたカスタムIDの最大のIDがcustom(n)と対応します。つまり、サーバに設定されたカスタムIDが5, 10, 15の3つの場合、custom(1)とサーバのカスタムID=5が対応し、custom(2)とサーバのカスタムID=10が対応、custom(3)とサーバのカスタムID=15が対応します。
doctype(n)	オプション	オプション	×	180- ((n-1)*2) [1〜nまでの指定値合計]	ユーザの好みの文書種別を記述します。 nには、1から60までの数字を記述します。複数指定する場合、doctype(1), doctype(2),...,doctype(n)のように記述します。なお、更新を指定した場合は、設定されている値をすべて指定した値に置き換えます。 nの値が同一の属性を複数指定した場合、最後の指定文字列から先頭の指定文字列の順番に結合されて設定されますので注意してください。
telnr(n)	オプション	オプション	×	64	ユーザの電話番号を記述します。 nには、1からの数字を記述します。nの値は、Directoryクライアントで指定できる最大値である30までの数を指定してください。 複数指定する場合、telnr(1), telnr(2), ..., telnr(n)のように記述します。 更新を指定した場合は、設定されている値をすべて指定した値に置き換えます。更新時に属性値を省略する場合は、1行目のみ指定してください。
teltype(n)	オプション	オプション	×	−	同一の修飾子(n)をもつ電話番号に対する種別を記述します。 telnr(n)と対応しています。nには、1からの数字を記述します。nの値は、Directoryクライアントで指定できる最大値である30までの数を指定してください。 複数指定する場合は、 teltype(1),teltype(2),...teltype(n)のように記述します。 指定できる値は以下のとおりです。 OFFICE :勤務先 HOME :自宅 MOBILE:携帯電話、PHSなど PAGER :ポケットベル telnrを指定し、teltypeを指定しなかった場合は、初期値としてOFFICEが設定されます。
teldescr(n)	オプション	オプション	×	180	同一の修飾子(n)を持つ電話番号に対する説明を記述します。 telnr(n)と対応しています。nには、1からの数字を記述します。nの値は、Directoryクライアントで指定できる最大値である30までの数を指定してください。 複数指定する場合、 teldescr(1), teldescr(2), ...,teldescr(n)のように記述します。なお、更新を指定した場合は、設定されている値をすべて指定した値に置き換えます。更新時に属性値を省略する場合は、1行目だけを指定してください。
faxnr(n)	オプション	オプション	×	64	ユーザのFAX番号を記述します。 nには、1からの数字を記述します。nの値は、Directoryクライアントで指定できる最大値である30までの数を指定してください。 複数指定する場合、faxnr(1), faxnr(2), ..., faxnr(n)のように記述します。更新を指定した場合は、設定されている値をすべて指定した値に置き換えます。更新時に属性値を省略する場合は、1行目のみ指定してください。
faxdescr(n)	オプション	オプション	×	180	同一修飾子(n)を持つFAX番号に対する説明を記述します。 faxnr(n)と対応しています。nには、1からの数字を記述します。nの値は、Directoryクライアントで指定できる最大値である30までの数を指定してください。 複数指定する場合、 faxdescr(1), faxdescr(2), ...,faxdescr(n)のように記述します。なお、更新を指定した場合は、設定されている値をすべて指定した値に置き換えます。更新時に属性値を省略する場合は、1行目だけを指定してください。
street(n)	オプション	オプション	×	30 (1行の長さ)	ユーザの所在地を記述します。 nには、1から6までの数字を記述します。 street(1), street(2), ..., street(n)のように記述すれば、複数行に記述することもできます。なお、更新を指定した場合は、設定されている値をすべて指定した値に置き換えます。更新時に属性値を省略する場合は、1行目のみ指定してください。 nの値が同一の属性を複数指定した場合、最後の指定文字列から先頭の指定文字列の順番に結合されて設定されますので注意してください。
internetuser	オプション	オプション	×	192	ユーザのインターネットアドレスの名前部分を記述します。 （注）外部エントリの登録・変更の時にインターネットアドレスを指定する場合、 internetuserとinternetbaseの合計が256バイト以内である必要があります。
internetbase	オプション	オプション	×	255	ユーザのインターネットアドレスのベースアドレス部分を記述します。 （注）ベースアドレス部分の変更では、internetuserとinternetbaseは、組で指定する必要があります。
newuser	×	オプション	×	64	新外部エントリ名を記述します。 外部エントリ名の変更に使用します。
x4mnep...					x4mnepで始まる以降の属性は、X.400簡易記述アドレスの印刷可能文字列形式の各部分名を意味します。 （注1）giv,init,gen属性を指定する場合、必ずsur属性も指定する必要があります。 （注2）X.400簡易記述アドレスを指定する場合、常に組で属性を指定してください。部門名と領域定義属性については、存在しない階層の部門名を省略できます。 x4mnepsur,x4mnepadmd,x4mnepcoについては、省略できません。 （注3）X.400簡易記述アドレスを更新する場合にも、常に組で属性を指定してください。一部の属性だけを指定して変更することはできません。 x4mnepadmd,x4mnepcoについては、省略できません。 （注4）更新時に、x4mnepadmd と x4mnepcoの値を空で指定すると、X.400アドレス情報全体が削除されます。
x4mnepsur	オプション	オプション	×	40	ユーザの姓を記述します。
x4mnepgiv	オプション	オプション	×	16	ユーザの名を記述します。
x4mnepinit	オプション	オプション	×	5	ユーザの頭文字を記述します。
x4mnepgen	オプション	オプション	×	3	ユーザの世代を記述します。
x4mneporg	オプション	オプション	×	64	ユーザの組織名を記述します。
x4mnepou1	オプション	オプション	×	32	ユーザの部門名1を記述します。
x4mnepou2	オプション	オプション	×	32	ユーザの部門名2を記述します。
x4mnepou3	オプション	オプション	×	32	ユーザの部門名3を記述します。
x4mnepou4	オプション	オプション	×	32	ユーザの部門名4を記述します。
x4mnepprmd	オプション	オプション	×	16	ユーザの私設領域名を記述します。
x4mnepadmd	オプション	オプション	×	16	ユーザの主管庁領域名を記述します。
x4mnepddef1	オプション	オプション	×	7+60	ユーザの領域定義属性1を記述します。記述の形式は、「種類.値」としてください。種類は長さ7バイト、値は60バイトが最大長です。
x4mnepddef2	オプション	オプション	×	7+60	ユーザの領域定義属性2を記述します。記述の形式は、「種類.値」としてください。種類は長さ7バイト、値は60バイトが最大長です。
x4mnepddef3	オプション	オプション	×	7+60	ユーザの領域定義属性3を記述します。記述の形式は、「種類.値」としてください。種類は長さ7バイト、値は60バイトが最大長です。
X4mnepddef4	オプション	オプション	×	7+60	ユーザの領域定義属性4を記述します。記述の形式は、「種類.値」としてください。種類は長さ7バイト、値は60バイトが最大長です。
x4mnepco	オプション	オプション	×	3	ユーザの国名を記述します。
x4mnet...					x4mnetで始まる属性は、X.400簡易記述アドレスのteletex形式の各部分名を意味します。x4mnet...には、上記x4mnep...と同じ属性が含まれています。 （注1）sur、givには、全角文字と半角文字の混在した値および半角カナをすることはできません。また、init、genに指定できるのは印刷可能文字のみです。 （注2）X.400簡易記述アドレスのteletex形式を指定する場合、X.400 印刷可能文字列形式アドレスの x4mnepco、x4mnepadmdと、条件付属性 (x4mnepsur、x4mneporg、x4mnep1〜4、x4mnepprmdおよび x4mnepddef1〜4) のどれかを定義する必要があります。また、teletex形式の x4mnetprmd、x4mnetadmd、x4mnetcoについては、印刷形式の x4mnepprmd、 x4mnepadmd、x4mnepcoと、同じ値となります。 （注3）X.400簡易記述アドレスのteletex形式を指定する場合、常に組で属性を指定してください。ただし、部門名については、存在しない階層の部門名を省略できます。x4mnetadmd、x4mnetcoについては、省略できません。 （注4）X.400簡易記述アドレスを更新する場合にも、常に組で属性を指定してください。一部の属性だけを指定して変更することはできません。x4mnetadmd、x4mnetcoについては、省略できません。

（注）："descr(n)"、"street(n)"、および"doctype(n)"属性以外を複数指定した場合、最後の値が採用されます。

以下に、外部エントリ情報ファイルの作成例を示します。

/* 新しく外部エントリ“伊藤のりこ”を登録。
/*“のりこ”は、“PFUサイト”のユーザです。
/ =OP add
=USER 伊藤のりこ
=SUR itoh
=GIV noriko
=TITLE 開発グループリーダー
=SORTUSER イトウノリコ
=DESCR(1) 'PFU TeamWARE Server Framework Leader'
=INTERNETUSER noriko
=INTERNETBASE @xx.fujitsu.co.jp
=PREFNET 7
=TELNR(1) 03-123-4567
=TELNR(2) 03-321-7654

/* 電話番号を“03-456-7654”に変更。
/ =OP modify
=USER 伊藤のりこ
=TELNR(1) 03-456-7654

/* インターネットのベースアドレスを“@zz.fujitsu.co.jp”に変更。
/ =OP modify
=USER 伊藤のりこ
=INTERNETUSER noriko

/* “伊藤のりこ”の情報は、削除。
/ =OP delele
=USER 伊藤のりこ