Manual de usuario para XML Assistant v2.2

Contenido:

1. Tutorial como introducción rápida

Este tutorial le enseña las funciones principales del XML Assistant utilizando ejemplos concretos.

1.1 Abrir archivos 

Los archivos se abren con el elemento de menú Archivo->Abrir o el icono de la barra de herramientas.

Para este tutorial abrimos el archivo de ejemplo utilizando el elemento de menú predefinido Ayuda->Ejemplo "Web Pages".

La figura siguiente muestra el archivo abierto en el XML Assistant. La ventana de la aplicación se divide en: a) Vista del archivo XML como árbol de nodos 2) Espacios de nombres, atributos y elementos del nodo de árbol seleccionado 3) Vista del código XML (si se activa).

1.2 Editar y usar reglas 

Las reglas de visualización definen cómo se muestran los datos de un archivo XML. Para diferentes tipos de archivos XML se pueden crear diferentes conjuntos de reglas.

El conjunto de reglas "WebPages" ya está seleccionado en la lista de conjuntos de reglas. Las reglas definidas allí se aplican al archivo, definen iconos y texto del árbol (izquierda) y los campos de entrada para el elemento seleccionado (derecha).

Vamos a modificar las reglas del conjunto de reglas para comprender mejor cómo funciona.

Seleccione "Editar reglas de visualización..." en la barra de herramientas:

Se abre la pestaña "Reglas de visualización":

Como siguiente paso movemos la pestaña "Reglas de visualización" a la parte inferior de la ventana principal. Esto se hace haciendo clic en el título de la pestaña y arrastrándolo al icono que se muestra en la parte inferior de la ventana.

La pestaña se reorganiza:

Ahora editamos las reglas de visualización, abrimos el conjunto de reglas "WebPages" y la regla "Web Page". Al seleccionar "Condición: Page" o "Se aplican condiciones" podemos, por ejemplo, ver que el texto "Page: http://www.myspace.com (05)" se puede mostrar para un nodo de árbol que representa el elemento "Page". Múltiples elementos "Page" se muestran en el árbol.

Ahora cambie la entrada de "Texto del nodo en el árbol" a "$name: [Title] ([@id])". Los cambios se aplican directamente mientras se escribe. El texto codificado entre corchetes no es texto simple, sino que expresa una expresión XPath que se ejecutará en este elemento. En este ejemplo se muestra el título en lugar de la dirección URL.

Como puede ver en los conjuntos de reglas existentes, hay muchas más posibilidades de configuración disponibles. Por favor, tómese unos segundos para probarlos.

1.3 Plantillas 

Las plantillas se utilizan para agregar pasajes de código utilizados con frecuencia rápidamente. Esto puede evitar la necesidad de operaciones frecuentes de copiar y pegar.

Para la demostración, de nuevo usamos el archivo "Web Pages".

Las plantillas se muestran como botones y en el menú contextual de nodos

Para la creación de una nueva plantilla seleccionamos "Responsible" y elegimos "Como una nueva plantilla" en su menú contextual.

Una plantilla es simplemente un archivo XML propio cuyo contenido está disponible en el menú contextual. Las plantillas se editan y guardan como archivos XML ordinarios. Se guardan en el subdirectorio "templates" del directorio de configuración de usuario (accesible con: Herramientas -> "Administración de plantillas" -> Haga clic en el enlace).

En este ejemplo eliminamos todo el contenido de los nodos de plantilla, esto se hace seleccionando el nodo raíz y el elemento de menú contextual Editar->Eliminar contenidos.

La plantilla también debe estar disponible para los nodos que usan la plantilla. Para ello, abra el conjunto de reglas "WebPages" y la regla "Web Page", el subelemento "Plantilla" de "Se aplican condiciones" definir, qué plantillas se mostrarán en el menú contextual para los nodos que coinciden con esta regla. Añadimos la nueva plantilla.

La plantilla se mostrará en la lista de menús contextuales y como un botón ahora.

2. Editar XML

Describe las características principales para editar XML en XML Assistant.

2.1 Funciones principales 

Se accede a las funciones de edición más importantes mediante el menú contextual (clic con el botón derecho del ratón) de los nodos del árbol XML o el menú Editar en el menú principal:

Las principales características son:

• Crear un Duplicado: crea un duplicado del nodo seleccionado y lo inserta al final.
• Duplicar después: crea un duplicado del nodo seleccionado y lo inserta como vecino.
• Cortar/Copiar/Pegar/Eliminar/Renombrar
• Añadir atributo: crear un nuevo atributo
• Añadir elemento: Crear nuevo elemento
• Añadir nodo: crea un nuevo elemento y contiene en él otro elemento. Esto mostrará el elemento envolvente en el árbol XML de la izquierda. Así que puede lograr esto agregando un elemento y otro elemento a él.
• Agregar espacio de nombres: cree espacios de nombres en el elemento actual
• Modificar Orden, ...

2.2 Administrar espacios de nombres 

Los espacios de nombres se administran de forma similar a los atributos y el contenido. Para agregar espacios de nombres, utilice la entrada de menú 'Añadir espacio de nombres':

Agregue el prefijo y el URI en el cuadro de diálogo de entrada, por ejemplo:

Después de la confirmación se añade el nuevo espacio de nombres:

Puede eliminar y editar el espacio de nombres desde el menú contextual del espacio de nombres:

2.3 Acceso directo 

Para editar en el área derecha puede utilizar los siguientes accesos directos en el teclado:

• ARRIBA, ABAJO: Cambie al atributo o contenido siguiente/anterior
• CTRL+ABAJO: Añadir atributo o contenido por debajo de la selección actual
• CTRL+SUPR: Elimine el atributo o contenido actual

