Vanliga fel och lösningar i Omnistudio

1. Logga in som en systemadministratör.
2. Sök fram och öppna Omnistudio i Inställningar.
3. Aktivera behörigheten Omnistudio för din organisation.

Om du inte ser alternativet, kontrollera att din organisation har Omnistudio-licenser. Kontakta din Salesforce Account Manager om licenser behövs.

Tips Efter att du har aktiverat Omnistudio-behörigheter kan det ta några minuter för ändringarna att propagera i hela din organisation. Om du fortsätter att se detta fel, testa att logga ut och logga in igen.

• Försöka ta bort ett aktivt Omniscript
• Försöka uppdatera strukturella fält i ett aktivt Omniscript
• Försök att ändra Typ, Undertyp eller Språk i ett aktivt Omniscript

1. Sök fram och öppna Omniscripts i Appstartaren.
2. Hitta det Omniscript du vill ändra eller ta bort.
3. Notera den aktuella versionen och varna användare om den kommande inaktiveringen.
4. Avmarkera kryssrutan Aktiv för att inaktivera Omniscript och spara dina ändringar.
5. Nu kan du göra önskade ändringar eller ta bort Omniscript.
6. Om du har gjort ändringar kan du återaktivera genom att markera kryssrutan Aktiv igen.

Varning Att inaktivera ett Omniscript påverkar omedelbart alla användare och processer som för närvarande använder det. Överväg att skapa en ny version istället för att ändra den aktiva versionen om du behöver upprätthålla servicekontinuitet.

• Ett annat Omniscript med identisk Typ, Undertyp och Språk är redan aktivt
• Skapa en ny version utan att inaktivera den tidigare versionen
• Flera versioner som skapats och försöker aktivera mer än en

Se till att du har behörighet att redigera Omniscript-poster och utföra dessa uppgifter.

1. Sök fram och öppna Omniscripts i Appstartaren.
2. Använd filter eller sök efter Omniscripts med matchande Typ och Undertyp.
3. Identifiera det aktiva Omniscript med samma Typ/Undertyp/Språk.
4. Granska båda versionerna för att avgöra vilka som ska fortsätta vara aktiva.
5. Öppna det Omniscript du vill inaktivera.
6. Avmarkera kryssrutan Aktiv och spara dina ändringar.
7. Gå tillbaka till den nya versionen och aktivera den.

Varning Innan du aktiverar en ny version, testa den noggrant i en förhandsvisning eller sandboxmiljö. När du är redo att distribuera, inaktivera den gamla versionen och aktivera omedelbart den nya för att minimera nedtid.

• Typfältet är tomt eller null
• Undertypfältet är tomt eller null
• Språkfältet är inte valt
• Försök att spara ett nytt Omniscript utan att fylla i alla obligatoriska fält

Se till att du har behörighet att redigera Omniscript-poster och utföra dessa uppgifter.

1. Sök fram och öppna Omniscripts i Appstartaren.
2. I Omniscript-egenskapspanelen, hitta fältet Typ.
3. Ange ett beskrivande typnamn, till exempel CustomerOnboarding eller ClaimSubmission.
4. Hitta fältet Undertyp och ange ett specifikt namn på Undertyp, till exempel Bostäder eller Kommersiell.
5. Välj ett språk från rullmenyn.
6. Se till att alla tre fält är ifyllda och spara dina ändringar.
7. Gå tillbaka till den nya versionen och aktivera den.

Tips Välj meningsfulla namn på Typ och Undertyp som tydligt indikerar syftet med ditt Omniscript. Dessa värden blir en del av hur du refererar Omniscript i dina program och kan inte ändras enkelt efter att de har skapats.

• Fälten Typ eller Undertyp innehåller blanksteg
• Fälten Typ eller Undertyp innehåller understreck
• Fälten Typ eller Undertyp innehåller specialtecken som inte stöds: !@#$%^&*, och så vidare
• Fälten Typ eller Undertyp innehåller bindestreck eller andra skiljetecken

1. Granska dina värden för Typ och Undertyp.
2. Ta bort blanksteg - använd UpperCamelCase (eller PascalCase) istället. Till exempel CustomerOnboarding.
3. Ta bort eventuella understreck och ersätt dem med UpperCamelCase (eller PascalCase).
4. Ta bort specialtecken.
5. Se till att endast bokstäver (A-Z, a-z) och siffror (0-9) används.
6. Spara dina ändringar.

Tips Använd PascalCase (även kallat UpperCamelCase) för värden för Typ och Undertyp. Detta förbättrar läsbarheten utan att kräva blanksteg eller understreck.

