A specialized utility for parsing and constructing YunZhijia form data, enabling seamless bidirectional synchronization between business systems and approval workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install yzj-form-parser
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install yzj-form-parser using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is YZJ Form Parser?
The YZJ Form Parser is an essential tool for developers working with YunZhijia enterprise systems. It provides a robust framework for handling the consistent JSON structure used in both data push events and approval initiation requests. By abstracting the complexities of widgetMap and detailMap, it ensures that data flows accurately between Openclaw Skills and the YunZhijia platform.
This skill automates the translation of business logic into technical form requirements, handling diverse widget types from simple text inputs to complex multi-select personnel and department pickers. It allows for reliable data extraction from incoming notifications and precise payload construction for system-triggered approvals.
YZJ Form Parser Use Cases
- Parsing incoming YunZhijia approval push notifications to update external databases.
- Automatically generating and initiating YunZhijia approval forms based on external system triggers.
- Mapping complex business data to YunZhijia-specific widgets like personnel, department, and attachment controls.
- Synchronizing data between CRM/ERP systems and enterprise mobile office forms via Openclaw Skills.
How YZJ Form Parser Works
- The skill receives a YunZhijia JSON payload containing formInfo (widgetMap and detailMap) and basicInfo.
- For parsing, it iterates through the widgetMap keys using specific codeIds to extract values based on the widget type.
- For construction, it maps business fields to the appropriate widget structure, ensuring type safety (e.g., converting dates to millisecond timestamps).
- It processes the detailMap for sub-form data, handling row IDs and column definitions (widgetVos).
- The final structured output is either a cleaned business object or a formatted YunZhijia JSON payload ready for API submission.
YZJ Form Parser Setup
To integrate this parser within your Openclaw Skills environment, ensure your data pipeline provides the standard YunZhijia JSON structure. You can initialize the parser using standard configuration:
# Example of integrating the parser logic
npm install yzj-form-parser
Ensure that you have the formDefId and codeId mapping for your specific YunZhijia forms to properly route the data.
YZJ Form Parser Data Schema & Taxonomy
The skill organizes data into three primary segments:
| Segment | Description |
|---|---|
| basicInfo | Metadata including eventId, formInstId, flowInstId, and actionType. |
| widgetMap | Main form components mapped by codeId, including title, type, and value. |
| detailMap | Sub-form or line-item data (detailedWidget) containing row-based values. |
Widget Data Types:
- Text/TextArea: String values.
- Date: Long (millisecond timestamps).
- Number/Money: String representations of decimals.
- Radio/Checkbox: Key-based selection strings or arrays.
- Person/Dept: Arrays containing OIDs and detailed metadata.
YZJ Form Parser Advanced Features
- Bidirectional conversion support for both reading push data and writing initiation data.
- Comprehensive support for specialized enterprise widgets like personSelectWidget and departmentSelectWidget.
- Advanced detailMap handling for processing dynamic line items in complex approval forms.
- Built-in type conversion for number and money widgets to prevent precision loss.
- Automated attachment and image metadata handling for file-based workflows within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
AI to Video Free
A powerful AI video creation tool that transforms text descriptions and image assets into high-quality 1080p MP4 videos using a cloud-based rendering pipeline.
AI Video Leonardo: Image to Motion
An automated AI video generation tool that transforms static images and text prompts into 1080p cinematic video clips.
Hello World Skill
A minimal demonstration skill used to verify plugin loading and provide basic greetings through the hello-world plugin.
Yoga Student Manager
A lightweight management system for yoga instructors to track student credits, course packages, and automated session logging via SQLite and SMTP.
AI Meeting Note Action Stickers
A prompt-only labeling system that transforms AI-generated meeting summaries into human-verified action items and decision flags.
AI Source Claim Audit Tags
A specialized organizational skill that generates physical or digital audit markers to help humans manually verify claims within AI-generated content.
Featured*
