Veel voorkomende fouten en oplossingen in Omnistudio

1. Log in als systeembeheerder.
2. Zoek en selecteer vanuit Set-up Omnistudio.
3. Schakel de machtiging Omnistudio in voor uw organisatie.

Als u de optie niet ziet, controleert u of uw organisatie Omnistudio-licenties heeft. Neem contact op met uw Salesforce Account Executive als er licenties nodig zijn.

Tip Na het inschakelen van Omnistudio-machtigingen kan het enkele minuten duren voordat de wijzigingen worden doorgevoerd in uw organisatie. Als u deze foutmelding blijft zien, probeert u uit te loggen en weer in te loggen.

• Een actief Omniscript proberen te verwijderen
• Structurele velden bijwerken voor een actief Omniscript
• Proberen Type, SubType of Taal te wijzigen voor een actief Omniscript

1. Zoek en selecteer vanuit de Appstarter Omniscripts.
2. Zoek het Omniscript dat u wilt wijzigen of verwijderen.
3. Noteer de huidige versie en waarschuw gebruikers voor de aanstaande deactivering.
4. Schakel het selectievakje Actief uit om Omniscript te deactiveren en uw wijzigingen op te slaan.
5. Nu kunt u de gewenste wijzigingen aanbrengen of het Omniscript verwijderen.
6. Als u wijzigingen hebt aangebracht, kunt u deze opnieuw activeren door het selectievakje Actief opnieuw in te schakelen.

Waarschuwing Het deactiveren van een Omniscript heeft onmiddellijk gevolgen voor alle gebruikers en processen die het momenteel gebruiken. Overweeg een nieuwe versie te maken in plaats van de actieve te wijzigen als u de servicecontinuïteit wilt behouden.

• Een ander Omniscript met identiek Type, SubType en Taal is al actief
• Een nieuwe versie maken zonder de vorige te deactiveren
• Meerdere versies gemaakt en geprobeerd om er meer dan één te activeren

Zorg ervoor dat u machtigingen hebt om Omniscript-records te bewerken en deze taken uit te voeren.

1. Zoek en selecteer vanuit de Appstarter Omniscripts.
2. Gebruik filters of zoek naar Omniscripts met overeenkomende Type en SubType.
3. Identificeer het momenteel actieve Omniscript met hetzelfde Type/SubType/Language.
4. Controleer beide versies om te bepalen welke actief moeten blijven.
5. Open het Omniscript dat u wilt deactiveren.
6. Schakel het selectievakje Actief uit en sla uw wijzigingen op.
7. Ga terug naar de nieuwe versie en activeer deze.

Waarschuwing Test een nieuwe versie grondig in een voorbeeld- of sandboxomgeving voordat u deze activeert. Wanneer u klaar bent om te implementeren, deactiveert u de oude versie en activeert u onmiddellijk de nieuwe om downtime te minimaliseren.

• Typeveld is leeg of null
• Veld Subtype is leeg of null
• Taalveld is niet geselecteerd
• Poging om een nieuw Omniscript op te slaan zonder alle verplichte velden in te vullen

Zorg ervoor dat u machtigingen hebt om Omniscript-records te bewerken en deze taken uit te voeren.

1. Zoek en selecteer vanuit de Appstarter Omniscripts.
2. Zoek in het deelvenster Omniscript-eigenschappen het veld Type.
3. Geef een beschrijvende Type-naam op, zoals CustomerOnboarding of ClaimSubmission.
4. Zoek het veld SubType en geef een specifieke naam op voor SubType, zoals Residentieel of Commercieel.
5. Selecteer een taal in de vervolgkeuzelijst.
6. Zorg ervoor dat alle drie de velden zijn ingevuld en sla uw wijzigingen op.
7. Ga terug naar de nieuwe versie en activeer deze.

Tip Kies betekenisvolle Type- en SubType-namen die duidelijk het doel van uw Omniscript aangeven. Deze waarden worden onderdeel van de manier waarop u naar Omniscript verwijst in uw toepassingen en kunnen niet gemakkelijk worden gewijzigd nadat ze zijn gemaakt.

