Change Experiment Material#

Experiment.ChangeMaterial

Overview#

This operation replaces the current main Material of an Experiment and lets you update its Sub-Material assignments.

Setup#

No special setup is required other than to meet the preconditions of the transaction.

Preconditions#

• The Experiment exists and is Active.
• The Experiment is in the Created or In Progress state.
• The Experiment Definition mode of the Experiment is Sub-Materials.
• The new Material must meet the same preconditions as in Special Create Experiment.
• Both the current and the new Materials must not have an Experiment Lock Id set.
• The new Material must be different from the current main Material.

Sequence of Steps#

Step 1: Material#

1. Select Change Experiment Material from the Experiment.

2. Select the new main Material.

   

3. If the current Sub-Material assignment contains invalid entries for the new Material, the system removes them automatically and displays a warning.

Step 2: Sub-Materials#

1. Add, remove, or replace Sub-Materials as needed.

2. To speed up the assignment, use one of the available utilities:

   • Clear All
   • Assign by Sub-Material Name
   • Assign by Container and Position
   • Assign Remaining Randomly

   

3. Optionally, enter a comment.

4. Select Change Material to confirm the operation. The main Material history is updated accordingly.