Lightning Platform API:n vanhojen versioiden käytöstä poistaminen

Mikä muuttuu?

Summer ’21 -julkaisun myötä seuraavat Lightning Platform API:n vanhat versiot poistetaan käytöstä eikä Salesforce enää tue niitä:

• 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

Asiakkaat voivat jatkaa näiden vanhojen API-versioiden käyttämistä Summer ‘21 -julkaisuun asti, jolloin näiden vanhojen versioiden tuki lopetetaan. Kun nämä vanhat versiot poistetaan käytöstä, näitä vanhoja API-versioita käyttävissä sovelluksissa ilmenee häiriöitä. Sillä pyynnöt epäonnistuvat ja johtavat virheeseen, joka ilmoittaa pyydetyn päätepisteen käytöstä poistamisesta. 

Mitä minun täytyy tehdä? 

Ennen Summer ’21 -julkaisua asiakkaiden täytyy muokata tai päivittää sovelluksensa, jotta ne toimivat ajantasaisimpien saatavilla olevien API-versioiden kanssa estääkseen häiriöt, jotka johtuvat ohjelmistoon viittaavista käytöstä poistetuista versioista. Siirtyminen uudempiin API-versioihin tarjoaa sinulle kehittyneitä ominaisuuksia sekä parempaa tietoturvaa ja suorituskykyä.

Mistä tiedän, käyttävätkö sovellukseni vanhaa API-versiota, johon tämä vaikuttaa?

Voit tunnistaa sovellukset, jotka käyttävät käytöstä poistettavia API-versioita ottamalla yhteyttä organisaatiosi kehittäjiin selvittääksesi, mitä API-versioita käytetään. 
 

Jos et saa yhteyttä sovellusten kehittäjiin, voit tarkastella tapahtumalokia, jotka raportoivat SOAP- ja REST API -toimintoja Salesforce-organisaatioistasi seuraavasti:

1. Käytä työkalua, kuten Salesforce CLI, suorittaaksesi SOQL-kyselyn EventLogFile-objektille, joka tarjoaa sinulle lokin kaikista organisaatiossasi edellisen 24 tunnin aikana tehdyistä toiminnoista.

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

2. Tee jokaiselle tulokselle REST-pyyntö käyttämällä päätepistettä datan saamiseksi ja kopioi se .CSV-tiedostoon.

   1. e.g. /services/data/v46.0/sobjects/EventLogFile/0AT3i000005vXpWGAU/LogFile

   2. Liitä vastauksen leipäteksti esimerkiksi Excel-sovellukseen, josta voit helpommin tarkastella lokitietoja .CSV-tiedostona.

3. Tarkasta jokainen .CSV-tiedosto ja määritä tehdäänkö pyynnöt päätepisteisiin, joiden API-versiot ovat vanhempia kuin versio 20.

   1. SOAP-/API-tapahtumatyyppi -- tarkasta arvot sarakkeesta API_VERSION tietueille API_TYPE “E” tai “P”

   2. REST-/RestApi-tapahtumatyyppi -- tarkasta arvot URI-sarakkeesta ja huomioi päätepisteet, joissa on ”/v20.0” tai vanhempi polussa

4. Tämä API-versioiden tuen lopettaminen vaikuttaa kaikkiin integraatioihin, jotka käyttävät versioita 20 tai sitä vanhempaa.

Lisätietoja on Trailhead-moduulissa How to Download and Visualize Event Log Files. 

Bulk API:ssa siirry Määritykset-valikon ”Bulk-datan lataustyöt” -sivulle ja tarkastele jokaisen ”Bulk V1” -työn tietoja. Tämän API:n käytöstä poistaminen vaikuttaa kaikkiin työn ominaisuuksiin, joiden arvo ”API-versio” -kentässä on 20.0 tai vanhempi. 

Miksi näin tapahtuu?

Keskitymme kehittämään uusimpia API-versioita parantaaksemme Salesforcen kokonaisvaltaista käyttökokemusta, kun laadit mukautettuja toimintoja sovelluksilla. 

Mistä saan lisätietoa?

Lisätietoja siitä mitä ominaisuuksia uusin SOAP API -versio tukee, löytyy Salesforce-kehittäjäsivustolta sekä seuraavista dokumentaatioista:

• Esittelyssä SOAP API -kehittäjien opas

• Esittelyssä Lightning Platform REST API

• Johdatus Bulk API:in

Jos sinulla on vielä kysyttävää, voit lähettää asiakaspalvelulle tukitapauksen Ohje ja koulutus -portaalista.