• Velden Type of Subtype bevatten spaties
• Velden Type of Subtype bevatten onderstrepingstekens
• Velden Type of Subtype bevatten niet-ondersteunde speciale lettertekens: !@#$%^&*, enzovoort
• Type- of SubType-velden bevatten afbreekstreepjes of andere interpunctie

1. Controleer uw waarden voor Type en SubType.
2. Verwijder eventuele spaties - gebruik in plaats daarvan UpperCamelCase (of PascalCase). Bijvoorbeeld CustomerOnboarding.
3. Verwijder eventuele onderstrepingstekens en vervang deze door UpperCamelCase (of PascalCase).
4. Verwijder eventuele speciale lettertekens.
5. Zorg ervoor dat alleen letters (A-Z, a-z) en cijfers (0-9) worden gebruikt.
6. Sla uw wijzigingen op.

Tip Gebruik PascalCase (ook UpperCamelCase genoemd) voor waarden voor Type en SubType. Dit verbetert de leesbaarheid zonder spaties of onderstrepingstekens.

• Typewaarde is te lang.
• De waarde voor SubType is te lang.
• Gecombineerd type + Subtype + Taal overschrijdt de lettertekenlimiet.

1. Controleer het foutbericht om de maximaal toegestane lengte te zien.
2. Verkort uw waarde voor Type of SubType.
3. Sla uw wijzigingen op.

Tip Gebruik afkortingen waar nodig. Verwijder overbodige woorden. Gebruik een kortere naamgevingsconventie.

Het veld Type of SubType gebruikt een gereserveerd trefwoord. Veel voorkomende beperkte trefwoorden zijn: in, out, exc, cb, kt, vt, v, x785f, x5f

Zoals voorgesteld in het foutbericht, vervangt u het beperkte trefwoord door een andere waarde. Zie Gereserveerde woorden op de pagina Omnistudio-naamgevingsconventies voor meer informatie.

• Poging om een nieuw element toe te voegen aan een actief Omniscript.
• Poging tot wijziging van een bestaand element in een actief Omniscript.
• Poging tot verwijdering van een element uit een actief Omniscript.
• Het Omniscript is actief en in gebruik.

Zorg ervoor dat u machtigingen hebt om Omniscript-records te bewerken en deze taken uit te voeren.

1. Controleer of Omniscript momenteel actief is.
2. Overweeg een nieuwe versie te maken in plaats van de actieve te wijzigen.
3. Nieuwe versie maken: Klik op Klonen in het Omniscript.
4. Bestaande wijzigen: Deactiveer door het selectievakje Actief uit te schakelen en uw wijzigingen op te slaan.
5. U kunt nu elementen toevoegen, bijwerken of verwijderen.
6. Test uw wijzigingen.
7. Activeer het Omniscript wanneer u klaar bent voor gebruik.

Waarschuwing Het wordt aanbevolen een nieuwe versie te maken voor belangrijke wijzigingen in plaats van de actieve versie te deactiveren en te wijzigen. Hierdoor kunt u grondig testen voordat u implementeert en kunt u gemakkelijk terugdraaien als er problemen optreden.

• Een ander element in hetzelfde Omniscript heeft dezelfde naam.
• Noem botsing tussen elementen in verschillende stappen.
• Het element is gekopieerd en de naam is niet gewijzigd.

1. Controleer alle elementen in uw Omniscript.
2. Identificeer de elementen met de conflicterende namen.
3. Bepaal welk element de naam moet behouden.
4. Wijzig de naam van het andere element met een unieke naam.
5. Overweeg prefixen te gebruiken om de stap of sectie aan te geven, bijvoorbeeld step1_firstName, step2_firstName.
6. Werk alle formules of gegevenstoewijzingen bij die verwijzen naar het element met de gewijzigde naam en sla uw wijzigingen op.

• Het Omniscript komt uit een beheerd pakket en u hebt geen machtigingen om het te wijzigen of te verwijderen.
• Poging om een Omniscript in een pakket bij te werken van buiten de pakketnaamruimte.

