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
- Utilizando Jython:
cellid= AdminConfig.getid("/Cell:myCell")
AdminTask.clonePreference(cellid, '[-name ChartGroups -fromuser user1 -touser user2,user3,user4,user5]')
AdminConfig.save()
- Utilizando Jacl:
AdminTask clonePreference cells/dabtcCell02|cell.xml#Cell_1 {-name ChartGroups -fromuser user1 -touser user2,user3,user4,user5}
Uso de exemplo do modo interativo
- Utilizando Jython:
AdminTask.clonePreference('[-interactive]')
- Utilizando Jacl:
$AdminTask clonePreference {-interactive}
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
- Utilizando a cadeia Jython:
AdminTask.getPreferences('[-interactive]')
- Utilizando Jacl:
$AdminTask getPreferences {-interactive}
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
- Utilizando a cadeia Jython:
AdminTask.setPreference(cellid, '[-name myChartGroup -propertyLongName defaultChartSize -propertyValue large]')
- Utilizando Jacl:
$AdminTask setPreference cells/dabtcCell02|cell.xml#Cell_1 {-name Reports -user user1 -propertyLongName defaultChartSize -propertyValue large}
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