Interstage Portalworks 管理者ガイド

A.2.2 ロール新規/更新

ロールを新規追加または更新する機能です。

【ファイルの形式】

入力用ファイルの形式は以下のように記述してください。

サービス名には2バイト文字が存在するため、CSVファイルはMS932（Shift_JIS）固定で記述してください。また、ロール登録コマンドにおいて、CSVファイルを利用して登録を行うため、ロール名、サービス名、ユーザID、コメントの中身には半角のダブルクォーテーションとカンマとシングルクォーテーションは使用できません。

1行目は入力ファイルの内容を表したヘッダーを記述します。

デフォルト（すべて記述する場合）は以下のように記述してください。

RoleID,roleName,user,service,roleAdmin,CustomizeStatus,PrivateBrickStatus,comment

2行目以降には実際のロールの設定情報を書き込みます。

入力ファイルで1行に1つのロールID分のデータを記述します。ヘッダーで記述した順番で記述してください。ロールID以外は、ヘッダーで省略した場合、実データも省略できます。省略した場合は、新規作成時にはデフォルトの値（空かfalse）を、更新時には現在値のままで設定します。

RoleID,roleName,user,service,roleAdmin,CustomizeStatus,PrivateBrickStatus,comment

PublicRoleの場合

publicrole,,,service,,,,comment

【ヘッダーの項目】

• roleID
  以下のどちらかを指定します。その他の場合には、エラーとなります。省略はできません。
  • 新規の場合：「new」
  • PublicRoleの場合：「publicrole」
  • 更新の場合：既存のロールID
• roleName
  ロール名を記述します。
• user
  利用者のユーザIDを記述します。ユーザIDが複数存在する場合には、（カンマ）区切りで記述し、その全体を、「"」（ダブルクォーテーション）で括ってください。
  ヘッダーの"user"文字列を"adduser"に置き換えると、対象のロールに現在登録されている利用者はそのままに残し、さらに入力ファイルに記述されているユーザIDを追加します。
  ヘッダーの"user"文字列を"deleteuser"に置き換えると、現在の利用者からCSVファイルに記述されているユーザIDを削除します。
• service
  サービス名とそのサービスのtypeの番号をセットで記述します。ロール登録後にサービスも登録できるようにサービス名の存在チェックを行っていません。綴り間違いのないよう注意してください。
  typeの番号は

  1.actorAlias（USPの別名）
  2.scenarioAlias（シナリオの別名）
  3.actor（USP本体）
  4.scenario（シナリオ本体）

  
  
  service記述例：,"'社内検索,1','スケジュール,4'",
  ヘッダーの"service"文字列を"addservice"に置き換えると、現在のサービスはそのままにCSVファイルに記述されているサービスを追加します。
  ヘッダーの" service"文字列を"deleteservice"に置き換えると、現在のサービスからCSVファイルに記述されているサービスを削除します。
• roleAdmin
  ロール管理者のユーザIDを記述します。ロール管理者が複数存在する場合には、（カンマ）区切りで記述し、その全体を、「"」（ダブルクォーテーション）で括ってください。
• CustomizeStatus
  trueのとき、ブリックのレイアウト変更を禁止します。
• PrivateBrickStatus
  trueのとき、プライベートブリックの作成を禁止します。
• Comment
  コメントを記述します。

全体の記述例

roleID,roleName,user,service,roleAdmin,CustomizeStatus,PrivateBrickStatus,comment
4088646,"検索","test026,test025,test024,test023,test022","'社内検索,1','スケジュール,4'","roleadmin",true,false,"comment"
New,"共有ドキュメント","AllUser","'カスタム時刻表,4','部会資料,1'","",true,false,""