1. Controleer of het Omniscript afkomstig is uit een beheerd pakket.
2. Als u het Omniscript moet aanpassen, kloont u het in plaats daarvan.
3. Wijzig de naam van de gekloonde versie met uw eigen combinatie Type/SubType/Language.
4. Breng de gewenste wijzigingen aan de gekloonde versie aan, sla uw Omniscript op en activeer het.
5. Werk alle formules of gegevenstoewijzingen bij die verwijzen naar het element met de gewijzigde naam en sla uw wijzigingen op.

Tip Neem contact op met de pakketleverancier of uw Salesforce-beheerder als u wijzigingen moet aanbrengen aan in een pakket opgenomen componenten. Ze kunnen configuratieopties of uitbreidingspunten bieden waarvoor het Omniscript in het pakket niet rechtstreeks hoeft te worden gewijzigd.

• Het Omniscript is herbruikbaar.
• Het Omniscript bevat Omniscript-elementen (ingebedde Omniscripts).
• Pogingen om een Omniscript herbruikbaar te maken na het toevoegen van ingebedde Omniscripts

1. Bepaal of dit Omniscript herbruikbaar moet zijn of ingebedde Omniscripts moet bevatten.
2. Optie 1: Herbruikbaar houden - Verwijder alle ingebedde Omniscript-elementen
3. Optie 2: Inbedden toestaan: Schakel het selectievakje Herbruikbaar uit.
4. Als u ingebedde Omniscripts verwijdert, kunt u overwegen om in plaats daarvan Integratieprocedures te gebruiken. U kunt de logica opnieuw inpassen in integratieprocedures die kunnen worden aangeroepen vanuit het Omniscript.

Tip Gebruik integratieprocedures voor gedeelde bedrijfslogica in plaats van herbruikbare Omniscripts te nesten. Dit zorgt voor een schonere architectuur en vermijdt complexiteit in Omniscript-afhankelijkheden.

• Een andere Flexcard met dezelfde naam is al actief.
• Poging om een nieuwe versie te activeren zonder de oude te deactiveren.

1. Zoek Flexcards met hetzelfde veld Naam.
2. Controleer deze om te bepalen welke actief moeten blijven.
3. Open de Flexcard die u wilt deactiveren.
4. Schakel het selectievakje Actief uit om de Flexcard te deactiveren en uw wijzigingen op te slaan.

Waarschuwing Het deactiveren van een Flexcard heeft onmiddellijk gevolgen voor alle gebruikers en processen die deze momenteel gebruiken. Overweeg een nieuwe versie te maken in plaats van de actieve te wijzigen als u de servicecontinuïteit wilt behouden.

1. Controleer of de Flexcard afkomstig is uit een beheerd pakket.
2. Als u deze uit gebruik moet nemen, deactiveert u deze in plaats van te verwijderen.
3. Open hiervoor de Flexcard en schakel het selectievakje Actief uit.
4. Als u een aangepaste versie van de Flexcard nodig hebt, kloont u deze in plaats daarvan.

Tip Neem contact op met de pakketleverancier of uw Salesforce-beheerder als u wijzigingen moet aanbrengen aan in een pakket opgenomen componenten. Ze kunnen configuratieopties of uitbreidingspunten bieden waarvoor de Flexcard in het pakket niet rechtstreeks hoeft te worden aangepast.

• De naam van de onderliggende Flexcard-naam is verkeerd gespeld.
• De onderliggende Flexcard bestaat wel, maar is niet actief.
• De onderliggende Flexcard is verwijderd.
• De onderliggende Flexcard bevindt zich in een andere naamruimte.

1. Zoek en selecteer vanuit de Appstarter Noteer de onderliggende Flexcard-naam uit het foutbericht.
2. Zoek de onderliggende Flexcard op naam.
3. Indien gevonden maar niet actief, activeert u deze.
4. Indien niet gevonden, verifieert u de correcte naam.
5. Als de naam onjuist is, werkt u de bovenliggende Flexcard-configuratie bij.
6. Zoek in de bovenliggende Flexcard de onderliggende Flexcard-verwijzing.
7. Corrigeer de naam zodat deze overeenkomt met een bestaande, actieve Flexcard en sla de bovenliggende Flexcard op.

Opmerking Onderliggende Flexcards moeten zijn geactiveerd voordat de bovenliggende Flexcard ernaar kan verwijzen. Maak en test eerst onderliggende Flexcards en configureer vervolgens bovenliggende Flexcards om ze te gebruiken.

