Retningslinjer for utvikling av jukselapper
Ved hjelp av jukselapper
og sammensatte jukselapper kan en bruker oppnå en målsetning ved å fullføre en sekvens av trinn. Disse retningslinjene
beskriver når du skal bruke jukselapper, og hvordan du kan skrive en jukselapp på beste måte.
Når jukselapper skal opprettes
Jukselapper passer godt til oppgaver der brukeren utfører trinn som leder mot et oppnåelig mål, som bygging av en
enkel applikasjon. Målet må være
godt definert slik at brukeren kan se suksessen når alle trinnene i jukselappen er fullført. Opplæring er
ofte gode kandidater for jukselapper, i en opplæring er målet å lære hvordan en bestemt
oppgave utføres. Jukselapper inneholder
vanligvis opptil 10 trinn, og de kan fullføres i løpet av en halvtime eller mindre. Til større oppgaver
bør du vurdere å bruke sammensatte jukselapper.
Når sammensatte jukselapper skal opprettes
Sammensatte jukselapper
brukes til å lede brukeren gjennom en oppgave som er for stor til å bli beskrevet i en enkelt jukselapp, eller
som har flere målsetninger. En sammensatt jukselapp
kan brukes til å beskrive en sekvens av oppgaver der hver av dem bygger på sin forgjenger.
Når jukselapper ikke skal brukes
Jukselapper fungerer
best når et problem kan løses av en rekke enkle trinn. Jukselapper er ikke en
erstatning av hjelpesystemet, som gjør det mulig å opprette HTML-sider med grafikk og direkte tilgang til
informasjon ved hjelp av søk og hyperlinker. Jukselapper er ikke
beregnet på oppgaver som krever at brukeren oppgir en stor mengde tekst.
Retningslinjer for oppretting av en jukselapp
- Velg en kort og meningsfull tittel.
- Bruk linker til hjelpesystemet
i jukselappoppgaver når det er mulig å gi bakgrunnsinformasjon eller mer detaljerte
opplysninger.
- Vurder om den
bør skrives om til en sammensatt jukselapp hvis den inneholder mer enn 10 trinn.
- Bruk kommandoer
når det er mulig for å utføre enkle og trettende oppgaver, som for eksempel å åpne perspektiver, åpne
ressurser og utføre veivisere. Sørg også for å
gi en beskrivelse av hvordan det er mulig å oppnå samme virkning uten kommandoen.
- Forsikre deg om at
det er mulig å hoppe over kommandoer hvis brukeren bestemmer seg for å utføre trinnene manuelt.
- Oppgi dialog="true"
for trinn som åpner dialogbokser. Det vil gjøre at
jukselappen åpnes i en "skuff" til høyre for de fleste dialogbokser.
- Ordne trinnene slik at
brukeren jevnlig ser synlig tegn på fremdriften. En jukselapp som
gjør flere forskjellige endringer i Java-kilden og deretter starter en applikasjon, kan skrives om slik at
applikasjonen ble startet etter hver kildeendring.
- Forsikre deg om
at brukerne forstår hvorfor de utfører hvert trinn.
- I stedet for å
beskrive flere forskjellige måter å utføre et trinn på, velger du den enkleste måten som krever så lite
beskrivelse som mulig.
- Bruk avbruddskoder
(<br/>) for å forbedre lesbarheten.
- Underelementer kan
brukes til å dele trinn inn i mindre trinn.
- Ikke alle jukselapper
krever underelementer.
- Begynn etiketteksten for
underelementer med handlingsord som "Oppgi", "Utvid",
"Velg" etc.
- For underelementetiketter
identifiserer du grensesnittekst ved å bruke anførselstegn slik at brukerne kan skille instruksjonstekst
fra grensesnittekst de trenger å finne og samhandle med.
- Hvert underelement
bør være ansvarlig for en atomisk oppgave, som å oppgi en verdi.
- Legg alltid til et
<onCompletion>-element i det siste trinnet i en jukselapp.
- Test jukselapper med forskjellige størrelser på jukselappvisningen.
- Test jukselapper med feilloggvisningen åpen, slik at du kan se om advarsler skrives til loggen.
Retningslinjer for oppretting av en sammensatt jukselapp
- En sammensatt
jukselapp kan inneholde oppgaver som tilhører et felles tema.
- Hver oppgave i
en sammensatt jukselapp bør ha en veldefinert målsetning.
- Bruk <onCompletion>-elementer
slik at det blir mulig å gjenkjenne suksess.
- Oppgavenavn bør
være korte og konsise.
- Komplekse problemer kan
løses ved hjelp av oppgaver som bygger på forgjengerne.
- Bruk skip="true"
hvis en oppgave er valgfri.
- Sørg for at den
enkle jukselappens introduksjon og navn samsvarer med introduksjonen og navnet som er oppgitt
i den sammensatte jukselappen slik at resultatet blir konsekvent.
- Til oppgavebeskrivelser
bør du identifisere grensesnittekst klart ved å bruke formatering med fete typer.
- Sekvenser bør bare
brukes når det er viktig å fremtvinge rekkefølgen oppgavene kan startes i.
Beslektede linker
Arbeide med jukselapper
Arbeide med sammensatte jukselapper
Enkle jukselapper
Sammensatte jukselapper