Page Comparison

...

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:

...

Go to Object Repository.

...

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

...

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

...

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

...

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

...

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

...

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.

...

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

...

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.

...

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

...

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.

...

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.

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

...

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

...

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

...

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.

...

Click Save to proceed; otherwise, click Cancel.

You can now add validation rules under the Validation Set.

...

Click Add Validation Rule from the validation set you created.

...

• 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.

Steps to Generate Security Token

Please generate the security token for all the users by following the below steps.

1. Login to Salesforce and go to Personal Settings.

2. In the Quick Find box, type "Reset" and click Enter.

3. From the search results, select Reset My Security Token.

4. You'll be directed to a page or option where you can reset the security token.

5. Click on the option or button labeled Reset Security Token.

6. After clicking, Salesforce will generate a new security token for you.

7. Check the email address associated with your Salesforce personal settings. You might have received an email containing the new Security Token.

8. Note down or copy the Security Token from the email.

9. You can now use this security token for authenticating with Salesforce or any integrations that require it.

APIs Used

QAS uses certain APIs to get access to the application data. The following are the categories of APIs used:

Metadata APIs

Metadata APIs

Connection APIs

Basic authentication

OAuth Authentication

💡 Golden Nuggets: Best Practices to Establish Connection Between Salesforce and Qualitia

There are 2 ways to Establish a connection between Salesforce and Qualitia.

• Using salesforce URL- for this we need Salesforce URL, Username, Password and security token.

• Using O-auth- for this we need Salesforce URL, Username, Password, Client Id, Client Secret.

🔧 Got a problem? Let’s fix!

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:

2. 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.

3. 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

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

4. 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

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

6. 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

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 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 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.

Steps to Generate Security Token

Please generate the security token for all the users by following the below steps.

1. Login to Salesforce and go to Personal Settings.

2. In the Quick Find box, type "Reset" and click Enter.

3. From the search results, select Reset My Security Token.

4. You'll be directed to a page or option where you can reset the security token.

5. Click on the option or button labeled Reset Security Token.

6. After clicking, Salesforce will generate a new security token for you.

7. Check the email address associated with your Salesforce personal settings. You might have received an email containing the new Security Token.

8. Note down or copy the Security Token from the email.

9. You can now use this security token for authenticating with Salesforce or any integrations that require it.

APIs Used

QAS uses certain APIs to get access to the application data. The following are the categories of APIs used:

Metadata APIs

Metadata APIs

Connection APIs

Basic authentication

OAuth Authentication

💡 Golden Nuggets: Best Practices to Establish Connection Between Salesforce and Qualitia

There are 2 ways to Establish a connection between Salesforce and Qualitia.

• Using salesforce URL- for this we need Salesforce URL, Username, Password and security token.

• Using O-auth- for this we need Salesforce URL, Username, Password, Client Id, Client Secret.

🔧 Got a problem? Let’s fix!

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:

   When you create a new connection using the Salesforce application and try to import objects, you will see additional object entries under the Import Object section

   • 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 selectingclicking going on the gear icon:
       Setup -> Manage Users Home -> Users -> Profile Profiles -> Profile select the profile name -> Login IP Ranges.

     • System administrators can verify if there are IP values in the Login IP ranges by selectingclicking going on the gear icon:
       Setup Home -> 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. • • 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

5. 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.

6. 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.

7. 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.

8. 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

...