3. Reglas de edición

La comodidad de editar archivos XML depende de las reglas que se utilicen. Con un archivo de ejemplo, se mostrará este capítulo, que ver las reglas que proporciona el XML Assistant.

3.1 Abra ejemplo y ajuste pestañas 

Preparación del ejemplo

Primero abrimos las pestañas necesarias, para ello, elegimos Ayuda -> Ejemplo "Web Pages" en el menú principal.

Ahora elija 'Editar reglas de visualización...'.

Se abre la pestaña para editar los conjuntos de reglas. Como se muestra a continuación, es más cómodo mover la pestaña para editar las reglas a la parte inferior de la ventana. Para ello, arrastre el título de la pestaña con el botón izquierdo del ratón hasta la parte inferior de la ventana principal.

3.2 Organizar reglas 

Reglas y conjuntos de reglas

Las reglas se agrupan en conjuntos de reglas. Para el archivo de ejemplo ya existe el conjunto de reglas "WebPages". Cada conjunto de reglas puede contener varias reglas.

3.3 Qué reglas son 

Condiciones y opciones de visualización de las reglas

Las reglas contienen una o más condiciones (en la mayoría de los casos una condición es suficiente) y muchas opciones de visualización. Si se cumplen todas las condiciones (1) para un nodo, se aplican las opciones de visualización (2).

En este ejemplo la condición "Nombre es... Page" es suficiente. Esto significa que si un elemento del árbol tiene este nombre, se aplican las opciones de visualización. Los otros tipos de condiciones se describen en la página para editar una condición.

Si todas las condiciones coinciden, se aplican las opciones de visualización en "Se aplican condiciones". Las opciones afectan al árbol (izquierda) y al panel de entrada (derecha).

3.4 Opciones de visualización 

Visión general de las opciones de visualización

Las opciones de visualización se separan en diferentes categorías. Estas categorías son:

• Mostrar título: Aquí puede personalizar el título y el subtítulo que se muestran en el panel de entrada (derecha)
• Opciones de visualización: Establece las opciones de visualización principales, por ejemplo, si los títulos son visibles o con etiquetas se muestran
• Operaciones permitidas: Para conservar ciertas partes de los datos de modificaciones no intencionadas, se pueden activar/desactivar varias operaciones de edición aquí
• Mostrar como cuadro combinado (lista de selección): con esta función puede mostrar un cuadro combinado en lugar de un campo de texto para el contenido de texto de un elemento/atributo. Esto es útil para valores recurrentes
• Mostrar como casilla de verificación (activada/desactivada): Para los elementos/atributos que solo tienen dos valores (por ejemplo, verdadero/falso) puede mostrar una casilla de verificación
• Mostrar como lista de casillas de verificación: permite la activación/desactivación de varios valores. Los valores están separados por un delimitador
• Mostrar como campo de fecha: Permite introducir y seleccionar fechas, en un formato especificado
• Textos de ayuda para elementos/atributos: muestra textos de ayuda adicionales para campos individuales. Con esto puede, por ejemplo, agregar instrucciones de edición

Por favor, tómese un tiempo para familiarizarse con las opciones de visualización.

3.5 Árbol XML: Usar sus propios iconos 

Puede definir sus propios iconos para mostrarlos en el árbol XML.

El cuadro de diálogo Ayuda -> Información del sistema muestra los directorios en los que se pueden almacenar iconos:

El siguiente enlace abre el directorio de iconos en el perfil de usuario: C:\Users\[Username]\.xmlassistant\icons

(Tan pronto como se encuentre al menos un icono en uno de estos directorios, solo estarán disponibles los iconos definidos por el usuario)

Descargar: XML_Assistant_Icons.zip de archivos con todos los iconos (370 iconos)

Ejemplo: Algunos iconos

Algunos iconos se encuentran en el directorio C:\Users\[Username]\.xmlassistant\icons

Estos iconos ahora se pueden seleccionar:

Se pueden definir otros iconos en las reglas de visualización. Si no existe ningún icono personalizado, se mostrará el icono del programa.

4. Más consejos

4.1 Mostrar más contenido en el árbol 

La vista de árbol puede mostrar más contenido para los elementos XML mostrados, como:

• Atributos: Los atributos de este elemento
• Espacios de nombres
• Contenido de texto: el texto de este elemento (excluyendo los elementos secundarios)
• Elementos secundarios: elementos secundarios que no tienen contenido adicional

4.2 Mostrar también elementos con atributos/subelementos 

El XML Assistant oculta tanto como sea posible de los archivos XML. Esto le permite concentrarse en el contenido. Pero en algunos casos también le gustaría mostrar elementos con atributos o subelementos en el panel de edición (derecha). Esto puede ser necesario para, por ejemplo, cambiar el orden de los elementos. Para ello, active la opción "Ver -> Elementos con contenidos".

Esto dará lugar también a que se enumeren estos elementos.

4.3 "Saltar" a Sub Elemento + Selección Múltiple 

Al presionar la tecla CTRL (o ALT) y mover el cursor sobre un campo que representa un elemento con elementos secundarios, el cursor del mouse cambia. Al hacer clic con el botón derecho, saltará a este elemento.

Al hacer clic con el botón izquierdo del ratón cuando CTRL está abajo, la entrada en la que se ha pulsado se agrega a la selección.

4.4 Reorganizar campos de texto y nodos de árbol 

Para mover contenido, haga clic en él o selecciónelo, mantenga presionada la tecla CTRL y mueva la rueda del ratón hacia arriba o hacia abajo.

5. Comience ahora

Esta documentación cubre las funciones principales de XML Assistant, pero no todas.

Esperamos que disfrute del uso de nuestro software.