Árboles

Muchos productos integrables e implantaciones hacen gran uso de las estructuras de árbol de la UI con el fin de mostrar las relaciones jerárquicas entre los registros del sistema. El marco incluye un objeto para definir una estructura de árbol y las reglas relativas al modo de relleno de los nodos del árbol, así como procesos para interpretar la configuración y representar de forma dinámica la visualización del árbol.

En los temas de esta sección se ofrece información sobre los elementos que incluye el marco. El producto puede incluir componentes de la UI con árboles generados preparados para los casos de uso más comunes. Consulte la documentación del producto para obtener más información.

Atributos comunes de los árboles

La organización puede disponer de muchos portales y zonas donde mostrar los datos en un árbol jerárquico. La mayor parte de los árboles del sistema siguen un patrón similar:

Los árboles tienen una serie de niveles. En un nivel determinado pueden existir distintos tipos de nodos de árboles como, por ejemplo, una lista de algoritmos para un script, seguida de una lista de pasos del script. Se pueden mostrar iconos para identificar de forma adicional el tipo de objeto del nodo.
Los tipos de nodos más comunes hacen referencia a una entidad del sistema como, por ejemplo, un esquema, un script, un área de datos, etcétera. Por lo general, estos nodos muestran la cadena de información de la referencia de clave externa de la entidad e incluyen la posibilidad de acceder a la entidad. También pueden permitir la difusión del contexto del nodo a otras zonas del portal.
Además de permitir el acceso a la entidad asociada, muchos tipos de nodos incluyen un menú contextual con rutas de navegación adicionales.
Algunos nodos son meramente informativos y se utilizan para agrupar un juego de nodos secundarios dentro de un tipo o categoría. Por ejemplo, el objeto de negocio de árbol de opciones agrupa los nodos de valor de opción en los nodos de resumen que describen el tipo de opción.

Cada árbol define los nodos que lo configuran y la relación principal/secundario entre ellos. Un nodo de árbol define qué atributos comunes son aplicables para él y los algoritmos que se encargan de recuperar los datos del nodo y, de forma opcional, de determinar la información del nodo que se muestra.

Algoritmo de relleno de nodo

Un nodo de árbol muestra una combinación de los atributos enumerados con anterioridad, por lo general para un objeto en contexto. En el caso de un nodo raíz, lo habitual será que el objeto se derive a partir de un valor de contexto global o de portal como, por ejemplo, el script actual. Para cada nodo de nivel inferior, el contexto quedará derivado a partir de los campos de contexto de la fila principal, por ejemplo, los algoritmos de un tipo de algoritmo específico.

La responsabilidad clave del algoritmo de relleno de nodo consiste en recibir el código del árbol, el nombre del nodo y el valor o valores de contexto principal; determinar si existen datos que deben aparecer para el nodo y devolver una lista de los campos y valores de contexto aplicables a cada fila del nodo. El algoritmo puede devolver los siguientes datos opcionales de información detallada:

Información de entidad. Si el nodo está relacionado con una entidad específica, podrían devolverse los valores de código de objeto de mantenimiento y de clave primaria. Se utilizan para determinar la información por defecto del nodo, incluidos los detalles de navegación.
Un valor de icono de visualización. Se utiliza para sustituir el icono definido en el nodo de árbol y/o el icono por defecto para la entidad, según se define en el objeto de mantenimiento o de negocio.
Una cadena de información. Se puede utilizar para sustituir la cadena de información por defecto para una entidad, o para mostrar el texto autónomo como un resumen o descripción de los nodos secundarios que seguir.

Nota: el algoritmo de relleno de nodo se encarga de devolver todos los valores de contexto necesarios para rellenar los nodos secundarios. En el caso de un nodo informativo o de resumen, puede precisar la inclusión de los campos de contexto principales del nodo en su propio contexto. Por ejemplo, en el árbol de script, el nodo de resumen que describe el número de pasos va seguido de una lista de pasos para el script. El algoritmo de relleno de nodo de resumen debe incluir el código de script transferido como contexto principal en la lista de contextos de salida, para que los pasos puedan recuperarse de forma correcta.

Algoritmo de sustitución de información

El algoritmo de sustitución de información tiene dos fines principales:

Ofrece un texto de información alternativa para un nodo de árbol cuando la información incluida no es adecuada para la implantación.
Recupera información detallada contextual relacionada con la entidad de nodo de árbol, para su inclusión en el texto de información del nodo. Actualmente, solo se soportan tipos de información detallada de placa.

