[AIX Solaris HP-UX Linux Windows][z/OS]

Intelligent Management : tâches d'administration pour les préférences utilisateur concernant les opérations d'exécution

Vous pouvez utiliser les langages de script Jacl et Jython pour cloner, définir et extraire les préférences à l'aide de l'outil wsadmin. Utilisez les commandes et les paramètres du groupe UserPreferences.

Les préférences utilisateur sont stockées sous le contexte de la cellule ou dans le contexte de chaque type de ressource. La liste suivante fournit des exemples au niveau de la cellule et à chaque niveau de ressource :
  • cells/maCellule/preferences/Utilisateur_1/preferenceset.xml
  • cells/maCellule/applications/TestAppA.ear/preferences/Utilisateur_1/preferenceset.xml
  • cells/maCellule/nodes/monNoeud/servers/monServeur/preferences/Utilisateur_1/preferenceset.xml
  • cells/maCellule/clusters/monCluster/preferences/Utilisateur_1/preferenceset.xml
  • cells/maCellule/serviceclasses/Platinum/preferences/Utilisateur_1/preferenceset.xml
Utilisez les commandes suivantes pour gérer les préférences s'appliquant aux opérations d'exécution :

Pour des exemples d'utilisation de Jython pour interagir avec des objets de préférences, voir Commandes Jython utilisables avec l'objet de préférences.

clonePreference

La commande clonePreference copie une préférence d'un utilisateur ou d'un rôle vers un autre utilisateur ou rôle.

Objet cible

ID configID du parent.

Paramètres requis

-name Indique le nom de la préférence à cloner. (Chaîne, obligatoire)

Paramètres optionnels

  • -scope : Indique la portée de la préférence à sauvegarder lors du clonage. Si vous ne spécifiez pas de portée, celle du configID est utilisée. (Chaîne, optionnelle) La valeur de portée peut être l'une des suivantes :
    • Applications
    • Servers
    • Clusters
    • ServiceClasses
  • -touser : Spécifie l'utilisateur pour lequel les préférences doivent être extraites. Si vous n'indiquez pas de valeur pour cette propriété, la valeur par défaut est l'ID utilisateur de la session dans laquelle la commande est exécutée. (Chaîne, facultative)
  • -torole : Spécifie le rôle pour lequel les préférences doivent être extraites. Cette valeur est ignorée si vous avez spécifié le paramètre -touser. (Chaîne, facultative)
  • -fromuser : Spécifie l'utilisateur qui reçoit une copie des préférences. Vous pouvez spécifier plusieurs utilisateurs dans une liste. Par exemple : util1,util2,util3. La liste de doit pas comporter d'espaces. (Chaîne, facultative)
  • -fromrole : Spécifie le rôle qui reçoit une copie des préférences. (Chaîne, facultative)

Syntaxe d'un exemple de mode différé

  • Avec Jython :
    cellid= AdminConfig.getid("/Cell:maCellule")
    AdminTask.clonePreference(cellid, '[-name ChartGroups -fromuser util1 -touser util2,util3,util4,util5]')
    AdminConfig.save()
  • En langage Jacl :
    $AdminTask clonePreference cells/dabtcCellule02|cell.xml#Cellule_1 {-name ChartGroups -fromuser utilisateur1 -touser utilisateur2,utilisateur3,utilisateur4,utilisateur5}

Exemple d'utilisation en mode interactif

  • Langage Jython :
    AdminTask.clonePreference('[-interactive]')
  • En langage Jacl :
    $AdminTask clonePreference {-interactive}

getPreferences

La commande getPreferences renvoie une collection de préférences basée sur le document de préférences que vous spécifiez en passant un rôle ou un nom d'utilisateur à la commande. Pour obtenir les préférences d'un utilisateur ou d'un rôle d'utilisateur particulier, vous devez disposer de privilèges d'administrateur.

Objet cible

ID configID du parent.

Paramètres requis

  • -name : Indique le nom de la préférence. (Chaîne, requise)

