# Tosca Cloud

### Integrating Tosca Cloud Test Automation with ReleaseOwl

This guide will help you integrate **Tosca Cloud** test automation with the **ReleaseOwl** dashboard to enhance your testing and release management workflows. With this integration, you can seamlessly monitor and manage cloud-based test automation, gain actionable insights, and automate test execution as part of your release pipeline.

### Prerequisites

Before starting, ensure the following prerequisites are met:

#### &#x20;Tosca Cloud Setup:

* A valid **Tricentis Tosca Cloud** account is available.
* You have access to the **Tricentis Cloud Platform (TCP)** to manage users and workspaces.
* Your test cases are uploaded or available in Tosca Cloud.

{% hint style="info" %}
**Note:** For more information on how to create playlists or run test cases in Tosca Cloud, please refer to the [link](https://documentation.tricentis.com/tricentis_cloud/en/content/run_tests/run_tests.htm).
{% endhint %}

### Steps for Integration

1. Go to the https\://\<yourdomain>.my.tricentis.com/\_identity/apiDocs/swagger/index.html.  Here, `<yourdomain>` refers to the domain name of the account you created on **Tricentis Tosca Cloud**.
2. **Authorize and Retrieve Token URL:**
   * Click the **Authorize** button.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FzyypaEemYRCfDXtaUVxk%2Fimage.png?alt=media&#x26;token=d1b03eb4-788d-49ae-97d4-c0a856065700" alt=""><figcaption></figcaption></figure>

* Copy the **token URL** displayed.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FDYJBGjLiaF0b6eUQyCzr%2Fimage.png?alt=media&#x26;token=28cfe960-ade4-4bf3-9e13-449f7f3c5c90" alt=""><figcaption></figcaption></figure>

3. **Get All Applications of the Organization:**

* Scroll to the section named **Application**.
* Click on **Get all applications of the organization**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FJjUh5VXX9WPhhZQnP0oU%2Fimage.png?alt=media&#x26;token=69f8551b-4d79-4c40-b8ab-221717d3b6c3" alt=""><figcaption></figcaption></figure>

* Click **Try it out**, then click **Execute**.
* From the response, identify and copy the **Client ID**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Fj14StTIh2dncyP46zLfp%2Fimage.png?alt=media&#x26;token=772b825e-767c-4071-9475-2a241f820fcd" alt=""><figcaption></figcaption></figure>

4. **Locate the Tricentis Cloud API Application:**

* Search for the application associated with **Tricentis Cloud API**.
* Copy the **Application ID** (you’ll use this to retrieve the Client Secret).

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FzhdhbPUHyXE9Rx5I8Ov7%2Fimage.png?alt=media&#x26;token=5a273e53-a201-4333-b44d-071963f2712b" alt=""><figcaption></figcaption></figure>

5. **Retrieve the Client Secret:**

* Navigate to **List all the secrets for an application**.
* Paste the **Application ID** you copied earlier into the input field.
* Click **Try it out**, then click **Execute**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FxWRfg2lve3fIkgxWLWyk%2Fimage.png?alt=media&#x26;token=df754a50-45d0-4c29-be41-e41552f5f2d1" alt=""><figcaption></figcaption></figure>

* The response will contain the **Client Secret**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FkPUNI3cSFqasC3UjwY00%2Fimage.png?alt=media&#x26;token=f33dc1bc-785f-4c44-ba33-369cd4b0fc2e" alt=""><figcaption></figcaption></figure>

6. **Register Credentials in ReleaseOwl:**

* In ReleaseOwl, go to **Credential Manager**.
* Click on **Register Credential** and select the credential type as **Tosca Cloud**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FIhKt0x2q6Rq33ovN7pFI%2Fimage.png?alt=media&#x26;token=d842df9a-5b7f-4650-9be5-b07689a72564" alt=""><figcaption></figcaption></figure>

* Paste the **Client ID** and **Client Secret** into the respective fields.
* Click **Save** to complete the integration.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FO2fXBpqxf9Sun07vpmOK%2Fimage.png?alt=media&#x26;token=831569eb-5a73-4530-b27d-39bcb5221a58" alt=""><figcaption></figcaption></figure>

### Test Configuration

Setting up the test configuration allows the ReleaseOwl application to run **Tosca Cloud** test automation with the specified parameters from the designated playlist or execution list using cloud-based execution.

#### **Create a New Test Configuration**

1. In **Project View**, navigate to **Test Configuration**.
2. On the displayed page, click **Create Test Configuration**.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FjcH2t6ZTmj4cOd46xrbZ%2Fimage.png?alt=media&#x26;token=2b8dcfa1-4e94-4d6e-b353-43f6506cce13" alt=""><figcaption></figcaption></figure>

#### **Fill in the Test Configuration Details**

* **Name:** Enter a meaningful name for the test configuration.
* **Test System:** Select **ToscaCloud** as the test system.
* **Credentials:** Select the registered Tosca Cloud credentials.
* **Tosca Cloud URL:** Enter the Tosca Cloud base URL (e.g., `https://<yourdomain>.my.tricentis.com`).
* **Workspace:** Select the appropriate workspace from the dropdown.
* **Playlists:** Choose the desired playlist(s) that contain the test cases to be executed.
* Click the **Submit** button to save the test configuration. Once submitted, a **Tosca Cloud test run** instance is created within ReleaseOwl.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FqVftOMghLOqAyCdAI572%2Fimage.png?alt=media&#x26;token=c6d36915-a70f-4641-b70e-72867b7ae3f2" alt=""><figcaption></figcaption></figure>

* To start the execution, click the **Run** button. Upon execution, a confirmation message will appear indicating whether the test run was successfully triggered in Tosca Cloud.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FYwyHe3TjCbWPUiZd1pEk%2Fimage.png?alt=media&#x26;token=03881926-b612-4f2e-8d59-90da6e012bbc" alt=""><figcaption></figcaption></figure>

### Viewing Test Runs and Reports

1. To view the test runs, click **View Test Runs** against the desired Test Configuration.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FxxrQwoPSs7U6mzQtxfa0%2Fimage.png?alt=media&#x26;token=a8c55659-ee50-46c7-a674-3c630f79fbe7" alt=""><figcaption></figcaption></figure>

2. The test runs and their results, along with **Logs** and **Reports**, will be displayed.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FKrE04Eim29LfUkCVLKPB%2Fimage.png?alt=media&#x26;token=071d0552-4590-451a-a50e-b8f7f09f5b20" alt=""><figcaption></figcaption></figure>

3. **Reports**:\
   Click the **Reports** button to open the Reports section. It displays:
   * The number of playlists that contain the executed test cases.
   * The user who triggered the execution.
   * If the test cases are still in progress, they will be shown in the **Queue** stage.&#x20;

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2Foqo8XaTvTvHWLdnwPGGp%2Fimage.png?alt=media&#x26;token=30ac10c9-5a2b-4116-a04b-16afaba9370c" alt=""><figcaption></figcaption></figure>

4. Once completed, the test results will appear in the **Results** section, where you can click to view details. This will redirect you to the **Tricentis Cloud Platform (TCP)** for detailed insights.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FZNu2QTtO7aryWEVkk5Pn%2Fimage.png?alt=media&#x26;token=0a59da40-155d-427a-8749-af8903053768" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FlSONZ8cTtQhOrOFjo4Ev%2Fimage.png?alt=media&#x26;token=e022409a-20db-4cd6-b808-c9bb1a1d5921" alt=""><figcaption></figcaption></figure>

5. When you expand the side navigation bar, it shows the number of test cases.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FztGDkfZFcpGn5L7BGSOT%2Fimage.png?alt=media&#x26;token=3354e0fc-efb3-4d88-baf7-2c5ca88bd08a" alt=""><figcaption></figcaption></figure>

6. Clicking on **Logs** will display the detailed logs for the selected test run.

<figure><img src="https://1890383800-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDWyxe6hm5vqosFaByVgs%2Fuploads%2FNLeKR8ia0PDlyNnmhGYY%2Fimage.png?alt=media&#x26;token=f1b0568c-f17d-420a-98ee-d4c5496cd9a3" alt=""><figcaption></figcaption></figure>
