Vanlige feil og løsninger i Omnistudio

1. Logg deg på som systemadministrator.
2. Finn og velg Omnistudio under Oppsett.
3. Aktiver OmniStudio-tillatelsen for organisasjonen.

Hvis du ikke ser alternativet, kontrollerer du at organisasjonen har OmniStudio-lisenser. Kontakt din Salesforce-kundeansvarlig hvis det er behov for lisenser.

Tips Når du har aktivert OmniStudio-tillatelser, kan det ta noen minutter før endringene overføres i hele organisasjonen. Hvis du fortsetter å se denne feilen, prøver du å logge av og logge på igjen.

• Forsøke å slette et aktivt Omniscript
• Forsøke å oppdatere strukturfelt i et aktivt OmniScript
• Forsøk på å endre Type, Undertype eller Språk i et aktivt OmniScript

1. Finn og velg Omniskript fra Appstarter.
2. Finn Omniskriptet du vil endre eller slette.
3. Noter deg den gjeldende versjonen, og advar brukerne om den kommende deaktiveringen.
4. Fjern merket for Active for å deaktivere Omniscript og lagre endringene.
5. Nå kan du gjøre de ønskede endringene eller slette OmniScript.
6. Hvis du har gjort endringer, kan du aktivere på nytt ved å merke av for Aktiv igjen.

Advarsel Deaktivering av et OmniScript påvirker umiddelbart alle brukere og prosesser som for øyeblikket bruker det. Vurder å opprette en ny versjon i stedet for å endre den aktive hvis du trenger å opprettholde tjenestekontinuitet.

• Et annet OmniScript med identisk Type, Undertype og Språk er allerede aktivt
• opprette en ny versjon uten å deaktivere den forrige versjonen
• Flere versjoner opprettet og forsøker å aktivere flere enn én

Forsikre deg om at du har tillatelse til å redigere Omnikanal-poster og utføre disse oppgavene.

1. Finn og velg Omniskript fra Appstarter.
2. Bruk filtre eller søk etter Omniskript med samsvarende Type og SubType.
3. Identifiser for øyeblikket aktivt OmniScript med samme Type/SubType/Language.
4. Se gjennom begge versjonene for å finne ut hvilke som skal forbli aktive.
5. Åpne Omniskriptet du vil deaktivere.
6. Fjern merket for Aktiv og lagre endringene.
7. Gå tilbake til den nye versjonen og aktiver den.

Advarsel Før du aktiverer en ny versjon, må du teste den grundig i et forhåndsvisnings- eller Sandbox-miljø. Når du er klar til å distribuere, deaktiverer du den gamle versjonen og aktiverer umiddelbart den nye for å minimere nedetid.

• Typefelt er tomt eller null
• Undertypefelt er tomt eller null
• Språkfelt er ikke valgt
• Forsøk på å lagre et nytt Omniscript uten å fylle ut alle nødvendige felt

Forsikre deg om at du har tillatelse til å redigere Omnikanal-poster og utføre disse oppgavene.

1. Finn og velg Omniskript fra Appstarter.
2. Finn Type-feltet i panelet for Omnikanal-egenskaper.
3. Skriv inn et beskrivende Type-navn, som CustomerOnboarding eller ClaimSubmission.
4. Finn SubType-feltet og skriv inn et bestemt SubType-navn, for eksempel Residential eller Commercial.
5. Velg et språk fra rullegardinlisten.
6. Kontroller at alle tre feltene er fylt ut, og lagre endringene.
7. Gå tilbake til den nye versjonen og aktiver den.

Tips Velg meningsfylte Type- og SubType-navn som tydelig angir formålet med Omniscript. Disse verdiene blir en del av måten du refererer til Omnikanal-skriptet i programmene på, og de kan ikke enkelt endres etter at de har blitt opprettet.

