Bedste fremgangsmåder for Omniscript

Forretningsproces og logik

Bedste fremgangsmåder for forretningsprocesser og logik omfatter:

• Brug entydige navne til Omniscript-elementer og Omnistudio Data Mapper-svarnoder.
• Identificer genanvendelige elementer ved at opbygge en oversigt over hele Omniscript.
• Dokumenter formålet med et element i elementets egenskab Interne notater.
• Undgå ændringer af elementnavne efter implementering i produktion. Når det er uundgåeligt, skal du anvende navnet ændres overalt, hvor der refereres til elementet.
• Tildel ikke et ContextId i Omniscript. Et Omniscripts ContextId er en reserveret nøgle, der tildeler et registrerings-id fra URL'en.
• Når processer kan gentages på tværs af flere Omniscripts, skal du oprette et genanvendeligt Omniscript og føje det til de relevante overordnede Omniscripts. Se Integreret et Omniscript i et andet Omniscript.
• Prøv at håndhæve påkrævede data og valideringer i det aktuelle trin i stedet for i slutningen af en formular. Dette hjælper brugerne med at rette deres input med det samme i stedet for at se på valideringer eller fejl i slutningen og tilbagesporing af deres trin for at rette hvert enkelt.
• Hvor det er muligt, kan du opdele komplekse opgaver i en applikation ved at bruge flere Omniscripts. Brug Omniscripts med Flexcards, hvis det er nødvendigt. Oprettelse af et stort Omniscript med flere trin kan hæmme ydeevnen og brugeroplevelsen.

Brugergrænseflade

Omniscripts bruger Lightning Web-komponenter til at definere formateringen af både individuelle elementer og selve Omniscript.

Bedste fremgangsmåder omfatter:

• Anvend global formatering. Hvis du ønsker yderligere oplysninger, kan du se Tilpassede typografier for Omniscripts.

Tilgængelighed

Bedste fremgangsmåder for tilgængelighed omfatter:

• Aktuelt er redigeringsblokke, der er konfigureret i tabeltilstand i Omniscripts, ikke kompatible med skærmlæsere. Hvis du bruger en skærmlæser, anbefaler vi, at du bruger Flexcards i stedet for Omniscripts. I Flexcards kan du bruge datatabeller eller Lightning, der er kompatible med skærmlæsere. Se Vis data i en tabel på et FlexCard og Lightning Web-komponent – Datatable.

Sikkerhed

Bedste fremgangsmåder for datasikkerhed omfatter:

• Hvis du vil sikre datasikkerhed og opretholde overensstemmelse med Salesforce-krypteringsadgangskontroller, skal du altid kontrollere, at en bruger har tilladelsen Vis krypterede data, før du viser eller behandler dekrypterede værdier for krypterede felter.

Brugeroplevelsesdesignprincipper

UX-designprincipper omfatter:

• Reducer antallet af felter, som brugeren skal indsætte oplysninger i, ved at udfylde felterne på forhånd ved brug af kontekstdata. Hvis du ønsker yderligere oplysninger, kan du se Angiv værdier i et Omniscript.
• Hvis du vil undgå kognitiv belastning, skal du omhyggeligt overveje, hvordan du opdeler processer. For mange korte trin, der kun indeholder et minimalt antal elementer, kan overvælde brugeren lige så nemt som store trin med flere elementer.
• Vejl brugeren ved at oprette kontekstbaseret hjælpetekst og logisk arrangere inputfelter.
• Sørg for, at de rekursive indlejrede blokke i et Omniscript ikke overskrider 10.

Ydelsesfaktorer

Der findes et sæt bedste fremgangsmåder for både ydeevne på klientsiden og ydeevne på serversiden.

Bedste fremgangsmåder på klientsiden omfatter:

• Reducer betingede visninger, flettefelter, formler, hvor det er muligt.
• Sæt skub i anvendelsen af svar ved at beskære svar-JSON. Hvis du ønsker yderligere oplysninger, kan du se Manipuler JSON med Egenskaber for Send/svar-transformationer.
• Fjern mellemrum fra elementnavne for at forbedre Omniscripts indlæsningstid.
• Reducer antallet af elementer i scriptet. Prøv at begrænse et enkelt Omniscript til maksimalt 750 elementer.
• Kør logik på serveren, hvor det er muligt, f.eks. betinget logik i integrationsprocedurer og formler i datatilknytninger.
• PDF'er, der er større end 250 KB, genereres langsomt. PDF'er, der er større end 1 MB, kan tage flere minutter at generere og kan nogle gange tage timeout.

Bedste fremgangsmåder på serversiden omfatter:

• Reducer størrelsen på en anmodning ved at beskære JSON-anmodningen. Hvis du ønsker yderligere oplysninger, kan du se Manipuler JSON med Egenskaber for Send/svar-transformationer.
• Opret ikke Omniscripts med Lightning, der er større end 4 MB. I eksempelvisning viser Omniscripts, der er større end 4 MB, en fejl, der angiver, at Omniscript enten er inaktivt eller ikke er implementeret. Download Omniscript LWC for at kontrollere dens størrelse.
• Reducer serverudflugter ved at bruge integrationsprocedurer, når der er flere handlinger mellem trin. Kør integrationsprocedurer asynkront ved at aktivere fire og forget-egenskaben.
• Fjern unødvendige data ved at beskære Data Mapper-udtrækningsoutput.
• Når du opbygger funktioner med Omnistudio, skal du huske på Apex. Disse begrænsninger sikrer, at en enkelt proces ikke kontrollerer delte ressourcer. Under udvikling skal du bruge fejlretningslogfiler til at spore og administrere styringsbegrænsninger, så du sikrer, at din udvikling er effektiv og ikke overskrider Salesforce-begrænsninger under kørsel. Se Apex Governor Limits.

  Hvis du vil overvåge, hvordan styringsbegrænsninger bruges af Omnistudio-komponenter under kørsel, skal du indsamle Apex for en transaktion, f.eks. aktivering af et Omniscript, start af et Flex Card eller kørsel af et trin i et Omniscript. Hvis du vil indsamle Apex, skal du oprette et sporingsflag og angive det for den bruger, der kører Omnistudio-processer. Se Opsæt fejlretningslogføring.

  Når du kører et Omniscript, integrationsprocedure eller Datatilknytning, registrerer fejlretningslogfilerne alle transaktioner og giver indsigt i styringsbegrænsningen for anvendelse.

Anvendelsessituationer for implementering

• Gem valgte registreringer fra Flexcard Datatable til et Omniscript.
  1. Opret et Flex Card, og tilføj et Datatable-element.
     

     Bemærk

     Sørg for, at du har oprettet dit Flex Card og tilføjet den nødvendige datatabelkomponent i Flex Card.

  2. Konfigurer Begivenhedslytter i FlexCard-opsætningen:
     1. Gå til FlexCard-opsætningsfanen.
     2. Tilføj en begivenhedsløser med disse indstillinger:
        • Begivenhedstype: Tilpasset begivenhed
        • Begivenhedsnavn: markør
        • Handlingsbetegnelse: Vælg en betegnelse, du foretrækker.
        • Handlingstype: Opdater Omniscript
        • Overordnet node: OsDataNode

        Denne konfiguration sikrer, at du opdaterer en specifik node i en matriks i Omniscript. Dette hjælper dig med at spore og opdatere de valgte registreringer. Du kan erstatte registreringer med ethvert matriksnodenavn efter behov.

        

        Bemærk Sørg for, at du opdaterer den korrekte node i Omniscript for nøjagtig datahåndtering.
  3. Tilføj inputparametre med disse indstillinger:
     • Nøgle: Vælg det relevante JSON-tag for den valgte registrering.
     • Værdi: {action.result}

     Denne konfiguration sikrer, at hele datarækken er inkluderet sammen med valgrækkevariablen, som angiver, om registreringen er valgt eller ej (sand eller falsk).

     

     Bemærk Inputparametrene skal matche dine Omniscript-variabelnavne for at sikre, at data overføres korrekt.
  4. Tilføj betingelser, hvis det er nødvendigt. Brug f.eks. action.result.selectrow til at bestemme, om registreringen skal tilføjes eller fjernes.

     Denne betingelse er valgfri. Hvis du har brug for forskellige handlinger for valgte og ikke-valgte registreringer, kan du oprette to begivenhedslydere med forskellige betingelser for hver sag. Du kan tilpasse logikken yderligere ved at tilføje flere betingelser baseret på kravene til dit arbejdsflow.

Konfiguration

Design af Omniscripts med specifikke konfigurationer kan nogle gange føre til utilsigtet adfærd på de lokaliteter, som de integreres i. Dette kan forekomme på grund af den måde, som Omniscripts er designet på, eller på grund af en kombination af faktorer uden for Omnistudios omfang. Nogle kendte problemer og relaterede bedste fremgangsmåder beskrives her.

Bedste fremgangsmåder for konfiguration omfatter:

• Når du bruger et Handlings-, Angiv værdier- eller Data Mapper-element til at udfylde data i en Rediger blok i et Omniscript, kan der forekomme dataduplikering, hvis afkrydsningsfeltet Flet gemte data JSON til den opdaterede version er markeret i afsnittet Gem indstillinger, og hvis en bruger genoptager en gemt session. Hvis du vil undgå dette, skal du tilføje en markering for at spore kørslen af elementet Handling, Datatilknytning eller Angiv værdier og inkludere en betingelse i afsnittet Betinget visning for kun at fortsætte, hvis markeringen er falsk. Du kan f.eks. bruge en markering med et Angiv værdier-element til at forhindre dataduplikering som vist.
  
• Tabeller understøttes ikke i tekstblokke.