This documentation is for WSO2 App Factory 1.0.0. View documentation for the latest release.
Skip to end of metadata
Go to start of metadata

This section covers the following:

Adding unit tests

You can add unit tests that are supported by JUnit to an application managed in App Factory. Some application types (e.g., JAX-RS) have a few test samples added to them by default. In order to write unit tests, you must checkout the source code of the application version and then add tests offline either through your own IDE or using WSO2 Developer Studio. We recommend using WSO2 Developer Studio as it has App Factory tooling support to make the development experience much simpler.

After checking in the unit tests to the application you can monitor the test logs using the steps given below.

  1. Log in to the App Factory portal (for the online version, try
  2. Select an application from the list of apps that you own or are invited to participate in.
  3. Click the Repositories and Builds tab from the left panel. 
  4. Build the version of the application that contains unit tests. For instructions on building and deploying, see Building and Deploying the Application.
  5. After building the correct branch, click the Build Server button at the top of the  Repositories and Builds page. 
  6. This opens the Jenkins build server. Log in with the same credentials that you use to log in to App Factory.
  7. The build server home page displays all builds linked to all application versions created so far. Select the application version that you added tests to and choose to view test logs.  
  8. After you select a particular version of an application, you are directed to the Jenkins project page, which shows details of that Jenkins project as shown in the following example. If more than one build is triggered, the test result trend graph will be populated.

  9. Click the Latest Test Result link to open the test results. You can drill down to the tests through module, package and class levels. It shows all tests for a class along with their pass/fail status and the duration each test executed. For example,

    Also, you can move to other build numbers to view their test results. 

Tracking issues

Defect management is an important aspect of application development. When you find a problem with an application, say as part of testing, you open a bug/defect/issue against it. WSO2 App Factory integrates Redmine by default for issue management. At the moment, issues are created and managed externally to the App Factory portal. You need to use the Redmine administration interface to create and manage issues, while a summary of issues is shown in the App Factory portal. You can integrate a different tool of your choice using instructions in  Adding new Issue Trackers. 

Follow the steps below to start managing issues.

  1. Log in to the App Factory portal (for the online version, try
  2. Select an application from the list of apps that you own or are invited to participate in.
  3. Click the Issues tab from the left panel. 
  4. Click Report Issues. This directs you to Redmine by default. You can log in with the same credentials used to log in to App Factory portal.
  5. After logging in to Redmine, note that the application against which you want to create issues is selected as the current project. You can also select a different application that you own from the drop-down list in the top, right-hand corner. 
  6. Click the New issue link to start reporting defects/improvements etc. to your application. For example,

    For more information on managing your projects in Redmine, see
  7. After creating issues, come back to the application's Issues tab in App Factory portal. It shows a summary of issues for each version. For example,

  • No labels