• Typvärdet är för långt.
• SubType-värdet är för långt.
• Kombinerad typ + Undertyp + Språk överskrider teckengränsen.

1. Granska felmeddelandet för att se den maximala tillåtna längden.
2. Förkorta ditt värde för Typ eller Undertyp.
3. Spara dina ändringar.

Tips Använd förkortningar där det behövs. Ta bort överflödiga ord. Använd en kortare namnkonvention.

Fältet Typ eller Undertyp använder ett reserverat nyckelord. Vanliga begränsade nyckelord inkluderar: in, ut, exc, cb, kt, vt, v, x785f, x5f

Som föreslås i felmeddelandet, ersätt det begränsade nyckelordet med ett annat värde. Se Reserverade ord på sidan Namnkonventioner för Omnistudio för mer information.

• Försöker lägga till ett nytt element i ett aktivt Omniscript.
• Försök att ändra ett befintligt element i ett aktivt Omniscript.
• Försöker ta bort ett element från ett aktivt Omniscript.
• Omniskriptet är aktivt och används.

Se till att du har behörighet att redigera Omniscript-poster och utföra dessa uppgifter.

1. Kontrollera om Omniscript är aktivt för närvarande.
2. Överväg att skapa en ny version istället för att ändra den aktiva.
3. Skapa ny version: Klicka på Klona i Omniscript.
4. Ändra befintliga: Inaktivera genom att avmarkera kryssrutan Aktiv och spara dina ändringar.
5. Nu kan du lägga till, uppdatera eller ta bort element.
6. Testa dina ändringar.
7. Aktivera Omniscript när det är redo att användas.

Varning Det rekommenderas att du skapar en ny version för betydande ändringar istället för att inaktivera och ändra den aktiva versionen. Detta låter dig testa noggrant innan distribuering och ger ett enkelt återställningsalternativ om problem uppstår.

• Ett annat element i samma Omniscript har samma namn.
• Namnkollision mellan element i olika steg.
• Elementet kopierades och namnet ändrades inte.

1. Granska alla element i ditt Omniscript.
2. Identifiera elementen med de motstridiga namnen.
3. Bestäm vilket element som ska behålla namnet.
4. Byt namn på det andra elementet med ett unikt namn.
5. Överväg att använda prefix för att indikera steget eller sektionen, till exempel step1_firstName, step2_firstName.
6. Uppdatera formler eller datamappningar som refererar det omdöpta elementet och spara dina ändringar.

• Omniscriptet kommer från ett hanterat paket och du har inte behörighet att ändra eller ta bort det.
• Försöker uppdatera ett paketerat Omniscript från utanför paketets namnutrymme.

1. Kontrollera om Omniscript är från ett hanterat paket.
2. Om du behöver anpassa Omniscript, klona det istället.
3. Byt namn på den klonade versionen med din egen Typ/Undertyp/Språk-kombination.
4. Gör önskade ändringar av den klonade versionen, spara och aktivera ditt Omniscript.
5. Uppdatera formler eller datamappningar som refererar det omdöpta elementet och spara dina ändringar.

Tips Kontakta paketleverantören eller din Salesforce-administratör om du behöver göra ändringar av paketerade komponenter. De kan tillhandahålla konfigurationsalternativ eller tilläggspunkter som inte kräver att det paketerade Omniscriptet ändras direkt.

• Omniskriptet kan återanvändas.
• Omniscript innehåller Omniscript-element (inbäddade Omniscript).
• Försöka göra ett Omniscript återanvändbart efter att inbäddade Omniscript har lagts till

1. Bestäm om detta Omniscript ska kunna återanvändas eller innehålla inbäddade Omniscripts.
2. Alternativ 1: Håll den återanvändbar - Ta bort alla inbäddade Omniscript-element
3. Alternativ 2: Tillåt inbäddning: Avmarkera kryssrutan Återanvändbar.
4. Om du tar bort inbäddade Omniscripts, överväg att använda integreringsprocesser istället. Du kan omfaktorisera logiken till integreringsprocesser som kan anropas från Omniscript.

Tips Använd integreringsprocesser för delad verksamhetslogik istället för att kapsla återanvändbara Omniscripts. Detta skapar en renare arkitektur och undviker komplexitet i Omniscript-beroenden.

• Ett annat Flexkort med samma namn är redan aktivt.
• Försöker aktivera en ny version utan att inaktivera den gamla.

1. Sök efter Flexkort med samma namnfält.
2. Granska dem för att avgöra vilka som ska förbli aktiva.
3. Öppna det Flexkort du vill inaktivera.
4. Avmarkera kryssrutan Aktiv för att inaktivera Flexkort och spara dina ändringar.

