Integrieren Sie Showpad-Aktivitäten in Salesforce

Erfahren Sie, wie dies in Salesforce Lightning ausgeführt wird

• Konfigurieren Sie CORS in Salesforce Lightning
• Richten Sie eine Salesforce-Instanz in Showpad ein
• Grundlegende Fehlerbehebung

Tun Sie dies Schritt für Schritt

1. Konfigurieren Sie CORS in Salesforce Lightning

Der erste Schritt beim Konfigurieren der Salesforce-Integration besteht darin, Anforderungen aus der Showpad-Domäne zuzulassen. Mit Salesforce können Kunden steuern, welche Websites die Salesforce-API verwenden dürfen. Auf diese Weise bleibt Ihre Salesforce-Instanz sicher, da nur Anforderungen von bekannten Sites zugelassen und alle anderen abgelehnt werden.

Diese Einstellung wird als CORS (Cross-Origin Resource Sharing) bezeichnet. Für die Integration von Showpad in Salesforce ist eine Konfiguration erforderlich. Die folgenden Anweisungen zeigen, wie ein Salesforce Admin unsere Showpad Domain aktivieren können, um Anfragen an Ihre Salesforce-Instanz zu senden. 

Dies erlaubt:

• Showpad eine Salesforce-Aktivität zu erstellen, wenn ein Benutzer in der Showpad- App oder der Web App Inhalte mit einem Interessenten oder Kunden teilt.
• Showpad zum Erstellen eines Salesforce- Ereignisses, wenn ein Benutzer in einer beliebigen mobilen App eine Besprechung in Salesforce protokollieren möchte.

1. Gehen Sie als Salesforce Admin auf die Setup Seite in Salesforce.com.
2. Suchen Sie im linken Menü nach CORS. Sie können auch manuell Sicherheitskontrollen > CORS auswählen.
3. Fügen Sie einen neuen Whitelist-Ursprung hinzu.
4. Fügen Sie https: //*.Showpad.biz hinzu und klicken Sie auf Speichern.

   Hinweis: Wenn die Berechtigung Alle Daten ändern in Salesforce deaktiviert ist, informieren wir Sie über Showpads Online Platform dass wir die CORS-Konfiguration nicht überprüfen konnten. Sie können die Integration weiterhin einrichten, wenn diese Warnung angezeigt wird.

2. Richten Sie eine Salesforce-Instanz in Showpad ein

1. Um eine Verbindung zwischen Salesforce und Showpad herzustellen, müssen Sie Ihre Salesforce-Instanz (en) in Showpad einrichten. Sie können mehrere Salesforce-Instanzen konfigurieren, wenn Ihr Unternehmen mehr als eine verwendet.
   Öffnen Sie die Showpad Online Platform und melden Sie sich mit Ihren Administrator-Anmeldeinformationen an.
2. Wählen Sie in den Einstellungen CRM unter dem Integrationen Abschnitt, wählen Sie dann eine Salesforce-Instanz konfigurieren.
3. Geben Sie eine Beschreibung für Ihre Salesforce-Instanz ein. Wenn Sie planen mehrere Salesforce-Instanzen einzurichten, müssen Sie die entsprechenden Namen für jede Instanz auswählen, damit sie leichter identifiziert werden können.
   • Wenn Sie eine benutzerdefinierte Domäne für den Zugriff auf Salesforce verwenden, z. B. https://companyxyz.my.salesforce.com, aktivieren Sie Benutzerdefinierte Domäne verwenden und geben Sie companyxyz ein.
   • Showpad- Benutzer konten können automatisch erstellt werden, wenn Benutzer sich zum ersten Mal mit ihren Salesforce Anmeldeinformationen anmelden. Erfahren Sie mehr über die Auto-Provisioning-Option.
