Page Comparison

...

1. User should have the QAS - Client installed.

2. Enable the feature flags.

3. The project needs to be Salesforce.

4. User should create Connect App in Salesforce.

...

Establishing Connection with the Salesforce

...

Application

To start using the Salesforce application, you need to first establish a connection between QAS - Client and the Salesforce application you a willing to use.

...

1. Click Import Objects to open the Import Salesforce Objects window.

2. You will see two options StandardButtons and the connection fields.

   

3. Import the Standard Buttons if not done before.
   Importing standard buttons is a one-time process. Once you have imported the standard buttons, it can be used for all the connections.

4. Expand the connection by clicking on the arrow to view all the objects tabs and fields available for the connectionavailable objects under it.

5. Select Search for the objects tab you want to import and click Import.

   Image Removed

Existing Connection

Already established connection where objects have been imported before. In this case, you will see an Import Object option next to Edit Connection. You can reimport the objects using this option.

1. Click Import Object to open the Import Salesforce Objects window.
   

   Image Removed

2. Expand the connection by clicking on the arrow to view all the objects and fields available for the connection.

3. Select the objects you want to import and click on Import.

Create Salesforce API Object

To create SFDC API object follow the below steps:

1. Go to Object Repository.

2. Click New API Object option for the connection as shown in the image below.

   Image Removed

3. Clicking New API Object will open the Create Salesforce API Object screen.

4. On the Create Salesforce API Object screen, enter the details such as:

   • Name: Enter the API name.

   • Salesforce Object: Select the Salesforce object form the dropdown. You will see list of all the imported objects here.

   • Operation: Choose the operation you want to perform on the object.

   • Description: Add desired description for the API.

     Image Removed

5. Once the Salesforce Object and Operation fields are selected, the Dataset and Validation Rules tabs will be enabled.

6. Now to perform the operation, you need to provide the dataset. Go to the Dataset tab and provide the details.

   Image Removed

   Note: All the mandatory fields (marked with asterisk) in the application will be fetched in default dataset. Dataset: 1 in the above image is the default dataset.

7. To add more dataset, click the + icon from the top-right corner.

8. Click on the three dots to:

   • Edit: Edit the dataset.

   • Duplicate: Create duplicate dataset.

   • View JSON: View JSON for the dataset.

   • Delete: Delete the dataset, only if there are more than one dataset.

   Image Removed

9. Click Test from the top-right corner to test the request.

10. Clicking Test will open a Response screen (as shown below), where you can view the test results. You can view the result in JSON or Text format.

    Image Removed

11. You can also view the result on the Salesforce application. The data will be fetched, and a JSON will be created on the Salesforce application.

12. Click Validation Rules tab to create a validation rule for an object.

13. When no Validation Rule exist, you are prompted to Create a validation set.

14. You can also click + Create Validation Set from the top-right corner of the tabular section.

Clicking Create will open a Create Validation Set windowwith the following fields: 

the object for and click the arrow near the tab to expand it, you will see three containers:

• Create: Contains list of all the objects available for the tab. Expand Create to view the list of objects. Select the objects you want to import or check the checkbox next to Create to select all.

• WebLinks: Consists of list of all the weblinks available for the tab. Expand WebLinks and select the ones you are willing to import.

• Record Details Pages: The record details will be available under Record Details Pages.

Image Added

15. Use filter next to Search to select the objects based on the Object Class and Object Type. For object type, you can select from the following options.

    • All: All the fields including mandatory as well as non-mandatory will be imported.

    • Mandatory: Only the mandatory fields will be imported.

    • Non-Mandatory: Only non-mandatory fields will be imported.

      Image Added

16. Once you have selected the objects you want to import, click Import.

17. The objects will be imported successfully.

Existing Connection

Already established connection where objects have been imported before. In this case, you will see an Import Object option next to Edit Connection. You can reimport the objects using this option.

1. Click Import Object to open the Import Salesforce Objects window.
   

   Image Added

2. Expand the connection by clicking on the arrow to view all the objects and fields available for the connection.

3. Follow steps 5 to 8 from New Connection.

Change Management

The Change Management or Sync Object functionality allows you to fetch the real-time updates or changes done on the SFDC application and review them.

1. Go to Salesforce tab from the Object Repository.

