Loading

Oppdatere hardkodede referanser

Publiseringsdato: Sep 2, 2021
Beskrivelse

Sist oppdatert 9. januar 2020

På høyt nivå er en hardkodet referanse en lenke som inneholder forekomstnavnet (f.eks. NA25, AP2, EU4, CS10 osv.). Hvis Salesforce-organisasjonen underlegges vedlikehold som en forekomstoppdatering eller organisasjonsoverføring, og organisasjonen har hardkodede referanser innenfor integrasjoner, e-postmaler, Knowledge-artikler og tilpassinger, kan avbrudd forekomme. For eksempel kan integrasjoner brytes og e-postmeldinger kan inneholde brutte lenker og bilder. For å hindre at slike typer avbrudd skjer anbefaler vi å implementere Mitt domene og se gjennom de vanlige spørsmålene nedenfor.

MERK: Dette dokumentet er bare til informasjon, og er ikke del av en juridisk eller på annen måte bindende avtale. Policyene og praksisen som beskrives i dette dokumentet, kan endres slik Salesforce ønsker.

Relaterte artikler:

Løsning

vanlige generelle spørsmål

1. Hva er hardkodede referanser (dvs. forekomstspesifikke referanser)?

a) En hardkodet referanse er en URL som inneholder navnet på forekomsten i URL-en (for eksempel na1.salesforce.com). Erstatt disse hardkodede referansene med generiske, ikke forekomstspesifikke eller relative URL-er (f.eks. login.salesforce.com eller <mittdomene>.my.salesforce.com).

Her er et eksempel på en hardkodet referanse: https://na1.salesforce.com/{Case.Id}
Gjør denne til en relativ referanse ved å fjerne “na1.salesforce.com” slik at den blir: /{Case.Id}

MERK: Innenfor Salesforce vil relative referanser automatisk dirigere deg til den riktige posten. Eksterne forespørsler bør sendes til et generisk endepunkt, som https://login.salesforce.com, i stedet for https://na1.salesforce.com.
 

2. Hvor kan jeg finne hardkodede referanser?

a) Bruk Salesforce-verktøyet Lightning Experience Readiness Check for å avdekke hardkodede referanser, og som også hjelper deg med å finne ut hvor klar du er for Lightning Experience:
I Lightning: Gå til Oppsett | Lightning Experience | Kontroller klargjøring
I Classic: Gå til Oppsett | klikk på “Kom i gang” nedenfor “Lightning Experience Overføringsassistent” | Kontroller klargjøring

Vær oppmerksom på at ikke alle hardkodede referanser avdekkes med verktøyet Lightning Experience Readiness Check. Hvis du vil vite mer om hva dette verktøyet rapporterer på, kan du lese dokumentasjonen What Does the Lightning Experience Readiness Check Evaluate?

b) Søk etter hardkodede referanser med Salesforce Extensions for Visual Studio Code
Salesforce Extensions for Visual Studio Code er et utviklerverktøy som kan brukes til å finne hardkodede referanser. Følg fremgangsmåten i artikkelen Opprette et Salesforce-prosjekt i Visual Studio Code og søke etter hardkodede referanser for å oppdatere hardkodede referanser* i organisasjonen og organisasjonens metadata (oppsett eller kundekode).

3. Hvordan oppdaterer jeg hardkodede referanser i integreringer?

For integreringer med Salesforce-produkter eller Force.com brukes Force.com-APIets login()-forespørsel som startpunkt. Login()-forespørselen skal sendes til et generisk endepunkt som: https://login.salesforce.com/services/Soap/u/26.0.
Login()-kallet åpner en Force.com-økt og svarer med URL-adressen til påloggingsserveren. Angi denne server-URLen som målserver for påfølgende API-forespørsler, og angi den returnerte økt-IDen i SOAP-hodet for å gi servergodkjenning for påfølgende API-forespørsler.

Vanlige spørsmål relatert til forekomstoppdatering og organisasjonsoverføring
Disse spørsmålene om hardkodede referanser kan være relevante når du forbereder flytting til en ny forekomst.

4. Hvilke hardkodede referanser kan Salesforce-servere omdirigere etter flytting til en ny forekomst?

Siden ikke alle hardkodede referanser blir omdirigert etter en forekomstoppdatering eller organisasjonsoverføring, anbefaler vi på det sterkeste å implementere Mitt domene og fjerne alle hardkodede referanser før en flytting. Nedenfor er en liste over elementer som Salesforce-servere kan omdirigere, men du kan oppleve treg ytelse når du bruker disse objektene etter flytting til en ny forekomst: 

