¿Qué hace esta tabla?

La tabla sup_uiMenuComponentCustomization le permite controlar qué opciones aparecen en las pestañas del panel lateral del configurador, y en qué orden. Ejemplos de lo que puede hacer:

Mover Frame Spacing de la pestaña Style a la pestaña Materials
Mover Frame Spacing a la pestaña Doors & Windows
Reordenar las opciones dentro de una pestaña (p. ej. poner Roof Pitch antes de Roofing)
Eliminar las opciones predeterminadas de una pestaña y definir una disposición completamente personalizada

El concepto más importante: dos capas separadas

Cada menú del configurador tiene dos capas de contenido completamente separadas. Esta tabla solo controla una de ellas.

Capa	Qué es	¿Puede esta tabla moverla?
Contenido de la plataforma	Opciones siempre presentes integradas en el menú por Boost (p. ej. el selector de Siding en Materials, los campos de Width/Length/Height en Size, los selectores de Color en Colors, el editor de paredes en Doors & Windows)	❌ No: siempre se muestra, no se puede mover ni eliminar
Opciones configurables	Opciones que se pueden colocar, mover o reordenar entre pestañas, como Frame Spacing, Roof Pitch, Roof Overhang, Wind Bracing, etc.	✅ Sí: esto es lo que controla la tabla

⚠️ Esta tabla no puede mover el contenido de la plataforma. Por ejemplo, el selector del panel de Siding siempre aparecerá en la pestaña Materials, sin importar lo que haya en esta tabla. Puede agregar otras opciones a su alrededor, pero no puede eliminarlo ni moverlo a otra pestaña.

Qué hay siempre en cada pestaña (contenido de la plataforma)

El siguiente contenido está codificado en cada menú por Boost. Esta tabla no puede afectarlo:

Pestaña	Siempre presente (contenido de la plataforma)
Style	Selector de iconos de estilo y selector de grupo de estilos
Size	Campos de Width, Length y Eave Height
Materials	Selector de Side Wall Siding Panels, y selectores de Gauge, Engineer Certified y Snow Load
Colors	Todos los selectores de grupos de color
Doors & Windows	Editor de paredes y disposiciones del edificio
Interior	Selectores de Insulation, Interior Wall, Interior Roof y Loft
Sections Properties	Atajos de paredes Fully Enclosed / Fully Open / Gable Ends / Custom, botón de tack room, botón de almacenamiento y cuadrícula de lean section

¿Qué opciones puede mover y a dónde pueden ir?

Las opciones que puede controlar con esta tabla se llaman opciones configurables. Cada plataforma (carports y sheds) tiene su propia lista. Una opción se puede colocar en cualquiera de las pestañas indicadas para esa plataforma.

⚠️ Los nombres de clave deben coincidir exactamente. Dos errores comunes: la clave del selector de tipo de truss es trusses (no truss), y la clave del selector de trim es trim-package (no trim). Usar la ortografía incorrecta hace que la fila se ignore silenciosamente sin ningún error.

Carports: opciones configurables que puede colocar y mover

Estas 18 opciones se pueden colocar en cualquier pestaña de carport indicada en la siguiente sección:

Clave de opción	Qué es
`installation-surface`	Selector de superficie de instalación
`roofing`	Material del techo
`roof-pitch`	Selector de inclinación del techo
`roof-snoop`	Roof snoop
`bracket`	Estilo de soporte
`frame-spacing`	Opciones de espaciado de marco y truss (ambas viven aquí)
`roof-overhang`	Voladizo del techo
`rain-gutter`	Canalón de lluvia
`trusses`	Selector de tipo/estilo de truss (p. ej. sunburst, triple wide, commercial), no el espaciado de truss. ⚠️ La clave es `trusses` (con una s); `truss` se ignora silenciosamente. Es mejor colocarlo en Style o Doors & Windows; evite las pestañas Materials, Size, Colors e Interior.
`leg`	Estilo de pata
`leg-footprint`	Huella de la pata
`ceiling`	Techo interior
`panel-gauge`	Calibre del panel
`brace`	Refuerzo
`roof-extension`	Extensión del techo
`trim-package`	Paquete de molduras. ⚠️ La clave es `trim-package`; `trim` se ignora silenciosamente.
`wind-bracing`	Refuerzo contra viento
`j-trim`	J-trim

⚠️ Cualquier clave de opción que no esté en esta lista se ignorará silenciosamente: sin mensaje de error, simplemente no aparecerá.

Carports: qué pestañas pueden recibir opciones configurables

Puede colocar cualquiera de las 18 opciones de carport anteriores en cualquiera de estas pestañas:

Style: pestaña predeterminada para la mayoría de las 18 opciones. Aquí aparecen a menos que las mueva.
Size: aparece después de los campos de plataforma Width/Length/Height
Materials: aparece después de los selectores de plataforma Siding/Gauge/Snow Load
Doors & Windows: aparece después del editor de paredes de la plataforma
Colors: aparece después de los selectores de color de la plataforma
Interior: aparece después de los selectores interiores de la plataforma
Sections Properties: pestaña predeterminada para wind-bracing y j-trim

