El atributo ICM$NAME es el atributo de nombre estándar para un tipo de elemento. Es un atributo necesario para los tipos de elementos jerárquicos.
Si no añade el atributo ICM$NAME a un tipo de elemento cuando habilite su opción jerárquica,
se añadirá automáticamente cuando se cree el tipo de elemento jerárquico.
Puede añadir el atributo ICM$NAME al
componente raíz de cualquier tipo de elemento nuevo o existente, salvo la
clase de tipo de parte.
El atributo ICM$NAME se puede aplicar a documentos, carpetas o
a cualquier dato devuelto al realizar un examen o una búsqueda. Como el atributo de nombre estándar, el atributo ICM$NAME resulta útil para ordenar y consultar operaciones sobre tipos de elementos, como por ejemplo, ordenar resultados por nombre y resolver vías de acceso basadas en nombres.
El atributo ICM$NAME tiene las siguientes características:
- Es un atributo de usuario predefinido.
- No se puede actualizar ni suprimir.
- Su valor no tiene espacios en blanco finales
- Su tipo de datos es VARCHAR con la longitud 256.
- No se puede añadir a ningún grupo de atributos definido por el usuario.
- Cuando se crea, su ID de atributo cumple la regla de generación de ID de atributo
de usuario (1 se añade al máximo). Por lo tanto, su ID de atributo es mayor o igual que 1000 y es diferente en distintos sistemas Content Manager EE.
Cuando el atributo ICM$NAME se añade a su tipo de elemento jerárquico,
tiene las siguientes propiedades de atributo de componente predeterminadas. Salvo que
se especifique otra cosa, estas propiedades se pueden cambiar:
- Que admite nulos
- No exclusivo. Esta propiedad no se puede cambiar.
- No se puede buscar texto
- No representado
- Sin ningún valor predeterminado
Al proporcionar
un valor para ICM$NAME, no existe ninguna restricción en cuanto al número de caracteres que se puede utilizar. Sin embargo, el
servidor de biblioteca elimina todos los espacios en blanco finales del valor. Por lo tanto, si ha proporcionado un valor ICM$NAME con espacios en blanco finales, estos no se visualizarán
en los resultados de la búsqueda. Si proporciona
un valor ICM$NAME con una serie que conste en su totalidad de espacios en blanco, su
valor se convertirá en una serie vacía y el servidor de biblioteca
devolverá el error ICM7016.
Las siguientes restricciones se aplican al atributo ICM$NAME de un
tipo de elemento jerárquico. No se puede:
- Actualizar la propiedad de exclusividad del atributo ICM$NAME una vez que se ha añadido
a un tipo de elemento. Si intenta hacerlo, el servidor de biblioteca devuelve el error ICM7123.
- Añadir el atributo ICM$NAME a un elemento hijo. Si intenta hacerlo, se devuelve
un error DGL7351A (DK_ICM_MSG_HIERARCHICAL_CHILD_COMPONENT_USE_ICMNAME_INVALID).
- Añadir el atributo ICM$NAME al grupo de atributos definido por el usuario.
Si intenta hacerlo, se devuelve el error DGL7353A (DK_ICM_MSG_HIERARCHICAL_ATTR_GROUP_USE_ICMNAME_INVALID).
- Definir el atributo ICM$NAME para que sea un valor nulo al crear o actualizar un tipo de elemento jerárquico. Si intenta hacerlo, se devuelve un error DGL7349A
(DK_ICM_MSG_HIERARCHICAL_INVALID_ICMNAME_NULLABLE).
- Definir el valor predeterminado del atributo ICM$NAME al crear o actualizar un tipo de elemento jerárquico. Si intenta hacerlo, se devuelve un error
DGL7350A (DK_ICM_MSG_HIERARCHICAL_INVALID_ICMNAME_DEFAULT_VALUE).
Para obtener el valor de atributo ICM$NAME de un tipo de elemento,
llame al método getName() de su objeto DKDatastoreICM.
Si desea más información, consulte la sección
Application Programming Reference.
