> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Conexiones y acciones

> Cómo una función del Panel Dev se conecta al script: configuración, función del servidor o colección, y qué envía cada botón.

El campo `connect` de `funcao.json` indica de dónde saca los datos la pantalla y adónde van.

| `type` | Lee | Guarda | Acciones `@call` |
| - | - | - | - |
| `config` | Los campos de `keys` | Los campos de `keys` | No |
| `function` | Lo que devuelva la función | Lo que decida la función | Sí |
| `collection` | Hasta 100 registros | No (solo lectura) | No |

## config — configuración remota

```json theme={null}
{ "connect": { "type": "config", "keys": ["aviso_ativo", "aviso_texto", "aviso_cor"] } }
```

* De 1 a 40 campos.
* Al abrir y en `@reload`: muestra solo esos campos.
* En `@save`: guarda solo esos campos; el resto de la configuración queda igual.
* El script lee los valores en `window.DoglyScript.config`, sin publicar una versión nueva.

## function — función del servidor

```json theme={null}
{ "connect": { "type": "function", "name": "cupons" } }
```

`name` es el nombre de una función del servidor del script (letras, números, `_` y `-`, hasta 64). Recibe en `request.body.panel`:

| Campo | Valor |
| - | - |
| `function` | El id de la función del panel, ej.: `"cupons"` |
| `op` | `"load"` (al abrir y en `@reload`), `"save"` (en `@save`) o `"call"` (en `@call:nombre`) |
| `action` | El `nombre` de `@call:nombre`, o `null` |
| `values` | Los valores actuales de la pantalla |

Y responde con:

| Campo | Qué hace |
| - | - |
| `values` | Actualiza los campos de la pantalla (objeto) |
| `rows` | Lista para `dt-table` (hasta 200) |
| `message` | Aviso corto mostrado después de la acción (hasta 200 caracteres) |

```js theme={null}
function handler(request) {
  const p = request.body.panel;

  if (p.op === "load") {
    return doglytdc.respond(200, {
      values: { ativos: 2, usos: 31, tipo: "pct", lista: [
        { codigo: "BIENVENIDO10", tipo: "pct", desconto: 10, usos: 25 },
        { codigo: "VIP", tipo: "valor", desconto: 5, usos: 6 },
      ] },
    });
  }

  if (p.op === "call" && p.action === "criar") {
    if (!p.values.codigo) return doglytdc.respond(400, { error: "Escribe el código." });
    return doglytdc.respond(200, { message: "Cupón creado." });
  }

  return doglytdc.respond(200, { values: p.values, message: "Guardado." });
}
```

* Una respuesta con estado 400 o más muestra el `error` en la pantalla.
* Nunca devuelvas contraseñas, claves ni tokens: todo lo que vuelve aparece en pantalla.

> [!NOTE]
>
> La carpeta del servidor del script tendrá su propia documentación. Aquí solo está lo que recibe y devuelve la función del Panel Dev.

## collection — colección (solo lectura)

```json theme={null}
{ "connect": { "type": "collection", "name": "acessos" } }
```

* Muestra hasta **100** registros en `dt-table` (y números en `dt-stat`).
* Los campos de entrada y `@save` se rechazan en la validación.
* `@reload` funciona.

## Quién puede usarlo

Cada acción se comprueba en el servidor: solo el dueño del script llama a las funciones creadas desde el código. Un colaborador recibe `OWNER_ONLY`, incluso llamando a la API directamente.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.