URL-parametere
Designet til Compose har blitt oppdatert. Siden kan inneholde skjermbilder av det gamle designet, men informasjonen er oppdatert. Vi takker for din tålmodighet mens vi oppdaterer bildene!
Sluttbrukere starter prosesser gjennom nettlenker generert av Compose (i tillegg til QR-koder). Disse nettlenkene kan ha parametere, som f.eks. https://demo.usecompose.com/cng/YouTubeTutorial/param_nor?orgnr=916158378&aar=2021. Verdiene til disse parameterne kan hentes ut i skjema og prosesser. Å tillate dynamisk innhold i nettlenker kan gjøres med egendefinerte prosessvariabler og ved å referere til skjemaspørsmål gjennom alias.
I dette eksempelet (som kan importeres til din installasjon med cng-filen på bunnen av siden) brukes et skjema som gir oversikt over regnskapsåret til en organisasjon.
Målet er å bruke URL-parametere til å trigge fylling av organisasjonsdetaljene og regnskapsåret sluttbrukeren vil se en oversikt over.
(Ikke viktig for parameter-eksempelet) Hver side har fått en visningsbetingelse basert på spørsmålet År (Q5). Dersom året tilsvarer 2021 vises kun siden Regnskapsåret 2021 (vist på skjermbildet til høyre). Tilsvarende visningsbetingelse er satt på de andre sidene, så kun siden for det aktuelle året vises etter at året er hentet ut fra URL-en. Under er et eksempel på tjenesten hvor URL-parameteren med år-verdien var 2021.
Som du kan se er kun Regnskapsåret 2021 synlig av regnskapssidene siden alle de andre visningsbetingelsene ikke oppfylles.
For å legge til URL-parametere, gå til prosessen og naviger til Variabler-menyen.
Vi må lage parameter-variabler. Trykk Opprett for å lage en ny variabel. Gi variabelen et navn og trykk OK.
Dobbeltklikk på variabelen for å endre variabelens egenskaper.
Velg parameterverdi og gi parameteren et navn i tekstfeltet (helst et kort navn siden den skal være i en URL). Hvis skjemasvaret du legger opp til å fylle har en spesifikk validering, så må valideringen til parameterverdien endres til samme validering.
Repeter steget for så mange parametere som ønskelig. Parametere kan også opprettes i startpunkt.
Naviger til Bygger-menyen og velg skjema-aktiviteten (eller en hvilken som helst annen aktivitet hvor du vil hente ut parameterverdier).
Trykk Forhåndsutfyll-knappen i skjemaets panel med egenskaper (et skjema må være koblet til aktiviteten).
Menyen for forhåndsutfylling av spørsmålssvar åpnes. Trykk Velg spørsmål fra skjema-knappen.
Datamodellen (alle spørsmål) til det tilkoblede skjemaet vises. Velg spørsmålet du vil fylle og trykk OK.
Repeter steget for alle spørsmålene du vil forhåndsfylle. Velg spørsmålet og velg radioknappen Verdi fra prosess. Trykk Bla gjennom for å se de tilgjengelige prosessvariablene og verdiene.
Utvid listen med prosessvariabler ved å trykke på pilhodet og velg parameterverdien du vil hente ut til ditt valgte spørsmål. Trykk deretter OK.
Verdien fra URL-parameteren aar vil nå puttes direkte i svarfeltet til spørsmålet År (Q5). Repeter stegene over hvis du valgte flere spørsmål.
Vi bruker den andre URL-parameteren, orgnr, som forespørsel-variabelen i en integrasjon mot Brønnøysundregisteret for å hente ut organisasjonsdetaljene til skjemaet (se brukerveiledningen Integrasjoner (automatisk utfylling av skjema og prosesser)for tilkobling av integrasjoner i prosessbyggeren).
Husk å lagre kladden og versjonere prosessen. Den publiserte URL-en til prosessen vil ikke automatisk inneholde URL-parameterne. Disse må legges til manuelt. Tillegging av parameterverdier i en Compose-URL følger denne syntaksen:
Tjeneste-URL + ? + parameter={parameterverdi} + & + parameter={parameterverdi} + & + etc.
F.eks..: https://demo.usecompose.com/cng/YouTubeTutorial/param_nor?orgnr=916158378&aar=2021
I eksempel-URLen er parameterverdien for orgnr verdien 916158378 og aar er 2021. Den resulterende forhåndsutfyllingen i tjenesten vises på skjermbildet under:
Spørsmålsalias som URL-parametere
Du kan også forhåndsutfylle skjemaspørsmål ved å referere til spørsmålsalias i tjeneste-lenken. La oss bruke det samme skjemaet som i eksempelet over.
Her har Postnummer-spørsmålet aliaset postnr. Syntaksen for referering av spørsmålsalias involverer navnet til skjema-aktiviteten i prosessen (i dette tilfellet er navnet Skjema).
Syntaksen for referering av spørsmålsalias er skjemaAktivitetNavn.alias={verdi}. Så hvis vi f.eks. ønsker at postnummeret skal være 0858 (i tillegg til at verdien for parameteren aar definert tidligere er 2021), så blir den totale URL-en
Tjenesten fylles dermed med de spesifiserte verdiene.
Viktig: Det er ingen begrensning på antall parametere/spørsmålsalias som kan refereres til i en URL.
Eksemplene fra denne brukerveiledningen er vedlagt som en prosessfil under:
