Importsecurity: operação do Utilitário de Comandos do Planning

Os sinalizadores a seguir fornecem instruções adicionais ao servidor quando usados com o comando importsecurity.

Importante:
A atualização QFE26 para o Microsoft Office PerformancePoint Server 2007 Service Pack 3 (SP3) é necessária para usar o comando importsecurity com o sinalizador /Replace. Para baixar e instalar Microsoft Office PerformancePoint Server 2007 QFE26 (KB978617), contate os Serviços de Atendimento ao Cliente da Microsoft.

Observação:
O sinalizador /Replace está disponível com o Planning Business Modeler SP3.

A opção de função do comando importsecurity define funções personalizadas para sites de modelo. Se a função já existir, a operação de importsecurity irá ignorá-la e continuará o processamento do restante do arquivo CSV. O arquivo CSV deve conter em primeiro lugar cabeçalhos de coluna, seguidos das funções que você está definindo.

Os cabeçalhos e definições de coluna estão indicados na tabela a seguir.

Observação:
Há um caractere de espaço em branco antes e depois do sinal de adição em "Leitura + Gravação". Esses espaços são obrigatórios

Exemplo:

A seguinte tabela de exemplo usa um aplicativo denominado testapp. Esse aplicativo testapp tem as funções role1 (contém vários usuários) e role2 (vazia e não contém usuários). O arquivo CSV de exemplo usado para importsecurity tem apenas as funções role3 e role4 disponíveis. Se o comando de exemplo a seguir for executado, D:\Program Files\Microsoft Office PerformancePoint Server\3.0\BizModeler>PPSCmd ImportSecurity /app testapp/ser http://<servername>:<port#>/replace/type role, a função role2 será excluída e as funções role3 e role4 serão adicionadas. Este comando de exemplo não exclui role1 porque não há usuários atualmente atribuídos a essa função.

Importar um arquivo CSV de usuários com o parâmetro /type definido como ‘User’ adicionará usuários ao sistema PerformancePoint Planning. Esse parâmetro apenas adicionará novos usuários, ignorando qualquer um que já esteja no sistema. Não é possível excluir usuários existentes usando essa operação; somente é possível adicionar/atualizar novos usuários

Um arquivo CSV deve ser criado com as colunas de cabeçalho Label, Name e Email. Os usuários associados são adicionados com base no rótulo, no nome e no endereço de email de cada um.

Os cabeçalhos de coluna estão descritos na tabela a seguir.

Exemplo:

A opção de importação UserRoles associa usuários do sistema definidos a funções no sistema. É possível atribuir usuários existentes a funções do sistema e a qualquer função personalizada definida em um aplicativo. Usuários e funções já devem estar no sistema. Se esse não for o caso, a operação de importsecurity exibirá um erro e continuará a processar o arquivo CSV.

As funções de usuário estão descritas na tabela a seguir.

Exemplo:

A opção de importação de funções de usuário associa funções definidas com modelos no sistema. Modelos e funções já devem existir no sistema. Se esse não for o caso, o comando importsecurity exibirá um erro e continuará a processar o arquivo CSV.

As associações entre funções e modelos estão descritas na tabela a seguir.

O exemplo a seguir representa um arquivo CSV de Associações entre Funções e Modelos:

A coluna Allow Journal especifica se a permissão “Allow Journal” está definida como on para um modelo financeiro. Se a permissão “Allow Journal” estiver definida como on para um modelo e esse modelo não tiver a propriedade "model" e o valor "journal" definidos como true, o sistema enviará uma mensagem de erro. Se a permissão “Allow Journal” estiver definida como on para um modelo e o acesso a esse modelo estiver definido como off, o sistema enviará uma mensagem de erro. Se uma função tiver uma associação existente para um modelo específico e essa associação não estiver especificada no arquivo CSV, a importação não alterará o acesso de RoleModel. Quando um erro ocorre, todas as entradas válidas ainda são importadas.

Para a associação de usuários a funções, o comportamento é quando a opção /Replace é usada:

Se uma função tiver uma associação existente para um modelo específico e essa associação não estiver especificada no arquivo CSV, importsecurity definirá o acesso de RoleModel como off. (A associação entre Role/Model será removida do back-end).

Exemplo:

PPSCmd ImportSecurity /type userpermissions / userpermissions.csv

PPSCmd ImportSecurity /type rolemodelassociations / rolesmodels.csv

A opção de importação UserPermission permite importar permissões de usuário novas ou adicionais, bem como substituir as permissões de usuário existentes do sistema.

As permissões de usuário estão descritas na tabela a seguir.

Exemplo:

A opção de importação RolePermissions permite importar definições de segurança de função personalizadas para funções personalizadas. Não é possível definir permissões em funções definidas pelo sistema (ou seja, administrador global, administrador de dados, modelador e administrador de usuários). Se a função não existir ou se qualquer valor de coluna for inválido, a operação de importsecurity irá ignorar a linha e processar as definições de função restantes.

As permissões de função estão descritas na tabela a seguir.

Exemplo:

A codificação de arquivo pode ser ISO-8859, UTF8, UNICODE ou ASCII. Use ISO-8859 para a codificação de caracteres de 8 bits.