Integrieren Sie Showpad-Aktivitäten für Salesforce-Communitys

Sehen Sie, wie es in Salesforce Lightning gemacht 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 wird Ihre Salesforce-Instanz geschützt, indem nur Anforderungen von bekannten Websites 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 es unserer Showpad Domain ermöglichen kann, Anforderungen an Ihr Salesforce-Instanz zu stellen. Wenn Sie dies bereits beim Einrichten Ihrer Standard-Showpad- und Salesforce-Integration getan haben, müssen Sie dies nicht erneut tun.

Dies erlaubt:

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

1. Gehen Sie zur Setup-Seite in Salesforce.com als Salesforce Admin.
2. Suchen Sie im linken Menü nach CORS. Sie können auch manuell Sicherheitssteuerungen > CORS wählen.
3. Einen neuen Ursprung auf der Whitelist hinzufügen.
4. Fügen Sie https://*.showpad.biz hinzu und klicken Sie auf Speichern.

   Hinweis: Wenn die Berechtigung Alle Daten ändern in Salesforce deaktiviert ist, werden wir Sie über die Showpad's Online Platform informieren, 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 Salesforce und Showpad zu verbinden, 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 im Abschnitt Integrationen die Option CRM aus, und wählen Sie dann Salesforce-Instanz konfigurieren aus. Wenn Sie bereits mit einer Salesforce-Instanz verbunden sind, klicken Sie auf Salesforce-Instanz hinzufügen.
3. Geben Sie eine Beschreibung für Ihre Salesforce-Instanz ein. Wenn Sie mehrere Salesforce-Instanzen einrichten möchten, müssen Sie für jede Instanz geeignete Namen auswählen, um die Identifizierung zu vereinfachen.
   • 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.
   • Aktivieren Sie das Kontrollkästchen für die Community-Anmeldung und geben Sie die Community-Anmelde-URL ein.
   • Showpad- Benutzerkonten können automatisch erstellt werden, wenn sich Benutzer zum ersten Mal mit ihren Salesforce- Anmeldeinformationen anmelden. Weitere Informationen zur Option "Automatische Bereitstellung".
4. Klicken Sie auf Weiter und stellen Sie eine Verbindung Mit Salesforce verbinden. 
5. Sie müssen jetzt Ihre Salesforce-Anmeldeinformationen eingeben. Diese Anmeldung wird als Integration Benutzer verwendet werden, um mit Salesforcezu verbinden.
   Wenn der Benutzer, der zum Konfigurieren dieser Integration verwendet wird, kein vollständiger Administrator ist, sind die folgenden Berechtigungen erforderlich:
   Systemeinstellungen.
   • API aktiviert
   • Aufgaben bearbeiten.
   • Ereignisse bearbeiten.
   • Rollen und Rollenhierarchie anzeigen
   • Setup und Konfiguration anzeigen
   
   Objekteinstellungen
   • Lesen / Erstellen / Bearbeiten für Leads, Kontakte, Opportunities, Kontenobjekte.
   • Lesen / Erstellen / Bearbeiten / Löschen für Showpad- Aktivitäten, Showpad- Aktivitäten, Showpad Content & Showpad Content.
   Die Integration funktioniert mit einer Server-zu-Server-Kommunikation. Das Ergebnis ist, dass die ursprüngliche IP-Adresse nicht der IP-Bereich oder die IP-Adresse des Unternehmens ist, sondern eine Showpad-IP-Adresse. Wenn Sie IP-Einschränkungen verwenden, empfehlen wir Ihnen, unsere OAuth-App-Empfehlungen zu lesen.
   Nach dem Anmelden wird die Showpad Online Platform geöffnet. 
6. Sie können jetzt Inhaltsempfehlungen für Ihre Vertriebskollegen aktivieren. Auf dieser Seite finden Sie weitere Informationen. Um diese Funktion nutzen zu können, müssen Sie die „ Showpad for 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 Opportunity sind standardmäßig ausgewählt, und Sie können andere relevante Objekte angeben, indem Sie deren Kontrollkästchen für das Feld "Verwandt mit" aktivieren. Dadurch können Ihre Benutzer beim Protokollieren von Aufgaben Freigaben auf andere Objekte als Konten oder Opportunities beziehen.
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 Aktivitäten 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 "Bezogen auf" einer Aufgabe verfügbar sind. Benutzer können keine Besprechungen in einem benutzerdefinierten Objekt protokollieren.  
10. Sie können steuern, 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 aus. Wenn Sie Gruppen auswählen, aktivieren Sie die Kontrollkästchen für die Gruppen, denen Sie Zugriff auf die Integration gewähren möchten.
11. Wenn eine Freigabe protokolliert wird, werden in den Kommentaren der Aufgabeninformationen der E-Mail-Text und ein Link zum Anzeigen der Freigabe als Empfänger angezeigt. Abhängig davon, wie Ihre Einstellungen konfiguriert sind, sieht es für Ihre Benutzer ähnlich aus.

3. Grundlegende Fehlerbehebung

OAuth-Authentifizierungsfehler

Die Showpad- und Salesforce-Integration funktioniert mit einer Server-zu-Server-Kommunikation. Dies hat zur Folge, dass die IP-Adresse des ursprünglichen Benutzers während des Anmeldevorgangs mit der Adresse des Showpads 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 erzwingen in IP-Einschränkungen lockern zu ändern.

Mit der Einstellung IP-Einschränkungen entspannen 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 verbundenen 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 Liste Connect Apps OAuth Usage auf App-Richtlinien verwalten.
4. Klicken Sie auf Richtlinien bearbeiten. Klicken Sie auf das Dropdown-Menü IP-Entspannung und ändern Sie erzwungene IP-Einschränkungen in lockere IP-Einschränkungen.
   
5. Klicken Sie auf Speichern!

Die Salesforce-Verbindung funktioniert in der Web-app nicht

Stellen Sie sicher, dass Sie an einem Browser arbeiten, der HTML vollständig unterstützt. Um einen vollständigen Überblick über unsere Browseranforderungen zu erhalten, klicken 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" für Internet und 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 Kontakt- und Leaddaten 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 dieselbe Änderung auch dort anwenden.
3. Wählen Sie Benutzerdefiniert!
4. Scrollen Sie, bis Sie Folgendes finden, und stellen Sie sicher, dass der Zugriff auf domänenübergreifende Datenquellen aktiviert ist
5. Übernehmen und speichern.
6. Stellen Sie sicher, dass Sie dieselben 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. Das Zugriffstoken wird auf den Showpad- Servern und nicht im Browser des Benutzers abgerufen. Wenn die Salesforce-Einstellung "Sperrt die Sitzung an die IP-Adresse" aktiviert ist, bedeutet dies, dass wir nur API-Anrufe von den Showpad-Servern senden können, da wir das Salesforce-Token auf unseren Servern angefordert haben. Wenn Sie dieses Zugriffstoken für eine andere IP-Adresse (Ihren 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, deaktiviert ist.