Paramètres optionnels

  • -scope : Spécifie une portée pour les préférences. Vous pouvez choisir l'une des valeurs suivantes :
    • Applications
    • Servers
    • Clusters
    • ServiceClasses
    La portée par défaut est vide, ou indéfinie. Dans ce cas, la portée utilisée est dérivée du contexte dans lequel le document est lu. Par exemple, si le document est dans la portée de la cellule, c'est cette portée qui est appliquée. Si le document est dans un contexte de serveur spécifique, la portée est considérée comme applicable à ce serveur. (Chaîne, facultative)
  • -user : Spécifie le nom d'utilisateur pour lequel les préférences doivent être extraites. Si vous n'indiquez rien, la commande utilise le nom d'utilisateur qui exécute le script. (Chaîne, optionnelle)
  • -role : Spécifie le rôle d'utilisateur pour lequel les préférences doivent être extraites. (Chaîne, optionnelle)

Valeur de retour

La commande renvoie un objet DescriptivePropertyGroup qui contient les préférences, ou Null si aucune préférence n'est trouvée.

Syntaxe d'un exemple de mode différé

  • A l'aide de la chaîne Jython :
    cellid= AdminConfig.getid("/Cell:maCellule")
    AdminTask.getPreferences(cellid, '[-name ChartGroups -user util1]')
  • En langage Jacl :
    $AdminTask getPreferences cells/dabtcCell02|cell.xml#Cellule_1 {-name Reports -user util1}

Exemple d'utilisation en mode interactif

  • Avec une chaîne Jython :
    AdminTask.getPreferences('[-interactive]')
  • En langage Jacl :
    $AdminTask getPreferences {-interactive}

setPreference

La commande setPreference définit une préférence spécifique dans un document de préférences. Pour définir les préférences d'un utilisateur ou d'un rôle d'utilisateur particulier, vous devez disposer de privilèges d'administrateur.

Objet cible

ID configID du parent.

Paramètres requis

  • -name : Indique le nom de la préférence. (Chaîne, requise)
  • -propertyLongName : Spécifie le chemin qualifié complet de la propriété dans la groupe de propriétés, délimité par une barre oblique (/). Si la propriété est directement contenue dans le groupe de propriétés racine, son nom court peut être utilisé, car il est alors strictement identique à son nom long. (Chaîne, obligatoire)
  • -propertyValue : Spécifie la nouvelle valeur à affecter à la préférence. (Chaîne, obligatoire)

Paramètres optionnels

  • -scope : Indique la portée de la préférence à sauvegarder lors du clonage. Si vous ne spécifiez pas de portée, celle du configID est utilisée. (Chaîne, optionnelle) La valeur de portée peut être l'une des suivantes :
    • Applications
    • Servers
    • Clusters
    • ServiceClasses
  • -user : Spécifie le nom d'utilisateur pour lequel les préférences doivent être sauvegardées. Si vous n'indiquez rien, la commande utilise le nom d'utilisateur qui exécute le script. (Chaîne, optionnelle)
  • -role : Spécifie le rôle d'utilisateur pour lequel les préférences doivent être sauvegardées. (Chaîne, optionnelle)

Syntaxe d'un exemple de mode différé

  • A l'aide de la chaîne Jython :
    AdminTask.setPreference(cellid, '[-name monChartGroup -propertyLongName defaultChartSize -propertyValue large]')
  • En langage Jacl :
    $AdminTask setPreference cells/dabtcCell02|cell.xml#Cellule_1 {-name Reports -user util1 -propertyLongName defaultChartSize -propertyValue large}

Exemple d'utilisation en mode interactif

  • Avec une chaîne Jython :
    AdminTask.setPreference('[-interactive]')
  • En langage Jacl :
    $AdminTask setPreference {-interactive}

Commandes Jython utilisables avec l'objet de préférences

Les exemples suivants montre comment interagir avec l'objet de préférences à l'aide des commandes Jython :

Pour lister les préférences par utilisateur

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

Pour supprimer les préférences d'un utilisateur

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

Pour lister les préférences de tous les utilisateurs, groupées par utilisateur

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

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwve_xadmuserprefs
Nom du fichier : rwve_xadmuserprefs.html