Ritiro delle versioni legacy delle API Lightning Platform

Che cosa cambia?

Con il rilascio Summer '21, le seguenti versioni legacy delle API Lightning Platform verranno ritirate e non saranno più supportate da 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: 20.0

• In blocco: 16.0, 17.0, 18.0, 19.0, 20.0

I clienti possono continuare a utilizzare queste versioni legacy delle API fino al rilascio Summer '21; dopo questo rilascio tali versioni non saranno più disponibili. Quando tali versioni legacy saranno ritirate, si verificheranno delle interruzioni nel funzionamento delle applicazioni che utilizzano le versioni delle API interessate, in quanto le richieste non funzioneranno e genereranno un errore indicante che l'endpoint richiesto è stato disattivato. 

Quale procedura devo eseguire? 

Prima del rilascio Summer '21, i clienti dovranno modificare o aggiornare le proprie applicazioni in modo che funzionino con le versioni delle API più recenti, per evitare qualsiasi interruzione dovuta a riferimenti alle versioni ritirate all'interno del software. Il passaggio a versioni più nuove delle nostre API consentirà di offrire funzionalità avanzate e livelli di sicurezza e prestazioni migliorati.

Come faccio a sapere se nelle mie applicazioni vengono utilizzate versioni interessate delle API legacy?

Per identificare le applicazioni che utilizzano API che verranno ritirate, contattare gli sviluppatori delle applicazioni utilizzate nella propria organizzazione per determinare le versioni delle API in uso. 
 

Se non è possibile contattare gli sviluppatori delle proprie applicazioni, esaminare i registri evento che riportano l'attività delle API SOAP e REST delle organizzazioni Salesforce seguendo questi passaggi:

1. Utilizzare uno strumento quale Salesforce CLI per eseguire una query SOQL nell'oggetto EventLogFile che produrrà un registro di tutte le azioni intraprese nella propria organizzazione nel corso delle ultime 24 ore.

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

2. Per ciascun risultato, eseguire una richiesta REST utilizzando l'endpoint per ottenere i dati e copiarli in un file .CSV.

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

   2. Incollare il corpo della risposta in un'applicazione, ad esempio Excel, per visualizzare più facilmente i dati del registro evento come file .CSV.

3. Esaminare tutti i file .CSV e stabilire se vengono effettuate richieste a endpoint con versioni delle API precedenti la versione 20.

   1. SOAP/API EventType -- Esaminare i valori nella colonna API_VERSION per i record il cui valore API_TYPE corrisponde a "E" o a "P"

   2. REST/RestApi EventType -- Esaminare i valori nella colonna URI e prendere nota degli endpoint con "/v20.0" o inferiore nel percorso

4. Eventuali integrazioni che utilizzano la versione 20 e versioni precedenti saranno interessate da questo ritiro di API.

Per maggiori informazioni, è possibile consultare il modulo Trailhead How to Download and Visualize Event Log Files (Come scaricare e visualizzare i file registro evento). 

Per l'API in blocco, passare alla pagina Processi di caricamento dati in blocco all'interno di Imposta e visualizzare i dettagli di ciascun processo "Bulk V1". Eventuali processi con un valore uguale o inferiore a 20.0 all'interno del campo Versione API saranno interessati dal ritiro delle API. 

Perché ritirerete il prodotto?

Stiamo concentrando i nostri sforzi di sviluppo sull'ottimizzazione delle ultime versioni delle API con l'obiettivo di migliorare l'esperienza Salesforce complessiva a livello di creazione di funzionalità personalizzate attraverso le applicazioni. 

Come posso ottenere altre informazioni?

Per maggiori informazioni sulle funzioni supportate dalla versione più recente dell'API SOAP, visitare il sito degli sviluppatori Salesforce e consultare la seguente documentazione:

• Introducing SOAP API Developer Guide (Guida per sviluppatori - Presentazione dell'API SOAP)

• Introducing Lightning Platform REST API (Presentazione dell'API REST per Lightning Platform)

• Introduction to Bulk API (Presentazione dell'API in blocco)

Per ulteriori domande, è possibile aprire un caso con l'Assistenza clienti sul portale Assistenza & formazione.