2. Click Sync Object from the right-hand corner. You will see Loading changed objects… screen.
   

   Image Added

3. Once the loading is complete, you will see an Object Updates window.

4. On the Object Updates window, you can review all the changes/updates done on the SFDC application. Where N stands for new, D stands for deleted, and U stands for updates object.

   Image Added

5. Click Accept to accept the change; else, click Cancel.

Multi-locator Support for Imported Object

QAS provides multi-locator support for the imported objects. Multiple locators for an object allow you to run a successful execution without interruption.

There are three locator types that QAS support for imported SFDC objects, which include SFDC:LABEL, SFDC:PARENT_LABEL, and SFDC:NAME. You can drag and drop the locator type field and rearrange the sequence as per your preference.

...

Create Salesforce API Object

Create Salesforce API Object through Object Repository

To create SFDC API object follow the below steps:

1. Go to Object Repository.

2. Click New API Object option for the connection as shown in the image below.

   Image Added

3. Clicking New API Object will open the Create Salesforce API Object screen.

4. On the Create Salesforce API Object screen, enter the details such as:

   • Name: Enter the API name.

   • Salesforce Object: Select the Salesforce object form the dropdown. You will see list of all the imported objects here.

   • Operation: Choose the operation you want to perform on the object.

   • Description: Add desired description for the API.

     Image Added

5. Once the Salesforce Object and Operation fields are selected, the Dataset and Validation Rules tabs will be enabled.

6. Now to perform the operation, you need to provide the dataset. Go to the Dataset tab and provide the details.

   Image Added

   Note: All the mandatory fields (marked with asterisk) in the application will be fetched in default dataset. Dataset: 1 in the above image is the default dataset.

7. To add more dataset, click the + icon from the top-right corner.

8. Click on the three dots to:

   • Edit: Edit the dataset.

   • Duplicate: Create duplicate dataset.

   • View JSON: View JSON for the dataset.

   • Delete: Delete the dataset, only if there are more than one dataset.

   Image Added

9. Click Test from the top-right corner to test the request.

10. Clicking Test will open a Response screen (as shown below), where you can view the test results. You can view the result in JSON or Text format.

    Image Added

11. You can also view the result on the Salesforce application. The data will be fetched, and a JSON will be created on the Salesforce application.

12. Click Validation Rules tab to create a validation rule for an object.

    1. When no Validation Rule exist, you are prompted to Create a validation set.

    2. You can also click + Create Validation Set from the top-right corner of the tabular section.

    3. Clicking Create will open a Create Validation Set windowwith the following fields: 

       1. Name: Enter an intuitive name for the validation set that is easy to recognize.
          Maximum length permitted is 300 characters including spaces.

       2. Description: A brief description about the suite.

    4. Click Save to proceed; otherwise, click Cancel.

    5. You can now add validation rules under the Validation Set.

       1. Click Add Validation Rule from the validation set you created.

       2. Clicking Add Validation Rule will open a Create Validation Rule windowwith the following fields:

          • Rule Name: Enter an intuitive name for the validation

          set

          • rule that is easy to recognize.
            Maximum length permitted is 300 characters including spaces.

       3. Description: A brief description about the suite.

    6. Click Save to proceed; otherwise, click Cancel.

    7. You can now add validation rules under the Validation Set.

       1. Click Add Validation Rule from the validation set you created.

       2. Clicking Add Validation Rule will open a Create Validation Rule windowwith the following fields:

          • Rule Name: Enter an intuitive name for the validation rule that is easy to recognize.
            Maximum length permitted is 300 characters including spaces.

          • Rule Type: You can select one of the three rule types.

            • Status Code: Select Status Code and provide the Expected Status Code to validate against it.

              Image Removed

            • Response Time: Select Response Time and enter the Response Time Witnin to get the expected response in time. This value should be in milliseconds.

            • Property-Value: Selecting Property-Value will open few more fields:

              • Field Name: Enter the field name that is available for the object.

              • Field Type: Select the field type from the dropdown, Text, Boolean, or Integer.

              • Match Field Value: Select Exact Match or Contains from the dropdown as per your requirement. Exact Match will look for the same field value provided.

              • Value: Enter the field value you want to be in your response.

                Image Removed

              • Select the check box Store field value as if you want to store the response as a Key.

          • Click Test Rule to validate the created rules.Rule Type: You can select one of the three rule types.

            • Status Code: Select Status Code and provide the Expected Status Code to validate against it.

              Image Added

            • Response Time: Select Response Time and enter the Response Time Witnin to get the expected response in time. This value should be in milliseconds.

            • Property-Value: Selecting Property-Value will open few more fields:

              • Field Name: Enter the field name that is available for the object.

              • Field Type: Select the field type from the dropdown, Text, Boolean, or Integer.

              • Match Field Value: Select Exact Match or Contains from the dropdown as per your requirement. Exact Match will look for the same field value provided.

              • Value: Enter the field value you want to be in your response.

                Image Added

              • Select the check box Store field value as if you want to store the response as a Key.

          • Click Test Rule to validate the created rules.