i. Nettleserlenker
ii. Bokmerkede nettleser-URLer
iii. Tilpassede knapper
iv. Innholds-URLer
v. Chatter-innlegg
vi. Påloggings-URLer for selvbetjening (sserv/login.jsp?orgid)
vii. Integrasjoner

5. Hvilke hardkodede referanser må oppdateres (dvs. blir ikke omdirigert) før flytting til en ny forekomst?

Hvis du ikke har Mitt domene aktivert, må du oppdatere hardkodede referanser i e-postmaler og Knowledge-artikler.
Uansett om du har Mitt domene aktivert eller ikke, må du sørge for at alle bilder innenfor Knowledge-artikler og e-postmaler har blitt oppdatert fra datamaskinen din og ikke en nettadresse for at de fortsatt skal vises etter vedlikeholdet.

i. Hvis du har bilder som er satt inn via nettadresse, må du laste ned bildet til datamaskinen din og laste det opp på nytt ved å velge alternativet "Last opp bilde" når du setter inn bildet i en Knowledge-artikkel eller e-postmal. De neste diagrammene viser den riktige prosessen.

MERK: Hvis du oppdager at bilder er brutt etter vedlikeholdet fordi de ikke ble lastet opp fra datamaskinen din, må du erstatte det gamle forekomstnavnet i bilde-URLen med det nye forekomstnavnet. Deretter må du laste ned bildet til datamaskinen og laste det opp på nytt fra datamaskinen for å hindre at bildet brytes etter fremtidige vedlikehold.

6. Hvordan kan jeg kontrollere at alle bilder i Knowledge-artikler og e-postmaler har blitt lastet opp fra datamaskinen min og ikke nettadresse?

Hvis et bilde har blitt lastet opp fra en lokal maskin, skal bilde-URLen være "https://[VERT-ELLER-MITT-DOMENE]/servlet/rtaImage…".

Hvis et bilde er lenket fra en nettadresse (eller din Dokumenter-fane), skal bilde-URLen være "https://[VERT-ELLER-MITT-DOMENE]/servlet/servlet.ImageServer..." eller “https://[VERT-ELLER-MITT-DOMENE]/servlet/servlet.FileDownload…"

7. Må jeg oppdatere de hardkodede referansene i CTI-integrasjonene hvis jeg flytter til en ny forekomst?

