Skip to content

Commit

Permalink
Merge pull request #397 from testsigmahq/dev
Browse files Browse the repository at this point in the history
Added all Salesforce Documents
  • Loading branch information
bharathk08 authored Apr 22, 2024
2 parents d6c9d0f + 22b7d95 commit a60faa2
Show file tree
Hide file tree
Showing 9 changed files with 472 additions and 29 deletions.
3 changes: 3 additions & 0 deletions src/left-nav-title.json
Original file line number Diff line number Diff line change
Expand Up @@ -646,5 +646,8 @@
},
"introduction":{
"/docs/salesforce-testing/introduction/": "Intro: Testsigma for Salesforce Testing"
},
"sf-test-cases":{
"/docs/salesforce-testing/sf-test-cases/": " Build Test Cases: Manual+Live"
}
}
66 changes: 63 additions & 3 deletions src/pages/docs/salesforce-testing/connected-app.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Creating a Connected App"
page_title: "Create Connected App"
metadesc: "How to create connected app"
page_title: "Create a Connected App"
metadesc: "A connected app is important to link external applications & the Salesforce ecosystem. This article discusses how to create a connected app in Salesforce."
noindex: false
order: 29.2
page_id: "Create Connected Application"
Expand All @@ -12,8 +12,68 @@ contextual_links:
- type: link
name: "Prerequisites"
url: "#prerequisites"
- type: link
name: "Steps to Create a Connected App"
url: "#steps-to-create-a-connected-app"
- type: link
name: "Fetch Consumer Details"
url: "#fetch-consumer-details"
---

---

Creating a connected app is important to link external applications and the Salesforce ecosystem. With a connected app, you can integrate APIs, enable single sign-on (SSO), and build applications. This article discusses how to create a connected app in Salesforce.

---

## **Prerequisites**

- Salesforce organization with the test setup.

---

## **Steps to Create a Connected App**

1. Log into your Salesforce instance.
![Login](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfcalg.png)

2. On the **Setup** page, enter **Apps** in the quick find box, then choose **App Manager**.
![Setup](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfcasa.png)

3. On **Lightning Experience App Manager**, click on **New Connected App**. This will open **App Manager** for **New Connected App**.
![LE App Manager](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfcalena.png)

4. In the **Basic Information** section, enter **Connected App Name**, **API Name**, and **Contact Email**.
![Basic Information](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sacabi.png)

[[info | **NOTE**:]]
| - Salesforce automatically fills in the **API Name** input field.
| - Other input fields are optional.

5. In the **API** section, select the **Enable OAuth Settings** checkbox to set **Callback URL** and **Selected OAuth Scopes**. The **Selected OAuth Scopes** are mandatory in the **Connected App** to connect & download the metadata.
![API Details](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfcaapiinfo.png)

6. Click on **Save**.
![Save](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfcasave.png)

[[info | **NOTE**:]]
| A connected app is limited to only a few approvals. The system can revoke the oldest approval when the limit exceeds automatically. As a best practice, you can create a different connected app for each new application connection/connection.

---

Coming Soon!
## **Fetch Consumer Details**

1. Edit the connected app and click on **Manage Consumer Details**. This will open a new window.
![Edit](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfcaed.png)

2. On the **Verify Your Identity** window, enter OTP sent to the admin email.
![Verify](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfcavyi.png)

3. Upon verification, the **Consumer Details** page will be displayed with **Consumer Key** and **Consumer Secret**.
![Consumer Details](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfcacdtls.png)

4. For Security Token, go to **My Personal Information > Reset My Security Token** and click on **Reset Security Token**. A new token will be sent to admin mail.
![Reset Security Token](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfcarst.png)


---
37 changes: 34 additions & 3 deletions src/pages/docs/salesforce-testing/create-sf-project.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Creating a Salesforce Project"
page_title: "Introduction: Testsigma for Salesforce Test Automation"
metadesc: "Salesforce Testing with Testsigma helps reduce average test authoring time by 50%, and test case execution will be 2X faster with a user-friendly interface"
page_title: "Creating a Salesforce Project"
metadesc: "Create and manage projects for Salesforce applications. This article discusses how to create a project for Salesforce testing in Testsigma."
noindex: false
order: 29.3
page_id: "Testsigma for Salesforce Test Automation"
Expand All @@ -12,8 +12,39 @@ contextual_links:
- type: link
name: "Prerequisites"
url: "#prerequisites"
- type: link
name: "Steps to Create a Salesforce Project"
url: "#steps-to-create-a-salesforce-project"
---