El algoritmo de sustitución de información recibe el código de árbol, el nombre de nodo, el objeto de mantenimiento y los valores de clave primaria para el nodo. A continuación, se resalta la información que puede devolver el algoritmo:

Un valor de icono de visualización.
Una cadena de información. Se utilizará para sustituir la cadena de información por defecto en la cadena con formato del nodo.
Texto de nodo completo. Se utilizará como texto completo en la visualización, sustituyendo el formato definido en el nodo.
Una lista de tipos de información detallada de placa y su contexto.

Nota: si el algoritmo de sustitución de información devuelve tipos de información detallada para la entidad, también se encargará de devolver todos los valores de contexto necesarios para estos tipos de información detallada. Para obtener más información, consulte Información detallada contextual.

Preparación de un nodo para visualización

En la siguiente sección se resaltan los pasos clave para recuperar los datos de un nodo y aplicar el formato para la visualización.

Determinación de contenido de nodo

Para recuperar los componentes que configuran la visualización del nodo de árbol se realizan los pasos siguientes:

Se llama al algoritmo de relleno de nodo para determinar todos los nodos de instancia para el nodo de árbol, junto con los detalles relacionados.
Se llama al algoritmo de sustitución de información para cada instancia de nodo, para permitir la sustitución opcional de los detalles relacionados con la presentación.

El contenido de visualización del nodo se determina de la siguiente manera:

El icono queda determinado por los orígenes siguientes, por este orden: definición de nodo de árbol, valor de algoritmo de sustitución de información, valor de algoritmo de relleno de nodo, valor por defecto de objeto de mantenimiento/objeto de negocio.
El uso de difusión lo determina el valor de la definición de nodo de árbol.
La cadena de información queda determinada por los orígenes siguientes, por este orden: valor de algoritmo de sustitución de información, valor de algoritmo de relleno de nodo, algoritmo de información de objeto de mantenimiento/objeto de negocio. Si la cadena se deriva a partir del algoritmo de objeto de mantenimiento/objeto de negocio, se utilizará el texto de información breve cuando esté disponible; en caso contrario, se utilizará la información estándar.
El uso de menú contextual lo determina el valor de la definición de nodo de árbol.
El sistema soporta un estilo distinto para filas de cabecera, incluyendo una fuente de mayor tamaño. El uso del estilo de cabecera lo determina el valor de la definición de árbol y solo es aplicable si se trata de un nodo raíz con una única instancia.

Formato de texto de nodo

Por lo general, el texto para los nodos que hacen referencia a una entidad de sistema, incluye alguna combinación de etiqueta, clave de entidad y cadena de información. La configuración de nodo incluye un campo de etiqueta y un campo de cadena de formato de sustitución, que puede utilizarse para definir el formato de texto de nodo. La cadena de formato define cuál de los tres componentes debe incluirse en el texto, el orden de dichos componentes y el texto y marcas HTML que lo rodean. Por ejemplo, una cadena de formato ‘%label - %key - %info’ dará como resultado un texto de nodo como el que aparece a continuación:

Formato de nodo de árbol

Si la cadena de formato está en blanco, el texto por defecto incluirá solo ‘%info’. Si se configura un algoritmo de sustitución de información que devuelve el texto de nodo completo, el texto aparecerá sin formato adicional.

Ampliación automática

Si la definición de un nodo de árbol indica que debe ampliarse el nodo, el sistema lo recuperará de forma automática y mostrará los datos para el nodo secundario. Este procesamiento continuará hasta que no haya más nodos secundarios marcados para expansión.

Árboles entregados base

Los árboles son datos del sistema; el producto puede incluir varios árboles listos para usar. Existe la opción de personalizar un árbol base de las formas siguientes:

Se pueden añadir nodos propios a una definición de árbol existente.
Se puede sustituir la cadena de información para un nodo, incluyendo un algoritmo de Sustitución de información propio. Si se ha configurado un algoritmo de sustitución base en el nodo, deberá conectarse el algoritmo personalizado en un número de secuencia mayor, de forma que tenga prioridad sobre el algoritmo base.

Representación de un árbol

Para representar un árbol en la UI, deberá incluir el componente web ou-tree en un mapa de UI que haga referencia a la definición de árbol.

Nota: para obtener más información, consulte Inclusión de un componente web.