Hvis du bruker Open CTI og CTI Adapter-URLen i Call Center-definisjonen er hardkodet med din Salesforce-forekomst (for eksempel https://c.na6-visual.force.com/apex/Softphone ), vil CTI-integrasjonen bli berørt.
Endre denne hardkodede referansen til en relativ URL (for eksempel /apex/Softphone) for å sikre at CTI-integrasjonen fungerer etter flytting til en ny forekomst. For å oppdatere dette kan du navigere til den spesifikke klikkbanen i Call Center-objektet: Oppsett > Call Center-enheter.

Hvis du bruker Salesforce Desktop CTI Integration Toolkit, vil ikke dette vedlikeholdet berøre CTI-integrasjonen fordi verktøysettet ikke tillater hardkodede referanser.

8. Må jeg oppdatere tråd-IDer for e-post hvis jeg flytter til en ny forekomst?

Hvis du har opprettet tilpassede tråd-IDer for e-post, kan du berøres etter flytting til en ny forekomst. Ellers trenger du ikke å oppdatere eksisterende tråd-IDer for e-post som er generert av Salesforce, etter en flytting til en ny forekomst (selv om det fremdeles henvises til forekomstnavnet).

Se gjennom følgende trinn for å korrigere en tilpasset tråd-ID for e-post:
i. Oppdater den tilpassede formelen til følgende format: ref:_00D[XX][yyyyy]._500[AA][bbbbb]:ref
ii. Der yyyyy og bbbbb er IDen på 10 tegn med de innledende nullene fjernet.
iii. Formater for tråd-ID for e-post som kan analyseres av systemkoden, er som følger (yyyyy og bbbbb er post-ID uten innledende nuller)

MERK: ref:00DXyyyyy.500Abbbbb:ref er det gamle formatet som ikke lenger brukes.

Salesforce kan endre formatene over tid. Derfor bør ikke kunder generere sine egne tråd-IDer. Med tilpassede tråd-IDer kan du oppleve et problem med E-post-til-sak (E2C) på forespørsel der nye saker blir opprettet og ikke legges ved den opprinnelige saken med svar. Ikke opprett dine egne tilpassede formater for tråd-IDer. Vi støtter offisielt ikke tilpassede formler for tråd-IDer for sak, og anbefaler derfor at kunder bruker den ferdige formelen for tråd-ID som Salesforce genererer. Hvis du ønsker mer informasjon om hvorfor du ikke bør opprette tilpassede formater, kan du lese artikkelen Bruke tilpassede tråd-IDer med e-post-til-sak.

9. Vil kunder fremdeles kunne få tilgang til partnerportalen vår fra den gamle forekomst-URLen etter at vi har flyttet til en ny forekomst?

Kunder skulle få tilgang til partnerportalen via den gamle forekomst-URLen i ca. 30 dager etter flytting til en ny forekomst. Etter dette vinduet på 30 dager vil påloggings-URLen for den gamle forekomsten settes ut av drift. Før flytting til en ny forekomst anbefaler vi at administratorer legger til et tilpasset notat under Systemvedlikehold-meldingen i organisasjonens partnerportal for å dirigere kunder til den nye partnerportal-URLen etter flyttingen til en ny forekomst. Administratorer kan også anbefale kundene å oppdatere påloggingsbokmerkene med den nye URLen.

10. Vil det være noen innvirkning på nett-til-salgsemne/saker (W2X) etter flytting til en ny forekomst?

Hvis du har hardkodede referanser i W2X, må du oppdatere dem til relative URLer før flytting til en ny forekomst. Hvis du ikke oppdaterer hardkodede referanser, kan du oppleve uønskede tjenesteavbrudd i W2X etter vedlikeholdet. W2X vil bli lagt i kø og behandlet når vedlikeholdet er fullført.

11. Må navn på eksterne steder oppdateres etter flytting til en ny forekomst?

Ja. Hvis du ikke bruker Mitt domene, må hardkodede referanser i navn på eksterne steder oppdateres med det nye forekomstnavnet umiddelbart etter vedlikeholdet.
Hvis du ikke oppdaterer hardkodede referanser i navn på eksterne steder etter vedlikeholdet, kan du oppleve uønskede tjenesteavbrudd for eksterne steder.

12. Vil flytting til en ny forekomst påvirke Salesforce Mobile SDK?

Flytting til en ny forekomst kan påvirke data i Salesforce Mobile SDK-opprettede apper hvis brukere ikke har de siste versjonene. Vi anbefaler at du oppdaterer alle Salesforce Mobile SDK-opprettede apper og sender disse oppdateringene til alle brukerne i organisasjonen før vedlikeholdet.
Hvis brukerne har de siste versjonene av alle Salesforce Mobile SDK-opprettede apper, skulle ikke flytting til en ny forekomst påvirke dataene innenfor appene.

​​13. Hva skal jeg gjøre hvis jeg har en Live Agent- eller SOS-implementasjon?

Hvis nettsiden eller sertifikater har en hardkodet referanse til endepunkt-URLen for Live Agent, vil en forekomstoppdatering, en organisasjonsoverføring eller et stedsbytte få innvirkning på Live Agent/SOS-funksjonaliteten. For å minimere innvirkningen bør du følge beste praksis og unngå alle hardkodede referanser til endepunktet, og sørge for å oppdatere endepunkt-URLen i distribusjonskoden du kopierte fra Distribusjon-siden i Oppsett. Distribusjonskoden vi leverer, kan omdirigere til den nylig tilordnede serveren, men du bør likevel oppdatere endepunktet umiddelbart etter at oppdateringen er fullført. 

Du finner mer informasjon om Live Agent-endepunkter og hva som menes med et hardkodet endepunkt, i artikkelen Live Agent-server (endepunkt-URL) er endret og nå fungerer ikke Live Agent Chat lenger.

14. Hva må jeg gjøre med hensyn til Apex Web Services-genererte WSDL-filer?

Hvis du bruker WSDL-filer til å generere kode, må alle områder der du har brukt koden, sjekkes for hardkodede referanser. Alle hardkodede referanser må oppdateres til enten en Mitt domene-URL eller en relativ URL (login.salesforce.com). Vi anbefaler å implementere Mitt domene før flytting til en ny forekomst. Dette vil sikre at straks du har fikset alle hardkodede referanser slik at de peker til den nye Mitt domene-URLen, trenger du ikke å gjøre dette flere ganger.

Knowledge-artikkelnummer

000387070

 
Laster
Salesforce Help | Article