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.

Promote entities

To open the promotions overview, go to the NCC portal and select Promotions from the left menu.

In the promotions overview, you can see which entities are available in each environment. This helps you understand which entities are currently created, and promoted to which enviroment.

Promotions overview:

ℹ️ Note:
Entities that are out of sync are marked with a orange warning icon in the Promotions overview. Use this indicator to identify entities whose configuration differs in comparison to the environment one level lower and might need to be promoted.

You can promote a single entity or multiple entities at the same time.

To promote entities to another environment, complete the following steps:

1. Open the promotions overview by selecting Promotions in the left hand menu from the NCC portal

2. Select the entities that you want to promote. > 💡 Tip:
   > You can quickly select all entities that are out of sync by using Select out of sync entities in [Environment] butten and select the environment.

   💡 Tip:
   You can quickly select all entities that are not in a specific environment by using Select entities not in [Environment] button and select the environment.

   💡 Tip:
   If you have a medallion structure (landing zone, bronze, silver, gold) promoting an entity in a higher layer it will also promote layers below. I.e. if a silver entity is promoted, the corresponding landing zone and bronze entity will be promoted as well.

3. Validate the selected promotions and confirm the promotion by selecting Yes.