• Type- eller Undertype-felt inneholder mellomrom
• Type- eller Undertype-felt inneholder understrek
• Type- eller Undertype-felt inneholder spesialtegn som ikke støttes: !@#$%^&*, og så videre
• Type- eller Undertype-felt inneholder bindestreker eller annen tegnsetting

1. Se gjennom Type- og SubType-verdiene.
2. Fjern eventuelle mellomrom – bruk i stedet UpperCamelCase (eller PascalCase). For eksempel CustomerOnboarding.
3. Fjern eventuelle understrek og erstatt dem med UpperCamelCase (eller PascalCase).
4. Fjern eventuelle spesialtegn.
5. Forsikre deg om at bare bokstaver (A-Z, a-z) og tall (0-9) brukes.
6. Lagre endringene.

Tips Bruk PascalCase (også kalt UpperCamelCase) til Type- og SubType-verdier. Dette forbedrer lesbarheten uten å kreve mellomrom eller understreking.

• Typeverdien er for lang.
• Undertype-verdien er for lang.
• Kombinasjonstype + Undertype + Språk overskrider tegngrensen.

1. Se gjennom feilmeldingen for å se maksimal tillatte lengde.
2. Forkort Type- eller SubType-verdien.
3. Lagre endringene.

Tips Bruk forkortelser der det er nødvendig. Fjern overflødige ord. Bruk en kortere navnekonvensjon.

Type- eller SubType-feltet bruker et reservert nøkkelord. Vanlige begrensede nøkkelord inkluderer følgende: inn, ut, exc, cb, kt, vt, v, x785f, x5f

Som foreslått i feilmeldingen erstatter du det begrensede nøkkelordet med en annen verdi. Se Reserverte ord på siden Omnistudio Naming Conventions for å få mer informasjon.

• Forsøker å legge til et nytt element i et aktivt Omniscript.
• Forsøker å endre et eksisterende element i et aktivt OmniScript.
• Forsøk på å slette et element fra et aktivt Omniscript.
• Omniskriptet er aktivt og i bruk.

Forsikre deg om at du har tillatelse til å redigere Omnikanal-poster og utføre disse oppgavene.

1. Kontroller om Omniscript er aktivt for øyeblikket.
2. Vurder å opprette en ny versjon i stedet for å endre den aktive.
3. For å opprette ny versjon: Klikk på Klone i Omniscript.
4. For å endre eksisterende: Deaktiver ved å fjerne merket for Aktiv og lagre endringene.
5. Nå kan du legge til, oppdatere eller slette elementer.
6. Test endringene dine.
7. Aktiver OmniScript når du er klar til bruk.

Advarsel Det anbefales at du oppretter en ny versjon for betydelige endringer i stedet for å deaktivere og endre den aktive versjonen. Det gir deg mulighet til å teste grundig før du distribuerer, og gir deg et enkelt alternativ for å rulle tilbake hvis det oppstår problemer.

• Et annet element i samme Omniscript har samme navn.
• Gi kollisjonen navn til elementer i forskjellige trinn.
• Elementet ble kopiert og navnet ble ikke endret.

1. Se gjennom alle elementene i Omniscript.
2. Identifiser elementene med de motstridende navnene.
3. Bestem hvilket element som skal beholde navnet.
4. Gi det andre elementet nytt navn med et unikt navn.
5. Vurder å bruke prefiks for å angi trinnet eller avsnittet, for eksempel step1_firstName, step2_firstName.
6. Oppdater eventuelle formler eller datatilordninger som refererer til elementet med det nye navnet, og lagre endringene.

• OmniScript er fra en administrert pakke, og du har ikke tillatelse til å endre eller slette den.
• Forsøk på å oppdatere et pakket Omniscript fra utenfor pakkenavneområdet.

1. Kontroller om Omniscript er fra en administrert pakke.
2. Hvis du trenger å tilpasse Omniscript, kloner du det i stedet.
3. Gi den klonede versjonen nytt navn med en egen Type/SubType/Language-kombinasjon.
4. Gjør de ønskede endringene i den klonede versjonen, lagre og aktiver OmniScript.
5. Oppdater eventuelle formler eller datatilordninger som refererer til elementet med det nye navnet, og lagre endringene.

