data-dictionary-lookup

Query Protheus ERP data dictionary metadata for tables, fields, indexes, and triggers.

115|54|Updated May 25, 2026
One-click install
npx skills add https://github.com/totvs/engpro-advpl-tlpp-skills --skill data-dictionary-lookup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: data-dictionary-lookup
Source: https://github.com/totvs/engpro-advpl-tlpp-skills/tree/main/skills/advpl-tlpp/data-dictionary-lookup
Command: npx skills add https://github.com/totvs/engpro-advpl-tlpp-skills --skill data-dictionary-lookup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the problem of not knowing how Protheus ADVPL/TLPP table metadata is structured, how fields relate, and what dictionary impact your changes may have.

Core Features & Use Cases

  • Dictionary discovery across SX catalogs*: look up table metadata, fields, indexes, triggers, parameters (MV_*), generic tables, parameterization questions, relationships, and standard lookups.
  • Impact validation for refactoring/migrations: confirm whether your planned code improvements affect fields, triggers, indexes, parameters, or relationships of the involved tables.
  • Query correctness rules: enforces soft-delete filtering and safe SQL patterns (lowercase columns, TRIM for character comparisons, base table names).
  • Use cases: “What fields does SA1 have?”, “Which index does SE1 use?”, “What is MV_ESTADO?”, “Triggers for field A1_COD?”, “Standard lookup for SA1 (SXB/F3)”, “Relationship between tables”.

Quick Start

Ask for the dictionary details by saying: Query the Protheus data dictionary for SA1 fields, including indexes and any triggers for A1_COD, and present the results in a clear markdown summary.

Frequently Asked Questions about data-dictionary-lookup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I look up Protheus data dictionary fields and indexes for a specific table?

To look up Protheus data dictionary fields and indexes, query the SX2, SX3, and SIX base tables. This validates metadata structure and confirms exact field definitions, index orders, and relationships to reduce uncertainty during ERP customization.

What are the mandatory SQL constraints for querying ADVPL dictionary metadata?

Mandatory SQL constraints for querying ADVPL dictionary metadata include applying soft-delete filtering, using lowercase column names, applying TRIM for character comparisons, and selecting base tables to prevent empty or incorrect query results.

How do I find triggers and standard lookups for Protheus tables like SA1?

To find triggers and standard lookups for Protheus tables like SA1, query the data dictionary for specific fields such as A1_COD and SXB/F3 configurations. This identifies validation triggers and standard lookup behavior attached to the table.

Can I validate the impact of code refactoring on Protheus MV parameters and triggers?

Yes, you can validate the impact of code refactoring on Protheus MV parameters and triggers by querying the data dictionary. This confirms whether planned code improvements affect existing parameters, triggers, or table relationships before migration.

Why do my Protheus dictionary queries return empty results for SX3 field metadata?

Protheus dictionary queries return empty results for SX3 field metadata when mandatory constraints are ignored. Failing to use lowercase columns, apply TRIM for character comparisons, or filter soft-deleted records prevents accurate base table data retrieval.