set_components_suppression
Apply the same suppression state to multiple components in a single call, reducing configuration switches for efficient BOM variant preparation.
Instructions
Cambiar el estado de varios componentes en una sola llamada.
Uso típico autopartes: preparación de variantes BOM ("suprime los 8
tornillos que el Base trim no incluye"). Más eficiente que un bucle
sobre set_component_suppression — cuando config_scope es "all" o
"specific", la implementación cambia de configuración una sola vez
por config y aplica todos los componentes en ese contexto.
[en: Apply the same suppression state to multiple components in one
call. Typical use: trim-variant BOM prep — suppress N fasteners
a Base trim doesn't include. Faster than looping
set_component_suppression: switches config once per config_scope
target instead of once per (component × config) pair.]
Args: component_names: List of SW component instance names from get_active_assembly_info. Must not be empty. All names are validated up-front; if any are missing the call raises before any change is made. state: "suppressed" | "resolved" | "lightweight". Default "suppressed". config_scope: "this" | "all" | "specific". config_names: Required when config_scope="specific".
Returns:
Dict with count (number applied), state (the applied state),
and components (list of {name, path, suppressed, state}).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | suppressed | |
| config_names | No | ||
| config_scope | No | this | |
| component_names | Yes |