advpl-jobs-rpc â Execução headless no Protheus
openbooklet.com/s/advpl-jobs-rpc-execuo-headless-no-protheusopenbooklet.com/s/[email protected]GET /api/v1/skills/advpl-jobs-rpc-execuo-headless-no-protheusQuando o Protheus precisa executar código **sem usuário humano logado** (cron-like jobs, scheduler, integrações batch, RPC chamado por sistema externo), o entrypoint não é `User Function` â é **`Main Function`** disparada via configuração do `appserver.ini` ou via `StartJob`/`CallProc`/`M
**Killer feature do v0.6.0** (Universo 4 â Qualidade & Métricas). Mostra **% de funções com header Protheus.doc por módulo** â pra responder "qual área está sem documentação?".
Orquestra o ciclo completo de dev: **compila o fonte, restarta o AppServer e (opcionalmente) confere se o REST voltou**. Não é um subcomando novo â é um wrapper instrutivo sobre [`/plugadvpl:compile`](../compile/SKILL.md) + [`/plugadvpl:tq`](../tq/SKILL.md) que evita o usuário ter que lembrar
Indexa o Dicionário SX (SX1..SXG + SIX) via REST API do `COLETADB.tlpp` instalado no AppServer Protheus do cliente. Substitui o workflow manual do `ingest-sx` (CSV exportado do Configurador) por **dump ao vivo via HTTP**.
Diagnostica arquivos de log Protheus em um único comando. Pipeline em 2 estágios:
**Killer feature do v0.6.0** (Universo 4 â Qualidade & Métricas). Responde **"por onde começar num refactor?"** via ranking de funções por complexidade.
Lista os matches entre as chamadas HttpClient do Angular e as rotas REST do Protheus (anotações `@Get`/`@Post` TLPP indexadas em `rest_endpoints`).
O catálogo `poui_componentes` contém **948 bindings `p-*`** (inputs e outputs) extraÃdos do repositório oficial `po-angular`. Cada entrada mapeia o atributo HTML (`p-columns`) para a propriedade TypeScript (`columns`) e o componente-pai (`po-table`).
Executa o `restart_cmd` configurado pro server (registry global) e espera o AppServer voltar via healthcheck HTTP (GET `/` retornando 200/401/404).
**Killer feature do v0.5.0** (Universo 4 â Trace Unificado). Substitui o workflow manual de **5 comandos** (`impacto` + `gatilho` + `tables` + `callers` + `execauto`) por **1 comando** que agrega TUDO que toca a entidade â atravessando os 3 universos do plugin.
**Killer feature do v0.4.0** (Universo 3 â Rastreabilidade). Lista os 4 mecanismos canônicos TOTVS de **execução não-direta** indexados pelo plugin:
ADVPL avançado cobre o que vai além do CRUD MVC básico: transações ACID, relatórios estruturados (TReport), manipulação de arquivos em massa (SPED, EDI), captura de informações multi-linha (grids dinâmicas fora de MVC), threads paralelas, OOP clássico, e técnicas de programação eficie
`plugadvpl` cataloga **35 regras de code review** para ADVPL/TLPP â **TODAS detectadas automaticamente** desde v0.3.27: **22 single-file** via regex/AST/lookup sobre o conteúdo do fonte, e **13 cross-file** â 12 que requerem `ingest-sx` (11 `SX-*` + `PERF-006` que cruza SQL embarcado com Ãndic
Catálogo dos 30 erros mais frequentes em produção Protheus, organizados por **sintoma** (o que aparece pro usuário ou no log) â **causa raiz** â **comando de diagnóstico** â **fix tÃpico**. Coberto em paralelo: ferramentas de debug do AppServer e métodos manuais quando não dá pra anex
ADVPL/TLPP suporta SQL embarcado direto no fonte com **substituição por macros** que garantem multi-empresa, multi-filial, anti-SQL-injection e portabilidade entre DBMS (Oracle, SQL Server, Postgres, DB2 via DBAccess).
Fontes ADVPL/TLPP em projetos Protheus reais misturam dois encodings:
ADVPL (Advanced Protheus Language) e seu sucessor TLPP (também chamado TL++) são linguagens proprietárias da TOTVS, derivadas do Clipper/xBase. Têm convenções fortes que **não são opcionais** em código de qualidade Protheus.
`MATXFIS` é a famÃlia de rotinas/funções fiscais do Protheus. Domina geração de **NF-e** (Nota Fiscal Eletrônica), **NFC-e**, **CT-e**, e integração com obrigações fiscais brasileiras: **SPED Fiscal**, **SPED Contribuições**, **ECF**, **EFD-REINF**, **GIA**, **DAPI**.
A skill `[[advpl-mvc]]` cobre criar cadastros MVC do zero. **Esta skill cobre o cenário muito mais comum**: customizar uma rotina MVC padrão TOTVS via Ponto de Entrada (`A300STRU`, `MA440STRU`, etc.) â adicionando grids filhas, gatilhos em cascata, validações preservando as originais, e contro
**Ponto de Entrada (PE)** é o mecanismo oficial TOTVS para customizar comportamento de rotinas padrão **sem alterar o fonte original**. Toda rotina Protheus principal tem dezenas de PEs cadastrados em pontos estratégicos (antes de validar, antes de gravar, antes de imprimir, etc.).
**TLPP** (também chamado **TL++**) é a evolução moderna do ADVPL lançada pela TOTVS para suportar paradigmas atuais: orientação a objetos completa, namespaces, annotations, exceções estruturadas, JSON nativo, reflection. Coexiste com ADVPL no mesmo RPO/tlpp.rpo â código TLPP chama ADVPL
Auto-indexed from JoniPraia/plugadvpl
Are you the author? Claim this skill to take ownership and manage it.
Related Skills
graceful-error-recovery
Use this skill when a tool call, command, or API request fails. Diagnose the root cause systematically before retrying or changing approach. Do not retry the same failing call without first understanding why it failed.
audience-aware-communication
Use this skill when writing any explanation, documentation, or response that will be read by someone else. Match vocabulary, depth, and format to the audience's expertise level before writing.
Refactoring Expert
Expert in systematic code refactoring, code smell detection, and structural optimization. Use PROACTIVELY when encountering duplicated code, long methods, complex conditionals, or any code quality issues. Detects code smells and applies proven refactoring techniques without changing external behavior.
Research Expert
Specialized research expert for parallel information gathering. Use for focused research tasks with clear objectives and structured output requirements.
clarify-ambiguous-requests
Use this skill when the user's request is ambiguous, under-specified, or could be interpreted in multiple ways. If proceeding with a wrong assumption would waste significant work, always ask exactly one focused clarifying question before doing anything.
structured-step-by-step-reasoning
Use this skill for any problem that involves multiple steps, tradeoffs, or non-trivial logic. Think out loud before answering to improve accuracy and transparency. Apply whenever the answer is not immediately obvious.