Sheds: opciones configurables que puede colocar y mover

Estas 23 opciones se pueden colocar en cualquier pestaña de shed indicada en la siguiente sección:

Clave de opción	Qué es
`installation-surface`	Superficie de instalación
`siding-group`	Selector de grupo de siding
`siding`	Selector de siding
`trim-package`	Paquete de molduras. ⚠️ La clave es `trim-package`; `trim` se ignora silenciosamente.
`porch`	Opción de porche
`porch-depth`	Profundidad del porche
`porch-length`	Longitud del porche
`porch-sidewall-depth`	Profundidad de la pared lateral del porche
`porch-railing`	Barandilla del porche
`sidewall-height`	Altura de la pared (altura de la pared lateral)
`roofing`	Material del techo
`roof-pitch`	Inclinación del techo
`roof-snoop`	Roof snoop
`bracket`	Estilo de soporte
`roof-overhang`	Voladizo del techo
`rain-gutter`	Canalón de lluvia
`ceiling`	Techo interior
`roof-extension`	Extensión del techo
`base`	Opción de base
`skylight`	Tragaluz (predeterminado: pestaña Doors & Windows)
`insulation`	Aislamiento (predeterminado: pestaña Interior)
`flooring`	Piso: siempre se muestra en la pestaña Flooring; no se puede reposicionar
`floor-joist`	Vigueta de piso: siempre se muestra en la pestaña Flooring; no se puede reposicionar

⚠️ Cualquier clave de opción que no esté en esta lista se ignorará silenciosamente: sin mensaje de error, simplemente no aparecerá.

Sheds: qué pestañas pueden recibir opciones configurables

Style: pestaña predeterminada para la mayoría de las opciones de shed
Size: aparece después de los campos de plataforma Width/Length/Height
Doors & Windows: pestaña predeterminada para skylight
Colors: aparece después de los selectores de color de la plataforma
Interior: pestaña predeterminada para insulation

Cómo funciona cada columna

Columna	Qué hace
`component`	La clave de opción que está colocando (p. ej. `frame-spacing`). Debe coincidir exactamente con la clave de la lista válida anterior; incluso una pequeña diferencia de ortografía hace que la fila se ignore silenciosamente.
`menu`	En qué pestaña debe aparecer la opción (p. ej. `material`, `doors-windows`, `style`). Debe ser una pestaña de destino válida para esta plataforma.
`priorComponent`	Qué opción debe ir inmediatamente antes de esta. Déjelo en blanco / nulo para que sea la primera en la pestaña. Así es como funciona el orden: la columna `order` se ignora en Boost.
`doNotAddDefaultComponents`	Establézcalo en `1` para suprimir las opciones predeterminadas de la pestaña y empezar desde cero. Establézcalo en `0` para mantener los valores predeterminados y agregar su opción encima. Consulte la siguiente sección para conocer advertencias importantes.
`control`	Cómo se muestra la opción: `radio` (predeterminado), `dropdown` o `compact-dropdown`.
`enabled`	Interruptor estándar de activado/desactivado. Las filas deshabilitadas son filtradas por la API de authoring antes de que los datos lleguen a Boost; desmarcar una fila impide que surta efecto.
`order`	⚠️ Ignorado en Boost. Esto lo usaba el antiguo configurador clásico. Para el orden en Boost, use solo `priorComponent`.

Pestañas con opciones configurables predeterminadas

La mayoría de las pestañas comienzan sin opciones configurables predeterminadas: usted coloca todo manualmente. Las siguientes pestañas vienen prepobladas con opciones predeterminadas que puede reordenar, eliminar (usando doNotAddDefaultComponents) o ampliar:

Pestaña	Plataforma	Opciones configurables predeterminadas
Style	Carports	Las 16 claves de opción de carport (installation-surface, roofing, roof-pitch, roof-snoop, bracket, frame-spacing, roof-overhang, rain-gutter, trusses, leg, leg-footprint, ceiling, panel-gauge, brace, roof-extension, trim-package)
Style	Sheds	Las 19 claves de style de shed (installation-surface, siding-group, siding, trim-package, porch, porch-depth, porch-length, porch-sidewall-depth, porch-railing, sidewall-height, roofing, roof-pitch, roof-snoop, bracket, roof-overhang, rain-gutter, ceiling, roof-extension, base)
Sections Properties	Carports	`wind-bracing`, `j-trim`
Doors & Windows	Sheds	`skylight`
Interior	Sheds	`insulation`

Todas las demás pestañas (Size, Materials, Colors, Doors & Windows para carports, Interior para carports, etc.) no tienen opciones configurables predeterminadas. Solo muestran contenido de la plataforma a menos que agregue opciones explícitamente mediante esta tabla.

