Domande frequenti sull'aggiornamento dei riferimenti codificati (hardcoded)

DOMANDE FREQUENTI di carattere generale

1. Che cosa sono i riferimenti codificati (hardcoded, ossia riferimenti specifici per istanza)?

a) Un riferimento codificato è un URL che contiene il nome dell'istanza (ad es. na1.salesforce.com). Sostituire a questi riferimenti codificati URL generici, non specifici di una particolare istanza o relativi (ad es. login.salesforce.com o <dominiopersonale>.my.salesforce.com).

Segue un esempio di riferimento codificato: https://na1.salesforce.com/{Case.Id}
Per trasformarlo in un riferimento relativo è sufficiente rimuovere "na1.salesforce.com" così che diventi: /{Case.Id}

NOTA: in Salesforce, i riferimenti relativi portano automaticamente al record corretto. Le richieste esterne devono essere inviate a un endpoint generico, quale: https://login.salesforce.com, invece di https://na1.salesforce.com.
 

2. Come posso trovare i riferimenti codificati (hardcoded)?

a) Sfruttare lo strumento Salesforce Controllo della preparazione a Lightning Experience per individuare i riferimenti codificati, il che è utile anche per determinare il grado di preparazione a Lightning Experience:
In Lightning: andare a Imposta| Lightning Experience | Controlla preparazione
In Classic: andare a Imposta| fare clic su "Per iniziare" alla voce "Assistente di migrazione a Lightning Experience" | Controlla preparazione

Si noti che non tutti i riferimenti codificati vengono individuati mediante lo strumento di controllo della preparazione a Lightning Experience. Per ulteriori informazioni in merito ai risultati ottenibili con questo strumento consultare la documentazione Che cosa valuta il controllo della preparazione a Lightning Experience?

b) Effettuare una ricerca dei riferimenti codificati mediante Salesforce Extensions for Visual Studio Code
Salesforce Extensions for Visual Studio Code è uno strumento per sviluppatori che può essere utilizzato per individuare i riferimenti codificati. Seguire i passaggi nell'articolo, Creating a Salesforce Project in Visual Studio Code and Searching for Hard-Coded References (Creazione di un Progetto Salesforce in Visual Studio Code e ricerca dei riferimenti codificati), per aggiornare i riferimenti codificati (hardcoded)* nella propria organizzazione e nei metadati della propria organizzazione (codice di impostazione o cliente).

3. Come si aggiornano i riferimenti codificati nelle integrazioni?

Per le proprie integrazioni ai prodotti Salesforce o Force.com, utilizzare la richiesta login() all'API Force.com come punto di partenza. La richiesta login() deve essere inviata a un endpoint generico, ad esempio: https://login.salesforce.com/services/Soap/u/26.0.
La chiamata login() stabilirà una sessione Force.com e risponderà con l'URL del server di accesso. Impostare l'URL di questo server come il server di destinazione per le successive richieste API e impostare l'ID di sessione restituito nell'intestazione SOAP per fornire l'autorizzazione del server per le successive richieste API.

Domande frequenti sull'aggiornamento dell'istanza e sulla migrazione dell'organizzazione
Le domande frequenti relative ai riferimenti codificati possono risultare utili quando ci si prepara allo spostamento su una nuova istanza.

4. Quali riferimenti codificati possono essere reindirizzati dai server Salesforce dopo lo spostamento su una nuova istanza?

Poiché non tutti i riferimenti codificati vengono reindirizzati dopo l'aggiornamento di un'istanza o la migrazione dell'organizzazione, si consiglia vivamente di implementare Dominio personale e rimuovere tutti i riferimenti codificati prima di procedere. Di seguito riportiamo un elenco di elementi che i server Salesforce sono in grado di reindirizzare; tuttavia, potrebbe verificarsi un rallentamento delle prestazioni durante l'utilizzo di questi oggetti dopo lo spostamento su una nuova istanza: 

i. Link del browser
ii. URL salvati nei segnalibri del browser
iii. Pulsanti personalizzati
iv. URL contenuto
v. Post Chatter
vi. URL di accesso Self-Service (sserv/login.jsp?orgid)
vii. Integrazioni

5. Quali riferimenti codificati devono essere aggiornati (ovvero non verranno reindirizzati) prima dello spostamento su una nuova istanza?

