Epicor User Defined Field Register Worksheet
UD fields are how Epicor sites extend standard tables, and over the years they pile up with names like Character07 that nobody can explain. This register gives each field a meaning, an owner and a usage count.
| Table | UD column | Data type | Business label | Used by | Owner | Total rows | Rows populated | Fill % | Action | |
|---|---|---|---|---|---|---|---|---|---|---|
86.7% | ||||||||||
14.1% | ||||||||||
54.2% | ||||||||||
0% | ||||||||||
4.9% |
Run counts of populated rows from a SQL or BAQ query against each table and paste them here. Fields with near zero fill and no owner are retirement candidates, after checking reports and customizations that reference them.
Data dictionary help
An optional review that documents your UD fields and where they are used.
Optional. The tool and every export work without this. No spam.
How to use the register
List each user defined column with its table, data type and business label. Add who uses it, such as a screen, report or integration, and name an owner. Enter total rows and populated rows from a query and the worksheet computes fill percentage. Use the action column to mark what to keep, document or retire. Export to Excel for review sessions.
- Record the business label, not only the column
- Name a human owner
- Pull fill counts from the database
- Check reports before retiring
Reading fill percentage
A high fill percentage on a table with many rows suggests an active, important field. A very low percentage may indicate a one time project field, a field used by a single team, or a field created and abandoned. Context matters, so low fill is a prompt to ask, not an instruction to delete.
UD fields versus UD tables
UD fields are columns added to existing tables such as parts or orders and suit a small number of extra attributes. When data is one to many, needs its own key, or has grown to dozens of fields, a UD table is usually cleaner. The action column includes Move to UD table to flag such cases for design work.
Common mistakes
Teams reuse a UD field for a second meaning when the first is forgotten, which corrupts reports. Others delete a field that a custom report, BAQ or integration still reads. Search your customizations and queries for each column before retiring, and keep a record of the old definition.
Frequently Asked Questions
What are UD fields in Epicor?
UD fields are user defined columns on standard tables, such as character, number, date and check box fields, that you label and show on screens through customization. They let you store extra data without changing the standard schema.
How do I count populated rows?
Run a query or BAQ that counts rows where the column is not empty for each table, and compare to the total rows. Do this per table, then paste the counts into the register. Numeric and check box fields need a rule for default values.
Is it safe to remove an unused UD field?
Only after checking every place that references it: screen customizations, BPM directives, reports, BAQs and integrations. Disable usage in a test system first, then keep a backup of the label and customization definition for rollback.
When should I choose a UD table instead?
Choose a UD table when the data repeats per parent record, has its own key, or needs many attributes. Adding many UD fields to a busy standard table makes the model harder to explain and test than a dedicated table.
If you want help finding where each UD field is referenced across screens, reports and queries, Netray can assist.
Related Tools
Epicor BPM Directive Inventory Worksheet
Inventory your BPM directives, score complexity and retest effort, and see total upgrade retest hours. Export to Excel.
EpicorEpicor Customization Change Request Template
A change request form for Epicor customizations that captures the business need, impact, test plan and approvals before anyone opens the tool.
EpicorEpicor Customization Code Review Checklist
A checklist for reviewing Epicor custom code, BPM directives and customizations before promotion to live.
EpicorEpicor DMT Data Load Plan Worksheet
Sequence your Epicor Data Management Tool loads with record counts, rates and estimated run time, then export the plan to Excel.
More Epicor tools
See all- Epicor Kinetic Customization Change Request Form Template
- Epicor Kinetic Go-Live Cutover Plan Template
- Epicor Kinetic User Access Request Form Template
- Epicor Kinetic BPM Directive Inventory Worksheet
- Epicor Kinetic Scheduled Task Register Worksheet
- Epicor Kinetic Custom Report Inventory Worksheet
- Epicor Kinetic Data Migration Mapping Worksheet
- Epicor Kinetic Data Load Effort Calculator
- Epicor Business Object Services Reference
New to Epicor ERP? Start with the Epicor ERP guide and toolkit, or plan with Training Path Builder, ERP Certification Study Planner, Upgrade Path Planner.
Keep exploring
Free tools
- Epicor UD Table Design WorksheetAn editable worksheet for planning user defined tables and fields before you build them in Epicor, with a column count and key check.
- Epicor Kinetic Scheduled Task Register WorksheetAn editable register of recurring Epicor tasks (MRP, reports, integrations) with schedule, duration, owner and failure contact.
- Epicor Kinetic Custom Report Inventory WorksheetAn editable register of custom reports, BAQs and dashboards to support upgrade testing and clean-up of unused items.
ERP fixes and how-tos
- Epicor Kinetic UD Tables and UD Fields: Setup, Studio Binding, BAQ and SecurityHow to create and use UD tables and UD fields in Epicor Kinetic: setup, binding in Application Studio, reading them in a BAQ, and securing access.
- Epicor BAQ: Add a Percentage Column and Change the Date Format in KineticAdd a percentage column to an Epicor BAQ with a safe calculated field, and control date format in BAQs and Kinetic through formats and user culture.
- Epicor BPM: Update a UD Field, a PO Cost or a Table, and Update vs UpdateExtUpdate a UD field, a PO cost or any table from an Epicor BPM: Update vs UpdateExt, updating by query, and fixing the record in process error.
AI on your ERP
- Private AI for Epicor Kinetic Cloud, Outside the Multi-Tenant BoundaryRun a private LLM on Epicor Kinetic private cloud or Kinetic Cloud data via BAQs, REST v2 and Data Fabric, keeping sensitive manufacturing data off shared AI.
- AI for Epicor Kinetic Job Shops: Quote History, Job Variance and Schedule RiskPrivate AI for Epicor Kinetic job shops: quote-to-job history, JobHead and JobOper variance, subcontract delays and schedule risk, via REST and BAQs.
Integrations
- How to add AI agents to Epicor KineticHow to add AI agents to Epicor Kinetic: a tool layer over the REST v2 API and BAQs, MRP exception triage, PO expediting, and human approval before any write.
- How to add an AI chatbot to Epicor KineticAdd an AI chatbot to Epicor Kinetic: an internal assistant for planners and buyers or a customer portal bot, grounded in BAQs and runnable fully on-prem.