SAP Knowledge Base Article - Public

2801085 - How to Work With the Manage Business Configuration (BCUI) feature in SuccessFactors

Symptom

  • How do I change, delete or add fields across SAP SuccessFactors?
  • How to change the system fields structure without access to Provisioning?
  • There's another way to manage the system fields besides manipulating the instance datamodel?
  • Is there any guide dedicated on show how to manage the System Business Configuration (BCUI)?
  • How can I enable the BCUI?

Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental.

Environment

  • SAP SuccessFactors HXM Suite
  • SAP SuccessFactors Employee Central
  • SAP SuccessFactors Employee Profile

Resolution

    1. Prerequisites to Using BCUI 

    1. Prior to start using BCUI it is necessary to ensure that your instance already have a datamodel uploaded. It's a XML file that must be uploaded in Provisioning. If you're unsure about this, you need to engage your Implementation Partner;
    2. If you are not working with an Implementation Partner anymore, please open an case with SAP Cloud Product Support who can check if the data model already exist in provisioning. (Note to Support: If the Successcion Data model is already present, simply export it and re-import without changes to sure it is sync).


    2. Enabling BCUI

At first, your Partner or the Support Engineer will ensure the BCUI-related features are enabled in Provisioning as per the below steps:

  1. Login on the respective instance's Provisioning page;
  2. In Edit Company Settings section, select Company Settings;
  3. Search for Enable Generic Objects and check/enable it;
  4. Search for Enable Business Configuration in Admin Tools and enable it;
  5. After this, leave Provisioning and get into the system's Admin Center page.

   
    3. Trigering  "Synchronize Business Configuration" job to Synchronizing the Succession Data Model with Metadata Framework (MDF)

1H 2023 Release and after:

The "Synchronize Business Configuration" job must be configured and triggered in the instance. 
 To create the job please review the following links:

2H 2022 Release:

Once you've enabled BCUI, you must Export the Data Model and Import again in the Provisioning to run automatically the Job that sync the BCUI with Succession Data Model.

Note: This is a one-time task.

  1. Export the Data Model: Export the Data Model in the Provisioning in Succession Management > "Import/Export Data Model";
  2. Import the Data Model: Import the Data Model in the Provisioning, in the same page as you exported the Data Model;
  3. Monitor the Job: Check in "Monitor Jobs" if the job "Synchronize Business Configuration" run as expected. If there is some error in Detais,  After the sync runs for the first time, any subsequent upload of Data Model XML will automatically trigger this job;
  4. If the sync job fails, BCUI is locked. Do not edit the attributes of ActivityListObject using Admin Center's Configure Object Definitions feature.
  5. Check the job details/results to identify the issue, fix it, and restart the job. If issue still exists, please contact SAP Cloud Support. You can use the KBA 2555493 - Missing Standard Elements in BCUI to resolve or the KBA 2324339 - Manage Business Configuration UI (BCUI) is locked;

You have set up a sync job that will enable you to synchronize Succession Data Model with Metadata Framework (MDF).

After the sync runs for the first time, future updates to BCUI will be automatically pushed to Succession Data Model.

Run One time job "MDF Object Definition to DB Sync" (Refer KBA 2534674 - How To Fix Inconsistencies In Metadata Framework (MDF))

Note: Job Owner must have a full permission example: Hris sync job owner

    4. Setting Permissions for BCUI

Before anyone can use BCUI, certain permissions need to be granted as per the below steps:

Note: This permissions should be defined by the customer. The support is not authorized to do it.

  1. Go through Admin Center > Manage User Permissions > Manage Permission Roles;
  2. Select the permission role assigned to the user you wish to grant BCUI access to;
  3. The Permission Role details page appears;
  4. Click Permission: the permission settings page appears;
  5. Scroll down to the section named Administrator Permissions > Metadata Framework, check the below permissions:
    • Configure Object Definitions;
    • Manage Data;
    • Access to non-secured objects;
    • Import Permission on Metadata Framework;
    • Admin Access to the OData API;
    • Manage Configuration UI;
  6. In Administrator Permissions > Manage Business Configuration, choose the visibility and actions allowed for the objects listed;
    • Visibility for an element indicates whether or not it will appear on BCUI whereas actions indicate the operations that can be performed on the element.
  7. Click Done to save your changes.

NOTE: If you receive a permissions error when then trying to access 'Manage Business Configuration', it may be a sync issue with regards to the BCUI and MDF Objects. As such, please perform the following:

  1. Go to Admin Center > OData API Metadata Refresh And Export > Clear cache (wait for it to show 'successful')
  2. Go to Provisioning > Search MDF Cache Tool > Clear cache (wait for it to show 'successful'
  3. Run the 'MDF Object Definition To DB SYNC' Job.
  4. Re-Import Succession Data Model and ensure the 'Synchronize Business Configuration job', which runs automatically, completes successfully

FAQ - Additional Information

Q) Where can I get information on this from the Guide?

A) Guide - Implementing and Managing Business Configuration (BCUI)

Run Audit - Business Configuration UI Audit Logs

  • 2651585 - Manage Business Configuration: How to Generate Business Configuration Audit logs via Manage Scheduled Jobs.
  • 2604836 - Reading Business Configuration Audit Logs in Employee Central - User Assistance Documentation Link.
  • Guidance to interpreting the Audit Logs for Manage Business Configuration can be found in Working with Business Configuration UI Audit Logs.

See Also

  • 2080620 - How to enable Manage Business Configuration UI (BCUI)
  • 2500964 - Unable to activate v4admin User - System System (v4admin user is inactive)
  • 2651585 - Manage Business Configuration: How to Generate Business Configuration Audit logs via Manage Scheduled Jobs
  • 2324339 - Manage Business Configuration UI (BCUI) is locked
  • 2799197 - How to select a picklist / SuccessFactors Employee Profile
  • 2799607 - Setting up Attachments in BCUI - SAP SuccessFactors Employee Profile
  • 2324339 - Manage Business Configuration UI (BCUI) is locked
  • 3077858 - Missing country-specific configuration in Country-specific succession data model XML but configuration present in BCUI
  • 2080620 - How to enable Manage Business Configuration UI (BCUI) - EC
  • 2394286 - Manage Business Configuration: Application Error when trying to save any element in Manage Business Configuration (BCUI)
  • 2478776 - Create New UI Config not available in Manage Business Configuration UI (BCUI)
  • 2458964 - Synchronise Business Configuration Job Failing due to Unknown Error (Error getRoleIdsRuleIdsMap for baseUserId)
  • 2534624 - Error On Save In Manage Business Configuration
  • 2555493 - Missing Standard Elements in BCUI
  • 2589774 - MDF Object Definition to DB Sync
  • 2171588 - SuccessFactors: OData API Metadata Refresh and Export
  • 2534674 - How To Fix Inconsistencies In Metadata Framework (MDF)

Keywords

datamodel, succession datamodel, business configuration, BCUI, system fields, implementation, enable fields, provisioning, SuccessFactors, Manage Business Configuration , KBA , LOD-SF-EC-BCI , Manage Business Configuration (BCUI) & Data Models (XML) , LOD-SF-PLT , Platform Foundational Capabilities , LOD-SF-EP-BCI , BCUI & Data Model (XML) Configuration , How To

Product

SAP SuccessFactors Employee Central all versions ; SAP SuccessFactors HCM all versions