Opdatering af hardcodede referencer

Generelle ofte stillede spørgsmål

1. Hvad er hardcodede referencer (også kaldet forekomstspecifikke referencer)?

a) En hardcodet reference er en URL, der indeholder navnet på forekomsten i URL'en (f.eks. na1.salesforce.com). Erstat disse hardcodede referencer med generiske, ikke-forekomstspecifikke eller relative URL'er (f.eks. login.salesforce.com eller <mydomain>.my.salesforce.com).

Her er et eksempel på en hardcodet reference: https://na1.salesforce.com/{Case.Id}
Lav den om til en relativ reference ved at fjerne 'na1.salesforce.com', så den bliver til: /{Case.Id}

Bemærk: Inden for Salesforce dirigerer relative referencer dig automatisk til den rigtige registrering. Eksterne anmodninger skal sendes til et generisk slutpunkt, f.eks.: https://login.salesforce.com i stedet for https://na1.salesforce.com.
 

2. Hvordan finder jeg hardcodede referencer?

a) Brug Salesforce-værktøjet Lightning Experience-parathedskontrol til at finde hardcodede referencer, og find samtidig ud af, hvor parat du er til Lightning Experience:
I Lightning: Gå til Opsætning | Lightning Experience | Kontroller parathed
I Classic: Gå til Opsætning | klik på 'Kom i gang' under 'Lightning Experience-migreringsassistent' | Kontroller parathed

Bemærk, at ikke alle hardcodede referencer bliver fundet med værktøjet Lightning Experience-parathedskontrol. Hvis du vil vide mere om, hvad dette værktøj rapporterer om, kan du gennemse dokumentationen What Does the Lightning Experience Readiness Check Evaluate? (Hvad evaluerer Lightning Experience-parathedskontrol)

