Manage promotions in NCC Portal

Promotions in NCC Portal allow you to move entities across environments in a controlled and scalable manner. Each entity is promoted individually, ensuring readiness for each environment and supporting efficient resource management throughout your solution.

Why use promotions?

Promoting entities between environments helps maintain solution reliability. Advancing entities through environments enables early detection and resolution of issues, upholds quality standards, and ensures a smooth transition to production.

Before promoting entities, confirm that the data source for those entities is configured in the target environment.

How to promote data sources

Promoting data sources is different from promoting entities. Data source configurations must be manually added to the Data Sources tab for each environment.

This method allows you to specify which source system each environment connects to. For example, you can connect your development environment to a development source system, preventing access to production data and protecting production systems from development workloads.

The following screenshot shows a data source configured in three environments, each connected to a different source system.

IMPORTANT
When you promote your entity to the next environment before adding the data source to this environment, you will get the error while processing your data:
Failed to resolve connection '' referenced in activity run '********-****-****-****-************' when running your pipelines on the environment you promoted the entity to.
This occurs when the Data Source in the NCC is not linked to a Fabric Connection.

Steps to promote entities

To promote an entity to another environment:

1. Open the NCC portal.
2. Select Promotions from the navigation menu.
3. Choose the entity to promote:
   • To promote a single entity, select the Action button in its row.
   • To promote multiple entities, select them and use the Promote button.
4. Select the desired options to promote or demote the entity.

NOTE
If you have a medallion structure (landing zone, bronze, silver, gold) for an entity like "Customers," you must promote each entity individually. Promoting only one (for example, the landing zone) does not advance the others. Ensure each entity is promoted to maintain proper progression and functionality.

IMPORTANT
If you create a new entity in Development that is not yet promoted to Production, it is made clear since Production does not contain a green circle.
However, if you have promoted an entity from Development to Production and you make a change in the entity in Development, it is in the current version not made clear that there is a difference between the configuration of the entity between the two environments.