Cuándo suprimir los valores predeterminados (doNotAddDefaultComponents)

Establecer doNotAddDefaultComponents = 1 en una fila le indica a Boost: "No muestres las opciones predeterminadas de esta pestaña; muestra solo lo que he definido explícitamente."

Cuándo importa esta configuración: Solo en las pestañas que tienen opciones configurables predeterminadas (vea la tabla anterior: Style, Sections Properties para carports; Style, Doors & Windows, Interior para sheds). Usarla en cualquier otra pestaña no tiene efecto porque no hay valores predeterminados que suprimir.

Lo que NO afecta: El contenido de la plataforma (selector de siding, campos de tamaño, selectores de color, editor de paredes, etc.) siempre se muestra sin importar esta configuración. doNotAddDefaultComponents solo suprime las opciones configurables, no el contenido de la plataforma.

⚠️ Importante: Si cualquier fila de una pestaña tiene esto establecido en 1, suprime los valores predeterminados de toda la pestaña, no solo de esa fila. No mezcle 0 y 1 en filas que apunten a la misma pestaña.

Cómo funciona el orden (priorComponent)

La columna order que puede ver en las filas existentes se ignora por completo en Boost. El orden se controla por completo mediante la columna priorComponent, que funciona como una lista enlazada:

priorComponent está en blanco o nulo → esta opción va primera en la pestaña
priorComponent: "roof-pitch" → esta opción va inmediatamente después de roof-pitch
Solo una fila por pestaña debe tener un priorComponent en blanco/nulo. Varias entradas en blanco causan un orden impredecible.
Si el componente referenciado no aparece en la lista resuelta, la opción se agrega al final.

Escenarios comunes

"Quiero mover Frame Spacing a la pestaña Materials"

Agregue una fila: component = frame-spacing, menu = material, priorComponent = nulo (o después de otra opción que ya esté en Materials), doNotAddDefaultComponents = 0.

Frame Spacing aparecerá debajo de los selectores siempre presentes de Siding / Gauge / Snow Load. Nota: frame-spacing representa las opciones de espaciado de marco y de truss en un solo bloque.

"Quiero mover Frame Spacing a la pestaña Doors & Windows"

Agregue una fila: component = frame-spacing, menu = doors-windows, priorComponent = null, doNotAddDefaultComponents = 0.

Frame Spacing aparecerá debajo del editor de paredes siempre presente.

"Quiero control completo sobre lo que aparece en la pestaña Style"

Agregue una fila por cada opción que quiera mostrar, cada una con doNotAddDefaultComponents = 1. La primera opción debe tener priorComponent = nulo. El priorComponent de cada opción posterior apunta a la anterior.

⚠️ Todas las filas de esa pestaña deben tener doNotAddDefaultComponents = 1; si incluso una fila tiene 0, los valores predeterminados se suprimen igualmente para toda la pestaña.

"Una opción no aparece aunque agregué una fila"

Verifique lo siguiente en orden:

¿La clave component está escrita exactamente como aparece en la tabla de claves válidas anterior? Errores comunes: truss en lugar de trusses, trim en lugar de trim-package. Las ortografías incorrectas se ignoran silenciosamente sin ningún error.
¿El valor de menu es una pestaña de destino válida para esta plataforma? (Apuntar a una pestaña no admitida también se ignora silenciosamente).
¿El valor de priorComponent apunta a una opción que realmente estará en la lista resuelta de esa pestaña?
¿Todas las filas de esta pestaña son coherentes en doNotAddDefaultComponents?
Si la opción es trusses, ¿se está colocando en Style o Doors & Windows? Colocarla en Materials, Size, Colors o Interior hará que se represente sin el contexto de sección que necesita.
¿El proveedor tiene otras filas habilitadas para este mismo componente que apunten a una pestaña diferente? Esa fila movería el componente allí en su lugar. Las filas deshabilitadas se excluyen y no interfieren.

Nota: si la opción que busca es contenido de la plataforma (p. ej. el selector de Siding, los campos de tamaño, los selectores de color), no se puede mover mediante esta tabla en absoluto; está codificada.

Lista de verificación rápida antes de guardar filas

✅ La clave component está escrita exactamente bien: trusses (no truss), trim-package (no trim)
✅ menu es una pestaña de destino válida para esta plataforma (no flooring-interior; use flooring)
✅ La cadena de priorComponent es correcta: un nulo por pestaña, cada opción apunta a la anterior
✅ doNotAddDefaultComponents es coherente en todas las filas de la misma pestaña
✅ No existen otras filas habilitadas para el mismo componente que apunten a una pestaña diferente
✅ No depende de la columna order; no tiene efecto en Boost
✅ Si usa trusses, lo coloca en Style o Doors & Windows, no en Materials/Size/Colors/Interior

Nota: Esta traducción fue generada por inteligencia artificial y puede contener errores.

Personalización del menú del configurador (sup_uiMenuComponentCustomization)