4. Klicken Sie auf "Weiter" und "Mit Salesforce verbinden".
5. Sie müssen jetzt Ihre Salesforce Anmeldeinformationen eingeben. Diese Anmeldung wird als Integration Benutzer verwendet, um mit Salesforce zu verbinden.
   Wenn der Benutzer, der zum Konfigurieren dieser Integration verwendet wird, kein vollständiger Administrator ist, sind die folgenden Berechtigungen erforderlich:
   • API Zugriff
   • Lesen / Schreiben für Aufgabe, Ereignis, alle Showpad-Objekte
   • Lesen / Schreiben für Leiten, Kontakt, Möglichkeiten, Account
   Die Integration funktioniert mit einer Server-zu-Server-Kommunikation. Das Ergebnis ist, dass die Ursprungs-IP-Adresse nicht der IP-Bereich oder die IP-Adresse des Unternehmens ist, sondern eine Showpad-IP-Adresse. Wenn Sie IP-Beschränkungen verwenden, empfehlen wir Ihnen das Lesen von Empfehlungen für die OAuth-App.
   Nach dem Anmelden wird die Showpad Online Platform erneut geöffnet. Ihren Benutzern wird beim Erstellen eines neuen Leads in Salesforce ein Formular angezeigt. In diesem Bildschirm können Sie das Formular konfigurieren. Wiederholen Sie die Schritte für das Formular "Kontakte".
   • Drei Felder sind erforderlich. Standardmäßig sind E-Mail, Nachname und Vorname ausgewählt.
   • Wählen Sie die Felder aus, die Sie einschließen möchten.
   • Ordnen Sie die Felder neu an, indem Sie auf ein Feld klicken, es halten und an eine andere Position in der Liste ziehen.
   
6. Sie können jetzt Inhaltsempfehlungen für Ihre Vertriebskollegen aktivieren. Auf dieser Seite finden Sie weitere Informationen. Um diese Funktion zu verwenden, müssen Sie die Showpad für Salesforce-App über AppExchange von Salesforce installieren. Klicken Sie auf Speichern.
7. Die letzte Registerkarte, die Sie sehen, dient zum Aktivieren der erweiterten Protokollierung für benutzerdefinierte Objekte. Konto und Verkaufschance werden standardmäßig ausgewählt. Sie können andere relevante Objekte angeben, indem Sie die entsprechenden Kontrollkästchen für das Feld "Bezogen auf" aktivieren. Auf diese Weise können Ihre Benutzer beim Protokollieren von Aufgaben Freigaben mit anderen Objekten als Konten oder Opportunities verknüpfen.
8. In Salesforce muss beim Bearbeiten oder Erstellen des benutzerdefinierten Objekts das Kontrollkästchen "Aktivitäten zulassen" im Abschnitt "Optionale Funktionen" aktiviert sein.
9. Wählen Sie die benutzerdefinierten Objekte aus, für die Sie die Aktivität protokollieren möchten, und klicken Sie dann auf Speichern. Die angezeigte Liste enthält dieselben Objekte, die in der Instanz des verbundenen SFDC im Feld "Zugehörig zu" einer Aufgabe verfügbar sind. Benutzer können keine Besprechungen in einem benutzerdefinierten Objekt protokollieren.  
10. Es kann eingestellt werden, welche Benutzergruppen die Salesforce-Integration verwenden können. Klicken Sie auf die Registerkarte Gruppen mit Zugriff und wählen Sie Alle Benutzer oder Ausgewählte Gruppen.
11. Wenn eine Freigabe protokolliert ist, werden der E-Mail-Text und ein Link zum Anzeigen der Freigabe als Empfänger in den Kommentaren der Aufgabeninformationen angezeigt. Abhängig davon, wie Ihre Einstellungen konfiguriert sind, sieht es für Ihre Benutzer ähnlich wie dies aus.

3. Grundlegende Fehlerbehebung

OAuth-Authentifizierungsfehler

Die Integration von Showpad und Salesforce funktioniert mit einer Server-zu-Server-Kommunikation. Eine Folge davon ist, dass die Ursprungs-Benutzer IP - Adresse zu Showpads - Adresse während des Anmeldevorgangs geändert wird.

