> ## 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.

# Ligações e ações

> Como uma função do Painel Dev se liga ao script: configuração, função do servidor ou coleção, e o que cada botão envia.

O campo `connect` do `funcao.json` diz de onde a tela tira os dados e para onde eles vão.

| `type` | Lê | Salva | Ações `@call` |
| - | - | - | - |
| `config` | Os campos de `keys` | Os campos de `keys` | Não |
| `function` | O que a função devolver | O que a função decidir | Sim |
| `collection` | Até 100 registros | Não (só leitura) | Não |

## config — configuração remota

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

* De 1 a 40 campos.
* Ao abrir e no `@reload`: mostra só esses campos.
* No `@save`: grava só esses campos; o resto da configuração fica como está.
* O script lê os valores em `window.DoglyScript.config`, sem publicar versão nova.

## function — função do servidor

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

`name` é o nome de uma função do servidor do script (letras, números, `_` e `-`, até 64). Ela recebe em `request.body.panel`:

| Campo | Valor |
| - | - |
| `function` | O id da função do painel, ex.: `"cupons"` |
| `op` | `"load"` (ao abrir e no `@reload`), `"save"` (no `@save`) ou `"call"` (no `@call:nome`) |
| `action` | O `nome` de `@call:nome`, ou `null` |
| `values` | Os valores atuais da tela |

E responde com:

| Campo | O que faz |
| - | - |
| `values` | Atualiza os campos da tela (objeto) |
| `rows` | Lista para `dt-table` (até 200) |
| `message` | Aviso curto mostrado depois da ação (até 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: "BEMVINDO10", 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: "Informe o código." });
    return doglytdc.respond(200, { message: "Cupom criado." });
  }

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

* Uma resposta com status 400 ou mais mostra o `error` na tela.
* Nunca devolva senhas, chaves ou tokens: tudo que volta aparece na tela.

> [!NOTE]
>
> A pasta do servidor do script vai ganhar uma documentação própria. Aqui está só o que a função do Painel Dev recebe e devolve.

## collection — coleção (só leitura)

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

* Mostra até **100** registros em `dt-table` (e números em `dt-stat`).
* Campos de entrada e `@save` são recusados na validação.
* `@reload` funciona.

## Quem pode usar

Toda ação é conferida no servidor: só o dono do script chama as funções criadas pelo código. Um colaborador recebe `OWNER_ONLY`, mesmo chamando a API direto.


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