Tips Kontakt pakkeleverandøren eller Salesforce-administratoren hvis du trenger å gjøre endringer i pakkede komponenter. De kan tilby konfigurasjonsalternativer eller utvidelsespunkter som ikke krever endring av det pakkede OmniScript direkte.

• Omniskriptet kan brukes på nytt.
• Omniskriptet inneholder Omniskript-elementer (innebygde Omniskript).
• Forsøke å gjøre et Omniscript gjenbrukbart etter å ha lagt til innebygde Omniscripts

1. Bestem om dette Omnikanet skal kunne brukes på nytt eller inneholde innebygde Omnikanter.
2. Alternativ 1: Hold den gjenbrukbar – fjern alle innebygde Omnikanal-elementer
3. Alternativ 2: Tillat innbygging: Fjern merket for Gjenbrukbar.
4. Hvis du fjerner innebygde Omnikanal-skript, kan du vurdere å bruke integrasjonsprosedyrer i stedet. Du kan refaktorere logikken i integrasjonsprosedyrer som kan kalles opp fra Omniscript.

Tips Bruk integrasjonsprosedyrer til delt forretningslogikk i stedet for å neste gjenbrukbare Omnikanal-skript. Dette oppretter en ryddigere arkitektur og unngår kompleksitet i Omnikanal-avhengigheter.

• Et annet FlexCard med samme navn er allerede aktivt.
• Forsøk på å aktivere en ny versjon uten å deaktivere den gamle.

1. Søk etter Flexkort med samme Navn-felt.
2. Se gjennom dem for å finne ut hvilke som skal forbli aktive.
3. Åpne FlexCard-kortet du vil deaktivere.
4. Fjern merket for Aktiv for å deaktivere FlexCard og lagre endringene.

Advarsel Deaktivering av et FlexCard påvirker umiddelbart alle brukere og prosesser som for øyeblikket bruker det. Vurder å opprette en ny versjon i stedet for å endre den aktive hvis du trenger å opprettholde tjenestekontinuitet.

1. Kontroller om FlexCard er fra en administrert pakke.
2. Hvis du må fjerne den fra bruk, deaktiverer du den i stedet for å slette den.
3. For å gjøre dette åpner du FlexCard og fjerner merket for Active.
4. Hvis du trenger en tilpasset versjon av FlexCard, kloner du det i stedet.

Tips Kontakt pakkeleverandøren eller Salesforce-administratoren hvis du trenger å gjøre endringer i pakkede komponenter. De kan tilby konfigurasjonsalternativer eller utvidelsespunkter som ikke krever at du endrer det pakkede FlexCard-kortet direkte.

• Navnet på det underordnede FlexCard-navnet skrives feil.
• Det underordnede FlexCard-kortet finnes, men er ikke aktivt.
• Det underordnede FlexCard-kortet ble slettet.
• Det underordnede FlexCard er i et annet navneområde.

1. Finn og velg Notat det underordnede FlexCard-navnet fra feilmeldingen i Appstarter.
2. Søk etter det underordnede FlexCard etter navn.
3. Hvis den blir funnet, men er inaktiv, aktiverer du den.
4. Hvis det ikke blir funnet, kontrollerer du riktig navn.
5. Hvis navnet er feil, oppdaterer du den overordnede FlexCard-konfigurasjonen.
6. Finn den underordnede FlexCard-referansen i det overordnede Flexcard-kortet.
7. Korriger navnet slik at det samsvarer med et eksisterende, aktivt Flexkort, og lagre det overordnede Flexkortet.

Merk Underordnede Flexkort må være aktivert før den overordnede Flexcard kan referere til dem. Opprett og test underordnede FlexCard først, og konfigurer deretter overordnede FlexCard til å bruke dem.

