7.1 Creating a Canvas

Login to https://portal.ahasa.io/login.
On the Left Pane, click Canvas.

Figure 7.1.1: Navigating to Canvas
Click the + sign or the Create button to add a new canvas (Card View). Click the Create button to add a new canvas (Grid View)
.
Figure 7.1.2: Navigating to Creating Canvas (Card View)

Figure 7.1.3: Navigating to Creating Canvas (Grid View)

Refer below to know more about the Canvas UI Elements.

Figure 7.1.4: Canvas UI Elements

When a product which has a Mandatory dependency on another product (created in the Products section), and it is dragged and dropped into the Canvas, the Mandatory dependent product will automatically be added. Click Here to know more about product onboarding and management.
Once the products are added, the automatically added product cannot be removed while the dependent product exists in the Canvas.
The connection between the dependent products cannot be deleted. This is added as a configuration in version management.

REFER SCREENSHOTS BELOW

Figure 7.1.5: An attached product is added automatically

Figure 7.1.6: An attached product cannot be deleted when there is a dependency (here, test5 depends on compose)

Figure 7.1.7: An attached product connector cannot be deleted when there is a dependency (here, test5 depends on compose)

7.1.1 Adding a Product to Canvas, Changing Product Properties, and Removing a Product from Canvas

Drag and drop the required products from the available products section.

Figure 7.1.1.1: Adding Products to Canvas
Click on a product and add/change the required product properties in the product properties section.

Figure 7.1.1.2: Adding/Changing Product Properties
To remove a product from canvas, click the required product on the work area and press the Delete key.
If the Environment Variables created during the product version creation were marked as Read-Only, then the user will not be able to override those variables in the Canvas properties section.
If the Environment Variables created during the product version creation were NOT marked as Read-Only, then the user will be able to override those variables in the Canvas properties section by clicking on the update icon of that variable.

Figure 7.1.1.3: Updating Environment Variable

7.1.2 Creating and Removing Connections Between Products

Click on the canvas, drag from the small square of the product to the other product which needs to be connected (The connection originates from the first product to the second product).

Figure 7.1.2.1: Connecting Products
The blue line denotes a valid connection and the red line denotes an invalid connection.

Figure 7.1.2.2: Valid and Invalid Connections
To remove a connection, click the connection and press the Delete key.

7.1.3 Adding Integrations Between Products

The integration can only be added if the products have integrations created during the creation of the product. Refer Products to know more about product onboarding and management.

Drag and drop the required product from the available products section.

Figure 7.1.3.1: Adding Product with dependency
Select the Connector and click Add Integration.

Figure 7.1.3.2: Navigating to Adding Integration
Fill the following information.

Figure 7.1.3.3: Adding Integration (Environment Variable)

Figure 7.1.3.4: Adding Integration (Endpoint)
- Expand Integration Header (here, Integration test5/Compose).
- Select the Product from the two.
- Select the From Environment Variable.
- Select the To Type.
- If the To Type is Environment Variable, then enter the To Environment Variable.
- If the To Type is Endpoint, then enter the To Endpoint Name.
- Click Add to add the Environment Variable/Endpoint. Multiple Environment Variables/Endpoints can be added.
- From Environment Variable will be disabled if the second product is selected (Refer screenshot below).
  
  Figure 7.1.3.5: Adding Integration (Selected second product, disabled field)
Click to delete the Environment Variable/Endpoint. Click to view the Environment Variable/Endpoint.

Figure 7.1.3.6: View or Delete Environment Variable/Endpoint

7.1.4 Saving, Publishing, and Exporting Canvas

Once the canvas has been created with all the products, enter the Canvas Name and click Save & Exit to save the Canvas.
NOTE: When the canvas is saved, it won’t be published for use.
Click Publish to publish the canvas for using it,
NOTE: All connections must be valid and all the properties should be assigned before publishing the canvas, When the canvas is published, it will be published for use.
Click Export to PDF to export the canvas in PDF format.

Figure 7.1.2.3: Saving, Publishing, and Exporting Canvas