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.
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]](../images/ngzos.gif)
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}}
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]](../images/ngzos.gif)
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}}}
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'])