Varning Att inaktivera ett Flexkort påverkar omedelbart alla användare och processer som för närvarande använder det. Överväg att skapa en ny version istället för att ändra den aktiva versionen om du behöver upprätthålla servicekontinuitet.

1. Kontrollera om Flexcard är från ett hanterat paket.
2. Om du behöver ta bort den från användning, inaktivera den istället för att ta bort den.
3. För att göra detta, öppna Flexkort och avmarkera kryssrutan Aktiv.
4. Om du behöver en anpassad version av Flexcard, klona det istället.

Tips Kontakta paketleverantören eller din Salesforce-administratör om du behöver göra ändringar av paketerade komponenter. De kan tillhandahålla konfigurationsalternativ eller tilläggspunkter som inte kräver att det paketerade Flexkortet ändras direkt.

• Namnet på det underordnade Flexcard-namnet är felstavat.
• Det underordnade Flexcard finns men är inte aktivt.
• Det underordnade Flexcard har tagits bort.
• Det underordnade Flexcard är i ett annat namnutrymme.

1. Sök fram och öppna Notera det underordnade Flexcard-namnet från felmeddelandet i Appstartaren.
2. Sök efter det underordnade Flexcard efter namn.
3. Om den hittas men är inaktiv, aktivera den.
4. Om det inte hittas, bekräfta rätt namn.
5. Om namnet är felaktigt, uppdatera den överordnade Flexcard-konfigurationen.
6. I det överordnade Flexkort, hitta den underordnade Flexkort-referensen.
7. Korrigera namnet så att det matchar ett befintligt, aktivt Flexkort och spara det överordnade Flexkortet.

Anteckning Underordnade Flexkort måste aktiveras innan det överordnade Flexkortet kan referera till dem. Skapa och testa underordnade Flexkort först och konfigurera sedan överordnade Flexkort att använda dem.

• Omniskriptets Typ/Undertyp/Språk är felaktigt.
• Omniskriptet finns men är inte aktivt.
• Omniskriptet har tagits bort.
• Omniskriptets Typ/Undertyp/Språk har ändrats.

1. Notera Typ, Undertyp och Språk från felmeddelandet.
2. Sök efter Omniscript med matchande Typ och Undertyp.
3. Kontrollera att Språk matchar.
4. Om det hittas men är inaktivt, aktivera Omniscript.
5. Om det inte hittas, bekräfta rätt värden för Typ/Undertyp/Språk.
6. Gå tillbaka till ditt Flexkort och uppdatera Omniscript-referensen med rätt värden.
7. Spara dina ändringar.

Tips Se till att det refererade Omniscriptet är aktivt innan du aktiverar Flexcard. Om du distribuerar båda tillsammans, aktivera Omniscript först.

• Namnet på Datamappningen är felstavat.
• Datamappningen finns men är inte aktiv.
• Datamappningen har tagits bort.
• Datamappningens namn har ändrats.

1. Notera namnet på Datamappningen från felmeddelandet.
2. Sök efter Datamappningen efter namn.
3. Om den hittas men är inaktiv, aktivera den.
4. Om det inte hittas, bekräfta rätt namn.
5. Gå tillbaka till ditt Flexkort, uppdatera referensen till Datamappning med rätt namn och spara dina ändringar.

Tips Aktivera datamappningar innan du aktiverar Flexkort som refererar dem. Testa Datamappningen oberoende för att säkerställa att den returnerar den förväntade datastrukturen.

• Namnet på integreringsprocessen är felaktigt.
• Datamappningen finns men är inte aktiv.
• Datamappningen har tagits bort.
• Du använder fel namnformat (bör använda Type_SubType-format).

1. Notera namnet på integreringsprocessen från felmeddelandet.
2. Sök efter integreringsprocessen.
3. Kontrollera att den finns och notera dess Typ och Undertyp.
4. Om den hittas men är inaktiv, aktivera den.
5. Gå tillbaka till ditt Flexkort.
6. Uppdatera referensen för integreringsprocessen genom att använda formatet: Type_SubType och spara dina ändringar.

Varning Integreringsprocedurer refereras med deras OmniProcessKey, som följer formatet Type_SubType. Se till att du använder rätt format när du konfigurerar Flexcard.

• Försöker byta namn på ett befintligt Flexkort.
• Försöker ändra författare för ett befintligt Flexkort.
• UniqueName används av andra komponenter och kan inte ändras.

