SAP — Set checkbox

Tipo: sap-set-checkbox · Paquete: SAP Activities v1.0.5

Marca o desmarca una casilla de SAP, como “Ejecución de prueba”, “Mostrar detalle” o cualquier opción de sí o no en una pantalla de selección.

Cómo funciona

Espera a que SAP termine lo que esté procesando, busca la casilla por su selector y la deja en el estado que indicas con checked: marcada (true, el valor por defecto) o desmarcada (false).

La actividad fija el estado, no lo alterna. Si la casilla ya estaba como pediste, queda igual. Así el resultado es siempre el mismo sin importar cómo encontró el robot la pantalla.

Si la casilla todavía no está en pantalla, la actividad la espera hasta el plazo configurado (timeout o el elementTimeout del ámbito, 30 segundos por defecto).

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
`selector`	`selector`	—	La casilla. Selector capturado o id de SAP, por ejemplo `wnd[0]/usr/chkP_TEST`.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanSapSession`	—	Sesión de SAP. Omítela dentro del `body` de un SAP — Attach o SAP — Log on.
`checked`	`bool`	`true`	`true` para marcar, `false` para desmarcar. También acepta una expresión que devuelva `true` o `false`; vacío cuenta como `true`.
`timeout`	`number`	—	Segundos que se espera a que aparezca la casilla. Manda sobre el `elementTimeout` del ámbito. Vacío usa el del ámbito (30 por defecto); `0` falla al primer intento. Admite decimales.

Salida

Esta actividad no devuelve ningún valor.

Errores comunes

Mensaje	Causa y solución
`El componente '…' no existe en la sesión de SAP. Se esperó … s a que apareciera. La pantalla actual es … dynpro … (transacción …). …`	El elemento no apareció en el plazo. El mensaje dice en qué pantalla está la sesión: casi siempre es otra distinta de la esperada (un diálogo delante, un paso que no se dio). Si la pantalla tarda, sube `timeout`.
`'checked' debe ser true o false; se recibió '…'.`	La expresión de `checked` no dio `true` ni `false`.

Además, los errores comunes a todas las actividades.

Ejemplo

Desmarcar la opción de ejecución de prueba antes de ejecutar un informe:

SAP — Run transaction   code = "ZREPORTE01"
SAP — Set text   selector = "wnd[0]/usr/ctxtP_BUKRS"   value = "1000"
SAP — Set checkbox   selector = "wnd[0]/usr/chkP_TEST"   checked = false
SAP — Send key   key = F8

Actividades relacionadas

SAP — Select radio — para opciones excluyentes (una de varias).
SAP — Set text — llenar campos de texto.
SAP — Send key — ejecutar la pantalla con F8.