metaobject-creation-index

Creates new K/3 Cloud metaobjects via BOS template inheritance over SaveForIDEV9 RPC.

24|7|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/qiaolei227/opendeploy --skill metaobject-creation-index-qiaolei227
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: metaobject-creation-index
Source: https://github.com/qiaolei227/opendeploy/tree/main/knowledge/skills/k3cloud/metaobject-creation-index
Command: npx skills add https://github.com/qiaolei227/opendeploy --skill metaobject-creation-index-qiaolei227

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Kingdee K/3 Cloud consultants occasionally need brand-new business objects (bills, base data, reports, dynamic forms) that no standard object covers, and creating them normally requires manual work in BOS Designer. This Skill provides the decision framework and tool-call sequences to create new metaobjects programmatically through template inheritance, equivalent to BOS Designer's New Wizard. ## Core Features & Use Cases - Template-based creation: Create bills (ModelType 100), base data (400), dynamic forms (500), and reports (900) from 27 registered BOS_* templates via k3cloud_create_from_template. - New-vs-extend decision tree: Enforces the rule that 99% of requirements should extend existing standard objects, with explicit anti-patterns and justified creation scenarios. - SysReport end-to-end pipeline: Chain create_from_template, add_sysreport_filter_parameters, add_sysreport_columns, and register_sysreport_python_plugins into a runnable report. - Use Case: A client needs a quality traceability report with date range, customer, and bill number filters. Load this Skill, select BOS_SimpleSysReport, create the report, add filter parameters and columns, then register an IronPython service plugin whose SQL column names match the fieldKey definitions. ## Quick Start Ask the agent to create a new K/3 Cloud report named Customer Sales Summary with date and customer filters using the BOS_SimpleSysReport template.

Frequently Asked Questions about metaobject-creation-index

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

FAQPage Schema
How do I create a new report in Kingdee K/3 Cloud programmatically?▼

Call k3cloud_create_from_template with templateId BOS_SimpleSysReport, a UUID-based newFormId, a name, and subSystemId 23. Then add filter parameters and columns, and register an IronPython service plugin via k3cloud_register_sysreport_python_plugins.

When should I create a new metaobject instead of extending a standard object?▼

Extend existing standard objects in almost all cases. Create new only for genuinely new entities with no K/3 counterpart, standalone custom report queries, or when the standard object's lifecycle and permission model fundamentally cannot fit.

Which BOS template should I choose for a new bill with entry lines?▼

Use BOS_BillWithEntryModel for a bill with detail entry rows, or BOS_BuinessBillWithEntryModel when you also need built-in audit and submit operation hooks. Note the SDK's own misspelling of Business must be copied verbatim.

Why does my new K/3 Cloud object not appear in the client after creation?▼

The K/3 Cloud client caches metadata and does not auto-refresh after BOS writes. You must close the client, fully log out, and log back in; in BOS Designer pressing F5 is sufficient.

Why is a report column blank even though the query returns data?▼

The column's fieldKey must exactly match, case-sensitively, the temp table column name written by the Python plugin's BuilderReportSqlAndTempTable SQL. Any mismatch fails silently with no server error or log entry.

What are the limitations of the SaveForIDEV9 creation wire format?▼

The DCXML root tag is always Form regardless of ModelType, __paras__ requires double JSON stringification, and there is no ap1 field. Combo filter parameters silently drop if the referenced enum type does not already exist.