ユーザー、プロフィール、サービスグループのロード
ユーザー、プロフィール、サービスグループは、管理ホームページ上にあるユーティリティを使用して個別に作成する代わりに、Servigistics InService の初期設定とコンフィギュレーションを行う際にファイルからロードできます。これを行うには LoadFromFile コマンドラインユーティリティを使用します。
これらのユーザー、プロフィール、サービスグループは、いったん Servigistics InService にロードされた後は、管理ホームページ上にあるユーティリティを使用して表示および管理できます。
LoadFromFile の構文は次のとおりです。
windchill wt.load.LoadFromFile -d <データファイル名> -u <ユーザー名> -p <パスワード>
ここで、
• <データファイル名> には、ロードするオブジェクトが含まれているオブジェクトファイルの名前を指定します。この引数は必須です。
• <ユーザー名> および <パスワード> には、Servigistics InService 管理者の資格証明を指定します。これらの引数はオプションですが、このコマンドで入力しなかった場合、このユーティリティの実行時に認証が求められます。
たとえば、Users.xml という名前のファイルからユーザーをロードするには、次のステップを実行します。
1. Windchill のシェルを開きます。
2. 次のコマンドを実行します。
windchill wt.load.LoadFromFile -d Users.xml
3. 認証が求められた場合、Servigistics InService 管理者の資格情報を入力します。
以降の各セクションには、ユーザー、プロフィール、サービスグループをロードする際のサンプルロードファイルが記載されています。
• ユーザーのロード
• プロフィールのロード
• サービスグループのロード
ユーザーのロード
Servigistics InService で設定されている外部エンタープライズアイデンティティ管理システム (通常は LDAP) からのユーザーと内部ユーザーの両方を Servigistics InService にバルクロードできます。内部ユーザーとは、内部システム用に Servigistics InService 内で作成された、外部エンタープライズアイデンティティ管理システムには存在しないユーザーのことです。詳細については、Servigistics InService Administration Help Center の「ユーザー」を参照してください。
Windchill シェルからコマンド wt.load.LoadFromFile -d SampleUsers.xml を実行することで SampleUsers.xml ファイルをロードします。
次の SampleUsers.xml ファイルは、ユーザーをロードする際のロードファイルのフォーマットを示しています。
<?xml version="1.0"?>
<!DOCTYPE NmLoader SYSTEM "standardX26.dtd">
<NmLoader>
<csvUser handler="orgLoadPrincipal.createUser">
<csvuser></csvuser>
<csvnewUser>mkangas</csvnewUser>
<csvwebServerID>mkangas</csvwebServerID>
<csvfullName>Mike Kangas</csvfullName>
<csvLast></csvLast>
<csvLocale></csvLocale>
<csvEmail></csvEmail>
<csvDescription></csvDescription>
<csvTitle></csvTitle>
<csvOrganization></csvOrganization>
<csvStreet1></csvStreet1>
<csvStreet2></csvStreet2>
<csvCity></csvCity>
<csvState></csvState>
<csvCountry></csvCountry>
<csvZipCode></csvZipCode>
<csvignore></csvignore>
<csvpassword></csvpassword>
<csvDirectoryService>com.ptc.ldap-web</csvDirectoryService>
</csvUser>
<csvUser handler="orgLoadPrincipal.createUser">
<csvuser></csvuser>
<csvnewUser>sampleUser</csvnewUser>
<csvwebServerID>sampleUser</csvwebServerID>
<csvfullName>Sample User</csvfullName>
<csvLast></csvLast>
<csvLocale></csvLocale>
<csvEmail>
[email protected]</csvEmail>
<csvDescription></csvDescription>
<csvTitle></csvTitle>
<csvOrganization></csvOrganization>
<csvStreet1></csvStreet1>
<csvStreet2></csvStreet2>
<csvCity></csvCity>
<csvState></csvState>
<csvCountry></csvCountry>
<csvZipCode></csvZipCode>
<csvignore></csvignore>
<csvpassword>sampleUser</csvpassword>
<csvDirectoryService></csvDirectoryService>
</csvUser>
</NmLoader>
次の点に注意してください。
• ローダーでは csvLast (ユーザーの姓) エレメントを必ずしも指定する必要はありませんが、指定することが最良事例です。
• csvDirectoryService エレメントはオプションです。指定しなかった場合、ユーザーは内部ユーザーとして InService に追加されます。Servigistics InService で設定されている外部エンタープライズアイデンティティ管理システム (通常は LDAP) にユーザーを追加する必要がある場合、csvDirectoryService エレメントに適切な値を設定する必要があります。
プロフィールのロード
次の SampleProfiles.xml ファイルは、プロフィールをロードする際のロードファイルのフォーマットを示しています。
<?xml version="1.0"?>
<!DOCTYPE InSObjects SYSTEM "standardX26.dtd">
<InSObjects>
<SCProfile>
<name>P2</name>
<description>Demo profile P2 from loader</description>
<objectContainerPath>/</objectContainerPath>
<PHNode>
<name>0000016616</name>
<value>SN_SedanHybrid_Engine V4</value>
<path>V=1~{"rId":"0000022202","op":["0000022202","0000015163","0000016604", "0000016607","0000022145","0000022144","0000016616"], "nn":289,"ts":1438844494106}
</path>
</PHNode>
<PHNode>
<name>0000022202</name>
<value>SEDAN</value>
<path>V=1~{"rId":"0000022202","op": ["0000022202","0000014982"]}</path>
</PHNode>
<IENode>
<name>Parts List</name>
<value>partsList</value>
<path>infoType</path>
</IENode>
<user>u1</user>
<user>u2</user>
<user>u3</user>
<privilege>Activation</privilege>
<privilege>Updation</privilege>
<enterpriseAttributes>
<name>faxNumber</name>
<value>340985034</value>
</enterpriseAttributes>
<enterpriseAttributes>
<name>email</name>
<value>
[email protected]</value>
</enterpriseAttributes>
</SCProfile>
<SCProfile>
<name>P1</name>
<description>Demo profile P1 from loader</description>
<objectContainerPath>/</objectContainerPath>
<allPHNode>true</allPHNode>
<allIENode>true</allIENode>
<user>u1</user>
<user>u2</user>
<user>u3</user>
<privilege>Activation</privilege>
<privilege>Updation</privilege>
<enterpriseAttributes>
<name>faxNumber</name>
<value>340985034</value>
</enterpriseAttributes>
<enterpriseAttributes>
<name>email</name>
<value>
[email protected]</value>
</enterpriseAttributes>
</SCProfile>
</InSObjects>
次の点に注意してください。
• 各 PHNode エレメント (製品階層) に、name、value、path の値を指定する必要があります。これらの値は、次のように InService システムから見つかります。
◦ value - 階層リンクナビゲーションから特定の製品階層レベルの名前を使用します。
◦ path - path の値を調べるには、次のステップに従います。
1. Servigistics InService ユーザーインタフェースで、プロフィールに含める特定の製品階層レベルに移動します。その製品階層レベルの相対アクセスパス ID だけが含まれるようにするため、情報構造階層より下の階層には移動しないでください。
2. ブラウザ URL から Product:: より後ろの文字列をコピーします。例: Vj0xfnsicklkIjoiMDAwMDAyMjIwMiIsIm9wIjpbIjAwMDAwMjIyMDIiLCIwMDAwMDE0OTgyIiwiMDAwMDAxNjYwMSIsIjAwMDAwMTY2MTAiXSwibm4iOjQ5NCwidHMiOjE0NTk3NzExMjUwNzF9
3. オープンソースデコーダ (
https://www.base64decode.org/ など) を使用して、必要なアクセスパス出力を取得します。ステップ 2 の URL 文字列の場合、この必須のアクセスパス出力は次のとおりです。
V=1~{"rId":"0000022202","op":["0000022202","0000014982","0000016601","0000016610"],"nn":494,"ts":1459771125071}
◦ name - ステップ 3 からのアクセスパス出力の “op”:[] セクションの最後の ID 番号を使用します。
サービスグループのロード
次の SampleServiceGroups.xml ファイルは、サービスグループをロードする際のロードファイルのフォーマットを示しています。
|
|
サービスグループはバルクロードできませんが、個別にロード可能です。
|
次の点に注意してください。
• サービスグループをロードする場合、isLoader エレメントには値 true を指定する必要があります。
• サービスグループロゴの fileLocation エレメントの値は、Windchill.ear の場所を基準にする必要があります。
