Grupo de mandatos IdMgrDataModel para el objeto AdminTask

Puede utilizar el lenguaje de scripts Jython o Jacl para gestionar el esquema del repositorio federado utilizando la herramienta wsadmin. Utilice los mandatos y parámetros del grupo IdMgrDataModel para gestionar el repositorio de extensiones de propiedad. Los mandatos están disponibles en la modalidad conectada o local utilizando la opción -conntype NONE.

El grupo de mandatos IdMgrDataModel para el objeto AdminTask incluye los mandatos siguientes:

addIdMgrPropertyToEntityTypes

Utilice el mandato addIdMgrPropertyToEntityTypes para añadir una nueva propiedad a uno o más tipos de entidad existentes con los parámetros especificados.

Objeto de destino

Ninguno.

Parámetros necesarios

-name
Utilice este parámetro para especificar el nombre de la nueva propiedad que se agrega a uno o más tipos de entidad existentes.

(String, obligatorio)

-dataType
Utilice este parámetro para especificar el tipo de datos de la propiedad. (String, obligatorio)
Los tipos de datos soportados predeterminados son:
  • Serie
  • Int
  • Booleano
  • Long
  • Doble
  • Base64binary
  • AnySimpleType
  • AnyURI
  • Byte
  • DateTime
  • Fecha
  • Short
  • Señal
  • IdentifierType
Nota: Para ampliar una propiedad de tipo Object, debe utilizar el tipo de datos AnySimpleType.
-entityTypeNames
Este parámetro especifica el nombre de uno o más tipos de entidad existentes a los que se agrega la nueva propiedad. Utilice un punto y coma (;) como delimitador para especificar varios tipos de entidad.

Puede utilizar un prefijo de espacio de nombres válido (nsPrefix) para hacer referencia a los nombres de tipo de entidad en un espacio de nombres específico. El prefijo de espacio de nombres predeterminado es wim. Utilice un signo de dos puntos (:) para especificar el prefijo de espacio de nombres. Por ejemplo, puede utilizar: ext_usuario:cuenta_persona

  • ext_usuario es el prefijo de espacio de nombres, que se correlaciona con el URI http://www.suempresa.com/ext_usuario espacio_nombres.
  • Person_Account es el nombre de tipo de entidad.

(String, obligatorio)

Parámetros opcionales

-securityDomainName
Utilice este parámetro para especificar el nombre que identifica de forma exclusiva el dominio de seguridad. Si no especifica este parámetro, el mandato utiliza el repositorio federado global. (String, opcional)
-nsURI
Utilice este parámetro para especificar el espacio de nombres al que se añade la nueva propiedad.

Debe correlacionar cada valor de URI de espacio de nombres (nsURI) a un valor de prefijo de espacio de nombres exclusivo (nsPrefix) la primera vez que se utiliza el URI de espacio de nombres. La nueva propiedad se añade al espacio de nombres predeterminado si no se especifica ningún valor de nsURI. El espacio de nombres predeterminado es http://www.ibm.com/websphere/wim, que se correlaciona, de forma predeterminada, con el valor wim nsPrefix.

(String, opcional)

-nsPrefix
Utilice este parámetro para especificar el prefijo para el espacio de nombres.

Debe especificar un valor de un prefijo de espacio de nombres (nsPrefix), si especifica un valor nuevo de URI de espacio de nombres (nsURI), de modo que el valor de nsURI nuevo se correlaciona con este valor de nsPrefix. El valor de nsPrefix predeterminado es wim, que se correlaciona por omisión con el valor de nsURI http://www.ibm.com/websphere/wim.

(String, opcional)

-isMultiValued
Utilice este parámetro para especificar si la nueva propiedad acepta más de un valor. El valor predeterminado es false.

(Boolean, opcional)

-repositoryIds
Utilice este parámetro para especificar el repositorio o repositorios a los que se añade la nueva propiedad.

Utilice un punto y coma (;) como delimitador para especificar varias identidades del repositorio. Todos los repositorios configurados se incluyen, si no se especifica este parámetro.

