Einstellung der älteren Versionen der Lightning-Plattform-API

Was ändert sich?

In der Version Summer ‘21 werden die folgenden älteren Versionen der Lightning-Plattform-API eingestellt und nicht mehr von Salesforce unterstützt:

• SOAP: 7.0, 8.0, 9.0, 10.0, 11.0, 12.0, 13.0, 14.0, 15.0, 16.0, 17.0, 18.0, 19.0, 20.0

• REST: v20.0

• Bulk: 16.0, 17.0, 18.0, 19.0, 20.0

Kunden können diese älteren API-Versionen bis zur Einführung der Version Summer ‘21 weiter verwenden. Danach sind diese Versionen nicht mehr verfügbar. Wenn diese älteren Versionen eingestellt werden, tritt bei Anwendungen, die betroffene Versionen der APIs verwenden, eine Unterbrechung auf, da die Anforderungen zu einem Fehler mit der Angabe führen, dass der angeforderte Endpunkt deaktiviert wurde. 

Welche Maßnahmen müssen ergriffen werden? 

Vor Einführung der Version Summer ‘21 müssen Kunden ihre Anwendungen so ändern oder aktualisieren, dass für sie die aktuellen API-Versionen verwendet werden können, um Unterbrechungen zu vermeiden, die durch auf eingestellte Versionen verweisende Software verursacht werden. Durch den Wechsel zu neueren Versionen der APIs profitieren Kunden von einer erweiterten Funktionalität mit höherer Sicherheit und verbesserter Leistung.

Wie kann ich feststellen, ob in meinen Anwendungen betroffene Versionen der älteren APIs verwendet werden?

Wenn Sie Anwendungen ermitteln möchten, die einzustellende APIs verwenden, wenden Sie sich an die Entwickler der in Ihrer Organisation verwendeten Anwendungen, damit festgestellt wird, welche API-Versionen verwendet werden. 
 

Falls Sie die Entwickler Ihrer Anwendungen nicht kontaktieren können, können Sie Ereignisprotokolle zu SOAP- und REST-API-Aktivitäten Ihrer Salesforce-Organisation überprüfen, indem Sie die folgenden Schritte ausführen:

1. Führen Sie in einem Tool wie Salesforce CLI eine Abfrage des EventLogFile-Objekts aus, um ein Protokoll aller Aktionen anzuzeigen, die während der letzten 24 Stunden in Ihrer Organisation ausgeführt wurden.

   1. sfdx force:data:soql:query -q "SELECT LogFile, EventType, CreatedDate FROM EventLogFile WHERE EventType IN ('API', 'RestApi')" -u <Ihr-Benutzername>

2. Führen Sie für jedes Ergebnis eine REST-Anforderung mithilfe des Endpunkts aus, um die Daten abzurufen und in eine CSV-Datei zu kopieren,

   1. z. B.: /services/data/v46.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile.

   2. Fügen Sie den Antworttext in eine Anwendung wie Excel ein, um die Ereignisprotokolldaten einfacher als CSV-Datei anzuzeigen.

3. Überprüfen Sie die einzelnen CSV-Dateien und bestimmen Sie, ob Anforderungen für Endpunkte mit API-Versionen unter Version 20 vorgenommen werden.

   1. SOAP / API EventType -- Überprüfen Sie die Werte in der Spalte API_VERSION auf Datensätze mit dem API_TYPE "E" oder "P".

   2. REST / RestApi EventType -- Überprüfen Sie die Werte in der Spalte URI und achten Sie auf Endpunkte mit "/v20.0" oder niedriger im Pfad.

4. Alle Integrationen, die Version 20 und niedriger verwenden, sind von dieser Änderung betroffen.

Weitere Informationen finden Sie im Trailhead-Modul Herunterladen und Visualisieren von Ereignisprotokolldateien. 

Navigieren Sie bei der Bulk-API in Setup zur Seite "Aufträge für das Massenladen von Daten" und zeigen Sie die Details für jeden Auftrag vom Typ "Massenvorgang V1" an. Alle Aufträge mit dem Wert 20.0 oder niedriger im Feld "API-Version" sind von dieser API-Einstellung betroffen. 

Warum wird dieses Produkt eingestellt?

Wir konzentrieren unsere Entwicklungsbemühungen auf die Verbesserung der neuesten API-Versionen, um die gesamte Salesforce-Erfahrung beim Erstellen benutzerdefinierter Funktionen über Anwendungen zu verbessern. 

Wo erhalte ich weitere Informationen?

Weitere Informationen dazu, welche Funktionen von der aktuellen SOAP-API-Version unterstützt werden, finden Sie auf der Salesforce Developer-Website in der folgenden Dokumentation:

• Introducing SOAP API Developer Guide

• Introducing Lightning Platform REST API

• Introduction to Bulk API

Bei weiteren Fragen können Sie beim Kundensupport im Portal "Hilfe und Schulung" einen Kundenvorgang erstellen.