Aktualisieren hartcodierter Verweise

Allgemeine häufig gestellte Fragen

1. Was sind hartcodierte Verweise (d. h. instanzenspezifische Verweise)?

a) Bei einem hartcodierten Verweis handelt es sich um einen URL, bei dem der Instanzname im URL enthalten ist (z. B. na1.salesforce.com). Ersetzen Sie diese hartcodierten Verweise durch generische, nicht instanzenspezifische oder relative URLs (z. B. "login.salesforce.com" oder "<meinedomäne>.my.salesforce.com").

Hier ist ein Beispiel für einen hartcodierten Verweis: https://na1.salesforce.com/{Case.Id}
Erstellen Sie daraus einen relativen Verweis, indem Sie "na1.salesforce.com" entfernen, um Folgendes zu erhalten: /{Case.Id}

HINWEIS: Innerhalb von Salesforce werden Sie bei relativen Verweisen automatisch zum richtigen Datensatz weitergeleitet. Externe Anforderungen sollten an einen generischen Endpunkt gesendet werden, z. B. "https://login.salesforce.com" anstelle von "https://na1.salesforce.com".
 

2. Wie finde ich hartcodierte Verweise?

a) Nutzen Sie das Salesforce-Tool Lightning Experience-Bereitschaftsüberprüfung, um hartcodierte Verweise aufzudecken, wodurch Sie außerdem bestimmen können, ob Sie für Lightning Experience bereit sind:
In Lightning: Navigieren Sie zu "Setup“ | "Lightning Experience" | "Bereitschaft prüfen".
In Classic: Navigieren Sie zu "Setup | "Erste Schritte" unter "Migrationsassistent für Lightning Experience" | "Bereitschaft prüfen".

Beachten Sie, dass bei der Lightning Experience-Bereitschaftsüberprüfung nicht alle hartcodierten Verweise aufgedeckt werden. Weitere Informationen dazu, worüber dieses Tool Berichte erstellt, finden Sie in der Dokumentation unter Was wird bei der Lightning Experience-Bereitschaftsüberprüfung evaluiert?

b) Suchen Sie mithilfe von Salesforce-Erweiterungen für Visual Studio-Code nach hartcodierten Verweisen.
Die Salesforce-Erweiterungen für Visual Studio-Code enthalten Entwicklertools, mit dem Sie hartcodierte Verweise finden können. Führen Sie die Schritte im Artikel Creating a Salesforce Project in Visual Studio Code and Searching for Hard-Coded References (Erstellen eines Salesforce-Projekts in Visual Studio Code und Suchen nach hartcodierten Verweisen) aus, um hartcodierte Verweise* in Ihrer Organisation und den Metadaten Ihrer Organisation (Setup oder Kunden-Code) zu aktualisieren.

3. Wie aktualisiere ich hartcodierte Verweise in Integrationen?

Verwenden Sie für Integrationen in Salesforce-Produkten oder Force.com die login()-Anforderung der Force.com-API als Ausgangspunkt. Die login()-Anforderung sollte an einen generischen Endpunkt gesendet werden, z. B.: https://login.salesforce.com/services/Soap/u/26.0.
Durch den login()-Aufruf wird eine Force.com-Sitzung hergestellt und es wird mit dem URL des Anmeldeservers geantwortet. Legen Sie diesen Server-URL als den Zielserver für nachfolgende API-Anforderungen fest und legen Sie die zurückgegebene Sitzungs-ID in der SOAP-Kopfzeile fest, um die Serverautorisierung für nachfolgende API-Anforderungen bereitzustellen.

Häufig gestellte Fragen zur Instanzaktualisierung und Organisationsmigration
Die zu den hartcodierten Verweisen gestellten Fragen können bei der Vorbereitung des Wechsels zu einer neuen Instanz nützlich sein.

4. Welche hartcodierten Verweise können von Salesforce-Servern weitergeleitet werden, nachdem ein Wechsel zu einer neuen Instanz erfolgte?

