Groupe de commandes IdMgrDataModel de l'objet AdminTask
Les langages de script Jython ou Jacl permettent de gérer, à l'aide de l'outil wsadmin, le schéma de référentiel fédéré. Les commandes et paramètres du groupe IdMgrDataModel permettent de gérer le référentiel d'extension de propriété. Les commandes sont disponibles en mode connecté ou en mode local à l'aide de l'option –conntype NONE.
addIdMgrPropertyToEntityTypes
La commande addIdMgrPropertyToEntityTypes permet d'ajouter une nouvelle propriété à un ou plusieurs types d'entité existants à l'aide de paramètres spécifiés.
Objet cible
Aucune.Paramètres obligatoires.
- -name
- Ce paramètre permet d'indiquer le nom de la nouvelle propriété qui est ajoutée à un ou plusieurs types d'entité existants.
(Chaîne, obligatoire)
- -dataType
- Ce paramètre permet d'indiquer le type de données de la propriété. (Chaîne, obligatoire)
- Les types de données pris en charge par défaut sont les suivants :
- Chaîne
- Int
- Booléen
- Long
- Double
- Base64binary
- AnySimpleType
- AnyURI
- Byte
- DateTime
- Date
- Short
- Jeton
- IdentifierType
- Remarque : Pour étendre une propriété de type Objet, vous devez utiliser le type de données AnySimpleType.
- -entityTypeNames
- Ce paramètre indique le nom d'un ou de plusieurs types d'entité
existants auxquels la nouvelle propriété est ajoutée. Utilisez le point-virgule (;) comme délimiteur pour indiquer plusieurs types d'entité.
Vous pouvez utiliser un préfixe d'espace de nom valide (nsPrefix) pour faire référence aux noms de types d'entité dans un espace de nom spécifique. Le préfixe d'espace de nom par défaut est wim. Utilisez le signe deux-points (:) pour indiquer le préfixe d'espace de nom. Par exemple, vous pouvez utiliser votre_ext:compte_personnel
- votre_ext représente le préfixe d'espace de nom, qui est mappé vers l'URI espace de nom http://www.votresociete.com/votre_ext.
- compte_personnel représente le nom du type d'entité.
(Chaîne, obligatoire)
Paramètres facultatifs
- -securityDomainName
- Ce paramètre permet d'indiquer le nom qui identifie de manière unique le domaine de sécurité. Si vous n'indiquez pas ce paramètre, la commande utilise le référentiel fédéré global. (Chaîne, facultatif)
- -nsURI
- Ce paramètre permet d'indiquer l'espace de nom dans lequel la nouvelle propriété est ajoutée.
Vous devez mapper chaque valeur d'URI espace de nom (nsURI) vers une valeur de préfixe d'espace de nom unique (nsPrefix) lors de la première utilisation de l'URI espace de nom. La nouvelle propriété s'ajoute dans l'espace de nom par défaut si vous ne spécifiez pas de valeur nsURI. L'espace de nom par défaut est http://www.ibm.com/websphere/wim, qui est mappé par défaut vers la valeur wim nsPrefix.
(Chaîne, facultatif)
- -nsPrefix
- Ce paramètre permet d'indiquer le préfixe de l'espace de nom.
Vous devez spécifier une valeur de préfixe d'espace de nom (nsPrefix), si vous spécifiez une nouvelle valeur d'URI espace de nom (nsURI), de sorte que la nouvelle valeur nsURI soit mappée vers cette valeur nsPrefix. La valeur nsPrefix par défaut est wim, qui est mappée par défaut vers la valeur nsURI http://www.ibm.com/websphere/wim.
(Chaîne, facultatif)
- -isMultiValued
- Ce paramètre permet d'indiquer si la nouvelle propriété accepte plusieurs valeurs. La valeur par défaut est false.
(Booléen, facultatif)
- -repositoryIds
- Ce paramètre permet d'indiquer le ou les référentiels dans lesquels la nouvelle propriété est ajoutée.
Utilisez le point-virgule (;) comme délimiteur pour indiquer plusieurs identités de référentiel. Si ce paramètre n'est pas spécifié, tous les référentiels configurés sont inclus.
Pour ajouter la nouvelle propriété dans le référentiel d'extension de propriété, spécifiez LA comme valeur de ce paramètre.
Pour ajouter la nouvelle propriété aux types d'entité pour tous les référentiels indiqués, spécifiez une liste d'identités de référentiel et n'incluez pas LA dans la liste.
Pour étendre la propriété au référentiel d'extension de propriété pour les référentiels LDAP (Lightweight Directory Access Protocol), spécifiez une liste incluant LA. La nouvelle propriété étendue est alors signalée comme n'étant pas prise en charge pour les autres référentiels LDAP inclus dans cette liste.
(Chaîne, facultatif)
- -requiredEntityTypeNames
- Ce paramètre permet d'indiquer un ou plusieurs types d'entité pour lesquels la nouvelle propriété est requise.
Utilisez le point-virgule (;) comme délimiteur pour indiquer plusieurs types d'entité.
Vous pouvez utiliser un préfixe d'espace de nom valide (nsPrefix) pour faire référence aux noms de types d'entité dans un espace de nom spécifique. Le préfixe d'espace de nom par défaut est wim. Utilisez le signe deux-points (:) pour indiquer le préfixe d'espace de nom. Par exemple, vous pouvez utiliser votre_ext:compte_personnel
- votre_ext représente le préfixe d'espace de nom, qui est mappé vers l'URI espace de nom http://www.votresociete.com/votre_ext.
- compte_personnel représente le nom du type d'entité.
Par exemple, si vous ajoutez la propriété contactNumber aux types d'entité PersonAccount et Group et que vous exigez que tous les types d'entité PersonAccount comportent une valeur contactNumber, indiquez ce qui suit :{-name contactNumber -entityTypeNames PersonAccount;Group -requiredEntityTypeNames PersonAccount}
(Chaîne, facultatif)
- -applicationId
- Ce paramètre permet d'indiquer l'ID de l'application pour laquelle la propriété est étendue.
Vous pouvez utiliser la commande getIdMgrEntityTypeSchema pour extraire les propriétés étendues pour un ID application spécifique, si vous indiquez une valeur pour le paramètre applicationId.
(Chaîne, facultatif)
Exemples
Syntaxe d'un exemple de mode différé :
- Avec Jacl :
$AdminTask addIdMgrPropertyToEntityTypes {-name property_name_1 -dataType string -entityTypeNames entity_type_1;entity_type_2}
- Avec
la chaîne Jython :
AdminTask.addIdMgrPropertyToEntityTypes ('[-name property_name_1 -dataType string -entityTypeNames entity_type_1;entity_type_2]')
- A l'aide de la liste Jython :
AdminTask.addIdMgrPropertyToEntityTypes (['-name', 'property_name_1', '-dataType', 'string' '-entityTypeNames', 'entity_type_1;entity_type_2'])
Exemple d'utilisation en mode interactif :
- Avec Jacl :
$AdminTask addIdMgrPropertyToEntityTypes {-interactive}
- Avec
la chaîne Jython :
AdminTask.addIdMgrPropertyToEntityTypes ('[-interactive]')
- A l'aide de la liste Jython :
AdminTask.addIdMgrPropertyToEntityTypes (['-interactive'])
getIdMgrEntityTypeSchema
La commande getIdMgrEntityTypeSchema renvoie le schéma de type d'entité. Cette commande est disponible en mode connecté et local.
![[z/OS]](../images/ngzos.gif)
Objet cible
Aucune.Paramètres obligatoires.
Aucun.Paramètres facultatifs
- -id
- Ce paramètre permet d'indiquer l'ID du référentiel. Si vous n'indiquez pas ce paramètre, le schéma de type d'entité par défaut des référentiels fédérés est renvoyé. (Chaîne, facultatif)
- Important : Si indiquez LA comme ID ID de référentiel, une erreur se produit car LA est un ID réservé pour le référentiel d'extension de propriété. Utilisez la commande listIdMgrPropertyExtension pour extraire le schéma du référentiel d'extension de propriété. Pour plus d'informations, consultez la description relative à la commande listIdMgrPropertyExtensions.
- -entityTypeNames
- Ce paramètre permet d'indiquer le nom d'un ou de plusieurs types d'entité pour lesquels le schéma du type d'entité doit être extrait. Si vous indiquez plusieurs noms de type d'entité, utilisez le point-virgule (;) comme délimiteur. Si vous n'indiquez pas ce paramètre, le schéma de type d'entité de tous les types d'entité est renvoyé. Vous devez utiliser un préfixe d'espace de nom valide en référence au type d'entité s'il n'appartient pas à l'espace de nom par défaut. (Chaîne, facultatif)
- -securityDomainName
- Ce paramètre permet d'indiquer le nom qui identifie de manière unique le domaine de sécurité. Si vous n'indiquez pas ce paramètre, la commande utilise le référentiel fédéré global. (Chaîne, facultatif)
Valeurs renvoyées
La commande getIdMgrEntityTypeSchema renvoie une mappe de hachage contenant la structure suivante :Map{entityType=Map{metadata}}
La commande getIdMgrEntityTypeSchema renvoie une mappe de hachage dans laquelle la clé est le type d'entité et la valeur est une autre mappe de hachage contenant le schéma du type d'entité. Cette mappe de hachage contient les clés nsPrefix, nsURI et parentEntityName et les valeurs correspondantes. L'exemple suivant illustre les exemples de résultats de cette commande :
{PersonAccount={nsPrefix=wim, nsURI=hhtp://www.ibm.com/websphere/wim, parentEntityName=loginAccount},
test1:PersonAccount={nsPrefix=test1, nsURI=hhtp://www.ibm.com/websphere/wim, parentEntityName=loginAccount},
Group={nsPrefix=wim, nsURI=hhtp://www.ibm.com/websphere/wim, parentEntityName=Party},
MyExtendedEntity={nsPrefix=wim , nsURI=hhtp://www.ibm.com/websphere/wim, parentEntityName=Person}}
Exemples
Syntaxe d'un exemple de mode différé :
- Avec Jacl :
$AdminTask getIdMgrEntityTypeSchema
- Avec
la chaîne Jython :
AdminTask.getIdMgrEntityTypeSchema()
- A l'aide de la liste Jython :
AdminTask.getIdMgrEntityTypeSchema()
Exemple d'utilisation en mode interactif :
- Avec Jacl :
$AdminTask getIdMgrEntityTypeSchema {-interactive}
- Avec
la chaîne Jython :
AdminTask.getIdMgrEntityTypeSchema ('[-interactive]')
- A l'aide de la liste Jython :
AdminTask.getIdMgrEntityTypeSchema (['-interactive'])
getIdMgrPropertySchema
La commande getIdMgrPropertySchema renvoie le schéma de propriété, incluant celui des propriétés étendues, du type d'entité spécifié ou de tous les types d'entité. Cette commande est disponible en mode connecté et local.
![[z/OS]](../images/ngzos.gif)
Objet cible
Aucune.Paramètres obligatoires.
Aucun.Paramètres facultatifs
- -id
- Ce paramètre permet d'indiquer l'ID du référentiel. Si vous n'indiquez pas ce paramètre, le schéma des propriétés par défaut des référentiels fédérés est renvoyé. (Chaîne, facultatif)
- Indiquez la valeur 'LA' pour le paramètre –id afin d'extraire le schéma de propriété du référentiel d'extension de propriété.
- -entityTypeName
- Ce paramètre permet d'indiquer le nom du type d'entité pour lequel le schéma de propriété doit être extrait. Si vous n'indiquez pas ce paramètre, le schéma de propriété de tous les types d'entité est renvoyé. Vous devez utiliser un préfixe d'espace de nom valide en référence au type d'entité s'il n'appartient pas à l'espace de nom par défaut. (Chaîne, facultatif)
- -propertyNames
- Ce paramètre permet d'indiquer un ou plusieurs noms de propriété. Si vous indiquez plusieurs noms de propriété, utilisez le point-virgule (;) comme délimiteur. Si vous ne spécifiez pas ce paramètre, toutes les propriétés sont renvoyées. Vous devez utiliser un préfixe d'espace de nom valide en référence aux noms de propriété s'ils n'appartiennent pas à l'espace de nom par défaut. (Chaîne, facultatif)
- -securityDomainName
- Ce paramètre permet d'indiquer le nom qui identifie de manière unique le domaine de sécurité. Si vous n'indiquez pas ce paramètre, la commande utilise le référentiel fédéré global. (Chaîne, facultatif)
Valeurs renvoyées
La commande getIdMgrPropertySchema renvoie une mappe de hachage contenant la structure suivante :Map{entityType=Map{propName=Map{metadata}}}
La commande getIdMgrPropertySchema renvoie une mappe de hachage dans laquelle la clé est le type d'entité et la valeur est une autre mappe de hachage contenant le schéma de propriété. Cette mappe de hachage contient le nom de propriété en tant que clé et sa valeur est une autre mappe de hachage qui contient chaque attribut de propriété et sa valeur. L'exemple suivant illustre les exemples de résultats de cette commande :
{PersonAccount={prop1={isMultiValued=false, dataType=String, nsPrefix=wim,
nsURI=hhtp://www.ibm.com/websphere/wim, isRequired=true}, test1:prop1={isMultiValued=false,
dataType=Integer, nsPrefix=test1, nsURI=hhtp://www.ibm.com/websphere/test1, isRequired=true},
prop2={isMultiValued=false, dataType=Integer, nsPrefix=wim, nsURI=hhtp://www.ibm.com/websphere/wim,
isRequired=true }}, Group={prop3={isMultiValued=false, dataType=String, nsPrefix=wim,
nsURI=hhtp://www.ibm.com/websphere/wim, isRequired=false}}}
Exemples
Syntaxe d'un exemple de mode différé :
- Avec Jacl :
$AdminTask getIdMgrPropertySchema
- Avec
la chaîne Jython :
AdminTask.getIdMgrPropertySchema()
- A l'aide de la liste Jython :
AdminTask.getIdMgrPropertySchema()
Exemple d'utilisation en mode interactif :
- Avec Jacl :
$AdminTask getIdMgrPropertySchema {-interactive}
- Avec
la chaîne Jython :
AdminTask.getIdMgrPropertySchema ('[-interactive]')
- A l'aide de la liste Jython :
AdminTask.getIdMgrPropertySchema (['-interactive'])
listIdMgrPropertyExtensions
La commande listIdMgrPropertyExtensions permet de répertorier les propriétés étendues pour les types d'entité.
Objet cible
Aucune.Paramètres obligatoires.
Aucun.Paramètres facultatifs
- -securityDomainName
- Ce paramètre permet d'indiquer le nom qui identifie de manière unique le domaine de sécurité. Si vous n'indiquez pas ce paramètre, la commande utilise le référentiel fédéré global. (Chaîne, facultatif)
- -applicationId
- Ce paramètre permet d'indiquer l'ID de l'application pour laquelle les propriétés étendues sont répertoriées.
Si vous ne spécifiez pas ce paramètre, toutes les propriétés étendues sont répertoriées.
(Chaîne, facultatif)
Valeur de retour
Ce paramètre renvoie une mappe de hachage contenant le nom de propriété comme clé. La valeur de chaque clé est une autre mappe de hachage qui contient la même clé que les paramètres d'entrée de la commande addIdMgrPropertyToEntityTypes. Pour les paramètres comportant plusieurs valeurs, la valeur de la clé est un objet liste.
Exemples
Syntaxe d'un exemple de mode différé :
- Avec Jacl :
$AdminTask listIdMgrPropertyExtensions
- Avec
la chaîne Jython :
AdminTask.listIdMgrPropertyExtensions()
- A l'aide de la liste Jython :
AdminTask.listIdMgrPropertyExtensions()
Exemple d'utilisation en mode interactif :
- Avec Jacl :
$AdminTask listIdMgrPropertyExtensions {-interactive}
- Avec
la chaîne Jython :
AdminTask.listIdMgrPropertyExtensions ('[-interactive]')
- A l'aide de la liste Jython :
AdminTask.listIdMgrPropertyExtensions (['-interactive'])
