Árboles

Muchas implementaciones y productos integrables usan ampliamente las estructuras de árbol de Interface de Usuario para desplegar relaciones jerárquicas entre registros del sistema. El marco proporciona objetos para definir una estructura de árbol y las reglas sobre cómo completar los nodos del árbol, y también ofrece procesos para interpretar la configuración y representar dinámicamente el despliegue del árbol.

En los temas de esta sección, se proporciona información acerca de lo que se incluye en el marco. Es posible que su producto incluya componentes de Interface de Usuario con árboles listos para usar destinados a casos de uso comunes. Para obtener más información, consulte la documentación del producto.

Atributos Comunes de Árboles

En su organización, puede haber muchos portales y zonas que muestren datos en un árbol jerárquico. La mayoría de los árboles del sistema siguen un patrón similar:

Los árboles tienen varios niveles. Puede haber diferentes tipos de nodos de árbol presentes en un nivel determinado; por ejemplo, una lista de tipos de algoritmos para un script, seguida de una lista de pasos del script. Se pueden desplegar íconos para identificar mejor el tipo de objeto del nodo.
Los tipos de nodos más comunes hacen referencia a una entidad dentro del sistema, como un esquema, un script, un área de datos, etc. Estos nodos generalmente despliegan la cadena de información de la referencia de Clave Foránea de la entidad y brindan la capacidad de navegar hasta la entidad. También pueden permitir que el contexto del nodo se difunda a otras zonas del portal.
Además de la capacidad de navegar hasta la entidad asociada, muchos tipos de nodos ofrecen un menú contextual con rutas de navegación adicionales.
Algunos nodos son simplemente informativos y se utilizan para agrupar un juego de nodos secundarios debajo de un tipo o una categoría. Por ejemplo, el árbol Opciones del objeto de negocio agrupa los nodos de valor de opción debajo de los nodos de resumen que describen el tipo de opción.

Cada árbol define los nodos que lo componen y la relación principal/secundaria entre esos nodos. Un nodo de árbol define cuáles de los atributos comunes son aplicables al nodo y cuáles son los algoritmos responsables de recuperar los datos del nodo y, opcionalmente, determinar la información del nodo que se desplegará.

Algoritmo Completar Nodo

Un nodo de árbol despliega una combinación de los atributos antes mencionados, generalmente para un objeto en contexto. Para un nodo raíz, el objeto suele derivarse de un valor de contexto global o de portal, como el script actual. Para cada nodo de nivel inferior, el contexto se deriva de los campos de contexto de su fila principal; por ejemplo, los algoritmos correspondientes a un tipo de algoritmo específico.

La responsabilidad clave del algoritmo Completar Nodo es recibir el código del árbol, el nombre del nodo y el valor (o los valores) del contexto principal; determinar si existen datos que se deban mostrar para este nodo; y devolver una lista de los valores y campos de contexto aplicables a cada fila del nodo. A continuación, se describe qué otro tipo de información opcional puede devolver el algoritmo:

Información de entidad. Si el nodo está relacionado con una entidad específica, se pueden devolver el código de objeto de mantenimiento y los valores de clave primaria. Estos valores se usan para determinar la información por defecto del nodo, incluidos los detalles de navegación.
Un valor de ícono de despliegue. Este valor se usa para sustituir el ícono definido en el nodo de árbol o el ícono por defecto para la entidad, según lo definido en el objeto de mantenimiento o el objeto de negocio.
Una cadena de información. Esta cadena se puede usar para sustituir la cadena de información por defecto de una entidad o para desplegar texto independiente, como un resumen o una descripción de los nodos secundarios que siguen.

Nota: El algoritmo Completar Nodo es responsable de devolver todos los valores de contexto necesarios para completar los nodos secundarios. En el caso de un nodo informativo o de resumen, esto puede requerir que se incluyan los campos de contexto principal del nodo en su propio contexto. Por ejemplo, en el árbol de script, el nodo de resumen que describe el número de pasos está seguido por una lista de pasos para el script. El algoritmo Completar Nodo del nodo de resumen debe incluir el código de script transmitido como contexto principal en la lista de contexto de salida, de modo que los pasos se recuperen correctamente.

Algoritmo Sustituir Información

El algoritmo Sustituir Información tiene dos propósitos principales:

Proporcionar texto de información alternativa para un nodo de árbol cuando la información ofrecida no es adecuada para la implementación.
Recuperar información detallada contextual relacionada con la entidad de nodo de árbol e incluirla en el texto de información del nodo. Por el momento, solo se soportan los tipos de información detallada de placa.

El algoritmo Sustituir Información recibe el código del árbol, el nombre del nodo, el objeto de mantenimiento y los valores de clave principal para el nodo. A continuación, se describe la información que puede devolver el algoritmo:

Un valor de ícono de despliegue.
Una cadena de información. Esta cadena se utilizará para sustituir la cadena de información por defecto en la cadena formateada del nodo.
Texto completo del nodo. Esto se utilizará como el texto completo para el despliegue y sustituirá el formato definido en el nodo.
Una lista de los tipos de información detallada de placa y su contexto.

Nota: Si el algoritmo Sustituir Información devuelve tipos de información detallada para la entidad, también es responsable de devolver todos los valores de contexto necesarios para esos tipos de información detallada. Consulte Información Detallada Contextual para obtener más información.

Preparación de un Nodo para Despliegue

En la siguiente sección, se describen los pasos clave para obtener los datos de un nodo y formatearlos para su despliegue.

Determinación del Contenido del Nodo

Para recuperar los componentes que forman parte del despliegue del nodo del árbol, se realizan los siguientes pasos:

Se llama al algoritmo Completar Nodo para determinar todos los nodos de instancia correspondientes al nodo del árbol junto con sus detalles relacionados.
Se llama al algoritmo Sustituir Información para cada instancia de nodo a fin de permitir la sustitución opcional de los detalles relacionados con la presentación.

El contenido de despliegue del nodo se determina de la siguiente manera:

El ícono se determina a partir de los siguientes orígenes, en orden: definición de nodo de árbol, valor de algoritmo Sustituir Información, valor de algoritmo Completar Nodo, valor por defecto de objeto de mantenimiento/objeto de negocio.
El uso de la difusión está determinado por la configuración en la definición de nodo de árbol.
La cadena de información se determina a partir de los siguientes orígenes, en orden: valor de algoritmo Sustituir Información, valor de Completar Nodo, algoritmo de información de objeto de mantenimiento/objeto de negocio. Si la cadena se deriva del algoritmo de Objeto de Mantenimiento/Objeto de Negocio, se utiliza el texto de información abreviado cuando está disponible; de lo contrario, se utiliza la información standard.
El uso del menú contextual está determinado por la configuración de la definición de nodo de árbol.
El sistema soporta un estilo diferente para las filas de encabezado, incluida una fuente más grande. El uso del estilo de encabezado está determinado por la configuración de la definición de árbol y solo se aplica si el nodo es un nodo raíz con una sola instancia.

Formato de Texto de Nodo

El texto de los nodos que hacen referencia a una entidad del sistema generalmente incluye la combinación de una etiqueta, la clave de entidad y una cadena de información. La configuración del nodo proporciona un campo de etiqueta y un campo de cadena de formato de sustitución que puede usarse para definir el formato de texto del nodo. La cadena de formato define cuál de los tres componentes debe incluirse en el texto, el orden de esos componentes y cualquier texto cercano y marcas HTML. Por ejemplo, una cadena con formato "%label - %key - %info" dará como resultado un texto de nodo similar al ejemplo siguiente:

Formato de Nodo de Árbol

Si la cadena de formato está en blanco, el texto por defecto incluirá únicamente "%info". Si se configura un algoritmo de sustitución de información que devuelve el texto completo del nodo, el texto se presenta sin ningún formato adicional.

Expansión Automática

Si la definición de nodo de árbol indica que el nodo debe expandirse, el sistema buscará y desplegará automáticamente los datos de su nodo secundario. Este procesamiento continúa hasta que no haya más nodos secundarios marcados para expansión.

Árboles Entregados con el Producto Base

Los árboles son datos del sistema y es posible que el producto incluya varios árboles listos para usar. Puede optar por personalizar un árbol entregado con el producto base de las siguientes maneras:

Puede agregar sus propios nodos a una definición de árbol existente.
Puede sustituir la cadena de información de un nodo y especificar su propio algoritmo Sustituir Información. Si se configura un algoritmo de sustitución base en el nodo, el algoritmo personalizado debe conectarse a un número de secuencia más alto para que tenga prioridad sobre el algoritmo base.

Representación de un Árbol

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

Nota: Consulte Incluir un Componente Web para obtener más información.