Replacing an Entity

Apps platform provides the ability to replace an entity referenced in app with another entity. This capability is very handy when you move your apps between organizations or environments (Development, Test, and Production).

1. An entity can be replaced in two ways:

1a. Right-click on the entity name from the tree view and click Replace.

1b. Click on the error icon next to the entity name in the tree view. An error is displayed only if the entity is not available, or you don't have access to the entity.

2. The Entity replacement dialog is launched. If the entity is placed in a different tenant, click on pick a different tenant to choose the appropriate tenant.

3. You can pick the replacement entity from the entity list in the left pane. For easier replacement, the best matches (based on the entity name) for the entity are displayed in the first section in the left pane. You can also pick another entity from the All Entities section.

4. Once you select an entity, it is displayed in the right pane.

5. Click Replace to replace the existing entity with the new one selected.

Note:

Once an entity is replaced, the action cannot be undone.

Replacing an entity where a field is removed, may lead to invalid bindings in the app.

When replacing an entity that depends on another entity whose name is different from when the app was exported, you cannot replace the dependent entity in the app as well. To avoid this, make sure that you replace entities in the correct dependency order.