---


In Testsigma, users can create and manage multiple projects and applications. Creating a Salesforce project is the same process as any other project. This article discusses how to create a project for Salesforce testing in Testsigma.


---

Coming Soon!
## **Prerequisites**

- A Salesforce org with test setup
- Salesforce connected app

---

## **Steps to Create a Salesforce Project**

1. From the **Dashboard**, go to **Project** and click on **New Project**.
![New SF Project](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfpccnp.png)

2. On the **New project** page,
- Enter **Project name** and choose **Salesforce** from the **Application type** dropdown.
![Name & App Type](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfnpc.png)
- Enter **Application** name, **Version** and click on **Create**.
![App Name & Version](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfpccoc.png)

3. You’ll be redirected to the **Salesforce connections** page.
![SF Connections](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfprtsfc.png)


---
50 changes: 45 additions & 5 deletions src/pages/docs/salesforce-testing/element-repos.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
title: "Element Repositories"
title: "Salesforce Element Repositories"
page_title: "Element Repositories"
metadesc: "How to check Element Repositories"
metadesc: "Elements repositories from Salesforce are imported after successfully synchronizing metadata. This article discusses Salesforce elements repositories."
noindex: false
order: 29.7
page_id: "Element Repositories"
Expand All @@ -10,10 +10,50 @@ contextual_links:
- type: section
name: "Contents"
- type: link
name: "Prerequisites"
url: "#prerequisites"
name: "Naming Conventions"
url: "#naming-conventions"
- type: link
name: "Steps to Check Element Repositories"
url: "#steps-to-check-element-repositories"
---

---

Coming Soon!
In Testsigma, elements from Salesforce are automatically learned after successfully synchronizing metadata. This enables the swift usage of elements in test cases, eliminating the need to create elements manually. This document discusses the repositories of Salesforce elements.

---

## **Naming Conventions**

1. **Field Names:** This will be in the **ObjectName_FieldName** format.
- **Example:** If the element name is **Account_CreatedDate**, **Account** is the object, and the created date **Field** is **CreatedDate**.

2. **Screen Names:** Generally, the name displayed on the UI screen is the object name.
- **Example:** A screen displaying account details should be named **Account**.

[[info | **NOTE**:]]
| Element names should be unique to avoid conflicts.


---

## **Steps to Check Element Repositories**


1. Navigate to **Create Tests > Test Cases**, and open any test case or create a test case.
![Test Cases](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfertcs.png)

2. From the **Test Case Details** page, add test steps and hover over the element and click on **Select Element** from the dropdown.
![Test Case Details](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sferse.png)

3. This will open the **Elements** overlay, where you can see all the elements.
![Overlay](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sferoverlay.png)

[[info | **NOTE**:]]
| Since the elements are auto-learned, you can't edit them.

4. You can also create the element manually by clicking on **Create Element**.