Para añadir la nueva propiedad al repositorio de extensiones de propiedad, especifique LA como valor de este parámetro.

Para añadir la nueva propiedad a los tipos de entidad para todos los repositorios especificados, especifique una lista de identidades del repositorio y no incluya LA en la lista.

Para ampliar la propiedad al repositorio de extensiones de propiedad para repositorios LDAP (Lightweight Directory Access Protocol) concretos, especifique una lista que incluya LA. La nueva propiedad ampliada se marcará como no soportada para los demás repositorios LDAP que se incluyan en esta lista.

(String, opcional)

-requiredEntityTypeNames
Utilice este parámetro para especificar uno o más tipos de entidad para los que la propiedad nueva es necesaria.

Utilice un punto y coma (;) como delimitador para especificar varios tipos de entidad.

Puede utilizar un prefijo de espacio de nombres válido (nsPrefix) para hacer referencia a los nombres de tipo de entidad en un espacio de nombres específico. El prefijo de espacio de nombres predeterminado es wim. Utilice un signo de dos puntos (:) para especificar el prefijo de espacio de nombres. Por ejemplo, puede utilizar: ext_usuario:cuenta_persona

  • ext_usuario es el prefijo de espacio de nombres, que se correlaciona con el URI http://www.suempresa.com/ext_usuario espacio_nombres.
  • Person_Account es el nombre de tipo de entidad.
Por ejemplo, si va a añadir la propiedad contactNumber a los tipos de entidad PersonAccount y Group y necesita que todos los tipos de entidad PersonAccount tiene un valor de contactNumber, especifique:
{-name contactNumber -entityTypeNames PersonAccount;Group  -requiredEntityTypeNames PersonAccount}

(String, opcional)

-applicationId
Utilice este parámetro para indicar el ID de la aplicación para la que se ha ampliado la propiedad.

Puede utilizar el mandato getIdMgrEntityTypeSchema para recuperar las propiedades ampliadas para un ID de aplicación específico, si especifica un valor para el parámetro applicationId.

(String, opcional)

Ejemplos

Ejemplo de utilización de la modalidad por lotes:

  • Utilizando Jacl:
    $AdminTask addIdMgrPropertyToEntityTypes {-name nombre_propiedad_1 -dataType string -entityTypeNames tipo_entidad_1;tipo_entidad_2}
  • Utilizando la serie Jython:
    AdminTask.addIdMgrPropertyToEntityTypes ('[-name nombre_propiedad_1 -dataType string -entityTypeNames tipo_entidad_1;tipo_entidad_2]')
  • Utilizando la lista Jython:
    AdminTask.addIdMgrPropertyToEntityTypes (['-name', 'nombre_propiedad_1', '-dataType', 'string' '-entityTypeNames', 'tipo_entidad_1;tipo_entidad_2'])

Ejemplo de utilización de la modalidad interactiva:

  • Utilizando Jacl:
    $AdminTask addIdMgrPropertyToEntityTypes {-interactive}
  • Utilizando la serie Jython:
    AdminTask.addIdMgrPropertyToEntityTypes ('[-interactive]')
  • Utilizando la lista Jython:
    AdminTask.addIdMgrPropertyToEntityTypes (['-interactive'])

getIdMgrEntityTypeSchema

El mandato getIdMgrEntityTypeSchema devuelve el esquema de tipo de entidad. Este mandato está disponible en ambas modalidades, conectada y local.

[z/OS]Nota: Si ejecuta este mandato en modalidad local para un registro de usuarios que utilice Resource Access Control Facility (RACF), no se devolverá nada.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguna.

Parámetros opcionales

