# Java JUnit
## Installation
First we need to include the Cloudbeat dependencies inside our pom.xml:
```
io.cloudbeatcb-kit-selenium4LATESTio.cloudbeatcb-kit-commonLATESTio.cloudbeatcb-kit-junit5LATEST
```
If you want to use a specific version, include it inside properties:
```
1.0.11
```
Then instead of LATEST, use cloudbeat.version
```xml
io.cloudbeatcb-kit-selenium4${cloudbeat.version}
```
{% hint style="info" %}
For on-prem, we can install the Cloudbeat kit using files stored locally
{% endhint %}
We need to specify the version of the jar files:
```
1.0.11-SNAPSHOT
```
Then install the dependencies:
```
mvn clean install
```
## Implementing Cloudbeat Reporting
We need to start by importing the Cloudbeat step extension inside our methods file:
```
import io.cloudbeat.common.annotation.CbStep;
```
Then, add CbStep above your method:
```
@CbStep("Open Base URL")
public void open() {
driver.get(baseUrl);
}
```
Import CloudBeat Junit extension in our tests:
```
import io.cloudbeat.junit.CbJunitExtension;
```
Extend Cloudbeat JUnit extension class:
```
import org.junit.jupiter.api.extension.ExtendWith;
@ExtendWith({ CbJunitExtension.class })
public class LoginTest {
private WebDriver driver;
private LoginPage loginPage;
@BeforeEach
public void setUp() {
driver = DriverManager.getDriver();
loginPage = new LoginPage(driver);
}
}
```
Wrap your test steps using startStep & endLastStep:
```
@Test
@DisplayName("Standard User Login Behaviour")
public void standardUserLoginBehaviour() {
CbJunitExtension.startStep("Open Main Page");
loginPage.open();
loginPage.assertPageOpen();
CbJunitExtension.endLastStep();
}
```
## Creating a Java JUnit project in Cloudbeat
Under Manage, open projects and click on add project, choose a name and select Java JUnit.
### Connect your test project to CloudBeat
CloudBeat is a platform for both test reporting and execution. To use CloudBeat, you must upload your test project files to execute tests and access report analytics. You can upload your project as a Zip file, or CloudBeat can automatically synchronize with your test project Git repository.
### Git synchronization
In order to sync your test project from git, select Git Integration and paste the url to your repository.
You can use your username and password, or with an access token.
### Uploading manually
If you want to upload a local test project, you need to zip your project folder, then select upload.
## Running your tests
Under Testing, go to cases and you will see all your tests. Under each test you will find multiple options such as choosing who will receive notifications for this test, schedule when the test will run, choosing environments and parameters and the browser it will run on.
Click on Run Now to execute the test, then the results will appear under the Results tab.
To expend the results and see all the steps, data, logs and errors, click on case summary:
### Running multiple tests
Under Testing, go to Suites, right-click on Dashboard to create a new suite, or start by creating a new folder then right-click on it and choose Create suites - web.
Similarly to single tests, select your browser and other configurations:
Select your desired tests:
Click on Save Changes and then Run Now. The results will wait for you under the results tab.
