Manual de usuario para XML Assistant v1.2.2

Contenido:
1. Tutorial como introducción rápida
    1.1 Abrir archivos
    1.2 Editar y usar reglas
    1.3 Plantillas
2. Editar XML
    2.1 Funciones principales
    2.2 Administrar espacios de nombres
    2.3 Acceso directo
3. Reglas de edición
    3.1 Abra ejemplo y ajuste pestañas
    3.2 Organizar reglas
    3.3 Qué reglas son
    3.4 Opciones de visualización
4. Más consejos
    4.1 Mostrar también elementos con atributos/subelementos
    4.2 "Saltar" a Sub Elemento + Selección Múltiple
    4.3 Reorganizar campos de texto y nodos de árbol
5. Comience ahora


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: 1) 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.

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":

Para una vista más clara, minimizamos la vista de código XML y colocamos la pestaña 'Reglas de visualización' en la parte inferior.

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 a la parte inferior al final de la ventana principal. El cursor del ratón está cambiando durante la operación de arrastre.

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".

Al hacer clic con el botón derecho en el nodo raíz se abrirá el menú contextual. En el submenú "Plantilla" ya se puede ver una plantilla, que se ha definido para ser enumerada aquí.

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: Ayuda->Informatión/Licencia->"Browse: User Configuration Directory").

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 "Plantillas en el menú contextual" 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á ahora en la lista de menús contextuales.

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:

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:

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'.

La pestaña para editar los conjuntos de reglas está abierta. 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.

Para finalizar la preparación, minimice el código XML. No lo necesitaremos.

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" (1). Las opciones afectan al árbol (2: izquierda) y al panel de entrada (3: 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:

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

4. Más consejos

4.1 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 "Mostrar también elementos con atributos/subelementos".

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

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

Al presionar la tecla CTRL 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.

Lo mismo se puede lograr manteniendo presionada la tecla ALT y haciendo clic a la izquierda

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.3 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.