Cuadro de diálogo Modificar atributos
Con las opciones del cuadro de diálogo Modificar atributos puede definir o cambiar los valores de atributo del marcador situado a la izquierda del cursor. Si el marcador a la izquierda del cursor es una referencia de entidad, una sección marcada, un comentario, un elemento sin atributos o una instrucción de procesamiento, el cuadro de diálogo Modificar atributos no estará disponible.
Los atributos y los valores disponibles para ellos en este cuadro de diálogo dependen del elemento seleccionado y del tipo de documento.
 |
Si ha aplicado un mapa de alias al documento, este cuadro de diálogo mostrará los alias de los atributos y de los valores que tengan un alias asignado, en lugar de mostrar su nombre real.
Si el mapa de alias incluye descripciones de atributos, cuando el cursor se encuentre sobre el rótulo de un atributo con descripción, ésta aparecerá en la zona inferior del cuadro de diálogo Modificar atributos.
|
Por defecto, los atributos se agrupan en categorías y el cuadro de diálogo se muestra en un esquema con fichas basado en estas categorías. El administrador de tipos de documentos puede definir las categorías de atributos en el fichero DCF del tipo de documento. Consulte la sección sobre definición de categorías de atributos para obtener información acerca del marcador que debe utilizarse.
En los tipos de documento XML, los atributos normalmente se muestran por orden alfabético. Si se categorizan los atributos, se puede usar el atributo sort para ModifyAttributeCategory en el fichero DCF, para clasificarlos. En el caso de los documentos SGML, los nombres de atributo se muestran por defecto en el orden en que se definen en el tipo de documento. Para mostrar los atributos alfabéticamente, defina el valor de la Preferencia avanzadamodifyattrsorted en on.
Los cuadros de diálogo Modificar atributos tienen las características siguientes:
• Un asterisco rojo junto a un nombre de atributo indica que ese valor es obligatorio. Si la preferencia requireattrs se define en on (por defecto), el cuadro de diálogo Modificar atributos se abre automáticamente cuando se inserta una etiqueta con el atributo obligatorio en un documento. En este caso, el cursor se coloca en el primer atributo obligatorio.
• Los nombres de los atributos en color azul son valores que se han modificado. Los valores aparecen en la etiqueta del panel de edición.
• Los nombres de atributo en negro indican que los valores, si existen, son los valores por defecto establecidos por el tipo de documento.
• La lista junto a cada a atributo muestra los valores disponibles. Los valores que aparecen dependen del tipo de documento.
• Cuando aparece un cuadro de texto detrás de un atributo, se puede introducir texto o números. Puede introducir texto o números para los atributos como ID o IDREF.
• El botón Generar un ID 
junto a un campo de texto permite generar un ID exclusivo para un atributo definido como ID en el tipo de documento o fichero DCF. La presencia de este botón se puede personalizar en el tipo de documento. Los administradores del sistema pueden personalizar la generación de ID a través de la llamada generate_id().
junto a un campo de texto permite generar un ID exclusivo para un atributo definido como ID en el tipo de documento o fichero DCF. La presencia de este botón se puede personalizar en el tipo de documento. Los administradores del sistema pueden personalizar la generación de ID a través de la llamada generate_id().• Un lista desplegable muestra todos los ID definidos en el documento actual para un atributo definido como IDREF en el tipo de documento.
• El botón Inspeccionar 
junto a un campo de texto permite inspeccionar rutas de directorios o URL.
junto a un campo de texto permite inspeccionar rutas de directorios o URL.• La etiqueta de elemento a la que pertenecen estos atributos aparece en la parte superior del cuadro de diálogo.
• Es posible introducir un valor vacío para los atributos CDATA. Por defecto, si se borra el último carácter de un valor de atributo CDATA, el atributo se borrará de la etiqueta. Sin embargo, se marca la opción Permitir valores de atributo de cadenas vacías de la categoría Editar del cuadro de diálogo Preferencias, es posible introducir valores vacíos para los atributos CDATA.
En este caso, se puede colocar el cursor en el campo de un atributo CDATA, escribir un carácter y pulsar la tecla de retroceso para borrarlo. El nombre del atributo seguirá apareciendo en azul para iniciar que existe un valor del atributo, incluso cuando sea el valor vacío. Asimismo, la frase (cadena vacía) aparece como el valor de ese atributo. Para borrar siempre un atributo CDATA independientemente de cómo esté definida la preferencia, coloque el cursor en el campo deseado y pulse en el botón Borrar.
• Si introduce un valor no válido, el cuadro de diálogo no podrá cerrarse. El nombre del atributo con el valor no válido se muestra en rojo.
• Si un tipo de documento define un valor por defecto para un atributo, el valor no aparecerá en el cuadro de diálogo Modificar atributos, ni tampoco en la etiqueta de ese elemento. Si desea que el valor por defecto aparezca, introduzca un valor distinto, guarde los cambios, y vuelva a especificar el valor por defecto.
• Si un fichero .dcf de un tipo de documento define un atributo en Sólo Lectura, el valor de ese atributo se podrá ver en el cuadro de diálogo Modificar atributos pero no se podrá cambiar.
• Si el fichero .dcf de un tipo de documento define un atributo como un atributo de creación de perfiles, el valor de ese atributo se podrá ver en el cuadro de diálogo Modificar atributos pero no se podrá cambiar. Un botón (
) aparece junto al atributo que invoca el cuadro de diálogo Aplicar perfiles.
) aparece junto al atributo que invoca el cuadro de diálogo Aplicar perfiles.• Si se están modificando los atributos de un gráfico inteligente o un vínculo para un gráfico inteligente, en el cuadro de diálogo se pueden incluir los atributos especiales siguientes:
◦ xmlns:atgra: se trata de un atributo de solo lectura que hace referencia a un espacio de nombres especial asociado al soporte de gráficos inteligente de Arbortext.
◦ atgra:links: se trata de un atributo de Sólo Lectura en el que se incluye información acerca de los vínculos almacenados dentro del gráfico inteligente.
Si desea modificar los vínculos, hay un botón 
situado junto al atributo que permite abrir el cuadro de diálogo Actualizar vínculos de objeto gráfico. Este cuadro de diálogo se puede utilizar para modificar los vínculos. Si se borra el valor de los atributos de referencia de fichero (fileref) o entidad (entityref), también se elimina el valor de este atributo.
situado junto al atributo que permite abrir el cuadro de diálogo Actualizar vínculos de objeto gráfico. Este cuadro de diálogo se puede utilizar para modificar los vínculos. Si se borra el valor de los atributos de referencia de fichero (fileref) o entidad (entityref), también se elimina el valor de este atributo.◦ atgra:linkdata: se trata de un atributo de Sólo Lectura que permite determinar la acción que se produce en un gráfico inteligente cuando se selecciona un vínculo.
Para modificar esta acción, seleccione el vínculo y pulse con el botón derecho del ratón para que aparezca el menú de accesos directos de la vista de edición. Seleccione Modificar vínculo del menú y utilice el cuadro de diálogo correspondiente para cambiar las propiedades del vínculo.
• Si edita el valor de un atributo de aplicabilidad en línea (por ejemplo, appl:applic), dispone de dos opciones:
◦ Editar el valor de forma manual en el campo de texto
En este caso, la expresión de aplicabilidad modificada no puede validarse con la sintaxis de aplicabilidad.
◦ Pulsar en el botón Modificar aplicabilidad en línea 
para invocar el cuadro de diálogo Modificar aplicabilidad en línea
para invocar el cuadro de diálogo Modificar aplicabilidad en líneaPara obtener más información, consulte Cuadro de diálogo Aplicar aplicabilidad en línea.
El atributo que representa la configuración de aplicabilidad en línea se encuentra definido en la sintaxis de aplicabilidad del entorno de Arbortext actual. Para obtener más información, consulte Confirmación de la sintaxis de aplicabilidad.
El atributo de aplicabilidad suele aparecer en la ficha Otro del cuadro de diálogo Modificar atributos.
El aspecto del cuadro de diálogo Modificar atributos puede variar en función del tipo y el número de atributos del documento. Sin embargo, normalmente contiene lo siguiente:
• Información de atributo — varios campos con valores de atributo determinados por el tipo de documento. Junto a algunos campos pueden aparecer listas con opciones de modificación.
• Nuevo atributo — (Documentos con formato libre XML y elementos de un espacio de nombres no declarado en el tipo de documento) Campo de texto en el que introducir el nombre del nuevo atributo.
• Añadir — (Documentos con formato libre XML y elementos de un espacio de nombres no declarado en el tipo de documento) Añade el atributo del campo Nuevo atributo a la lista de atributos existentes.
• Aceptar — valida y aplica los cambios antes de cerrar el cuadro de diálogo. Si en la validación se encuentran errores:
a. Se muestra un cuadro de mensaje de error con todos los errores. En el cuadro de mensaje de error, pulse en Cerrar para descartarlo.
b. Corrija el error en el cuadro de diálogo Modificar atributos. El nombre del campo que tiene el error se muestra en rojo.
c. Pulse en Aceptar para cerrar el cuadro de diálogo después de corregir todos los errores. Se mostrará un mensaje de confirmación que indica que no se han encontrado errores.
• Cancelar — cierra el cuadro de diálogo.
• Ayuda — muestra la ayuda en línea.
• 
(Acoplar cuadro de diálogo): acopla el cuadro de diálogo al lado izquierdo de la ventana. Cuando está acoplado, los atributos disponibles se actualizan automáticamente en función de la posición del cursor en la ventana Editar. Pulse en 
(Desacoplar cuadro de diálogo) para desacoplar.
(Acoplar cuadro de diálogo): acopla el cuadro de diálogo al lado izquierdo de la ventana. Cuando está acoplado, los atributos disponibles se actualizan automáticamente en función de la posición del cursor en la ventana Editar. Pulse en (Desacoplar cuadro de diálogo) para desacoplar.• 
(Validar): permite verificar que todos los valores introducidos son válidos, pero no aplica los cambios ni cierra el cuadro de diálogo. Validar no está disponible para los documentos con tipo de documento Formato libre XML.
(Validar): permite verificar que todos los valores introducidos son válidos, pero no aplica los cambios ni cierra el cuadro de diálogo. Validar no está disponible para los documentos con tipo de documento Formato libre XML.• 
(Redefinir): para el campo en el que se encuentra el cursor, redefine el valor del atributo cambiado al valor que tenía al abrir el cuadro de diálogo.
(Redefinir): para el campo en el que se encuentra el cursor, redefine el valor del atributo cambiado al valor que tenía al abrir el cuadro de diálogo.• 
(Borrar): para el campo en el que se encuentra el cursor, quita ese valor de atributo.
(Borrar): para el campo en el que se encuentra el cursor, quita ese valor de atributo.• 
(Borrar todo): permite quitar todos los ajustes de valores de atributos modificados y devolverlos a su estado original sin modificar.
(Borrar todo): permite quitar todos los ajustes de valores de atributos modificados y devolverlos a su estado original sin modificar.Opciones de documentos DITA
En el cuadro de diálogo Modificar atributos se incluyen las siguientes opciones adicionales cuando se edita un documento DITA:
• Soporte de inspección para conref, href y atributos similares: cuando se invoca el cuadro de diálogo Modificar atributos en un documento DITA, un botón ( ) aparece junto a atributos como conref y href que hacen referencia a otro fichero. Con este botón se abre el Administrador de recursos para modificar los atributos. Puede usar el Administrador de recursos para examinar el sistema de ficheros o el sistema de gestión de contenido (CMS) y buscar un documento o elemento al que referirse con el atributo.
) aparece junto a atributos como conref y href que hacen referencia a otro fichero. Con este botón se abre el Administrador de recursos para modificar los atributos. Puede usar el Administrador de recursos para examinar el sistema de ficheros o el sistema de gestión de contenido (CMS) y buscar un documento o elemento al que referirse con el atributo.• Soporte de atributo de perfilado: un botón () junto a los atributos DITA que suelen usarse para el perfilado (audience, platform, product y otherprops). El valor de estos atributos no se puede modificar en el cuadro de diálogo Modificar atributos. Si se selecciona el botón, se invoca el cuadro de diálogo Aplicar perfiles en el que se puede elegir el perfil que se debe aplicar al atributo.
) junto a los atributos DITA que suelen usarse para el perfilado (audience, platform, product y otherprops). El valor de estos atributos no se puede modificar en el cuadro de diálogo Modificar atributos. Si se selecciona el botón, se invoca el cuadro de diálogo Aplicar perfiles en el que se puede elegir el perfil que se debe aplicar al atributo.Modificación de atributos de marcadores no válidos
En esta sección se describe el comportamiento del cuadro de diálogo para las siguientes condiciones de marcado no válidas:
• Etiquetas declaradas con atributos declarados y valores no válidos.
• Etiquetas declaradas con atributos no declarados.
• Etiquetas no declaradas.
Al elegir > se mostrarán las etiquetas en el cuadro de diálogo. Arbortext Editor adjuntará la etiqueta no declarada al título del cuadro de diálogo si la etiqueta no está declarada.
Arbortext Editor trata los marcadores de atributo no válidos de las siguientes maneras:
• En la entrada: cuando el cuadro de diálogo aparece, los atributos declarados con valores no válidos se mostrarán en rojo. Los atributos sin declarar aparecerán en rojo y tachados.
• Edición: es posible modificar los valores declarados y también los no declarados. También puede eliminar cualquier atributo (declarado o no) con el botón Borrar, o borrando manualmente su valor.
• Validar: el botón Validar desempeña su función normal con los atributos declarados, y señalará los atributos no declarados si todos los atributos declarados son válidos. Si borra el valor de un atributo no declarado, la función de validación no lo tendrá en cuenta.
• Atributos no declarados: si existe algún atributo no declarado, Arbortext Editor permite adoptar los cambios para ocuparse de ellos más tarde.
• Valor no válido en entrada y salida: si un atributo declarado tiene un valor no válido al abrir el cuadro de diálogo, Arbortext Editor permite adoptar los cambios sin corregirlo.
• Válido en la entrada, no válido en la salida: si el valor de un atributo era válido al abrir el cuadro de diálogo pero se modifica y deja de ser válido, Arbortext Editor NO permitirá adoptar los cambios.