How to Create a Project using algoScraper Extension

TABLE OF CONTENTS

1. Overview

2. Creating a Project

2.1 Searching a Project

2.2 Adding Scraped Data to the Existing Project

3. Creating Projects in algoQA with the Uploaded Scraped files

1. Overview

This article provides you the details for creating the project directly from the algoScraper extension. This feature reduces the effort for you to download the scraped file from the algoscraper tool and upload the scraped file for creating an offline model.

2. Creating a Project

Perform the following:

1. Navigate to the application where you want to scrape the UI elements. Click the algoScraper extension from the Chrome Browser bar.  You can either scrape all the elements by clicking the Scrape UI button or click the individual elements to enable algoQA button in the Scraper window.
   Note that before clicking on the algoQA button, if you wish to update the names of the UI elements, you can update it manually by clicking on individual name in the Control Name section.
   
   
2. Click the algoQA button to navigate to the Create Project screen in the Profiler page.
   1. In this screen, enter the project name. 
   2. By default, the Use scraped data option is selected; If it is not selected, select this option.
   3. Click the Create Project button.
      By default, web automation is selected as the Automation Type.
      
3. In the Main Canvas, Nodes will be automatically created along with the corresponding features and UI elements upon clicking the Create Project button, as shown:
   

2.1 Searching a Project

To search for a project, perform the following:

1. In the left pane of the Main Canvas, find the search textbox.
2. Enter the same project name as provided earlier. 
3. You will see the configuration folder displayed, as shown:
   

2.2 Adding Scraped Data to the Existing Project 

If there are changes in your application, you can add additional scraped data to the existing project.

Perform the following:

1. In the algoScraper window, scrape the required UI elements.
2. Click algoQA button to navigate to the Create Project screen in the Main Canvas.
3. In the Project Explorer, search for the required project, click More Menu options next to the configuration folder to choose Upload scraper file option. For more information, see How to Upload existing scraped file article.
4. You can upload the scraped file using 'Upload' option and select the 'Use the JSON scraped to create configuration' option and click Submit to view the node configured for the re-scraped UI elements. Note that you can move the active node to see the original node. 
   

   Note: Ensure that you provide a unique control name. Otherwise, you will see a message stating that 'Duplicate Control names are not allowed'. 
   
   

3. Creating Projects in algoQA with the Uploaded Scraped Files

Consider the configuration folder with uploaded scraped files as represented in the screenshot.

To access the Configuration file, perform the following:

1. In the Project Explorer, select the appropriate Project Name> Configuration Folder. 
2. Configuration folder displays all the uploaded or created CSV files. Each file is segregated using a different naming convention.
   
   
   

You can either create a project using algoQA button or from Create a Project page in the Profiler window.

Following are the methods for creating a project or uploading a scraped file from the algoScraper Chrome extension:

1. Upload a scraped file using downloaded file after scraping the UI elements with the algoScraper extension.
2. Create a project using algoQA button from the algoScraper extension.
3. Re-scrape the UI elements if there are application changes and create a project using algoQA button. The re-scraped elements will be reflected in the different node, which is created earlier. You can upload this scraped file using 'Upload' option and select the 'Use the JSON scraped to create configuration' option and click Submit to view the node configured for the re-scraped UI elements. Note that you can move the active node to see the original node. 
4. If you wish to upload any additional workflow to the existing configuration, you can upload the scraped file. For example, if you wish to add a validation check flow for credit card details, then you can upload the scraped file only for this particular configuration.