• Omniskriptets Type/SubType/Språk er feil.
• Omniskriptet finnes, men er ikke aktivt.
• Omniskriptet ble slettet.
• Omniskriptets Type/SubType/Språk ble endret.

1. Noter deg Type, Undertype og Språk fra feilmeldingen.
2. Søk etter Omniscript med samsvarende Type og SubType.
3. Kontroller språksamsvarene.
4. Hvis det blir funnet, men inaktivt, aktiverer du OmniScript.
5. Hvis den ikke blir funnet, kontrollerer du de riktige Type/SubType/Language-verdiene.
6. Gå tilbake til FlexCard-kortet og oppdater Omnikanal-referansen med de riktige verdiene.
7. Lagre endringene.

Tips Kontroller at Omniskriptet det refereres til, er aktivt før du aktiverer FlexCard. Hvis du distribuerer begge sammen, aktiverer du Omnikanal først.

• Navnet på datatilordneren skrives feil.
• Datatilordneren finnes, men er ikke aktiv.
• Datatilordneren ble slettet.
• Navnet på datatilordneren ble endret.

1. Noter deg Data Mapper-navnet fra feilmeldingen.
2. Søk etter datatilordneren etter navn.
3. Hvis den blir funnet, men er inaktiv, aktiverer du den.
4. Hvis det ikke blir funnet, kontrollerer du riktig navn.
5. Gå tilbake til FlexCard-kortet, oppdater Datatilordning-referansen med riktig navn, og lagre endringene.

Tips Aktiver datatilordninger før du aktiverer FlexCard-er som refererer til dem. Test Datatilordning uavhengig for å forsikre deg om at den returnerer den forventede datastrukturen.

• Navnet på integrasjonsprosedyren er feil.
• Datatilordneren finnes, men er ikke aktiv.
• Datatilordneren ble slettet.
• Du bruker feil navngivningsformat (må bruke Type_SubType-format).

1. Noter deg navnet på integrasjonsprosedyren fra feilmeldingen.
2. Søk etter integrasjonsprosedyren.
3. Kontroller at den finnes, og noter deg Type og SubType.
4. Hvis den blir funnet, men er inaktiv, aktiverer du den.
5. Gå tilbake til FlexCard-kortet.
6. Oppdater integrasjonsprosedyre-referansen ved å bruke formatet: Type_SubType, og lagre endringene.

Advarsel Det refereres til integrasjonsprosedyrer med OmniProcessKey, som følger Type_SubType-formatet. Forsikre deg om at du bruker riktig format når du konfigurerer FlexCard.

• Forsøker å gi nytt navn til et eksisterende FlexCard.
• Forsøk på å endre forfatteren av et eksisterende FlexCard.
• UniqueName brukes av andre komponenter og kan ikke endres.

1. Hvis du trenger et annet navn eller forfatter, kloner du FlexCard i stedet.
2. Finn FlexCard-kortet og klon det.
3. Skriv inn det nye navnet eller forfatteren.
4. Gjør eventuelle andre nødvendige endringer i den klonede versjonen, og aktiver det nye FlexCard-kortet.
5. Oppdater eventuelle komponenter som refererer til det gamle FlexCard-kortet, til å bruke det nye.
6. Deaktiver det gamle FlexCard-kortet når alle referanser er oppdatert.

• Navnet på integrasjonsprosedyren starter med FileBased.
• Integrasjonsprosedyrtypen starter med filbasert.
• Undertypen Integrasjonsprosedyre starter med FileBased.

1. Åpne integrasjonsprosedyren.
2. Kontroller feltene Navn, Type og Undertype.
3. Hvis noen starter med FileBased, velger du et annet prefiks.
4. Vurder å bruke prefiks som Fil, Dokument, Data eller navnet på organisasjonen.
5. Oppdater feltene som er utsatt for feil, og lagre endringene.

• JSON-inndataskjemaet har nestede objekter som er dypere enn 10 nivåer.
• JSON-utdataskjemaet har nestede objekter som er dypere enn 10 nivåer.