b) Søg efter hardcodede referencer med Salesforce Extensions for Visual Studio Code
Salesforce Extensions for Visual Studio Code er et udviklerværktøj, der kan anvendes til at finde hardcodede referencer. Følg trinene i artiklen Creating a Salesforce Project in Visual Studio Code and Searching for Hard-Coded References (Oprettelse af et Salesforce-projekt i Visual Studio-kode og Søgning efter hardcodede referencer* i din organisation og din organisations metadata (opsætning eller kundekode).

3. Hvordan opdaterer jeg hardcodede referencer i integrationer?

For dine integrationer til Salesforce-produkter eller Force.com, skal du bruge Force.com API'ers login()-anmodningen som et startpunkt. login()-anmodningen skal sendes til et generisk slutpunkt som f.eks.: https://login.salesforce.com/services/Soap/u/26.0.
login()-kaldet vil etablere en Force.com-session og svarer med loginserver-URL'en. Angiv denne server-URL som målserver for efterfølgende API-anmodninger, og indstil den returnerede sessions-id i SOAP-sidehovedet til at give servergodkendelse for efterfølgende API-anmodninger.

Ofte stillede spørgsmål om forekomstopdatering og organisationsmigrering
Spørgsmålene om hardcodede referencer kan være relevante, når du forbereder flytning til en ny forekomst.

4. Hvilke hardcodede referencer kan Salesforce-servere omdirigere efter flytning til en ny forekomst?

Da det ikke er alle hardcodede referencer, der omdirigeres efter en forekomstopdatering eller organisationsmigrering, anbefaler vi, at du implementerer Mit domæne og fjerner alle hardcodede referencer forud for en flytning. Følgende er en liste over punkter, som Salesforce-servere kan omdirigere, men du kan opleve en langsom ydeevne, når du bruger disse objekter efter flytning til en ny forekomst: 

i. Browserlinks
ii. Browserbogmærkede URL'er
iii. Tilpassede knapper
iv. Indholds-URL'er
v. Chatter-indlæg
vi. Selvbetjeningslogin-URL'er (sserv/login.jsp?orgid)
vii. Integrationer

5. Hvilke hardcodede referencer skal opdateres (dvs. omdirigeres ikke) før flytning til en ny forekomst?

Uanset om du har Mit domæne aktiveret, skal du sørge for, at opdatere hardcodede referencer i mailskabeloner og knowledge-artikler.
Uanset om du har Mit domæne aktiveret, skal du sørge for, at alle billeder i knowledge-artikler og mailskabeloner er blevet uploadet fra din computer i modsætning til en webadresse, så de fortsat kan vises efter vedligeholdelsen.

i. Hvis du har billeder, der er indsat via webadresse, skal du downloade billedet til din computer og genuploade det ved at vælge "Upload billede", når billedet indsættes i en knowledge-artikel eller en mailskabelon. Se følgende diagrammer for at få vist den relevante proces.

BEMÆRK: Hvis du opdager, at referencer til billeder er brudt efter vedligeholdelsen, fordi de ikke var uploadet fra din computer, skal du erstatte det gamle forekomstnavn i billed-URL'en med det nye forekomstnavn. Derefter skal du downloade billedet til din computer og genuploade det fra din computer for at forhindre, at referencer til billedet brydes efter fremtidige vedligeholdelser.

6. Hvordan kan jeg kontrollere, at alle billeder i mine knowledge-artikler og mailskabeloner er uploadet fra min computer i modsætning til en webadresse?

Hvis et billede er uploadet fra en lokal maskine, skal billed-URL'en se sådan ud "https://[VÆRT-ELLER-MIT-DOMÆNE]/servlet/rtaImage…".

Hvis et billede er linket fra en webadresse (eller fra fanen Dokumenter), skal billed-URL'en se sådan ud "https://[VÆRT-ELLER-MIT-DOMÆNE]/servlet/servlet.ImageServer..." eller "https://[VÆRT-ELLER-MIT-DOMÆNE]/servlet/servlet.FileDownload…"

7. Har jeg brug for at opdatere de hardcodede referencer i mine CTI-integrationer, hvis jeg flytter til en ny forekomst?

Hvis du bruger Open CTI, og CTI Adapter-URL'en i din callcenter-definition er hardcodet med din Salesforce-forekomst (f.eks. https://c.na6-visual.force.com/apex/Softphone ), vil det hav indflydelse på din CTI-integration.
Rediger denne hardcodede reference til en relativ URL (f.eks. /apex/Softphone) for at sikre, at din CTI-integration vil fortsætte med at fungere efter flytningen til en ny forekomst. Hvis du vil opdatere denne, kan du navigere til den specifikke kliksti for callcenter-objektet: Opsætning > Call Centers (Callcentre).

Hvis du bruger Salesforce Desktop CTI Integration Toolkit, vil denne vedligeholdelse ikke have indflydelse på din CTI-integration, da dette toolkit ikke tillader hardcodede referencer.

8. Skal jeg opdatere mine id'er for mailtråde, hvis jeg flytter til en ny forekomst?

Hvis du har oprettet tilpassede id'er for mailtråde, kan det have indflydelse efter en flytning til en ny forekomst. Ellers vil det ikke blive krævet, at du opdaterer eksisterende mailtråd-id'er, der er genereret af Salesforce, efter en flytning til en ny forekomst (selvom der stadig refereres til et gammelt forekomstnavn).

Gennemse følgende trin for at redigere et tilpasset mailtråd-id:
i. Opdater din tilpassede formel til følgende format: ref:_00D[XX][yyyyy]._500[AA][bbbbb]:ref
ii. Hvor yyyyy og bbbbb er 10-tegns id'et med indledende nuller fjernet.
iii. Formater på mailtråd-id'er, der kan parses af vores systemkode, er følgende, (yyyyy og bbbbb er registrerings-id'et uden indledende nuller)

BEMÆRK: at ref:00DXyyyyy.500Abbbbb:ref er det gamle format, der ikke længere bruges.

Salesforce kan ændre formaterne med tiden, hvorfor kunderne bør undlade at generere deres egne tråd-id'er. Med tilpassede tråd-id'er kan du opleve et problem med on-demand Email-til-Sag (E2C), hvor der oprettes nye sager, som ikke vedhæftes til den oprindelige sag med svar. Opret ikke dine egne tilpassede tråd-id-formater. Vi understøtter ikke officielt tilpassede formler for sags-tråd-id'er og anbefaler derfor kunderne at bruge den indbyggede tråd-id-formel, som Salesforce genererer. Hvis du ønsker flere oplysninger om, hvorfor du ikke skal oprette tilpassede formler, kan du gennemse artiklen Use custom thread IDs with Email to Case (Brug tilpassede tråd-id'er med Mail-til-sag).

