Ayuda > Introducción a la creación DITA > Interfaz de usuario de soporte DITA > Administrador de recursos > Ficha Definición de clave
Ficha Definición de clave
La ficha Definición de clave permite insertar definiciones de clave en mapas DITA. Si se selecciona la opción de menú Insertar > Definición de clave y el Administrador de recursos aún no está abierto, se abrirá el Administrador de recursos con la ficha Definición de clave activa. Esta ficha está disponible en el Administrador de recursos cuando se edita un mapa o una especialización de un mapa. La configuración de la preferencia avanzada ditakeyrefui también permite determinar si esta opción está disponible o no en el Administrador de recursos.
En la ficha Definición de clave se proporcionan dos estados distintos. El primer estado es para insertar definiciones de clave para documentos locales. El segundo estado es para insertar definiciones de clave en documentos de Internet. Además, el tipo de mapa DITA que se esté editando determinará las opciones disponibles en la ficha. Si se edita un mapa de definiciones de clave DITA, habrá más opciones disponibles.
Opciones para la inserción de definiciones de clave en documentos locales
Cuando se insertan referencias de tema a documentos de Internet, en la ficha Definición de clave se incluyen las opciones siguientes:
• Buscar en: permite determinar la ubicación del contenido mostrado en el explorador del Administrador de recursos.
Seleccione una ubicación en la lista desplegable. Este campo siempre contiene la ubicación disponible actualmente en el explorador. Al pulsar dos veces en una carpeta del explorador, dicha carpeta se mostrará en el campo Buscar en. Si se selecciona Web en esta lista, la ficha Definición de clave cambia al estado para insertar definiciones de clave en documentos de Internet.
La lista contiene una elección Ubicaciones favoritas Imagen de una estrella amarilla.. Al seleccionar esta opción, la ubicación que se muestra en el explorador se mueve al nodo Ubicaciones favoritas, donde aparece una lista de las ubicaciones favoritas que se han guardado.
En la lista también se incluye una opción Historial Imagen de una carpeta con una flecha azul superpuesta apuntando hacia atrás.. Al seleccionar esta opción, la ubicación que se muestra en el explorador se mueve al nodo Historial, donde aparece una lista de todas las ubicaciones que se han visitado durante la sesión actual.
• Botón Menú Imagen de un documento.: permite mostrar un menú que contiene las opciones que se indican a continuación:
◦ Abrir (seguido por Documento): si se ha seleccionado un documento en el explorador, permite abrir ese documento en una ventana nueva.
Los documentos XML, DITA, SGML y HTML seleccionados se abren en una ventana de Arbortext Editor nueva. Otros tipos de documentos o gráficos se abren en la aplicación asociada. Por ejemplo, un gráfico se abre en la aplicación de gráficos por defecto.
◦ Borrar historial: permite borrar la lista de ubicaciones visitadas del nodo Historial del explorador.
Esta opción solo está disponible cuando se selecciona el nodo Historial.
◦ Añadir a favoritos: añade la ubicación seleccionada a la lista Ubicaciones favoritas.
Esta opción solo está disponible si se ha seleccionado una carpeta del sistema de ficheros, una carpeta del sistema de gestión de contenido (CMS) o una ubicación similar en el explorador.
◦ Quitar de favoritos: permite quitar la carpeta seleccionada de la lista Ubicaciones favoritas.
Esta opción solo está disponible si se ha seleccionado un elemento de la lista Ubicaciones favoritas.
◦ Subir: permite subir un elemento un nivel en la lista Ubicaciones favoritas.
Esta opción solo está disponible si se ha seleccionado un elemento de la lista Ubicaciones favoritas.
◦ Bajar: permite bajar un elemento un nivel en la lista Ubicaciones favoritas.
Esta opción solo está disponible si se ha seleccionado un elemento de la lista Ubicaciones favoritas.
◦ Exportar favoritos: permite abrir el cuadro de diálogo Guardar como, desde el que se puede guardar la lista de ubicaciones favoritas en un fichero XML.
Esta opción solo se encuentra disponible si se ha seleccionado el nodo Ubicaciones favoritas en el explorador. Esta opción permite guardar los favoritos en un fichero XML que se podrá importar posteriormente como una lista de favoritos por medio de la opción de menú Importar favoritos. No modifique este fichero XML, ya que solo está destinado a guardar una lista de favoritos.
◦ Importar favoritos: permite abrir el cuadro de diálogo Abrir, desde el que se puede seleccionar un fichero XML que contenga una lista de favoritos exportada del Administrador de recursos.
Esta opción solo se encuentra disponible si se ha seleccionado el nodo Ubicaciones favoritas en el explorador. Esta opción permite importar una lista de favoritos exportada mediante la opción de menú Exportar favoritos.
Después de seleccionar un fichero en el cuadro de diálogo Abrir y de pulsar en Abrir, se abrirá otro cuadro de diálogo que le preguntará si desea ¿Desea combinar el elemento con la lista de favoritos actual o reemplazar esta última? Pulse en Combinar para que se incluyan en la lista importada ubicaciones que no estén presentes en la lista actual que se ha añadido a la lista de favoritos. Pulse en Reemplazar para que la lista importada reemplace completamente la lista de favoritos actual.
◦ Extraer y editar: permite abrir el objeto CMS seleccionado en Arbortext Editor para su edición.
Si el objeto no está extraído, el Administrador de recursos extrae (bloquea) el objeto automáticamente. Se dispone de la opción de extraer cualquier objeto dependiente en la misma operación. Esta opción del menú solo está disponible para objetos de Conexión al servidor de PTC.
◦ Extraer: permite extraer (bloquear) el objeto CMS desbloqueado que se ha seleccionado.
Se dispone de la opción de extraer cualquier objeto dependiente en la misma operación. Esta opción del menú solo está disponible para objetos de Conexión al servidor de PTC.
◦ Deshacer extracción: permite cancelar la extracción de un objeto CMS y descartar los cambios efectuados en la versión extraída.
Después de cancelar la extracción de un objeto, si el objeto de documento está abierto en Arbortext Editor, cambiará a solo lectura. Esta opción del menú solo está disponible para objetos de Conexión al servidor de PTC.
◦ Propiedades — Muestra el cuadro de diálogo Propiedades del objeto con las propiedades del objeto seleccionado.
Esta opción del menú solo está disponible para objetos de Conexión al servidor de PTC.
◦ Buscar CMS: permite mostrar el cuadro de diálogo Buscar.
Esta opción del menú solo está disponible para objetos de Conexión al servidor de PTC. El cuadro de diálogo Buscar permite definir una consulta para buscar todos los objetos CMS que cumplan determinados criterios. Los resultados de la búsqueda aparecen en el nodo Resultados de búsqueda CMS del explorador del Administrador de recursos.
◦ Despejar resultados de búsqueda CMS: permite quitar todos los objetos CMS que se han añadido al artículo Resultados de búsqueda CMS del explorador del Administrador de recursos.
Esta opción del menú solo está disponible para adaptadores CMS soportados. Esta opción no quita los objetos de CMS, sólo del explorador del Administrador de recursos.
◦ Sincronizar ubicación entre fichas: permite determinar si la primera ubicación que se inspecciona en el explorador del Administrador de recursos se conserva cuando se cambia a una ficha diferente o cuando se abre otro cuadro de diálogo del Administrador de recursos.
La configuración de la preferencia avanzada ditasynctabs permite determinar si la función está activada o desactivada por defecto.
• Botón Carpeta anterior Imagen de una carpeta con una flecha azul superpuesta apuntando hacia atrás.: permite mover la vista del explorador de la ubicación que se muestra en el explorador a la última carpeta que se ha mostrado en el explorador.
El Administrador de recursos mantiene un historial de las carpetas que se han visto en la sesión actual, por lo que este botón se puede usar para cambiar la vista del explorador hacia atrás en el historial. Si sólo se ha visto una carpeta en la sesión actual, este botón está desactivado.
• Botón Subir un nivel Imagen de una carpeta con una flecha azul superpuesta apuntando hacia arriba.: permite subir un nivel de la jerarquía actual la ubicación de la vista del explorador que se muestra en el explorador.
Si se encuentra en la parte superior de la jerarquía, este botón está desactivado.
• Botón Carpeta del documento actual Imagen de una carpeta abierta con un documento que sobresale y una flecha azul superpuesta apuntando hacia el lado.: permite mover la vista del explorador de la ubicación que se muestra en el explorador a la carpeta que contiene el documento actual.
• Botón Renovar Imagen de un documento en blanco con dos flechas azules superpuestas que forman un círculo.: permite actualizar la vista del explorador para que refleje los cambios realizados en los objetos que se muestran en el explorador.
• Botón Examinar Web Imagen de un documento en blanco con un globo superpuesto.: permite cambiar la ficha Definición de clave al estado en el que se podrán insertar referencias de Internet.
• Botón Utilizar el explorador de objetos CMS Imagen de un archivador.: permite invocar el Explorador de Conexión al servidor de PTC o un adaptador de almacén.
Este botón sólo está disponible si el usuario está conectado a un sistema de gestión de contenido (CMS) mediante Conexión al servidor de PTC o un adaptador de almacén.
• Botón Buscar CMS Imagen de un par de binoculares sobre un archivador.: permite invocar el cuadro de diálogo Buscar.
Este botón solo está disponible para los objetos de la Conexión al servidor de PTC. El cuadro de diálogo Buscar permite definir una consulta para buscar todos los objetos CMS que cumplan determinados criterios. Los resultados de la búsqueda aparecen en la sección Resultados de búsqueda CMS del explorador del Administrador de recursos.
• Filtro: permite filtrar la lista de ficheros y documentos que se muestra en el explorador.
Al introducir texto en esta opción, la lista de ficheros y documentos que aparece en el explorador se filtra para que solo aparezcan los ficheros o elementos cuyos rótulos contienen el texto que ha introducido. En este caso, la opción Filtro y el explorador presentan un color fondo amarillo claro para indicar que el contenido del explorador se está filtrando.
Por ejemplo, si se introduce "prueba", solo los objetos con rótulos que contengan "Prueba", "pruebas", "casos de prueba", etc. aparecerán en el explorador. Si ha expandido un documento para que se muestren los elementos de su interior, los elementos mostrados también se filtrarán. En este caso, el documento se seguirá mostrando en el explorador aunque su rótulo no contenga el texto del filtro.
El filtro no distingue entre mayúsculas y minúsculas. Las carpetas y otros objetos similares no se filtran. Si se introducen varios términos en la opción Filtro, los rótulos coincidentes deberán contener todos estos términos.
• Explorador del Administrador de recursos — proporciona un sistema de ficheros, un sistema de gestión de contenido (CMS) o una jerarquía de documentos.
El explorador del Administrador de recursos permite buscar contenido en un sistema de ficheros o CMS para insertarlo en el documento. El explorador proporciona una vista jerárquica del contenido del sistema de ficheros o CMS. Además de mostrar carpetas y ficheros, el explorador también permite ver el contenido de los documentos DITA. Por ejemplo, cuando se usa la ficha Definición de clave, en el explorador se muestran los elementos de un documento DITA que están disponibles para usar como destino de una definición de clave según el contexto actual del documento. Si está disponible el título de un elemento, el título se muestra en el explorador junto al elemento. También se muestra el ID del elemento (en función de la configuración de la preferencia avanzada ditahideids) y cualquier valor del atributo href.
Si un elemento que se muestra en el explorador ya tiene un valor de referencia de clave en el atributo keyref, que se indica mediante un icono especial Imagen de una tecla con una flecha azul.. Al seleccionarse un elemento en el explorador se rellenan automáticamente algunas de las opciones de la sección Propiedades de clave del cuadro de diálogo. Por ejemplo, si el elemento seleccionado tiene un elemento title, el contenido de dicho elemento se coloca en la opción Título. Las opciones que se vayan a rellenar vendrán determinadas por el elemento seleccionado.
El explorador contiene un nodo Ubicaciones favoritas Imagen de una estrella amarilla. que contiene la lista de las ubicaciones favoritas que se han guardado. Al pulsar dos veces en uno de los favoritos, la ubicación correspondiente se abre en el explorador. Si una ubicación favorita no está disponible actualmente, por ejemplo, si se ha borrado o es una carpeta CMS y no se ha iniciado sesión en CMS, la carpeta tiene un icono especial Imagen de una carpeta con un rectángulo rojo que contiene un signo de exclamación blanco encima. para indicar ese estado.
En el explorador también se incluye un nodo Historial Imagen de una carpeta con una flecha azul superpuesta apuntando hacia atrás. que contiene una lista de todas las ubicaciones que se han visitado en la sesión actual. Al pulsar dos veces en una de esas ubicaciones, dicha ubicación se abre en el explorador.
Pulse el signo más ( + ) en la jerarquía para abrir un nivel en la jerarquía o el contenido de un documento. Pulse en el signo menos (–) para cerrar un nivel o documento. Pulse un objeto de la jerarquía para seleccionarlo. Pulse dos veces una carpeta para mover el enfoque del explorador a dicha carpeta.
Al pulsar dos veces en el nodo Web del explorador, la ficha cambia al estado para insertar referencias en documentos de Internet.
• Tipo — determina el tipo de documento que se muestra en el explorador del Administrador de recursos.
Utilice esta lista desplegable para filtrar los documentos mostrados en el explorador por tipo de documento. Se pueden elegir los siguientes tipos de documentos:
◦ Tema, mapa o imagen: permite visualizar los documentos de mapas y temas DITA, así como los ficheros de gráfico.
◦ Tema — sólo muestra documentos de tema DITA.
◦ Tema o mapa — muestran documentos de mapa o de tema DITA.
◦ Mapa — sólo muestra documentos de mapa DITA.
◦ Imagen — sólo muestra ficheros de gráfico.
◦ PDF — sólo muestra documentos PDF.
◦ HTML — sólo muestra documentos HTML.
◦ Cualquiera — muestra todos los tipos de documentos.
• Mostrar — determina el tipo de elementos que se muestran para los documentos DITA en el explorador del Administrador de recursos.
Utilice esta lista desplegable para filtrar los elementos mostrados para documentos en el explorador por tipo de elemento. Se pueden elegir los siguientes tipos de elementos:
◦ Todos los elementos
◦ Todos los elementos con ID
◦ Definiciones de clave
◦ Referencias de claves
• Propiedades de clave: permite especificar las propiedades de una definición de clave.
Las opciones de esta sección del Administrador de recursos se usan para definir las propiedades de la clave que se está definiendo. El número de opciones disponibles depende del tipo de mapa DITA que se está editando. Si se edita un mapa de definiciones de clave DITA, habrá más opciones disponibles. Estas opciones adicionales proporcionan más detalles sobre la clave en el cuadro de diálogo Insertar referencia de clave.
Están disponibles las siguientes propiedades de clave:
◦ Botón Despejar: permite quitar el contenido introducido en las opciones de propiedad de clave.
Cuando se introduce contenido en una de las opciones de propiedad de clave, el rótulo de dicha opción pasa a estar en color azul. Una vez que se haya modificado el contenido de una propiedad, no se actualiza si se cambia la selección en el explorador. Al pulsar en este botón, se borra el contenido de todas las opciones modificadas, los rótulos vuelven a estar en color negro y se restauran los valores por defecto.
◦ Nombre: permite proporcionar el nombre de la clave.
Se pueden introducir uno o varios nombres de clave separados por espacios. Si se selecciona un elemento en el explorador que ya tenga definida una referencia de clave, el valor del atributo keyref se inserta en esta opción por defecto. Si se introduce un nombre de clave no válido, el rótulo de esta opción pasa a estar en color rojo y se muestra un error en la barra de estado. También se muestra un mensaje en la barra de estado cuando el nombre de clave es un duplicado de otra definición de clave en el mismo contexto de clave.
◦ Título: permite proporcionar un título para la clave.
El valor aquí se coloca en el atributo navtitle para la definición de clave en el caso de documentos DITA 1.3.
◦ Descripción: permite proporcionar una descripción de la clave.
Esta opción solo está disponible cuando se edita un mapa de definiciones de clave DITA. El valor aquí se coloca en el elemento keydescription para la definición de clave.
◦ ID de elemento: permite proporcionar el ID para el elemento seleccionado en el explorador.
Si el elemento seleccionado ya tiene ID, el valor de dicha ID se inserta en esta opción por defecto. Si el elemento seleccionado no tiene ID, se puede generar una mediante el botón Generar ID.
Esta opción solo está disponible cuando se edita un mapa de definiciones de clave DITA. El valor aquí se coloca en el atributo value del elemento keysubelementid en la definición de clave.
◦ Botón Generar ID Imagen del botón de la barra de herramientas Generar ID.: permite generar un ID para el elemento seleccionado en el explorador y actualizar el documento que contiene el elemento.
Esta opción solo está disponible cuando se edita un mapa de definiciones de clave DITA.
◦ Etiquetas de referencia: permite proporcionar la lista de elementos que hacen referencia a la clave.
Se pueden introducir uno o varios nombres de elemento separados por espacios. En función del elemento que se seleccione en el explorador, algunas etiquetas de elemento se insertan por defecto. Debe tenerse en cuenta que este campo no se verifica para ver si los nombres de etiqueta son válidos.
Esta opción solo está disponible cuando se edita un mapa de definiciones de clave DITA. El valor aquí se coloca en el atributo value del elemento keyreftags en la definición de clave.
• Insertar: permite determinar el tipo de elemento que se insertará en el mapa.
Utilice esta lista desplegable para seleccionar el tipo de elemento que se insertará en el documento.
• Botón Insertar: permite insertar la definición de clave en el mapa que se está editando.
Si el contexto actual del documento no es un punto de inserción válido, este botón está desactivado.
Opciones para la inserción de definiciones de clave en documentos de Internet
Cuando se insertan definiciones de clave en documentos de Internet, en la ficha Definición de clave se proporcionan las opciones siguientes:
• Buscar en: permite determinar el estado de la ficha Definición de clave.
Esta opción siempre tiene el valor Web cuando se inserta una definición de clave en un documento de Internet. Al seleccionar una ubicación distinta de la lista desplegable se cambia el estado de la ficha por el de inserción de definiciones en documentos locales.
Botón Menú Imagen de un documento.: permite mostrar un menú que contiene las opciones que se indican a continuación:
◦ Abrir (seguido por Documento): esta elección está desactivada.
◦ Buscar CMS: permite mostrar el cuadro de diálogo Buscar.
Esta opción del menú solo está disponible para objetos de Conexión al servidor de PTC.
◦ Despejar resultados de búsqueda CMS: permite quitar todos los objetos CMS que se han añadido al artículo Resultados de búsqueda CMS del explorador del Administrador de recursos.
◦ Sincronizar ubicación entre fichas: permite determinar si la primera ubicación que se inspecciona en el explorador del Administrador de recursos se conserva cuando se cambia a una ficha diferente o cuando se abre otro cuadro de diálogo del Administrador de recursos.
La configuración de la preferencia avanzada ditasynctabs permite determinar si la función está activada o desactivada por defecto.
• Botón Carpeta anterior Imagen de una carpeta con una flecha azul superpuesta apuntando hacia atrás.: permite mover la vista del explorador de la ubicación que se muestra en el explorador a la última carpeta que se ha mostrado en el explorador.
Si la última ubicación visualizada en el explorador no es Web, el estado de la ficha cambia por el de inserción de referencias a documentos locales.
• Botón Subir un nivel Imagen de una carpeta con una flecha azul superpuesta apuntando hacia arriba.: este botón está desactivado.
• Botón Carpeta del documento actual Imagen de una carpeta abierta con un documento que sobresale y una flecha azul superpuesta apuntando hacia el lado.: permite mover la vista del explorador de la ubicación que se muestra en el explorador a la carpeta que contiene el documento actual.
El estado de la ficha cambia al de modificar referencias a documentos locales.
• Botón Renovar Imagen de un documento en blanco con dos flechas azules superpuestas que forman un círculo.: este botón está desactivado.
• Botón Examinar Web Imagen de un documento en blanco con un globo superpuesto.: este botón está desactivado.
• Botón Utilizar el explorador de objetos CMS Imagen de un archivador.: permite invocar el Explorador de Conexión al servidor de PTC o un adaptador de almacén.
Este botón sólo está disponible si el usuario está conectado a un sistema de gestión de contenido (CMS) mediante Conexión al servidor de PTC o un adaptador de almacén.
• Botón Buscar CMS Imagen de una lupa sobre un archivador.: permite invocar el cuadro de diálogo Buscar.
Este botón solo está disponible para los objetos de la Conexión al servidor de PTC. El cuadro de diálogo Buscar permite definir una consulta para buscar todos los objetos CMS que cumplan determinados criterios. Los resultados de la búsqueda aparecen en la sección Resultados de búsqueda CMS del explorador del Administrador de recursos.
• URL: permite mostrar el URL que se va a insertar para la definición de clave.
Este campo se puede editar para añadir el URL deseado o bien se puede seleccionar el botón Obtener URL de explorador para insertar en la opción el URL de la página Web que se muestra en el explorador Web activo.
• Abrir explorador: permite abrir el explorador Web por defecto.
Si hay un URL en la opción URL, el explorador Web se abre mostrando esa página Web. Es necesario tener un explorador Web por defecto definido en el sistema operativo o en las preferencias de Ubicaciones de ficheros del cuadro de diálogo Preferencias para usar esta opción.
• Obtener URL de explorador: permite insertar el URL de la página Web que se muestra en el explorador Web activo en la opción URL.
Es necesario tener un explorador Web por defecto definido en el sistema operativo o en las preferencias de Ubicaciones de ficheros del cuadro de diálogo Preferencias para usar esta opción.
• Propiedades de clave: permite especificar las propiedades de una definición de clave.
Las opciones de esta sección del Administrador de recursos se usan para definir las propiedades de la clave que se está definiendo. El número de opciones disponibles depende del tipo de mapa DITA que se está editando. Si se edita un mapa de definiciones de clave DITA, habrá más opciones disponibles. Estas opciones adicionales proporcionan más detalles sobre la clave en el cuadro de diálogo Insertar referencia de clave.
Están disponibles las siguientes propiedades de clave:
◦ Botón Despejar: permite quitar el contenido introducido en las opciones de propiedad de clave.
Cuando se introduce contenido en una de las opciones de propiedad de clave, el rótulo de dicha opción pasa a estar en color azul. Una vez que se haya modificado el contenido de una propiedad, no se actualiza si se cambia la selección en el explorador. Al pulsar en este botón, se borra el contenido de todas las opciones modificadas, los rótulos vuelven a estar en color negro y se restauran los valores por defecto.
◦ Nombre: permite proporcionar el nombre de la clave.
Se pueden introducir uno o varios nombres de clave separados por espacios. Si se introduce un nombre de clave no válido, el rótulo de esta opción pasa a estar en color rojo y se muestra un error en la barra de estado. También se muestra un mensaje en la barra de estado cuando el nombre de clave es un duplicado de otra definición de clave en el mismo contexto de clave.
◦ Título: permite proporcionar un título para la clave.
El valor aquí se coloca en el atributo navtitle para la definición de clave.
◦ Descripción: permite proporcionar una descripción de la clave.
Esta opción solo está disponible cuando se edita un mapa de definiciones de clave DITA. El valor aquí se coloca en el elemento keydescription para la definición de clave.
◦ ID de elemento: esta opción está desactivada.
◦ Botón Generar ID Imagen del botón de la barra de herramientas Generar ID.: esta opción está desactivada.
◦ Etiquetas de referencia: permite proporcionar la lista de elementos que hacen referencia a la clave.
Se pueden introducir uno o varios nombres de elemento separados por espacios. Algunas etiquetas de elementos se insertan por defecto. Debe tenerse en cuenta que este campo no se verifica para ver si los nombres de etiqueta son válidos.
Esta opción solo está disponible cuando se edita un mapa de definiciones de clave DITA. El valor aquí se coloca en el atributo value del elemento keyreftags en la definición de clave.
• Insertar: permite determinar el tipo de elemento que se insertará en el mapa.
Utilice esta lista desplegable para seleccionar el tipo de elemento que se insertará en el documento.
• Botón Insertar: permite insertar una definición de clave al URL designado en el mapa que se está editando.
Si el contexto actual del documento no es un punto de inserción válido, este botón está desactivado.
Introducción al Administrador de recursos
Uso de claves y referencias de clave
Menú de accesos directos Administrador de recursos
¿Fue esto útil?