1. Se gjennom JSON-skjemastrukturen.
2. Identifiser dypt nestede deler.
3. Flat ut strukturen ved å redusere nestingsnivåer.
4. Vurder å flytte dypt nestede data for å skille integrasjonsprosedyrer.
5. Bruk matriser med flate objekter i stedet for dypt nestede hierarkier.
6. Omstrukturer for å beholde nesting under 10 nivåer.
7. Lagre det oppdaterte skjemaet.

Integrasjonsprosedyre-JSON-skjemaer har en maksimumsgrense på 500 nøkler på tvers av hele strukturen. Dette inkluderer alle nøkler på alle nestingsnivåer kombinert. Spesifikt:

• JSON-inndataskjemaet inneholder mer enn 500 nøkler totalt.
• JSON-utdataskjemaet inneholder mer enn 500 nøkler totalt.
• Skjemaet inkluderer et stort antall felt på tvers av flere nestede objekter.

1. Se gjennom JSON-skjemaet.
2. Teller totalt antall nøkler på alle nivåer.
3. Identifiser deler med overflødige nøkler.
4. Vurder å dele opp integrasjonsprosedyren i flere mindre prosedyrer.
5. Fjern ubrukte eller overflødige nøkler.
6. Bruk matriser til å representere gjentatte strukturer i stedet for nummererte nøkler.
7. Konsolider relaterte felt i underobjekter.
8. Lagre det optimaliserte skjemaet.

Tips Hvis du legitimt trenger mer enn 500 nøkler, kan du vurdere å dele prosessen i flere integrasjonsprosedyrer som kan kjede sammen.

• Det valgte sObject støttes ikke for Datatilordning-operasjoner.
• Det valgte sObject-objektet er et systemobjekt som ikke støtter spørringer.
• Det valgte sObject-objektet har ikke nødvendig API-støtte for å fungere med Datatilordninger.

1. Se gjennom sObject-objektet du valgte som inndatatype, og sjekk Salesforce Hjelp for støttede objekter.
2. Vurder å bruke et annet, relatert objekt som støttes.
3. Hvis du trenger data fra objektet som ikke støttes, bruker du i stedet en integrasjonsprosedyre med tilpasset Apex.
4. Oppdater Datatilordning-konfigurasjonen med et støttet objekt, og lagre endringene.

Merk De fleste standardobjekter og tilpassede objekter støttes. Hvis du støter på et objekt som ikke støttes, bør du vurdere om du kan omstrukturere dataflyten til å bruke et støttet alternativ.

• OmniAnalytics for Omnistudio er ikke aktivert.
• Organisasjonen din har ikke blitt konfigurert for OmniAnalytics.

1. Logg deg på som systemadministrator, og søk etter Omnistudio-innstillinger eller Omni-interaksjonskonfigurasjoner i Oppsett.
2. Finn innstillingen OmniAnalytics for Core, og aktiver den.
3. Lagre endringene og vent noen minutter til endringen trer i kraft.
4. Test om analysesporingen fungerer.

Merk Kontroller at beslutningsforklaring er riktig konfigurert.

• ID-en er ikke i gyldig Salesforce-ID-format, med 15 eller 18 tegn.
• ID-en tilhører ikke OmniTrackingComponentDef-objektet.
• Sporingskomponentdefinisjonen ble slettet.
• IDen er null eller feil utformet.

1. Kontroller komponentdefinisjons-IDen du bruker.
2. Gå til Oppsett > Omnistudio > Analytics-sporing, og finn den riktige sporingskomponentdefinisjonen.
3. Kopier den riktige IDen fra posten.
4. Oppdater koden eller konfigurasjonen med riktig ID.
5. Hvis definisjonen ble slettet, oppretter du en ny sporingskomponentdefinisjon. Se Opprette en sporingsgruppe og legge til komponenter for sporing.
6. Test sporingen på nytt.

Merk Kontroller at beslutningsforklaring er riktig konfigurert.