Create Salesforce API Object through Test Case Editor

1. Login to QAS - Client.

2. Access Develop from left navigation to view Test Explorer screen.

   1. On the Explorer section, you can view existing Test Scenarios.

3. Click the Expand option on a test scenario, where you can view all its test cases.

4. Select a test case.

5. Right-click on the test case and hover over Create Object.

6. Click Salesforce API, it will open Create Salesforce API Object screen.

7. Follow steps 4 to 12 from the previous section. https://qualitia.atlassian.net/wiki/spaces/QASNew/pages/edit-v2/34857453225#Create-Salesforce-API-Object-through-Object-Repository.

   Image Added

Steps to Generate Security Token

...

1. Issue: Unable to find “Reset My Security Token” Information or “Your security token isn’t displayed in your settings or profile.”
   Solution:
   Qualitia Client
   Standard Resolutions for the above are:

   • Restriction enabled in connected App

     • Go to Setup

     • Search for “Manage App”

     • Select your connected app

     • Click on “Edit Policy”

     • In the Trusted IP Range for OAuth Web server flow section

     • Select “No Restriction”/ “Anyone can connect” or enter the right restrictions as per your policy.

   • IP Restrictions in the Login IP Ranges

     • For the Reset My Security Token option to appear you will need to remove the Login IP Ranges or change the User to a profile that does not have Login IP Ranges listed.

   • In Salesforce Classic

     • Unlimited, Performance or Enterprise, system administrators can verify if there are IP values in the Login IP ranges by selecting:
       Setup -> Manage Users -> Users -> Profile -> Profile name -> Login IP Ranges.

     • System administrators can verify if there are IP values in the Login IP ranges by selecting:
       Setup -> Security Controls -> Session Settings.

     • Remove the IP ranges if required.

   • In Lightning Experience

     • System administrators can verify if there are IP values in the Login IP ranges by clicking going on the gear icon:
       Setup Home -> Users -> Profiles -> select the profile name -> Login IP Ranges.

     • System administrators can verify if there are IP values in the Login IP ranges by clicking going on the gear icon:
       Setup Home -> Security -> Session Settings.

   • Network Access is missing

     • System administrators can confirm if Network Access is missing by following these steps:

       • Go to Setup

       • On the Quick Find box, enter Network Access.

       • Login Challenge Enabled

       • Login with API Token
         OR

       • Delete the IP address range in the network access.

     • Forcefully reset by hitting the following URL:

       • § /_ui/system/security/ResetApiTokenEdit

2. Not able to load the SFDC project after an upgrade: If you are not able to load the SFDC project after an upgrade to Qualitia’s latest version, you need to delete the Workspace folder. You can find the workspace folder on the below path: C:\Users\user1\AppData\Local\Qualitia Automation Studio - Client\workspace.

3. Newly added objects are not visible on Import model: If you are not able to find a newly added object on the import model, while creating an object create it as mandatory and save. Once the object is saved, make it non-mandatory, as only mandatory fields are visible on the Import modal. This will make the object visible and ready to be used.

4. The Check operation for the imported SFDC Checkbox object failed, it displays a pass result in the report: If the Check operation for the imported SFDC Checkbox object is failed then the result displayed in the report should be fail. However, if you are getting a pass result, try the execution with indexing.

5. Error while fetching objects for connection: If you are getting the error message Error while fetching objects for connection, while importing the objects, make sure to enable the Client credential flow on the Connected App.
   Note: You can also connect using OAuth Client Credential to avoid such errors.

📞📚 Here to Help: Support and Resources

...