# manage-data

> Create and manage OFBiz data files (Entity Engine XML). Use when adding Seed/Demo data, fixing foreign keys, or configuring entity resources.

- Author: toaditi
- Repository: toaditi/ofbiz-dev-agent-skills
- Version: 20260124175846
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/toaditi/ofbiz-dev-agent-skills
- Web: https://mule.run/skillshub/@@toaditi/ofbiz-dev-agent-skills~manage-data:20260124175846

---

---
name: manage-data
description: Create and manage OFBiz data files (Entity Engine XML). Use when adding Seed/Demo data, fixing foreign keys, or configuring entity resources.
---

# Skill: manage-data (v1.0)
## Goal
Create and manage OFBiz data files (Entity Engine XML).

## Triggers
**ALWAYS** read this skill when:
- Creating new data files (Seed, Demo).
- Fixing foreign key or data loading errors.
- Configuring `ofbiz-component.xml` entity resources.

## Use when
- Adding Seed data (required for app).
- Adding Type data (enums, status).
- Adding Demo data (testing).

## Don’t use when
- Loading massive datasets (use Entity Import).
- Modifying schema (use `manage-entities`).

## Inputs
- required: Type (Seed|Type|Demo), Entities
- optional: Component

## Outputs
- Data file in `data/`, registered in `ofbiz-component.xml`.

## Procedure
1. Create file `data/[Component][Desc][Type]Data.xml`.
2. Root tag: `<entity-engine-xml>`.
3. Add entities (e.g., `<Enumeration .../>`).
4. **Register**: Add `<entity-resource>` to `ofbiz-component.xml` matching `reader-name` (`seed`, `demo`).

## Guardrails
- **Config**: File creation is useless without registration in `ofbiz-component.xml`.
- **Readers**: Use standard `seed` or `demo` readers unless creating a custom one.
- **Location**: Paths are relative to component root.

## Failure handling
- **Data Not Found**: Check `ofbiz-component.xml` path and reader name.
- **Load Error**: Check XML syntax and entity field names.

## Examples
**Example A (Seed Data)**:
Input: Permission 'VIEW'
Output: `data/AppSecurityPermissionSeedData.xml`
```xml
<entity-engine-xml>
    <SecurityPermission permissionId="APP_VIEW" description="View App"/>
</entity-engine-xml>
```
**Registration**:
```xml
<entity-resource type="data" reader-name="seed" loader="main" location="data/AppSecurityPermissionSeedData.xml"/>
```