-id
Utilice este parámetro para especificar el ID del repositorio. Si no especifica este parámetro, se devuelve el esquema de tipo de entidad predeterminado de los repositorios federados. (String, opcional)
Importante: Si especifica LA como ID de repositorio, se produce un error porque LA es un ID reservado para el depósito de extensión de propiedades. Utilice el mandato listIdMgrPropertyExtension para recuperar el esquema del repositorio de extensiones de propiedades. Para obtener más información, consulte la descripción del mandato listIdMgrPropertyExtensions.
-entityTypeNames
Utilice este parámetro para especificar los nombres de uno o varios tipos de entidad para los que debe recuperarse el esquema de tipo de entidad. Si especifica varios nombres de tipos de entidad, utilice el punto y coma (;) como delimitador. Si no especifica este parámetro, se devuelve el esquema de tipo de entidad de todos los tipos de entidad. Debe utilizar un prefijo de espacio de nombres válido para hacer referencia al tipo de entidad si no pertenece al espacio de nombres predeterminado. (String, opcional)
-securityDomainName
Utilice este parámetro para especificar el nombre que identifica de forma exclusiva el dominio de seguridad. Si no especifica este parámetro, el mandato utiliza el repositorio federado global. (String, opcional)

Valores de retorno

El mandato getIdMgrEntityTypeSchema devuelve un HashMap que contiene la estructura siguiente:
Map{entityType=Map{metadata}}

El mandato getIdMgrEntityTypeSchema devuelve un HashMap donde la clave es el tipo de entidad y el valor es otro HashMap que contiene el esquema de tipo de entidad. Este HashMap contiene las claves nsPrefix, nsURI y parentEntityName y sus correspondientes valores. El siguiente ejemplo muestra resultados de muestra de este mandato:

{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}}
Nota: Si el mismo tipo de entidad está definido en distintos espacios de nombres, se lista para cada uno de estos espacios de nombres en los resultados de salida con el prefijo de espacio de nombres (nsPrefix) como prefijo del nombre de tipo de entidad, por ejemplo, test1:PersonAccount.

Ejemplos

Ejemplo de utilización de la modalidad por lotes:

  • Utilizando Jacl:
    $AdminTask getIdMgrEntityTypeSchema
  • Utilizando la serie Jython:
    AdminTask.getIdMgrEntityTypeSchema()
  • Utilizando la lista Jython:
    AdminTask.getIdMgrEntityTypeSchema()

Ejemplo de utilización de la modalidad interactiva:

  • Utilizando Jacl:
    $AdminTask getIdMgrEntityTypeSchema {-interactive}
  • Utilizando la serie Jython:
    AdminTask.getIdMgrEntityTypeSchema ('[-interactive]')
  • Utilizando la lista Jython:
    AdminTask.getIdMgrEntityTypeSchema (['-interactive'])

getIdMgrPropertySchema

El mandato getIdMgrPropertySchema devuelve el esquema de propiedad, incluido el de propiedades ampliadas, del tipo de entidad especificado o todos los tipos de entidad. Este mandato está disponible en ambas modalidades, conectada y local.

[z/OS]Nota: Si ejecuta este mandato en modalidad local para un registro de usuarios que utilice Resource Access Control Facility (RACF), no se devolverá nada.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguna.

Parámetros opcionales

-id
Utilice este parámetro para especificar el ID del repositorio. Si no especifica este parámetro, se devuelve el esquema de propiedades predeterminado de los repositorios federados. (String, opcional)
Especifique 'LA' como valor del parámetro -id para recuperar el esquema propiedad del repositorio de extensiones de propiedades.
-entityTypeName
Utilice este parámetro para especificar el nombre del tipo de entidad para el que se debe recuperar el esquema de propiedad. Si no especifica este parámetro, se devuelve el esquema de propiedad de todos los tipos de entidad. Debe utilizar un prefijo de espacio de nombres válido para hacer referencia al tipo de entidad si no pertenece al espacio de nombres predeterminado. (String, opcional)
-propertyNames
Utilice este parámetro para especificar uno o varios nombres de propiedades. Si especifica varios nombres de propiedades, utilice el punto y coma (;) como delimitador. Si no especifica este parámetro, se devuelven todas las propiedades. Debe utilizar un prefijo de espacio de nombres válido para hacer referencia los nombres de propiedades si no pertenecen al espacio de nombres predeterminado. (String, opcional)
-securityDomainName
Utilice este parámetro para especificar el nombre que identifica de forma exclusiva el dominio de seguridad. Si no especifica este parámetro, el mandato utiliza el repositorio federado global. (String, opcional)