9. Kan kunderne stadig få adgang til vores partnerportal fra URL'en til den gamle forekomst, når vi flytter til den nye forekomst?

I ca. 30 dage efter flytning til en ny forekomst vil kunderne kunne få adgang til din partnerportal ved brug af URL'en til den gamle forekomst. Efter dette 30-dages vindue vil login-URL'en til den gamle forekomst blive taget ud af drift. Før flytning til den nye forekomst anbefaler vi, at administratorer tilføjer en tilpasset bemærkning under meddelelsen om "systemvedligeholdelse" på deres organisations partnerportal, der dirigerer kunderne til at bruge URL'en til den nye partnerportal efter flytningen til en ny forekomst. Administratorer kan også vælge at anbefale kunder at opdatere deres bogmærker med den nye URL til partnerportalen.

10. Vil der være nogen påvirkning af Web-til-Emner/Sager (W2X), når jeg er flyttet til en ny forekomst?

Hvis du har hardcodede referencer i din W2X, skal du opdatere dem til relative URL'er, før du flytter til en ny forekomst Hvis du ikke opdaterer hardcodede referencer, vil du kunne opleve utilsigtede tjenesteafbrydelser af W2X efter vedligeholdelsen. W2X vil blive sat i kø og behandlet, efter vedligeholdelsen er fuldført.

11. Skal navne på eksterne websites opdateres, når jeg er flyttet til en ny forekomst?

Ja. Hvis du ikke bruger Mit domæne, skal hardcodede referencer i navne på eksterne websites opdateres med navnet på den nye forekomst umiddelbart efter vedligeholdelsen.
Hvis du ikke opdaterer hardcodede referencer i navne på eksterne websites efter vedligeholdelsen, kan du opleve tjenesteafbrydelser på de eksterne sites.

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

Flytning til en ny forekomst kan påvirke data i Salesforce Mobile SDK-oprettede apps, hvis brugerne ikke har de nyeste versioner. Vi anbefaler, at du opdaterer alle Salesforce Mobile SDK-oprettede apps og overfører disse opdateringer med push til alle brugere i din organisation før vedligeholdelsen.
Hvis brugerne har de nyeste versioner af alle Salesforce Mobile SDK-oprettede apps, burde flytning til en ny forekomst ikke påvirke data i disse apps.

13. Hvad gør jeg, hvis jeg har en Live Agent- eller SOS-implementering?

Hvis din webside eller certifikater har en hardcodet reference til Live Agents slutpunkts-URL, så kan en forekomstopdatering, organisationsmigrering eller et lokalitetsskift påvirke din Live Agent-/SOS-funktionalitet. Du kan minimere påvirkningen ved at følge bedste fremgangsmåder og undgå hardcodede referencer til slutpunktet og sørge for, at du opdaterer slutpunkts-URL'en i den implementeringskode, du kopierede fra implementeringssiden i Opsætning. Den implementeringskode, vi leverer, har mulighed for at omdirigere til den netop tildelte server, men du skal stadig opdatere slutpunktet umiddelbart efter opdateringen er fuldført. 

Hvis du ønsker flere oplysninger om Live Agent-slutpunkter, og hvad der menes med et hardcodet slutpunkt, kan du gennemse artiklen Live Agent-server (slutpunkts-URL) er ændret og nu fungerer Live Agent-chat ikke længere.

14. Hvilke handlinger skal jeg udføre for Apex-webtjenestegenererede WSDL'er?

a. Hvis du bruger WSDL'er til at generere koden, skal alle områder, hvor du har anvendt koden, kontrolleres for hardcodede referencer. Alle hardcodede referencer skal opdateres til enten en URL til Mit domæne eller en relativ URL (login.salesforce.com). Vi anbefaler implementering af Mit domæne, før du flytter til en ny forekomst. Dette vil sikre, at du ikke behøver at udføre dette arbejde igen, når du har rettet alle hardcodede referencer til at pege på den nye URL til Mit domæne.