• Het type/subtype/taal van het Omniscript is incorrect.
• Het Omniscript bestaat wel, maar is niet actief.
• Het Omniscript is verwijderd.
• Het type/subtype/taal van Omniscript is gewijzigd.

1. Noteer het Type, SubType en Taal uit het foutbericht.
2. Zoek het Omniscript met overeenkomende Type en SubType.
3. Controleer de overeenkomsten met Taal.
4. Indien gevonden maar niet actief, activeert u het Omniscript.
5. Indien niet gevonden, controleert u de juiste waarden voor Type/SubType/Language.
6. Ga terug naar uw Flexcard en werk de Omniscript-verwijzing bij met de juiste waarden.
7. Sla uw wijzigingen op.

Tip Zorg ervoor dat het Omniscript waarnaar wordt verwezen, actief is voordat u de Flexcard activeert. Als u beide tegelijk implementeert, activeert u eerst Omniscript.

• De naam van de Data Mapper is verkeerd gespeld.
• De Data Mapper bestaat wel, maar is niet actief.
• De Data Mapper is verwijderd.
• De naam van de Data Mapper is gewijzigd.

1. Noteer de naam van Data Mapper uit het foutbericht.
2. Zoek naar de Data Mapper op naam.
3. Indien gevonden maar niet actief, activeert u deze.
4. Indien niet gevonden, verifieert u de correcte naam.
5. Ga terug naar uw Flexcard, werk de verwijzing naar Data Mapper bij met de juiste naam en sla uw wijzigingen op.

Tip Activeer Data Mappers voordat u Flexcards activeert die ernaar verwijzen. Test de Data Mapper onafhankelijk om er zeker van te zijn dat deze de verwachte gegevensstructuur retourneert.

• De naam van de integratieprocedure is onjuist.
• De Data Mapper bestaat wel, maar is niet actief.
• De Data Mapper is verwijderd.
• U gebruikt de verkeerde naamgevingsnotatie (moet de notatie Type_SubType gebruiken).

1. Noteer de naam van de integratieprocedure in het foutbericht.
2. Zoek naar de integratieprocedure.
3. Controleer of deze bestaat en noteer het Type en SubType ervan.
4. Indien gevonden maar niet actief, activeert u deze.
5. Ga terug naar uw Flexcard.
6. Werk de verwijzing naar de integratieprocedure bij met behulp van de indeling: Type_SubType en sla uw wijzigingen op.

Waarschuwing Naar integratieprocedures wordt verwezen met behulp van hun OmniProcessKey, die de notatie Type_SubType volgt. Zorg ervoor dat u de juiste indeling gebruikt bij het configureren van de Flexcard.

• Poging om de naam van een bestaande Flexcard te wijzigen.
• Poging om de auteur van een bestaande Flexcard te wijzigen.
• De UniqueName wordt gebruikt door andere componenten en kan niet worden gewijzigd.

1. Als u een andere naam of auteur nodig hebt, kloont u in plaats daarvan de Flexcard.
2. Zoek uw Flexcard en kloon deze.
3. Geef de nieuwe naam of auteur op.
4. Breng eventuele andere noodzakelijke wijzigingen aan de gekloonde versie aan en activeer uw nieuwe Flexcard.
5. Werk alle componenten die verwijzen naar de oude Flexcard bij om de nieuwe te gebruiken.
6. Deactiveer de oude Flexcard zodra alle verwijzingen zijn bijgewerkt.

• De naam van de integratieprocedure begint met FileBased.
• Het Type integratieprocedure begint met filebased.
• Het subtype Integratieprocedure begint met FileBased.

1. Open uw integratieprocedure.
2. Controleer de velden Naam, Type en Subtype.
3. Als u begint met FileBased, kiest u een ander prefix.
4. Overweeg het gebruik van prefixen zoals Bestand, Document, Gegevens of de naam van uw organisatie.
5. Werk de foutgevoelige velden bij en sla uw wijzigingen op.

• Het JSON-invoerschema heeft geneste objecten die dieper zijn dan 10 niveaus.
• Het JSON-uitvoerschema heeft geneste objecten die dieper zijn dan 10 niveaus.