Valores de retorno

El mandato getIdMgrPropertySchema devuelve un HashMap que contiene la estructura siguiente:
Map{entityType=Map{propName=Map{metadata}}}

El mandato getIdMgrPropertySchema devuelve un HashMap donde la clave es el tipo de entidad y el valor es otro HashMap que contiene el esquema de propiedad. Este HashMap contiene el nombre de propiedad como clave y su valor es otro HashMap que contiene cada atributo de la propiedad y su valor. El siguiente ejemplo muestra resultados de muestra de este mandato:

{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}}}
Nota: Si la misma propiedad está definida en espacios de nombres diferentes para un tipo de entidad, se lista para cada uno de dichos espacios de nombres en los resultados de la salida con el prefijo del espacio de nombres (nsPrefix) como prefijo del nombre de propiedad, por ejemplo, test1:prop1. El atributo isRequired se devuelve como true para la propiedad de un tipo de entidad, si dicho tipo de entidad se lista en la lista requiredEntityTypeNames.

Ejemplos

Ejemplo de utilización de la modalidad por lotes:

  • Utilizando Jacl:
    $AdminTask getIdMgrPropertySchema
  • Utilizando la serie Jython:
    AdminTask.getIdMgrPropertySchema()
  • Utilizando la lista Jython:
    AdminTask.getIdMgrPropertySchema()

Ejemplo de utilización de la modalidad interactiva:

  • Utilizando Jacl:
    $AdminTask getIdMgrPropertySchema {-interactive}
  • Utilizando la serie Jython:
    AdminTask.getIdMgrPropertySchema ('[-interactive]')
  • Utilizando la lista Jython:
    AdminTask.getIdMgrPropertySchema (['-interactive'])

listIdMgrPropertyExtensions

Utilice el mandato listIdMgrPropertyExtensions command para listar las propiedades ampliadas para tipos de entidad.

Objeto de destino

Ninguno.

Parámetros necesarios

Ninguna.

Parámetros opcionales

-securityDomainName
Utilice este parámetro para especificar el nombre que identifica de forma exclusiva el dominio de seguridad. Si no especifica este parámetro, el mandato utiliza el repositorio federado global. (String, opcional)
-applicationId
Utilice este parámetro para indicar el ID de la aplicación para la que se han listado las propiedades ampliadas.

Si no especifica este parámetro, se listan todas las propiedades ampliadas.

(String, opcional)

Valor de retorno

Este parámetro devuelve una correlación hash que contiene el nombre de la propiedad como clave. El valor de cada clave es otra correlación hash, que contiene las mismas claves que los parámetros de entrada del mandato addIdMgrPropertyToEntityTypes. Para los parámetros de varios valores, el valor de la clave es un objeto de Lista.

Ejemplos

Ejemplo de utilización de la modalidad por lotes:

  • Utilizando Jacl:
    $AdminTask listIdMgrPropertyExtensions
  • Utilizando la serie Jython:
    AdminTask.listIdMgrPropertyExtensions()
  • Utilizando la lista Jython:
    AdminTask.listIdMgrPropertyExtensions()

Ejemplo de utilización de la modalidad interactiva:

  • Utilizando Jacl:
    $AdminTask listIdMgrPropertyExtensions {-interactive}
  • Utilizando la serie Jython:
    AdminTask.listIdMgrPropertyExtensions ('[-interactive]')
  • Utilizando la lista Jython:
    AdminTask.listIdMgrPropertyExtensions (['-interactive'])
Supported configurations Supported configurations: Este mandato lista las propiedades ampliadas que sólo están presentes en el archivo wimxmlextension.xml.sptcfg

Icon that indicates the type of topic Reference topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_atidmgrDataModel
File name: rxml_atidmgrDataModel.html