odt-authoring

Design, validate, execute, and debug OmniDataTransform Extract and Transform mappers on Salesforce.

33|12|Updated Sep 24, 2024
One-click install
npx skills add https://github.com/bgaldino/rlm-base-dev --skill odt-authoring-bgaldino
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: odt-authoring
Source: https://github.com/bgaldino/rlm-base-dev/tree/main/.cursor/skills/odt-authoring
Command: npx skills add https://github.com/bgaldino/rlm-base-dev --skill odt-authoring-bgaldino

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? OmniDataTransform (ODT) mappers fail silently when items lack OutputObjectName, use dot notation, or have uneven hierarchy depths, producing empty output or malformed arrays that are hard to diagnose. This Skill provides the rules, validation workflow, and scripts to author and debug ODTs correctly. ## Core Features & Use Cases - ODT Authoring Rules: Enforces colon-path notation, mandatory OutputObjectName, and separation of object-query items from field-mapping items. - Validation and Inspection: Runs scripts to validate metadata, visualize hierarchy trees, check depth uniformity, and execute Extracts against live records. - Comparison and Debugging: Compares ODT revisions and diagnoses empty output or malformed JSON arrays. - Use Case: When a Quote proposal Extract returns empty results, run the validate and inspect-hierarchy scripts to find a missing OutputObjectName or a depth-uneven branch, fix the item, and re-execute against a record ID. ## Quick Start Ask the agent to validate and inspect the hierarchy of your OmniDataTransform, then execute it against a record ID in your scratch org to confirm the output JSON shape.

Frequently Asked Questions about odt-authoring

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

FAQPage Schema
How do I create an OmniDataTransform Extract mapper?

Define object query items with InputObjectName, InputFieldName, FilterGroup, and OutputObjectName to build the hierarchy, then add field mapping items using colon paths like Quote:Name. Validate with docgen_odt_validate.py before executing against a record.

Why does my OmniDataTransform return empty output?

Empty output usually comes from missing OutputObjectName on items, since the engine silently drops them, or from dot notation breaking SOQL generation. Run the validate and inspect-hierarchy scripts to locate the failing item.

Should I use dot notation or colon paths in ODT field mappings?

Use colon paths such as Parent:Child:Field in InputFieldName and OutputFieldName. Dot notation like Parent.Child.Field breaks SOQL generation and must be avoided in all ODT mappings.

When should I use odt-authoring versus document-generation?

Use odt-authoring for designing and debugging Extract and Transform mappers, hierarchies, and output JSON. Use document-generation when the task is .docx templates, DocumentTemplate lifecycle, token rendering, or final output verification.

Can I create ODTs programmatically via the REST API?

Yes, the data-mapper-authoring reference covers programmatic ODT creation via REST API and cloning patterns, but REST writes should be limited to scratch-org experimentation. Commit ODT metadata via .rpt-meta.xml for real work.