Da nach einer Instanzaktualisierung oder Organisationsmigration nicht alle hartcodierten Verweise weitergeleitet werden, wird dringend empfohlen, "Meine Domäne" zu implementieren und alle hartcodierten Verweise vor einem Wechsel zu entfernen. Zwar können die nachfolgend aufgelisteten Objekte von Salesforce-Servern weitergeleitet werden, bei Verwendung dieser Objekte nach dem Wechsel zu einer neuen Instanz kann es jedoch zu einem Leistungsabfall kommen: 

i. Browser-Links
ii. URLs, die als Browser-Lesezeichen gesetzt wurden
iii. Benutzerdefinierte Schaltflächen
iv. Inhalts-URLs
v. Chatter-Posts
vi. URLs zur Anmeldung bei einem Self-Service-Portal (sserv/login.jsp?orgid)
vii. Integrationen

5. Welche hartcodierten Verweise müssen vor dem Wechsel zu einer neuen Instanz aktualisiert werden, damit Sie weitergeleitet werden?

Wenn Sie "Meine Domäne" nicht aktiviert haben, müssen Sie die hartcodierten Verweise in E-Mail-Vorlagen und Knowledge-Artikeln aktualisieren.
Unabhängig davon, ob "Meine Domäne" aktiviert ist, müssen Sie sicherstellen, dass alle Bilder in Knowledge-Artikeln und E-Mail-Vorlagen von Ihrem Computer hochgeladen und nicht über eine Webadresse eingefügt wurden, damit sie auch nach der Wartung weiterhin angezeigt werden.

i. Falls Bilder über eine Webadresse eingefügt wurden, müssen Sie das Bild auf Ihren Computer herunterladen und anschließend über die Option "Bild hochladen" erneut hochladen, wenn Sie das Bild in einen Knowledge-Artikel oder eine E-Mail-Vorlage einfügen. Die nachfolgenden Diagramme erläutern den jeweiligen Prozess.

HINWEIS: Falls Bilder nach der Wartung nicht mehr korrekt angezeigt werden, weil Sie nicht über Ihren Computer hochgeladen wurden, müssen Sie den alten Instanznamen im Bild-URL durch den neuen Instanznamen ersetzen. Anschließend sollten Sie das Bild auf Ihren Computer herunterladen und anschließend wieder hochladen, um Probleme infolge zukünftiger Wartungsarbeiten zu vermeiden.

6. Wie kann ich überprüfen, ob alle Bilder in meinen Knowledge-Artikeln und E-Mail-Vorlagen von meinem Computer hochgeladen und nicht über eine Webadresse eingefügt wurden?

Wenn ein Bild über einen lokalen Computer hochgeladen wurde, sieht der URL wie folgt aus: "https://[HOST-ODER-MEINE-DOMÄNE]/servlet/rtaImage…".

Wenn ein Bild über eine Webadresse (oder Ihre Registerkarte "Dokumente") verknüpft wurde, sieht der URL wie folgt aus: "https://[HOST-ODER-MEINE-DOMÄNE]/servlet/servlet.ImageServer..." oder "https://[HOST-ODER-MEINE-DOMÄNE]/servlet/servlet.FileDownload…"

7. Muss ich die hartcodierten Verweise in meinen CTI-Integrationen aktualisieren, wenn ich zu einer neuen Instanz wechsle?