1. Om du behöver ett annat namn eller författare, klona Flexcard istället.
2. Hitta ditt Flexkort och klona det.
3. Ange det nya namnet eller författaren.
4. Gör andra nödvändiga ändringar av den klonade versionen och aktivera ditt nya Flexkort.
5. Uppdatera komponenter som refererar till det gamla Flexkortet så att det använder det nya.
6. Inaktivera det gamla Flexkortet när alla referenser har uppdaterats.

• Namn på integreringsprocess börjar med FileBased.
• Integreringsprocedurtypen börjar med filbaserad.
• Undertypen Integreringsprocedur börjar med FileBased.

1. Öppna din integreringsprocess.
2. Kontrollera fälten Namn, Typ och Undertyp.
3. Om något börjar med Filbaserad, välj ett annat prefix.
4. Överväg att använda prefix som Fil, Dokument, Data eller ditt organisationsnamn.
5. Uppdatera de felbenägna fälten och spara dina ändringar.

• JSON-inmatningsschemat har kapslade objekt djupare än 10 nivåer.
• JSON-utdataschemat har kapslade objekt djupare än 10 nivåer.

1. Granska din JSON-schemastruktur.
2. Identifiera djupt kapslade sektioner.
3. Platta ut strukturen genom att minska kapslingsnivåerna.
4. Överväg att flytta djupt kapslade data till separata integreringsprocesser.
5. Använd matriser med plattare objekt istället för djupt kapslade hierarkier.
6. Omstrukturera för att hålla kapsling under 10 nivåer.
7. Spara det uppdaterade schemat.

JSON-scheman för integreringsprocesser har en maximal gräns på 500 nycklar över hela strukturen. Detta inkluderar alla nycklar på alla kapslingsnivåer tillsammans. Specifikt:

• JSON-inmatningsschemat innehåller mer än 500 totala nycklar.
• JSON-utdataschemat innehåller mer än 500 totala nycklar.
• Schemat innehåller ett stort antal fält över flera kapslade objekt.

1. Granska ditt JSON-schema.
2. Räkna det totala antalet nycklar på alla nivåer.
3. Identifiera sektioner med överflödiga nycklar.
4. Överväg att dela upp integreringsprocessen i flera mindre procedurer.
5. Ta bort nycklar som inte används eller är överflödiga.
6. Använd matriser för att representera upprepade strukturer istället för numrerade nycklar.
7. Slå samman relaterade fält i underobjekt.
8. Spara det optimerade schemat.

Tips Om du behöver mer än 500 nycklar, överväg att dela upp processen i flera integreringsprocesser som kan kedjas ihop.

• Det valda sObject stöds inte för Datamappningsoperationer.
• Det valda sObject är ett systemobjekt som inte har stöd för sökfrågor.
• Det valda sObject har inte det API-stöd som behövs för att arbeta med Datamappningar.

1. Granska det sObject du valde som indatatyp och kontrollera Salesforce-hjälpen för objekt som stöds.
2. Överväg att använda ett annat, relaterat objekt som stöds.
3. Om du behöver data från objektet som inte stöds, använd en integreringsprocess med egen Apex istället.
4. Uppdatera din Data Mapper-konfiguration med ett objekt som stöds och spara dina ändringar.

Anteckning De flesta standardobjekt och egna objekt stöds. Om du stöter på ett objekt som inte stöds, överväg om du kan omstrukturera ditt dataflöde så att det använder ett alternativ som stöds.

• OmniAnalytics för Omnistudio är inte aktiverat.
• Din organisation har inte konfigurerats för OmniAnalytics.

1. Logga in som systemadministratör och sök efter Omnistudio-inställningar eller Omni Interaction-konfigurationer i Inställningar.
2. Hitta inställningen OmniAnalytics for Core och aktivera den.
3. Spara dina ändringar och vänta några minuter på att ändringen ska börja gälla.
4. Testa om din Analytics-spårning fungerar.

Anteckning Kontrollera att beslutsförklararen är korrekt konfigurerad.

• ID:t är inte i giltigt Salesforce ID-format, med 15 eller 18 tecken.
• ID:t hör inte till objektet OmniTrackingComponentDef.
• Definitionen av spårningskomponenten har tagits bort.
• ID:t är null eller har fel format.

1. Verifiera det komponentdefinitions-ID du använder.
2. Gå till Inställningar > Omnistudio > Analytics-spårning och hitta rätt spårningskomponentdefinition.
3. Kopiera rätt ID från posten.
4. Uppdatera din kod eller konfiguration med rätt ID.
5. Om definitionen togs bort, skapa en ny spårningskomponentdefinition. Se Skapa en spårningsgrupp och Lägg till komponenter att spåra.
6. Testa spårningen igen.

Anteckning Kontrollera att beslutsförklararen är korrekt konfigurerad.