WebSphere Virtual Enterprise, Version 6.1.1
             Sistemas Operacionais: AIX,, HP-UX, Linux, Solaris, Windows ,


Tarefas Administrativas de Preferências do Usuário de Operações do Tempo de Execução

Você pode utilizar as linguagens de script Jacl e Jython para clonar, configurar e obter preferências com a ferramenta wsadmin. Utilize os comandos e parâmetros no grupo UserPreferences.

As preferências do usuário são armazenadas no contexto de célula ou no contexto de cada tipo de recurso. A seguinte lista fornece exemplos no nível de célula e em cada nível do recurso:
  • cells/myCell/preferences/User_1/preferenceset.xml
  • cells/myCell/applications/TestAppA.ear/preferences/User_1/preferenceset.xml
  • cells/myCell/nodes/myNode/servers/myServer/preferences/User_1/preferenceset.xml
  • cells/myCell/clusters/myCluster/preferences/User_1/preferenceset.xml
  • cells/myCell/serviceclasses/Platinum/preferences/User_1/preferenceset.xml
Utilize os seguintes comandos para trabalhar com as preferências de operações de tempo de execução:

Para obter exemplos que usam Jython para interagir com objetos de preferências, consulte Comandos do Objeto de Preferências Jython.

clonePreference

O comando clonePreference copia uma preferência de um usuário ou função para outro usuário ou função.

Objeto de destino: O configID do pai de onde a preferência foi clonada.

Parâmetros Requeridos
  • -name: Especifica o nome da preferência a ser clonada. (Cadeia, obrigatória)
Parâmetros Opcionais
  • -scope: Especifica o escopo da preferência a ser salva quando as preferências são clonadas. Se você não especificar um escopo, será utilizado o escopo do configID. (Cadeia, opcional) O escopo pode ser um dos seguintes valores:
    • Aplicativos
    • Servidores
    • Clusters
    • ServiceClasses
  • -touser: Especifica o usuário para o qual recuperar as preferências. Se você não indicar esse valor, o padrão utilizará o ID de usuário da sessão na qual o comando está sendo executado. (Cadeia, opcional)
  • -torole: Especifica a função para a qual recuperar preferências. Esse valor será ignorado se você tiver especificado o parâmetro -touser. (Cadeia, opcional)
  • -fromuser: Especifica o usuário que obtém uma cópia das preferências. Você pode indicar vários usuários colocando-os em uma lista, por exemplo: user1,user2,user3. Não coloque espaços na lista. (Cadeia, opcional)
  • -fromrole: Especifica a função que obtém uma cópia das preferências. (Cadeia, opcional)

Exemplo de uso do modo em lote

Uso de exemplo do modo interativo

getPreferences

O comando getPreferences retorna uma coleta de preferências com base no documento de preferência especificado pela transmissão de uma função ou de um nome de usuário. É necessário ter privilégios de administrador para obter preferências para um determinado usuário ou função de usuário.

Objeto de destino: O configID do pai

Parâmetros Requeridos
  • -name: Especifica o nome da preferência. (Cadeia, opcional)
Parâmetros Opcionais
  • -scope: Especifica um escopo para as preferências. Você pode escolher entre um dos seguintes valores válidos:
    • Aplicativos
    • Servidores
    • Clusters
    • ServiceClasses
    O escopo padrão é vazio ou indefinido. Se o escopo for vazio, ele será derivado de onde o documento estiver sendo lido. Por exemplo, se o documento estiver no escopo da célula, será um escopo definido na célula. Se o documento estiver em um contexto de servidor específico, o escopo será assumido como aplicável a esse servidor. (Cadeia, opcional)
  • -user: Especifica o nome de usuário para o qual recuperar preferências. Se você não indicar um usuário, a ação padrão será utilizar o nome do usuário que está executando o script. (Cadeia, opcional)
  • -role: Especifica a função de usuário para a qual recuperar as preferências. (Cadeia, opcional)

Valor de retorno:

O comando retornará um objeto DescriptivePropertyGroup contendo as preferências, ou nulo se nenhuma preferência for localizada.

Uso de exemplo do modo em lote

Uso de exemplo do modo interativo

setPreference

O comando setPreference configura uma preferência específica em um documento de preferência. É necessário ter privilégios de administrador para configurar preferências para um determinado usuário ou função de usuário.

Objeto de destino: O configID do pai

Parâmetros Requeridos
  • -name: Especifica o nome da preferência. (Cadeia, opcional)
  • -propertyLongName: Especifica o caminho completo para a propriedade no grupo de propriedades, delimitado pelo caractere de barra (/). Se a propriedade estiver contida diretamente no grupo de propriedades-raiz, o nome abreviado da propriedade poderá ser utilizado porque seria exatamente igual ao nome longo. (Cadeia, obrigatória)
  • -propertyValue: Especifica o novo valor configurado para a preferência. (Cadeia, obrigatória)
Parâmetros Opcionais
  • -scope: Especifique o escopo da preferência a ser salvo quando as preferências forem clonadas. Se você não especificar um escopo, será utilizado o escopo do configID. (Cadeia, opcional) O escopo pode ser um dos seguintes valores:
    • Aplicativos
    • Servidores
    • Clusters
    • ServiceClasses
  • -user: Especifique o nome do usuário para o qual salvar as preferências. Se você não indicar um usuário, a ação padrão será utilizar o nome do usuário que está executando o script. (Cadeia, opcional)
  • -role: Especifica a função de usuário para a qual salvar as preferências. (Cadeia, opcional)

Exemplo de uso do modo em lote

Uso de exemplo do modo interativo

Comandos do Objeto de Preferências Jython

Utilize os seguintes exemplos para interagir com o objeto de preferências com comandos Jython:

Para listar preferências por usuário:

prefSets = AdminConfig.list("PreferenceSet")
print prefSets

Para remover preferências de um usuário:

prefid = AdminConfig.getid("/PreferenceSet:User_1")
AdminConfig.remove(prefid)
AdminConfig.save()

Para listar preferências para todos os usuários, agrupados por usuário:

prefs = AdminConfig.list("Preferences")
print prefs



Conceitos relacionados
Visão Geral de Operações de Tempo de Execução
Tarefas relacionadas
Monitorando Operações
Criando e Gerenciando Relatórios
Referências relacionadas
Interfaces de Script do Administrador
Tópico de Referência    

Termos de Uso | Feedback

Última atualização: 24/09/2009 14h19min03s EDT
http://publib.boulder.ibm.com/infocenter/wxdinfo/v6r1m1/index.jsp?topic=/com.ibm.websphere.ops.doc/info/reference/rxadmuserprefs.html