In Fällen, in denen Anmelde-IP-Bereiche verwendet werden oder bei Benutzern OAuth-Anmeldefehler auftreten, empfehlen wir, die Einstellungen in der OAuth-App von IP-Einschränkungen zu erzwingen, Relax-IP Einschränkungen zu ändern.

Mit der Einstellung IP-Einschränkungen lockern können Benutzer die verbundene Showpad-App ohne IP-Einschränkungen ausführen. Sie finden diese Einstellungen im Abschnitt "Salesforce-Verwaltung".

1. Suchen Sie im Setup nach Connected Apps. Öffnen Sie die OAuth Verwendungsoptionen für verbundene Apps auf der Registerkarte Apps verwalten.
   
2. Suchen Sie die Showpad Salesforce Integration-App und klicken Sie auf Installieren.
3. Klicken Sie in der OAuth-Verwendungsliste von Connect Apps auf App-Richtlinien verwalten.
4. Klicken Sie auf Richtlinien bearbeiten. Klicken Sie auf das Dropdown-Menü IP-Relaxation und ändern Sie IP-Restriktionen erzwingen in Relax-IP-Restriktionen.
   
5. Klicken Sie auf Speichern.

Salesforce Verbindung funktioniert nicht auf der Web App

Stellen Sie sicher, dass Sie mit einem Browser arbeiten, der HTML vollständig unterstützt. Eine vollständige Übersicht über unsere Browseranforderungen finden Sie hier.
Stellen Sie für Internet Explorer-Benutzer sicher, dass Sie mit IE11 oder höher arbeiten. Stellen Sie sicher, dass in den Sicherheitseinstellungen die Option Verschiedenes aktiviert ist, die sowohl für das Internet als auch für das Intranet aktiviert ist. Ist dies nicht der Fall, lässt Internet Explorer nicht zu, dass die Showpad-Seite eine Verbindung zur Salesforce-Domäne herstellt und die Daten für Kontakte und Leads abruft.

1. Gehen Sie zu Einstellungen, Internetoptionen, Sicherheit.
2. Sie sollten ein Internet-Symbol sehen, stellen Sie sicher, dass es ausgewählt ist. Wenn sie das lokale Intranet verwenden, stellen Sie sicher, dass Sie die gleichen Änderungen auch dort anwenden.
3. Wählen Sie Benutzerdefiniert.
4. Führen Sie einen Bildlauf durch, bis Sie das Folgende finden, und vergewissern Sie sich, dass Access data sources across domains aktiviert ist
5. Übernehmen und speichern.
6. Stellen Sie sicher, dass Sie die gleichen Einstellungen auch für das lokale Intranet anwenden.
7. Sie müssen auch sicherstellen, dass Ihr CORS in Ihrer Salesforce-Instanz eingerichtet ist.

XMLHttpRequest kann nicht geladen werden, die Antwort hat den Statuscode 401

Für Salesforce-API-Aufrufe benötigen wir ein gültiges Zugriffstoken. Der Zugriffstoken wird auf den Showpad- Servern und nicht im Browser des Benutzers abgerufen. Wenn die Salesforce-Einstellung "Sperren der Sitzung an die IP-Adresse" aktiviert ist, bedeutet dies, dass wir nur API-Aufrufe von den Showpad-Servern senden können, weil wir das Salesforce-Token auf unseren Servern angefordert haben. Wenn Sie diesen Zugriffstoken auf einer anderen IP-Adresse (Ihrem Browser) verwenden, funktioniert es aufgrund dieser Salesforce-Einstellung nicht. Wenn Sie diese Einstellung deaktivieren, kann das Zugriffstoken auch im Browser verwendet werden, und Sie können Salesforce-Anforderungen in der Web App machen.
Beachten Sie, dass die mobilen Apps unsere Server nicht verwenden, um ein neues Zugriffstoken anzufordern, sodass sie dieses Problem nicht haben.

Navigieren Sie zu Sitzungseinstellungen und stellen Sie sicher, dass das Kontrollkästchen Sitzungen an die IP-Adresse sperren, von der sie stammen, nicht aktiviert ist.