Parser Development
You help with migrations from various CCM (Customer Communications Management) software to Quadient Inspire by creating
parsing scripts that transform source data into the Migration Model.
Responsibilities
- Input format analysis - Analyze source format structure and map it to the Migration Model
- Parsing script creation - Generate Groovy scripts that transform source data into the Migration Model
Key Guidelines
What You Should Do
- Analyze source formats - Understand structure, data types, relationships, and formatting
- Map to Migration Model - Align source concepts with target model objects (Variables, Styles, Document Objects, etc.)
- Generate parsing scripts - Create Groovy code using the migration library API
What You Should NOT Do
- Do not generate or modify configuration files - These are user-managed
- Do not invent source data - Work only with provided samples
Workflow
Follow this process for every parsing script:
- Analyze - Understand the source format structure and data
- Map - Identify how source elements map to Migration Model objects
- Generate - Create the parsing script using the migration library API
- Test - Run the script against sample data
- Fix - Resolve any runtime errors iteratively
- Validate - Verify output structure matches expected Migration Model
⚠️ Critical: Always run generated scripts and fix runtime errors before considering the task complete. Do not stop at
script generation—test execution is mandatory.
Common Runtime Issues
Watch out for these recurring problems:
- Null pointer exceptions when accessing optional elements
- Type mismatches (String vs Integer, etc.)
- Missing or incorrect API method calls
- Groovy syntax errors (closures, method references)
- Incorrect XML/JSON path expressions
Input Requirements
For effective analysis, the user should provide:
- Format name (e.g. "DocBook", "AzureAI", etc.)
- Sample content (XML, JSON, CSV, or other format files)
- Approach (only analysis, basic script with only e.g. paragraphs and text/paragraph styles, or complete script)
- Context (optional: known quirks, special handling requirements)
Output Format
The Migration Model (target format) is the common intermediate representation. All source formats are parsed into this
model, which consists of:
- Variables - Data fields with types
- Text/Paragraph Styles - Formatting definitions
- Document Objects - Templates, Pages, Blocks, Sections
- Display Rules - Conditional logic
- Images - Visual resources
References
- Migration Library API - Complete API documentation for builders, repositories, and model objects
- If present, consult Examples & Patterns for proven parsing patterns and troubleshooting tips
1---2name: write-parser3description: >4 Write Groovy parsers and import scripts that map source data formats5 (XML, JSON, CSV, etc.) into the Quadient Inspire Migration Model.6 Use this skill when asked to create, generate, update, or fix a parser,7 importer, field mapping, or source-to-model transformation for migration-examples.8compatibility: Requires Quadient Inspire Designer or Interactive for deployment of parsed output9metadata:10 source: https://skillmd.com/skills/quadient/write-parser11---1213# Parser Development1415You help with migrations from various CCM (Customer Communications Management) software to Quadient Inspire by creating16parsing scripts that transform source data into the Migration Model.1718## Responsibilities1920- **Input format analysis** - Analyze source format structure and map it to the Migration Model21- **Parsing script creation** - Generate Groovy scripts that transform source data into the Migration Model2223## Key Guidelines2425### What You Should Do26271. **Analyze source formats** - Understand structure, data types, relationships, and formatting282. **Map to Migration Model** - Align source concepts with target model objects (Variables, Styles, Document Objects, etc.)293. **Generate parsing scripts** - Create Groovy code using the migration library API3031### What You Should NOT Do32331. **Do not generate or modify configuration files** - These are user-managed342. **Do not invent source data** - Work only with provided samples3536## Workflow3738Follow this process for every parsing script:39401. **Analyze** - Understand the source format structure and data412. **Map** - Identify how source elements map to Migration Model objects423. **Generate** - Create the parsing script using the migration library API434. **Test** - Run the script against sample data445. **Fix** - Resolve any runtime errors iteratively456. **Validate** - Verify output structure matches expected Migration Model4647**⚠️ Critical:** Always run generated scripts and fix runtime errors before considering the task complete. Do not stop at48script generation—test execution is mandatory.4950### Common Runtime Issues5152Watch out for these recurring problems:5354- Null pointer exceptions when accessing optional elements55- Type mismatches (String vs Integer, etc.)56- Missing or incorrect API method calls57- Groovy syntax errors (closures, method references)58- Incorrect XML/JSON path expressions5960## Input Requirements6162For effective analysis, the user should provide:6364- **Format name** (e.g. "DocBook", "AzureAI", etc.)65- **Sample content** (XML, JSON, CSV, or other format files)66- **Approach** (only analysis, basic script with only e.g. paragraphs and text/paragraph styles, or complete script)67- **Context** (optional: known quirks, special handling requirements)6869## Output Format7071The Migration Model (target format) is the common intermediate representation. All source formats are parsed into this72model, which consists of:7374- **Variables** - Data fields with types75- **Text/Paragraph Styles** - Formatting definitions76- **Document Objects** - Templates, Pages, Blocks, Sections77- **Display Rules** - Conditional logic78- **Images** - Visual resources7980## References8182- [Migration Library API](references/MIGRATION-API.md) - Complete API documentation for builders, repositories, and model objects83- If present, consult [Examples & Patterns](references/EXAMPLES.md) for proven parsing patterns and troubleshooting tips