Importsecurity : Planning コマンド ユーティリティ操作

次のフラグは、importsecurity コマンドと共に使用して、サーバーに対する追加の指示を指定します。

重要 :
importsecurity コマンドで /Replace フラグを使用するには、Microsoft Office PerformancePoint Server 2007 Service Pack 3 (SP3) の QFE26 更新プログラムが必要です。Microsoft Office PerformancePoint Server 2007 QFE26 (KB978617) をダウンロードおよびインストールするには、マイクロソフト カスタマ サポート サービスにお問い合わせください。

メモ :
/Replace フラグは Planning Business Modeler SP3 で使用できます。

importsecurity コマンドのロール オプションでは、モデル サイトのカスタム ロールを定義します。ロールが既に存在する場合は、importsecurity 操作はそのロールを無視し、残りの CSV ファイルの処理を続行します。CSV ファイルには、先頭に列見出しがあり、その後に定義するロールが指定されている必要があります。

次の表に、列見出しと定義を示します。

メモ :
"Read + Write" の正符号の前後には空白文字があります。空白文字は必須です。

例 :

次の例では、testapp という名前のアプリケーションを使用しています。testapp アプリケーションには role1 (複数のユーザーを含む) と role2 (空で、ユーザーを含まない) があります。importsecurity で使用するサンプル CSV ファイルでは、role3 と role4 のみを使用できます。サンプル コマンドの D:\Program Files\Microsoft Office PerformancePoint Server\3.0\BizModeler>PPSCmd ImportSecurity /app testapp/ser http://<servername>:<port#>/replace/type role を実行すると、role2 は削除され、role3 と role4 が追加されます。role1 には現在ユーザーが割り当てられているため、このロールは削除されません。

/type パラメータを "User" と設定してユーザー CSV ファイルをインポートすると、PerformancePoint Planning システムにユーザーが追加されます。新しいユーザーのみを追加し、システムの既存のユーザーをスキップします。この操作で既存のユーザーを削除することはできません。新しいユーザーの追加または更新のみを実行できます。

ラベル、名前、および電子メールの見出し列を含む CSV ファイルが作成される必要があります。関連付けられているユーザーが追加されますが、ラベル、名前、および電子メール アドレスを指定します。

次の表では、列見出しについて説明します。

例 :

UserRoles インポート オプションは、定義済みのシステム ユーザーをシステムのロールに関連付けます。アプリケーション内で定義されているシステムおよび任意のカスタム ロールに既存のユーザーを割り当てることができます。ユーザーとロールはあらかじめシステムに存在している必要があります。ない場合は importsecurity 操作ではエラーを表示し、CSV ファイルの処理を続行します。

次の表では、ユーザー ロールについて説明します。

例 :

ユーザー ロール インポート オプションは、定義済みのロールをシステムのモデルに関連付けます。モデルとロールはあらかじめシステムに存在している必要があります。ない場合は importsecurity コマンドではエラーを表示し、CSV ファイルの処理を続行します。

次の表では、ロール/モデルの関連付けについて説明します。

次に、ロール/モデルの関連付けに使用するサンプル CSV ファイルを示します。

"Allow Journal" 列は、会計モデルに対して "Allow Journal" 権限を on に設定するかどうかを示しています。あるモデルで "Allow Journal" 権限を on に設定するが、そのモデルにモデル プロパティがない場合、値の履歴は true に設定され、エラー メッセージが送信されます。また、あるモデルで "Allow Journal" 権限を on に設定し、モデルのアクセスを off に設定すると、エラー メッセージが送信されます。ロールに特定のモデルとの既存の関連付けがあるが、その関連付けが CSV ファイルに指定されていない場合、ロール/モデルのアクセスは変更されません。エラーが発生しても、有効なすべての項目がインポートされます。

ユーザーとロールの関連付けでは、/Replace スイッチが使用されている場合に機能します。

ロールに特定のモデルとの既存の関連付けがあるが、その関連付けが CSV ファイルに指定されていない場合、importsecurity ではロール/モデルのアクセスを off に設定します (ロール/モデルの関連付けはバック エンドから削除されます)。

例 :

PPSCmd ImportSecurity /type userpermissions / userpermissions.csv

PPSCmd ImportSecurity /type rolemodelassociations / rolesmodels.csv

UserPermission インポート オプションを使用すると、新しいまたは追加のユーザー権限をインポートして、システムの既存のユーザー権限を上書きすることもできます。

次の表では、ユーザー権限について説明します。

例 :

RolePermissions インポート オプションを使用すると、カスタム ロールのカスタム ロール セキュリティ定義をインポートできます。システム定義ロール (つまり、グローバル管理者、データ管理者、モデル管理者、およびユーザー管理者) に対して権限を設定することはできません。ロールが存在しない場合または任意の列の値が無効な場合、importsecurity 操作はこの行を無視し、残りのロール定義を処理します。

次の表では、ロール権限について説明します。

例 :

ファイル エンコードは、ISO-8859、UTF8、UNICODE、または ASCII を使用できます。8 ビット文字エンコードでは、ISO-8859 を使用します。