Two Types Of Environments

CAUTION:

This section is confusing as it assumes you understand the difference between objects with random number prime-keys versus those that have user-assigned prime keys. If the object has a prime key that's suffixed with _ID, this is a random number object; otherwise, it's not.

When you run the utility that creates an environment reference, you must define the type of environment:

If you want the prime-key values of "random number" objects to be unique across both environments, indicate the environment is a ConfigLab .
If you don't care about the uniqueness of the prime-keys in the two environments, indicate the environment is a Comparison Source . If you choose this option and you add entities with system-assigned prime keys, there's a slight chance that your newly added rows will be rejected as duplicates if you promote the additions to the target environment.

Note: Rule of thumb. If you think you're going to add "random number" objects in the source environment and you don't want to risk the system assigning a prime-key that's already used in the current environment, indicate the environment is a ConfigLab . Otherwise, indicate the environment is a Comparison Source.