SystemSetup Annotation: When are the methods run?

The SystemSetup annotation is used to run import data, synchronize catalogues, migrate CMS components and execute Java code during every project or essential data creation step.

In past versions the essential and project data steps weren't run during the initialization of the junit tenant. This prevented the import of test data for the integration tests if you weren't using the Areco deployment script manager as patch system. To get an updated picture of the current situation, I ran a test on the latest SAP hybris versions and here are the results:

SystemSetup.Process	INIT			UPDATE			ALL			.
SystemSetup.Type	ESSENTIAL	PROJECT	ALL	ESSENTIAL	PROJECT	ALL	ESSENTIAL	PROJECT	ALL	What Hybris impexes are imported?
ant initialize -Dtenant=master	Called once with process INIT and type ESSENTIAL per extension	Called once with process INIT and type PROJECT per extension	Called twice with process INIT and type ESSENTIAL and with process INIT and type PROJECT per extension	No call			Called once with process INIT and type ESSENTIAL per extension	Called once with process INIT and type PROJECT per extension	Called twice with process INIT and type ESSENTIAL and with process INIT and type PROJECT per extension	Project and essential scripts
ant initialize -Dtenant=junit	No call									None
ant yunitinit	No call									None
ant updatesystem -Dtenant=master1)	No call			Called once with process UPDATE and type ESSENTIAL per extension	Called once with process UPDATE and type PROJECT per extension	Called twice with process UPDATE and type ESSENTIAL and with process UPDATE and type PROJECT per extension	Called once with process UPDATE and type ESSENTIAL per extension	Called once with process UPDATE and type PROJECT per extension	Called twice with process INIT and type ESSENTIAL and with process INIT and type PROJECT per extension	Project and essential scripts
ant updatesystem -Dtenant=junit2)	1	2	3	4	5	6	7	8	9

When @SystemSetup(extension = ArecosystemsetuptestConstants.EXTENSIONNAME), the field hybrisContext.getExtensionName() always contains the name of the current extension.

I created a new extension based on the templa yempty and added the property “initialpassword.admin=nimda” to the local.properies. Then I create a class for the test and annotated at class level with:

@SystemSetup(extension = "ALL_EXTENSIONS")
public class SystemSetupAnnotationCallsTest {

Each method contains the following code for all possible combinations of process and type:

@SystemSetup(process = SystemSetup.Process.UPDATE, type = SystemSetup.Type.ESSENTIAL)
public void logUpdateEssential(final SystemSetupContext hybrisContext) {
  LOG.error(String.format("Called Update Essential with extension %s, process %s and type %s", hybrisContext.getExtensionName(), hybrisContext.getProcess(), hybrisContext.getType()));
}

I ran all ant commands and process on HAC and I analysed the log afterwards:

ant initialize -Dtenant=master | tee initializeMaster.log | grep SystemSetupAnnotationCallsTest

– Based on SAP hybris 1905