Puede utilizar los lenguajes de script Jacl y Jython para clonar,
establecer y obtener preferencias con la herramienta wsadmin. Utilice los mandatos y parámetros del grupo
UserPreferences.
Las preferencias de usuario se almacenan en el contexto de célula o en contecto para cada tipo de recurso.
La lista siguiente incluye ejemplos sobre
el nivel de célula y en cada nivel de 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
Utilice los mandatos siguientes para trabajar con las preferencias de las
operaciones de tiempo de ejecución:
Para obtener ejemplos sobre cómo utilizar Jython para interactuar con objetos de preferencias, consulte
Mandatos de objeto
de preferencias Jython.
clonePreference
El mandato clonePreference copia una preferencia de un usuario o rol en otro usuario o
rol.
Objeto de destino: el configID del padre de donde se
clona la preferencia.
Parámetros necesarios
- -name: especifica el nombre de la preferencia que se va a clonar.
(String, necesario)
Parámetros opcionales
- -scope: especifica el ámbito de la preferencia que se guarda cuando se clonan las preferencias. Si no especifica un ámbito, se utiliza el ámbito del configID.
(String, opcional) El ámbito puede ser uno de los siguientes valores:
- Applications
- Servers
- Clusters
- ServiceClasses
- -touser: especifica el usuario para el que se recuperan preferencias. Si no indica este valor,
el valor predeterminado utiliza el ID de usuario para la sesión en la que se ejecuta el
mandato. (String,
opcional)
- -torole: especifica el rol para el que se recuperan preferencias. Este valor se ignora si ha
especificado el parámetro -touser. (String,
opcional)
- -fromuser: especifica el usuario que obtiene una copia de las preferencias. Puede indicar
varios usuarios colocando los usuarios en una lista, por ejemplo: user1,user2,user3.
No incluya espacios en la lista. (String,
opcional)
- -fromrole: especifica el rol que obtiene una copia de las preferencias. (String,
opcional)
Ejemplo de utilización de la modalidad por lotes:
- 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}
Ejemplo de utilización
de la modalidad interactiva
- Utilizando Jython:
AdminTask.clonePreference('[-interactive]')
- Utilizando Jacl:
$AdminTask clonePreference {-interactive}
getPreferences
El mandato getPreferences devuelve una colección de preferencias basándose en el
documento de preferencias que ha especificado pasando un nombre de usuario o rol. Debe tener privilegios de
administrador para obtener preferencias para un determinado usuario o rol de usuario.
Objeto
de destino: el configID del padre
Parámetros necesarios
- -name: especifica el nombre de la preferencia. (String, necesario)
Parámetros opcionales
- -scope: especifica el ámbito de las preferencias.
Puede elegir uno de los siguientes valores
válidos:
- Applications
- Servers
- Clusters
- ServiceClasses
El ámbito predeterminado está vacío o no
se ha definido. Si el ámbito está vacío, el ámbito se obtiene de donde se está leyendo el
documento. Por ejemplo, si el documento está en el ámbito de célula, el ámbito se obtiene
de la célula. Si el documento está en un contexto de servidor específico, el ámbito se
supone que se puede aplicar a dicho servidor. (String,
opcional)
- -user: especifica el nombre de usuario para el que se recuperan las preferencias. Si no indica un
usuario, la acción predeterminada es utilizar el nombre de usuario que ejecuta el script. (String,
opcional)
- -role: especifica el rol de usuario para el que se recuperan las preferencias. (String,
opcional)
Valor de retorno:
El mandato devuelve un objeto DescriptivePropertyGroup que
contiene las preferencias, o null si no se encuentra ninguna preferencia.
Ejemplo de utilización de la modalidad por lotes:
Ejemplo de utilización
de la modalidad interactiva
- Utilizando serie de Jython:
AdminTask.getPreferences('[-interactive]')
- Utilizando Jacl:
$AdminTask getPreferences {-interactive}
setPreference
El mandato setPreference establece una preferencia específica en un documento de
preferencias. Debe tener privilegios de administrador para establecer preferencias para
un determinado usuario o rol de usuario.
Objeto de
destino: el configID del padre
Parámetros necesarios
- -name: especifica el nombre de la preferencia. (String, necesario)
- -propertyLongName: especifica la vía de acceso plenamente cualificada de la propiedad en el grupo de
propiedades, delimitada por un carácter de barra inclinada (/). Si la propiedad
está contenida directamente en el grupo de propiedades raíz, puede utilizarse el nombre
abreviado de la propiedad porque será exactamente igual al nombre largo. (String,
necesario)
- -propertyValue: especifica el nuevo valor que se establece para la preferencia.
(String, necesario)
Parámetros opcionales
- -scope: especifica el ámbito de la preferencia que se guarda cuando se clonan las preferencias. Si no especifica un ámbito, se utiliza el ámbito del configID.
(String, opcional) El ámbito puede ser uno de los siguientes valores:
- Applications
- Servers
- Clusters
- ServiceClasses
- -user: especifica el nombre de usuario para el que se guardan las preferencias. Si no indica un
usuario, la acción predeterminada es utilizar el nombre de usuario que ejecuta el script. (String,
opcional)
- -role: especifica el rol de usuario para el que se guardan las preferencias. (String,
opcional)
Ejemplo de utilización de la modalidad por lotes:
- Utilizando serie de 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}
Ejemplo de utilización
de la modalidad interactiva
Mandatos de objeto
de preferencias Jython
Utilice los siguientes ejemplos para interactuar con el
objeto de preferencias con mandatos Jython:
Para listar
las preferencias por usuario:
prefSets = AdminConfig.list("PreferenceSet")
print prefSets
Para eliminar las preferencias de un
usuario:
prefid = AdminConfig.getid("/PreferenceSet:User_1")
AdminConfig.remove(prefid)
AdminConfig.save()
Para listar las preferencias de todos
los usuarios, agrupadas por usuario:
prefs = AdminConfig.list("Preferences")
print prefs