ℹ️ For more information, refer to [creating elements manually](https://testsigma.com/docs/elements/web-apps/create-manually/).

---
36 changes: 33 additions & 3 deletions src/pages/docs/salesforce-testing/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,10 +10,40 @@ contextual_links:
- type: section
name: "Contents"
- type: link
name: "Prerequisites"
url: "#prerequisites"
name: "Setup"
url: "#setup"
- type: link
name: "Getting Started"
url: "#getting-started"
- type: link
name: "Getting Help"
url: "#getting-help"
---

---

Salesforce is a cloud-based Customer Relationship Management (CRM) platform that is the backbone for many businesses worldwide. However, testing applications built on Salesforce can be difficult because of complex workflows, frequent updates, and complex DOM structures. Testsigma revolutionizes Salesforce test automation by reducing average test authoring time by 50%, ensuring reliability, speeding up test case execution (up to 2X faster), and providing a user-friendly interface with a minimal learning curve.

---

## **Setup**

- For setup, refer to creating a connected app and configuring metadata connection.

---

## **Getting Started**

- Create User Connections
- Live Test Authoring
- Element Repositories
- Special NLPs

---

Coming Soon!

## **Getting Help**

- Reach out to Testsigma support at **[email protected]**.

---
100 changes: 96 additions & 4 deletions src/pages/docs/salesforce-testing/metadata-connections.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,111 @@
---
title: "Creating Metadata Connections"
page_title: "Introduction: Testsigma for Salesforce Test Automation"
metadesc: "Salesforce Testing with Testsigma helps reduce average test authoring time by 50%, and test case execution will be 2X faster with a user-friendly interface"
page_title: "Metadata Connections"
metadesc: "A Metadata connection enables actions like refreshing metadata, configurations, creating objects, & managing components that define how the application behaves"
noindex: false
order: 29.4
page_id: "Testsigma for Salesforce Test Automation"
page_id: "Creating Metadata Connections"
warning: false
contextual_links:
- type: section
name: "Contents"
- type: link
name: "Prerequisites"
url: "#prerequisites"
- type: link
name: "Steps to Create Metadata Connection"
url: "#steps-to-create-metadata-connection"
- type: link
name: "Steps to Edit Metadata Connection"
url: "#steps-to-edit-metadata-connection"
- type: link
name: "Steps to Refresh Metadata Connection"
url: "#steps-to-refresh-metadata-connection"
---

---

In Testsigma, you can create a Salesforce application and establish a Metadata connection, which enables you to perform various actions like retrieving metadata, updating configurations, creating custom objects, and managing other components that define how the application behaves. This article discusses creating a metadata connection in Testsigma.

---

## **Prerequisites**

- You need to have Salesforce org with test setup
- Salesforce connected app

---

## **Steps to Create Metadata Connection**

1. Click on **Create metadata connection** on **Salesforce connections page**.
![Create Metadata](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmdcm.png)

2. This will open the **Metadata connection** prompt.
![Prompt](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmaprm.png)

3. On **Metadata connection** prompt,
- Enter **Connection name**, which is generally the user role you connect through, e.g., **Admin**.
![Name](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmdname.png)
[[info | **NOTE**:]]
| You can also choose a custom name for the connection.
- Choose the **Production / Developer edition**, if you’re testing the product environment or Sandbox, if you’re testing the staging environment from **Connect with** dropdown.
![Edition](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/samdce.png)
- Choose the **Authentication type** from the dropdown. In this example, we are choosing **OAuth 2.0**.
![Authentication](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmdatype.png)

<details style="border: 1px solid gray; border-radius: 4px; padding: 0.5em; margin: 0.5em 0; background-color: #f2f2f2;">
<summary style="color: darkgreen; font-weight: bold; list-style: none;" onclick="if(this.parentNode.open) this.parentNode.style.border='1px solid gray'; else this.parentNode.style.border='none';">
<span style="margin-right: 5px;">ℹ️</span>Authentication Types:
</summary><br>
There are two ways to Authenticate:
<ul>
<li><b>User name & Password:</b> For User name & Password, enter Username, Password, Security token, Consumer key, and Consumer secret. </li>
<li><b>OAuth</b> For OAuth, enter Username, Consumer key, Consumer secret and Callback URL.</li>
</ul>
</details>

- Click on **Authorise & Connect**.
![Authorise](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmdaaaut.png)

- A new window will open up requesting for **Salesforce Login**. Enter the credentials and click on **Log In**.
![Login](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmdlifsf.png)

- This will display the **Environment** associated with the credentials. Click on **Start metadata sync**.
![Start MD](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmdssync.png)

- Wait until the sync is complete. This will take some time.
![Wait](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmdsipg.png)

4. Once Metadata sync is successful, you can create test cases by clicking **Create Test Case**.
![Create Tests](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmdctc.png)

---

## **Steps to Edit Metadata Connection**

1. From the **Dashboard**, click on **SF Connections**.
![Edit Metadata](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmdedt.png)

2. In the **Metadata connection** section, hover over the connection, click on the kebab menu, and choose **Edit connection** from the dropdown menu.
![Edit Connection](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmdec.png)

3. On the **Metadata connection** prompt, make the necessary changes and click on **Authorise & Connect**.
![Metadata Connection](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmdecetd.png)

[[info | **NOTE**:]]
| You can not update the Metadata connection with a different environment.

---

Coming Soon!
## **Steps to Refresh Metadata Connection**

To refresh metadata, you have two options:

1. From the **Dashboard**, go to **SF Connections** and click on **Refresh Metadata**.
![Refresh](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmdref1.png)

2. Click on **Refresh Metadata** directly from the dashboard.
![Refresh](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/sfmdref2.png)

---
Loading

0 comments on commit a60faa2

Please sign in to comment.