4.5 Metadata Framework Enablement and Object Definition Settings
Key Takeaways
- The Metadata Framework (MDF) extends SAP SuccessFactors with Generic Objects; Position Management, Time Off, and BCUI are built on it.
- Administrators can create 250 custom MDF objects by default, and the limit can be raised to 400 in Provisioning.
- MDF is enabled in Provisioning with Enable Generic Objects and Enable the Attachment Manager.
- Effective dating options are None, Basic, Multiple Changes Per Day, and From Parent (for child objects).
- Pending Data set to Yes keeps changes invisible until the workflow is approved.
4.5 Metadata Framework Enablement and Object Definition Settings
Quick Answer: The Metadata Framework (MDF) lets consultants and customers extend SAP SuccessFactors with Generic Objects (GOs). MDF objects come with import and export, workflow, rules, reporting, OData, and RBP security. You build an object's structure in Configure Object Definitions, add logic with business rules, maintain records in Manage Data, and optionally design screens in Manage Configuration UI.
What MDF Is and Why EC Depends on It
MDF can create custom objects and maintain existing objects, link objects, and build hierarchies of objects. SAP uses it for many applications. Position Management, Time Off, and Manage Business Configuration are all built on MDF, and so are the MDF foundation objects such as Legal Entity, Business Unit, Division, Department, Cost Center, and Job Classification. Every MDF object shares the same capabilities: import and export, UI, OData API access, workflows, rules, reporting, and RBP.
Limit: administrators can create 250 custom MDF objects by default. The limit can be raised to 400 in Provisioning > Company Settings.
MDF Layers
- Object Definition: where the object is built. Behavior, fields, associations, and security are set here.
- Business Rules: logic to default data, set values, raise messages, and trigger actions on save or delete.
- Data: create, import, and manage records (Manage Data, Import and Export Data, OData).
- Configuration UI: alternative screens with different layouts, labels, text, and links (Manage Configuration UI).
Enabling MDF
In Provisioning > Company Settings:
- Enable Generic Objects (the basis of MDF and of the rules engine)
- Enable the Attachment Manager
For workflows and rules on MDF data, also enable Employee Central Foundation Objects, Effective Dated Data Platform, and Enable Business Rules for Workflow Derivation.
MDF Permissions
In Manage Permission Roles > Administrator Permissions > Metadata Framework:
| Permission | Allows |
|---|---|
| Configure Object Definitions | Managing object definitions |
| Access to Business Rule Execution Log | Tracing rule execution |
| Configure Business Rules | Creating and editing rules |
| Manage Data | Creating and editing records |
| Manage Sequence | Automatic sequence numbers, for example for externalCode generation |
| Import Permission on Metadata Framework | Import and export of generic objects and rules |
Record access for individual objects is granted in Miscellaneous Permissions or another category the object is assigned to. There you choose View, Edit, Import, and Export, plus Field Level Overrides that make specific fields No Access or Read Only. Access to Non-RBP Secured Objects covers objects with Secured = No.
Record-Level Permission for Import and Export
For a secured object, you can require explicit Import or Export permission at record level. In Manage Data, create or edit the Object Configuration for the object and set Enable Record-Level Permission Check on Import and/or …on Export to Yes.
Object Details in Configure Object Definitions
Open Configure Object Definitions > Create New: Object Definition, or search an existing one and choose Take Action > Make Correction.
| Setting | Options and rules |
|---|---|
| Code | Unique identifier; custom objects are prefixed cust_ automatically |
| Effective Dating | None (one record, overwritten), Basic (several records, one per date), Multiple Changes Per Day (several records per date), From Parent (child objects inherit the parent's dating and cannot be maintained on their own) |
| API Visibility | Not Visible (default), Read Only, Editable (OData read and write) |
| Status | Active or Inactive. An object cannot be set inactive while records exist or while another active object references it. |
| MDF Version History | No, Delete History (audit only deletes), or Complete History (audit create, insert, update, delete) |
| Default Screen | A Configuration UI shown in Manage Data |
| Label / Description | Display name and summary |
| API Sub Version | V1.1 hides technical system fields from OData and is recommended for new objects. No Selection behaves like V1.1. |
| Subject User Field | A User-type field that determines workflow routing |
| Workflow Routing | A workflow run for every operation. Requires Employee Central Foundation Objects in Provisioning. |
| Pending Data | Yes keeps changes invisible until approval |
| To Do Category | Where approvers see the item; used when Pending Data is Yes |
| Object Category | Uncategorized, Configuration, User Transactional, Non-User Transactional, or Technical |
Do not confuse effective dating with audit. Audit (MDF Version History) can be enabled regardless of the dating option.
MDF Data Management and Auditing
- MDF data volume objects (MDF Audit Data Volume, MDF Association Data Volume, MDF Transactional Data Volume) help administrators understand data volumes and decide when to purge.
- The MDF Change History Data report under Change Audit Reports covers all root-level MDF data except configuration objects such as object definitions, picklists, and object configurations. It may first need enabling in Manage Audit Configuration.
Position Management Preview
THR79 applies these settings to the Position object. Position uses Basic effective dating, is secured in Miscellaneous Permissions, and must have Pending Data = Yes if workflows are used. SAP recommends triggering position workflows through business rules rather than Workflow Routing at object level (Section 11.4).
A child MDF object must always share its parent's effective dating and cannot be maintained on its own. Which effective dating option is required?
A customer has created 250 custom MDF objects and needs more. What does THR80 say?
An MDF object has a workflow that requires approval. Changes should only take effect after approval. Which setting achieves this?