Wenn Sie Open CTI verwenden und der CTI-Adapter-URL in Ihrer Callcenter-Definition mit Ihrer Salesforce-Instanz hartcodiert ist (z. B. https://c.na6-visual.force.com/apex/Softphone), wirkt sich dies auf Ihre CTI-Integration aus.
Ändern Sie diesen hartcodierten Verweis in einen relativen URL (z. B. "/apex/Softphone"), damit Ihre CTI-Integration nach dem Wechsel zu einer neuen Instanz weiterhin funktioniert. Wenn Sie dies ändern möchten, können Sie zum jeweiligen Klickpfad des Callcenter-Objekts navigieren: "Setup“ > "Callcenter".

 Wenn Sie das Salesforce Desktop-CTI-Integrations-Toolkit verwenden, wirkt sich diese Wartungsmaßnahme nicht auf Ihre CTI-Integration aus, da hartcodierte Verweise im Toolkit nicht zulässig sind.

8. Muss ich meine E-Mail-Thread-IDs aktualisieren, wenn ich zu einer neuen Instanz wechsele?

Wenn Sie benutzerdefinierte E-Mail-Thread-IDs erstellt haben, kann dies nach einem Wechsel zu einer neuen Instanz Auswirkungen für Sie haben. Andernfalls müssen Sie vorhandene, von Salesforce generierte E-Mail-Thread-IDs nach dem Wechsel zu einer neuen Instanz nicht aktualisieren. (Dies gilt auch für Verweise mit einem alten Instanznamen).

Befolgen Sie die nachstehend aufgeführten Schritte, um eine benutzerdefinierte E-Mail-Thread-ID zu korrigieren:
i. Aktualisieren Sie Ihre benutzerdefinierte Formel, sodass sie folgendes Format aufweist: ref:_00D[XX][yyyyy]._500[AA][bbbbb]:ref
ii. Dabei sind yyyyy und bbbbb die 10-stellige ID ohne führende Nullen.
iii. E-Mail-Thread-ID-Formate in folgendem Format sind für unser System analysierbar (yyyyy und bbbbb sind die Datensatz-ID ohne die führenden Nullen)

HINWEIS: Bei ref:00DXyyyyy.500Abbbbb:ref handelt es sich um das alte Format, das nicht mehr verwendet wird.

Salesforce kann die Formate im Laufe der Zeit ändern, sodass den Kunden davon abgeraten wird, eigene Thread-IDs zu generieren. In Bezug auf Ihre benutzerdefinierten Thread-IDs kann ein Problem bei der On-Demand-E-Mail-Vorgangserfassung (E2C) auftreten. Dabei werden neue Kundenvorgänge erstellt und nicht an den ursprünglichen Kundenvorgang mit Antworten angehängt. Erstellen Sie keine eigenen benutzerdefinierten Thread-ID-Formate. Benutzerdefinierte Formeln für Kundenvorgangs-Thread-IDs werden offiziell nicht unterstützt, weshalb Kunden empfohlen wird, eine von Salesforce generierte standardmäßige Thread-ID zu verwenden. Weitere Informationen dazu, warum Sie keine benutzerdefinierte Formel erstellen sollten, finden Sie im Artikel Verwendung von benutzerdefinierten Thread-IDs bei der E-Mail-Vorgangserfassung.

9. Können Kunden nach unserem Wechsel zu einer neuen Instanz weiterhin über den alten Instanz-URL auf unser Partnerportal zugreifen?

Bis etwa 30 Tage nach dem Wechsel zu einer neuen Instanz sollten Kunden weiterhin mithilfe des alten Instanz-URL auf Ihr Partnerportal zugreifen können. Nach diesem Zeitfenster von 30 Tagen wird der alte Instanzanmelde-URL außer Betrieb genommen. Administratoren wird vor dem Wechsel zu einer neuen Instanz empfohlen, unter der Meldung "Systemwartung" im Partnerportal eine benutzerdefinierte Notiz hinzuzufügen, die Benutzer darauf hinweist, nach dem Wechsel zu einer neuen Instanz den neuen Partnerportal-URL zu verwenden. Administratoren können Kunden auch empfehlen, ihre Anmeldelesezeichen mit dem neuen Partnerportal-URL zu aktualisieren.

10. Hat der Wechsel zu einer neuen Instanz Auswirkungen auf die Online-Leaderfassung oder die Online-Kundenvorgangserfassung (W2X)?

Wenn Ihre Online-Lead oder -Kundenvorgangserfassungen (W2X) hartcodierte Verweise enthalten, müssen Sie sie vor dem Wechsel zu einer neuen Instanz auf relative URLs aktualisieren. Wenn Sie die hartcodierten Verweise nicht aktualisieren, können nach der Wartung unerwünschte Service-Unterbrechungen bei Online-Leaderfassungen oder Online-Kundenvorgangserfassungen (W2X) auftreten. Online-Lead oder -Kundenvorgangserfassungen werden in die Warteschlange gesetzt und verarbeitet, nachdem die Wartung abgeschlossen wurde.

11. Müssen Remote-Standort-Namen nach dem Wechsel zu einer neuen Instanz aktualisiert werden?

Ja. Wenn Sie "Meine Domäne" nicht verwenden, müssen hartcodierte Verweise in Remote-Standort-Namen sofort nach der Wartung mit dem neuen Instanznamen aktualisiert werden.
Wenn Sie die hartcodierten Verweise in Remote-Standort-Namen nach der Wartung nicht aktualisieren, können bei Remote-Standorten unerwünschte Service-Unterbrechungen auftreten.

12. Wirkt sich der Wechsel zu einer neuen Instanz auf das Salesforce Mobile SDK aus?

Der Wechsel zu einer neuen Instanz kann sich auf Daten in mit dem Salesforce Mobile SDK erstellten Anwendungen auswirken, wenn Benutzer nicht über die aktuellen Versionen verfügen. Es wird empfohlen, alle mit dem Salesforce Mobile SDK erstellten Anwendungen zu aktualisieren und diese Aktualisierungen vor der Wartung per Push an alle Benutzer in Ihrer Organisation zu senden.
Wenn Benutzer über die neuesten Versionen aller mit dem Salesforce Mobile SDK erstellten Anwendungen verfügen, sollte der Wechsel zu einer neuen Instanz keine Auswirkungen auf die Daten innerhalb der Anwendungen haben.

​​13. Wie muss ich vorgehen, wenn ich über eine Live Agent- oder SOS-Implementierung verfüge?

Wenn Ihre Webseite oder Ihre Zertifikate einen hartcodierten Verweis auf den Live Agent-Endpunkt-URL aufweisen, kann sich eine Instanzaktualisierung, eine Organisationsmigration oder ein Standortwechsel auf Ihre Live Agent-/SOS-Funktionen auswirken. Wenn Sie die Auswirkungen minimieren möchten, befolgen Sie die bewährten Vorgehensweisen und vermeiden Sie hartcodierte Verweise auf den Endpunkt. Stellen Sie zudem sicher, dass Sie den Endpunkt-URL im Bereitstellungscode aktualisieren, den Sie in Setup auf der Seite "Bereitstellung" kopiert haben. Der von uns bereitgestellte Bereitstellungscode kann zum neu zugewiesenen Server umleiten, aber Sie sollten den Endpunkt sofort aktualisieren, nachdem die Aktualisierung abgeschlossen wurde. 

Weitere Informationen zu Live Agent-Endpunkten und zur Bedeutung eines hartcodierten Endpunkts finden Sie im Artikel Live Agent-Server (Endpunkt-URL) wurde geändert und jetzt funktioniert der Live Agent-Chat nicht mehr.

14. Wie muss ich mit von Apex-Webservices generierten WSDLs verfahren?

Wenn Sie WSDLs zum Generieren von Code verwenden, müssen alle Bereiche, in denen der Code angewendet wurde, auf hartcodierte Verweise überprüft werden. Alle hartcodierten Verweise müssen dann entweder in einen URL für "Meine Domäne" oder einen relativen URL (login.salesforce.com) geändert werden. Es wird empfohlen, "Meine Domäne" vor dem Wechsel zu einer neuen Instanz zu implementieren. So wird sichergestellt, dass Sie diesen Aufwand nicht wiederholen müssen, sobald alle hartcodierten Verweise geändert wurden und auf den neuen URL für "Meine Domäne" verweisen.