# Configure Salesforce Integration

{% hint style="info" %}
Please make sure you are connected to Salesforce. Otherwise, head to [getting-started](https://docs.upsmith.app/atlassian-cloud/scrybe-external-data-objects-and-query-for-jira/administrator-guide/getting-started "mention")
{% endhint %}

### Object Views Configuration

This section lists the details for configuring object views.

Step by step guide:

1. Click on add object view<br>

   <figure><img src="https://639954725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlgzAhV4EMBU0KrkmJ6L0%2Fuploads%2FyqcS294awdt9z5swhgIr%2F1.png?alt=media&#x26;token=2017133b-8c55-4412-b36a-aec6cf71aa3b" alt=""><figcaption></figcaption></figure>
2. In the dialog, the **Title of view** will be used as the tab name in the Jira issue panel. You can configure multiple tabs, allowing you to display different objects within the same Jira issue.\
   \
   \- Select the Salesforce object you want to use as the main object. \
   \- You can configure which fields will appear in the table view. \
   \- You can also specify which user groups are allowed to access the tab.\ <br>

   <figure><img src="https://639954725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlgzAhV4EMBU0KrkmJ6L0%2Fuploads%2FESiUc7ADYWXZ11fBSM5X%2Fo2.png?alt=media&#x26;token=b274fd64-0447-4b78-8750-4b1e080142b6" alt=""><figcaption></figcaption></figure>

   <figure><img src="https://639954725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlgzAhV4EMBU0KrkmJ6L0%2Fuploads%2FViJ7xs0STAcBLdQuffrQ%2F2.png?alt=media&#x26;token=dc59de23-a311-42e6-be86-7072cd97f263" alt=""><figcaption></figcaption></figure>
3. Click **Save** once you are done.

### Query Views Configuration

This section lists the details for configuring query views.

Step by step guide:

1. Click on add query view.

   <figure><img src="https://639954725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlgzAhV4EMBU0KrkmJ6L0%2Fuploads%2FX0Og0nEqz7AM2FiGgqpk%2F1.png?alt=media&#x26;token=8dfaf507-b0c9-4b19-a975-9651c3a8d1ab" alt=""><figcaption></figcaption></figure>
2. In the dialog, the **Title of view** will be used as the tab name in the Jira issue panel. You can configure multiple tabs, allowing you to display different queries within the same Jira issue.<br>

   <figure><img src="https://639954725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlgzAhV4EMBU0KrkmJ6L0%2Fuploads%2FonTjNLzM5JZM16lhP3kW%2F2.png?alt=media&#x26;token=21b0c162-46cb-4219-aa72-17f3fbe0d4c5" alt=""><figcaption></figcaption></figure>
3. In the SOQL query section, you can enter the SOQL query you want to run. There are three types of queries:

   1. **Query with no variables**\
      A standard SOQL query with fixed values.\
      Exampl&#x65;*:* `SELECT Name FROM Account`
   2. **Query with issue variables**\
      You can reference values from the Jira issue (e.g., reporter email) to make the query dynamic.\
      Example:

      ```
      SELECT Id, Name, Account.Name, Owner.Name 
      FROM Contact 
      WHERE Email = '{{issue.reporter.emailAddress}}'
      ```

      With this, the query will automatically run using the issue reporter’s email.
   3. **Query with query variables**\
      These queries require the user to input values directly in the Jira issue. Once entered, the values are saved and will be used automatically the next time the tab is loaded.\
      Example:

      ```
      SELECT Id, Name, Owner.Name 
      FROM Account 
      WHERE Name LIKE '{{AccountName}}%'
      ```

      You can then provide the variable value within the Jira issue.<br>

      <figure><img src="https://639954725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlgzAhV4EMBU0KrkmJ6L0%2Fuploads%2FhcalMzTttj9dzdOIiNH2%2F3.png?alt=media&#x26;token=781ec1de-7041-4c23-9a27-ff32a0ac531b" alt=""><figcaption></figcaption></figure>

   \
   \
   You can also specify which user groups are allowed to access the tab.<br>
4. Click **Preview** to verify that the query runs successfully. Once everything looks correct, click **Save**.

\
**Additional Resources**

If you need further assistance, don’t hesitate to contact our support team at **<support@upsmith.app>**. We’re always happy to help!
