IT47579: DOC - UPDATE ACE JUNIT TEST DOCUMENTATION TO MENTION THAT SRC/MAIN AS THE DIRECTORY STRUCTURE CANNOT BE CHANGED

APAR status

• Closed as documentation error.

Error description

• When generating JUnit Tests via the ACE Toolkit or `ibmint
  generate tests` command, the generated Test Project by-default
  uses `src/main/java` and `src/main/resources` as the Directory
  structure for storing the Java Test Program and the Recorded
  Messages respectively. This Directory structure should not be
  changed and manually changing it may cause the BAR File Building
  Process for the Test Project to Fail.
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All Users of IBM App Connect Enterprise version 12 and version
  13 who use integration tests to validate the operation of their
  message flows or message flow nodes.
  
  
  Platforms affected:
  LinuxZ64, AIX, LinuxX64, LinuxPPCLE64
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  When generating JUnit tests via the App Connect Enterprise
  Toolkit or `ibmint generate tests` command, the generated test
  project by-default uses `src/main/java` and `src/main/resources`
  as the directory structure for storing the Java test source and
  the recorded messages respectively. This directory structure
  should not be changed as modifying it may cause the BAR file
  building process for the test project to fail.
  

Problem conclusion

• App Connect Enterprise 12
  (https://www.ibm.com/docs/en/app-connect/12.0?topic=solutions-de
  veloping-integration-tests) and App Connect Enterprise 13
  (https://www.ibm.com/docs/en/app-connect/13.0?topic=solutions-de
  veloping-integration-tests) documentation will be modified to
  add the below additional information to the documentation for
  better clarity while creating JUnit tests using IBM App Connect
  Enterprise.
  
  
  ```
  The integration tests are generated in a
  pre-defined directory structure with `src/main/java` containing
  the Java test files and `src/main/resources` containing the
  saved resources used by the tests. This is a fixed directory
  format that App Connect Enterprise uses for segregating the test
  code and the referenced test data used by the integration tests
  into a single test project and this cannot be modified. The
  `src/main` directory structure for containing the integration
  tests is used because in App Connect Enterprise, a test project
  is used to store only the generated tests and its accompanying
  resources. The actual message flow logic to be tested is always
  separate from the test project.
  ```
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels