Rekommenderade metoder för Omniscript

Verksamhetsprocess och logik

Rekommenderade metoder för verksamhetsprocesser och logik inkluderar:

• Använd unika namn för Omniscript-element och svarsnoder för Omnistudio Data Mapper.
• Identifiera återanvändbara element genom att bygga en kontur av hela Omniscript.
• Dokumentera syftet med ett element i elementets egenskap Interna anteckningar.
• Undvik ändringar av elementnamn efter distribuering till produktion. Om det är oundvikligt, tillämpa namnändringarna där elementet refereras.
• Tilldela inte ett ContextId inom Omniscript. Ett Omniscripts ContextId är en reserverad nyckel som tilldelar ett Post-ID från URL:en.
• När processer kan upprepas över flera Omniscript, skapa ett återanvändbart Omniscript och lägg till det i lämpliga överordnade Omniscript. Se Bädda in ett Omniscript i ett annat Omniscript.
• Försök tillämpa obligatoriska data och valideringar i det aktuella steget istället för i slutet av ett formulär. Detta hjälper användare att korrigera sina inmatningar omedelbart istället för att titta på valideringar eller fel i slutet och följa sina steg för att åtgärda dem.
• Om möjligt, dela upp komplexa uppgifter i ett program genom att använda flera Omniscript. Använd Omniscripts med Flexcards om det behövs. Att skapa ett stort Omniscript med flera steg kan hindra prestanda och användarupplevelse.

Användargränssnitt

Omniskript använder Lightning för att definiera formateringen för både enskilda element och själva Omniskriptet.

Rekommenderade metoder inkluderar:

• Tillämpa global styling. Mer information finns i Egna stilar för Omniscripts.

Tillgänglighet

Rekommenderade metoder för tillgänglighet inkluderar:

• För närvarande är redigeringsblock som konfigurerats i tabelläge i Omniscripts inte kompatibla med skärmläsare. Om du använder en skärmläsare rekommenderar vi att du använder Flexcards istället för Omniscripts. I Flexkort kan du använda datatabeller eller Lightning datatabeller som är kompatibla med skärmläsare. Se Visa data i en tabell på ett flexkort och Lightning-webbkomponent – Datatabell.

Säkerhet

Rekommenderade metoder för datasäkerhet inkluderar:

• För att säkerställa datasäkerhet och upprätthålla efterlevnad av Salesforces krypteringsåtkomstkontroller, kontrollera alltid att en användare har behörigheten Visa krypterade data innan du visar eller bearbetar avkrypterade värden för krypterade fält.

Designprinciper för användarupplevelser

UX-designprinciper inkluderar:

• Minska antalet fält som användaren måste ange information i genom att fylla i fälten i förväg med sammanhangsdata. Mer information finns i Ange värden i ett Omniscript.
• För att undvika kognitiv belastning, tänk noga igenom hur du delar upp processer. För många korta steg som endast innehåller ett minimalt antal element kan överväldiga användaren lika lätt som stora steg med flera element.
• Guida användaren genom att skapa sammanhangsberoende hjälptext och logiskt ordna inmatningsfält.
• Se till att de rekursiva kapslade blocken i ett Omniscript inte överstiger 10.

Prestandafaktorer

Det finns en uppsättning rekommenderade metoder för prestanda på både klientsidan och serversidan.

Rekommenderade metoder på klientsidan inkluderar:

• Minska villkorliga vyer, kopplingsfält, formler där så är möjligt.
• Snabba på tillämpningen av svar genom att trimma Response JSON. Mer information finns i Hantera JSON med egenskaperna för Skicka/Svara-transformationer.
• Ta bort blanksteg från elementnamn för att förbättra Omniscriptets inläsningstid.
• Minska antalet element i skriptet. Försök begränsa ett enskilt Omniscript till högst 750 element.
• Kör logik på servern där det är möjligt, till exempel villkorlig logik i integreringsprocesser och formler i Datamappningar.
• PDF-filer större än 250 KB skapas långsamt. PDF-filer större än 1 MB kan ta flera minuter att skapa och ibland ta timeout.

Rekommenderade metoder på serversidan inkluderar:

• Minska storleken på en begärans belastning genom att trimma JSON-begäran. Mer information finns i Hantera JSON med egenskaperna för Skicka/Svara-transformationer.
• Skapa inte Omniscripts med Lightning större än 4 MB. I förhandsvisningen visar Omniscripts som är större än 4 MB ett fel för att indikera att Omniscript antingen är inaktivt eller inte distribuerat. Ladda ner Omniscript LWC för att kontrollera dess storlek.
• Minska serverresor genom att använda integreringsprocesser när det finns flera åtgärder mellan stegen. Kör integreringsprocesser asynkront genom att aktivera egenskapen fire och forget.
• Ta bort onödiga data genom att trimma extraheringen av utdata från Data Mapper.
• När du bygger funktioner med Omnistudio, tänk på de styrande gränserna för Apex. Dessa gränser säkerställer att en enskild process inte styr delade resurser. Under utveckling, använd felsökningsloggar för att följa och hantera styrande gränser, vilket säkerställer att din utveckling är effektiv och inte överskrider Salesforces gränser under körning. Se Apex styrande gränser.

  För att bevaka hur styrande gränser används av Omnistudio-komponenter under körning, samla in Apex felsökningsloggar för en transaktion, till exempel aktivera ett Omniscript, starta ett Flexcard eller utföra ett steg i ett Omniscript. För att samla in Apex felsökningsloggar, skapa en spårningsflagg och ange den för användaren som utför Omnistudio-processer. Se Konfigurera felsökningsloggning.

  När du kör ett Omniscript, integreringsförfarande eller datamappning samlar felsökningsloggarna in alla transaktioner och ger insikter i användningen av styrande begränsningar.

Användningsfall för implementering

• Spara valda poster från Flexkortdatatabell till ett Omniscript.
  1. Skapa ett Flexkort och lägg till ett datatabellelement.
     

     Anteckning

     Se till att du har skapat ditt Flexkort och lagt till den nödvändiga datatabellkomponenten i Flexkortet.

  2. Konfigurera Händelselyssnare i inställningarna för Flexkort:
     1. Gå till fliken Flexkortsinställningar.
     2. Lägg till en händelselyssnare med dessa inställningar:
        • Händelsetyp: Egen händelse
        • Händelsens namn: välja rad
        • Åtgärdsetikett: Välj en etikett som du föredrar.
        • Åtgärdstyp: Uppdatera Omniscript
        • Överordnad nod: OsDataNode

        Denna konfiguration säkerställer att du uppdaterar en specifik nod i en matris i Omniscript. Detta hjälper dig följa och uppdatera de valda posterna. Du kan ersätta poster med valfritt matrisnodnamn efter behov.

        

        Anteckning Se till att du uppdaterar rätt nod i Omniscript för korrekt datahantering.
  3. Lägg till indataparametrar med dessa inställningar:
     • Nyckel: Välj lämplig JSON-tagg för den valda posten.
     • Värde: {action.result}

     Denna konfiguration säkerställer att hela dataraden inkluderas, tillsammans med variabeln selectrow, vilket indikerar om posten är vald eller inte (sant eller falskt).

     

     Anteckning Indataparametrarna ska matcha dina Omniscript-variabelnamn för att säkerställa att data överförs korrekt.
  4. Om det behövs, lägg till villkor. Använd till exempel action.result.selectrow för att avgöra om posten ska läggas till eller tas bort.

     Detta villkor är valfritt. Om du behöver olika åtgärder för valda och omarkerade poster kan du skapa två händelselyssnare med olika villkor för varje kundcase. Du kan anpassa logiken ytterligare genom att lägga till fler villkor baserat på kraven i ditt arbetsflöde.

Konfigurering

Att utforma Omniscripts med specifika konfigurationer kan ibland leda till oavsiktliga beteenden på de webbplatser de bäddar in i. Detta kan inträffa på grund av hur Omniscripts är utformade eller på grund av en kombination av faktorer utanför Omnistudio. Vissa kända problem och relaterade rekommenderade metoder beskrivs här.

Rekommenderade metoder för konfiguration inkluderar:

• När du använder elementen Åtgärd, Ställ in värden eller Datamappning för att fylla i data i ett redigeringsblock i ett Omniscript kan dataduplicering inträffa om kryssrutan Koppla sparade data JSON till den uppdaterade versionen är markerad i sektionen Spara alternativ och om en användare återupptar en sparad session. För att undvika detta, lägg till en flagga för att följa utförandet av elementet Åtgärd, Datamappning eller Ange värden och inkludera ett villkor i sektionen Villkorlig vy för att fortsätta endast om flaggan är falsk. Du kan till exempel använda en flagga med ett element för Ange värden för att förhindra duplicering av data som visas.
  
• Tabeller stöds inte inuti textblock.