Tilbagetrækning af forældede versioner af Lightning Platform-API

Hvad bliver ændret?

Fra og med Summer ‘21-udgaven vil følgende forældede versioner af Lightning Platform-API blive trukket tilbage og vil ikke længere være understøttet af Salesforce:

• 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

Kunderne kan fortsætte med at bruge disse ældre API-versioner indtil Summer ‘21-udgaven, hvor disse ældre versioner bliver utilgængelige. Når disse ældre versioner er trukket tilbage, vil applikationer, der bruger de berørte versioner af API'erne, opleve en afbrydelse, fordi anmodningerne vil mislykkes og resultere i en fejl, der angiver, at det anmodede slutpunkt er blevet deaktiveret. 

Hvad skal jeg gøre? 

Før Summer ‘21-udgaven skal kunderne redigere eller opgradere deres applikationer til at fungere med de nyeste tilgængelige API-versioner for at forhindre en afbrydelse forårsaget af software, der henviser til tilbagetrukne versioner. Med flytning til de nyere versioner af vores API følger der avancerede funktioner med forbedret sikkerhed og ydeevne.

Hvordan ved jeg, om der bruges påvirkede versioner af forældede API'er i mine applikationer?

Du identificerer applikationer, der bruger ældre API-versioner, ved at kontakte udviklerne af de applikationer, der anvendes i din organisation, for at bestemme, hvilke API-versioner der bruges. 
 

Hvis du ikke kan kontakte udviklerne af dine applikationer, kan du gennemse dine begivenhedslogfiler, der rapporterer SOAP- og REST API-aktivitet fra dine Salesforce-organisationer, ved at følge disse trin:

1. Brug et værktøj som Salesforce CLI til at køre en SOQL-forespørgsel mod objektet EventLogFile, hvilket vil give dig en log over alle handlinger, der er udført i din organisation inden for de seneste 24 timer.

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

2. Udfør for hvert resultat en REST-anmodning ved brug af slutpunktet for at hente dataene og kopiere dem ind i en .CSV-fil.

   1. f.eks. /services/data/v46.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile

   2. Indsæt svarteksten i en applikation, f.eks. Excel for nemmere at se begivenhedslogdata som en .CSV-fil.

3. Gennemse hver .CSV-fil, og fin ud af, om der sendes anmodninger til slutpunkter med API-versioner under 20.

   1. SOAP/API EventType -- gennemse værdierne i kolonnen API_VERSION for registreringer af API_TYPE "E" eller "P"

   2. REST / RestApi EventType -- gennemse værdierne i kolonnen URI, og bemærk slutpunkter med "/v20.0" eller lavere i stien

4. Eventuelle integrationer, der bruger version 20 og ældre, vil blive berørt af denne API-tilbagetrækning.

Hvis du ønsker yderligere oplysninger, kan du se Trailhead-modulet How to Download and Visualize Event Log Files (Sådan downloades og visualiseres begivenhedslogfiler). 

For Bulk API skal du navigere til siden "Massedataindlæsningsjob" i Opsætning og se detaljerne for hvert "Bulk V1"-job. Ethvert job med værdien 20.0 eller derunder i feltet "API Version" vil være påvirket af denne API-tilbagetrækning. 

Hvorfor trækker vi dette produkt tilbage?

Vi koncentrerer vores udviklingsindsats om forbedring af vores nyeste API-versioner for at forbedre den generelle Salesforce-oplevelse ved opbygning af tilpasset funktionalitet via applikationer. 

Hvordan får jeg flere oplysninger?

Hvis du ønsker yderligere oplysninger om, hvilke funktioner den nyeste SOAP API-version understøtter, kan du besøge Salesforce Developer-sitet og se følgende dokumentation:

• Introduktion til SOAP API Developer Guide

• Introduktion til Lightning Platform REST API

• Introduktion til Bulk API

Hvis du har flere spørgsmål, kan du oprette en sag hos Kundesupport via portalen Hjælp og uddannelse.