1. Controleer uw JSON-schemastructuur.
2. Identificeer diep geneste secties.
3. Maak de structuur platter door het nestniveau te verlagen.
4. Overweeg diep geneste gegevens te verplaatsen naar afzonderlijke integratieprocedures.
5. Gebruik arrays met plattere objecten in plaats van diep geneste hiërarchieën.
6. Herstructureer om nesting onder 10 niveaus te houden.
7. Sla het bijgewerkte schema op.

JSON-schema's voor integratieprocedures hebben een maximale limiet van 500 sleutels voor de gehele structuur. Dit omvat alle sleutels op alle nestingniveaus gecombineerd. Met name:

• Het JSON-invoerschema bevat in totaal meer dan 500 sleutels.
• Het JSON-uitvoerschema bevat in totaal meer dan 500 sleutels.
• Het schema omvat grote aantallen velden voor meerdere geneste objecten.

1. Controleer uw JSON-schema.
2. Tel het totale aantal sleutels voor alle niveaus.
3. Identificeer secties met buitensporige sleutels.
4. Overweeg de integratieprocedure op te splitsen in meerdere kleinere procedures.
5. Verwijder ongebruikte of redundante sleutels.
6. Gebruik arrays om herhaalde structuren weer te geven in plaats van genummerde sleutels.
7. Consolideer gerelateerde velden in subobjecten.
8. Sla het geoptimaliseerde schema op.

Tip Als u legitiem meer dan 500 sleutels nodig hebt, kunt u overwegen om het proces op te splitsen in meerdere integratieprocedures die aan elkaar kunnen worden gekoppeld.

• Het geselecteerde sObject wordt niet ondersteund voor Data Mapper-bewerkingen.
• Het geselecteerde sObject is een systeemobject dat geen query's ondersteunt.
• Het geselecteerde sObject heeft niet de benodigde API-ondersteuning om met Data Mappers te werken.

1. Controleer het sObject dat u als invoertype hebt geselecteerd en controleer Salesforce Help op ondersteunde objecten.
2. Overweeg het gebruik van een ander, gerelateerd object dat wordt ondersteund.
3. Als u gegevens uit het niet-ondersteunde object nodig hebt, gebruikt u in plaats daarvan een integratieprocedure met aangepaste Apex.
4. Werk uw Data Mapper-configuratie bij met een ondersteund object en sla uw wijzigingen op.

Opmerking De meeste standaard- en aangepaste objecten worden ondersteund. Als u een niet-ondersteund object tegenkomt, overweeg dan of u uw gegevensstroom kunt herstructureren om een ondersteund alternatief te gebruiken.

• OmniAnalytics voor Omnistudio is niet ingeschakeld.
• Uw organisatie is niet geconfigureerd voor OmniAnalytics.

1. Log in als systeembeheerder en zoek vanuit Set-up naar Omnistudio-instellingen of Omni Interaction-configuraties.
2. Zoek de instelling OmniAnalytics voor Core en schakel deze in.
3. Sla uw wijzigingen op en wacht enkele minuten totdat de wijziging van kracht wordt.
4. Test of uw analyses bijhouden werkt.

Opmerking Controleer of de Beslissingsuitleg correct is geconfigureerd.

• De ID heeft geen geldige Salesforce-ID-indeling, met 15 of 18 lettertekens.
• De ID behoort niet tot het object OmniTrackingComponentDef.
• De definitie van de volgcomponent is verwijderd.
• De ID is null of heeft een verkeerde notatie.

1. Controleer de ID van de componentdefinitie die u gebruikt.
2. Navigeer naar Set-up > Omnistudio > Analytics Tracking en zoek de juiste definitie van de trackingcomponent.
3. Kopieer de juiste ID uit de record.
4. Werk uw code of configuratie bij met de juiste ID.
5. Als de definitie is verwijderd, maakt u een nieuwe definitie van de volgcomponent. Zie Een volggroep maken en Componenten toevoegen aan bijhouden.
6. Test het bijhouden opnieuw.

Opmerking Controleer of de Beslissingsuitleg correct is geconfigureerd.