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.

Le groupe de commandes IdMgrDataModel de l'objet AdminTask inclut les commandes suivantes :

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]Remarque : Si vous exécutez cette commande en mode local pour un registre d'utilisateurs qui utilise la fonction de contrôle d'accès aux données, aucune valeur n'est renvoyée.

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}}
Remarque : Si le même type d'entité est défini dans différents espaces de nom, il est répertorié pour chacun d'entre eux dans les résultats, avec le préfixe d'espace de nom (nsPrefix) apposé au nom du type d'entité, par exemple, test1:PersonAccount.

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]Remarque : Si vous exécutez cette commande en mode local pour un registre d'utilisateurs qui utilise la fonction de contrôle d'accès aux données, aucune valeur n'est renvoyée.

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}}}
Remarque : Si la même propriété est définie dans différents espaces de nom pour un type d'entité, il est répertorié pour chacun d'entre eux dans les résultats, avec le préfixe d'espace de nom (nsPrefix) apposé au nom de la propriété, par exemple test1:prop1. L'attribut isRequired est renvoyé avec la valeur true pour la propriété d'un type d'entité, si ce dernier est répertorié dans la liste requiredEntityTypeNames.

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'])
Configurations prises en charge Configurations prises en charge: Cette commande répertorie les propriétés étendues qui sont présentes uniquement dans le fichier wimxmlextension.xml.sptcfg

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=rxml_atidmgrDataModel
Nom du fichier : rxml_atidmgrDataModel.html