Se non si è abilitato Dominio personale, è necessario aggiornare i riferimenti codificati nei modelli di email e negli articoli Knowledge.
A prescindere che Dominio personale sia abilitato o meno, sarà necessario accertarsi che tutte le immagini all'interno degli articoli Knowledge e dei modelli di email siano state caricate dal proprio computer e non inserite tramite un indirizzo Web, altrimenti non verranno visualizzate dopo la manutenzione.

i. Se si hanno immagini che sono state inserite tramite un indirizzo Web, sarà necessario scaricare tali immagini sul computer e ricaricarle scegliendo l'opzione "Carica immagine", quando si aggiungono immagini a un articolo Knowledge o a un modello di email. Vedere i seguenti grafici per una rappresentazione della procedura appropriata.

NOTA: se si rilevano immagini con link interrotti dopo la manutenzione, perché non sono state caricate dal computer, sarà necessario sostituire il vecchio nome dell'istanza nell'URL dell'immagine con il nuovo nome dell'istanza. A questo punto, è necessario scaricare l'immagine sul proprio computer e ricaricarla dal computer per fare in modo che venga visualizzata anche dopo eventuali manutenzioni future.

6. Come posso verificare che tutte le immagini all'interno dei miei articoli Knowledge e dei miei modelli di email siano state caricate dal mio computer e non inserite tramite un indirizzo Web?

Se un'immagine è stata caricata da un computer in locale, l'URL dell'immagine dovrebbe essere simile a "https://[HOST-O-DOMINIO-PERSONALE]/servlet/rtaImage…".

Se, invece, un'immagine è stata linkata da un indirizzo Web (o dalla scheda Documenti), l'URL dell'immagine è simile a "https://[HOST-O-DOMINIO-PERSONALE]/servlet/servlet.ImageServer..." oppure "https://[HOST-O-DOMINIO-PERSONALE]/servlet/servlet.FileDownload…"

7. Devo aggiornare i riferimenti codificati (hardcoded) nelle mie integrazioni CTI se mi sto spostando su una nuova istanza?

Se si sta utilizzando Open CTI e l'URL di CTI Adapter nella propria definizione di call center è codificato con la propria istanza Salesforce (ad es. https://c.na6-visual.force.com/apex/Softphone), ci sarà un impatto per la propria integrazione CTI.
È necessario sostituire questo riferimento codificato (hardcoded) con un URL relativo (ad es. /apex/Softphone) per assicurarsi che l'integrazione CTI continui a funzionare dopo lo spostamento su una nuova istanza. Per aggiornare, è possibile spostarsi sul clickstream specifico dell'oggetto call center: Imposta > Call Center.

Se si sta utilizzando il toolkit di integrazione CTI di Salesforce Desktop, questa manutenzione non avrà un impatto sulla propria integrazione CTI, in quanto il toolkit non consente i riferimenti codificati (hardcoded).

8. Devo aggiornare i miei ID thread delle email se mi sto spostando su una nuova istanza?

