advpl-dicionario-sxlisted

# advpl-dicionario-sx — Dicionário de dados Protheus O **Dicionário SX** é o conjunto de tabelas de metadados que controlam estrutura, apresentação, validação e comportamento de tudo no Protheus. **Parte do código-fonte do Protheus está no dicionário** — alterar SX3, SX7, SXB muda comportamento sem recompilar. A partir da **v0.3.0 do plugadvpl** (Universo 2), o dicionário SX é ingerido via `/plugadvpl:ingest-sx <pasta-csv>` e cruzado com fontes via `/plugadvpl:impacto <campo>` (killer feature). Veja `[[advpl-dicionario-sx-validacoes]]` pra detalhes das expressões ADVPL embutidas em `X3_VALID`/`X7_REGRA`/`X1_VALID`. ## Quando usar - Usuário pede para "criar campo", "adicionar parâmetro `MV_*`", "criar gatilho", "criar pergunta", "criar consulta F3", "F3 lookup". - Investigar por que um campo aparece/desaparece (provavelmente `X3_USADO`/`X3_WHEN`). - Customizar comportamento sem mexer em fonte (preferir SX a PE quando possível). - Diagnose "campo custom não aparece no cadastro" — checar `X3_USADO`, `X3_FOLDER`, browse default. - Análise de impacto: `/plugadvpl:impacto A1_COD` cruza referências do campo em fontes + SX3 + SX7 + SX1. ## Mapa das tabelas SX | Tabela | Função | Tabela no plugadvpl (após `ingest-sx`) | Cardinalidade típica | |--------|---------------------------------------------|----------------------------------------|------------------------| | SX1 | Perguntas (`Pergunte`/`ParamBox`) | `perguntas`