Se sono stati creati ID thread email personalizzati, lo spostamento su una nuova istanza può comportare alcune conseguenze. In caso contrario, non sarà necessario aggiornare gli ID thread email esistenti generati da Salesforce dopo lo spostamento su una nuova istanza (anche se si fa riferimento al nome di un'istanza precedente).

Per correggere un ID thread email generato in modo personalizzato attenersi alle seguenti procedure:
i. Aggiornare la formula personalizzata in modo che segua il formato: ref:_00D[XX][yyyyy]._500[AA][bbbbb]:ref
ii. Dove yyyyy e bbbbb sono gli ID da 10 caratteri con gli zero iniziali rimossi.
iii. I formati degli ID thread email che sono analizzabili dal codice del nostro sistema sono i seguenti (yyyyy e bbbbb sono gli ID record privi degli zero iniziali)

NOTA: ref:00DXyyyyy.500Abbbbb:ref è il formato obsoleto che non è più in uso.

Salesforce potrebbe modificare i formati in futuro, ecco perché i clienti dovrebbero astenersi dal generare i propri ID thread personalizzati. Se si utilizzano ID thread personalizzati, si potrebbe riscontrare un problema con Email a caso (E2C) on-demand, ovvero vengono creati nuovi casi, anziché essere allegati al caso originale con le risposte. Si prega di non creare dei formati di ID thread personalizzati. Ufficialmente non supportiamo le formule personalizzate per gli ID thread dei casi, pertanto si consiglia ai clienti di utilizzare la formula degli ID thread già pronta generata da Salesforce. Per ulteriori informazioni sui motivi per cui si sconsiglia la personalizzazione, consultare l'articolo Use custom thread IDs with Email to Case (Uso di ID thread personalizzati con Email a caso).

9. I clienti saranno ancora in grado di accedere al nostro portale partner dall'URL della vecchia istanza dopo che ci saremo spostati su una nuova istanza?

I clienti dovrebbero essere in grado di accedere al portale partner utilizzando l'URL della vecchia istanza per circa 30 giorni dopo lo spostamento su una nuova istanza. Trascorsi i 30 giorni, l'URL di accesso alla vecchia istanza verrà ritirato. Prima di spostarsi su una nuova istanza, consigliamo agli amministratori di aggiungere una nota personalizzata sotto al messaggio "Manutenzione di sistema" sul portale partner della propria organizzazione, indicando ai clienti di utilizzare il nuovo URL del portale partner in seguito allo spostamento su una nuova istanza. Gli amministratori possono anche scegliere di consigliare ai clienti l'aggiornamento delle pagine di accesso salvate nei segnalibri con il nuovo URL del portale partner.

10. I Web a lead/Web a caso (W2X) saranno influenzati in qualche modo dopo lo spostamento su una nuova istanza?

Se si hanno riferimenti codificati (hardcoded) nei propri W2X, sarà necessario aggiornarli agli URL relativi prima di spostarsi su una nuova istanza. Se non si aggiornano i riferimenti codificati, in seguito alla manutenzione potrebbero verificarsi interruzioni non previste dei servizi W2X. I W2X verranno messi in area di attesa ed elaborati dopo il completamento della manutenzione.

11. I nomi dei siti remoti devono essere aggiornati dopo lo spostamento su una nuova istanza?

Sì. Se non si sta utilizzando Dominio personale, i riferimenti codificati (hardcoded) nei nomi dei siti remoti dovranno essere aggiornati con il nome della nuova istanza immediatamente dopo la manutenzione.
Se non si aggiornano i riferimenti codificati (hardcoded) nei nomi dei siti remoti dopo la manutenzione, potrebbero verificarsi interruzioni non previste del servizio nei siti remoti.

12. Lo spostamento su una nuova istanza avrà un impatto sull'SDK Salesforce Mobile?

Lo spostamento su una nuova istanza potrebbe avere un impatto sui dati delle app create con l'SDK Salesforce Mobile se gli utenti non dispongono delle versioni più recenti. Si consiglia di aggiornare tutte le app create con l'SDK Salesforce Mobile e di trasmettere questi aggiornamenti a tutti gli utenti della propria organizzazione prima della manutenzione.
Se gli utenti dispongono delle versioni più recenti di tutte le app create con l'SDK Salesforce Mobile, lo spostamento su una nuova istanza non dovrebbe avere alcun impatto sui dati contenuti nelle app.

​​13. Cosa devo fare se ho un'implementazione Live Agent o SOS?

Se la propria pagina Web o i propri certificati hanno un riferimento codificato (hardcoded) all'URL dell'endpoint di Live Agent, un aggiornamento dell'istanza, una migrazione dell'organizzazione o un passaggio di sede potrebbero avere un impatto sulla funzionalità Live Agent/SOS implementata. Per ridurre al minimo tale impatto, è sufficiente seguire le procedure ottimali, evitare i riferimenti codificati (hardcoded) all'endpoint e assicurarsi di aggiornare l'URL dell'endpoint nel codice di distribuzione copiato dalla pagina Distribuzione in Imposta. Il codice di distribuzione che forniamo è in grado di reindirizzare al nuovo server assegnato, ma sarà comunque necessario aggiornare l'endpoint immediatamente una volta completato l'aggiornamento. 

Per ulteriori informazioni sugli endpoint Live Agent e sul significato di endpoint codificato (hardcoded), consultare l'articolo Live Agent server (endpoint URL) has changed and now Live Agent Chat is no longer working (Il server Live Agent (URL dell'endpoint) è cambiato e ora la chat Live Agent non funziona più).

14. Quali azioni devo intraprendere per i WSDL generati dai Servizi Web Apex?

Se si utilizzano WSDL per generare il codice, tutte le aree in cui è stato utilizzato il codice dovranno essere controllate per verificare la presenza di riferimenti codificati. Tutti i riferimenti codificati devono essere aggiornati a un URL di Dominio personale oppure a un URL relativo (login.salesforce.com). Consigliamo di implementare Dominio personale prima dello spostamento su una nuova istanza. In questo modo, una volta corretti tutti i riferimenti codificati in modo che puntino al nuovo URL di Dominio personale, non sarà necessario eseguire nuovamente questa operazione.