Integrasjoner (automatisk utfylling av skjema og prosesser)
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!
Integrasjoner er ekstremt praktiske når du bygger tjenester. De representerer selve essensen av automatisering, da du kan bruke dem til automatisk utfylling av lister, både direkte i Listebyggeren eller i Skjemabyggeren på flervalgspørsmål, og automatisk utfylling av felter i skjema og prosesser. Denne brukerveiledningen vil ta deg gjennom hvordan du kobler integrasjoner til skjema og prosesser med tre brukertilfeller:
Hvordan trigge et integrasjonskall i Skjemabyggeren
Hvordan klargjøre forhåndsutfylling av et skjema i Prosessbyggeren
Hvordan konfigurere Bruk integrasjon-aktiviteten i Prosessbyggeren
For å lære hvordan du setter opp integrasjoner, se dokumentasjonen for Integrasjonsbyggeren og Integrasjoner, eller se opplæringsvideoen Integrasjon mot åpent API. For å lære hvordan du fyller lister, se veiledningen Lister – automatisk utfylling, eller se opplæringsvideoen Lister fra tidspunkt 1:54.
Skjemabyggeren – Trigge integrasjonskall
I dette eksempelet skal vi trigge et integrasjonskall som fyller ut skjemasvar med en integrasjon mot API-et til Brønnøysundregisteret. Når sluttbrukeren fyller inn et organisasjonsnummer i et skjemafelt skal det trigge automatisk utfylling i andre felter med informasjon om organisasjonen (navn, kontoradresse, postnummer, etc.).
Integrasjonen vi ønsker å koble til skjemaet har dermed organisasjonsnummeret som forespørselsvariabel og informasjonen om organisasjonen som svar-variabler.
Siden vi ønsker at handlingen å skrive inn et organisasjonsnummer skal trigge utfyllingen av de andre skjemafeltene, velger vi Organisasjonsnummer-spørsmålet og trykker Trigger-knappen.
Trigger-menyen blir synlig på skjermen. Opprett en ny trigger ved å trykke Ny trigger-knappen.
En ny trigger dukker opp i listen. I kolonnene Når? og Hva? velges henholdsvis når hendelsen skal utløses og hva som skal skje. Vi ønsker at utfyllingen skal skje etter inntastingen, og at hendelsen skjer ved et integrasjonskall.
Nå kan vi koble til integrasjonen. Trykk Bla gjennom, og finn integrasjonen du ønsker å bruke fra arbeidsområdet.
Vår integrasjon heter “Hent brreg info”. Velg versjonen av integrasjonen du ønsker å koble til skjemaet i nedtrekkslisten under. Først må vi koble spørsmålsfeltet som får inn forespørsel-variabelen til integrasjonen. I vårt tilfelle er det organisasjonsnummeret som blir forespurt for å trigge resten av utfyllingen. Trykk Forespørsel-variabler-knappen.
I Variabler-menyen er alle forespørselsvariablene til integrasjonen listet opp (i dette tilfellet kun én). Velg variabelen, velg Verdi fra skjema-radioknappen og trykk Bla gjennom for å finne spørsmålet for organisasjonsnummeret.
Åpne datamodellen ved å trykke på pilen, og velg spørsmålselementet ekvivalent med forespørsel-variabelen, altså organisasjonsnummeret i vårt tilfelle. Trykk OK, og OK igjen for å gå tilbake til Trigger-menyen.
Nå skal vi koble svar-variablene fra integrasjonen til de korresponderende spørsmålselementene. Trykk Svar-variabler-knappen.
På lik linje med Variabler-menyen for forespørsel-variablene er også svar-variablene listet til venstre. Velg en av variablene og trykk velg spørsmål fra skjema-knappen for å koble svar-variablene.
Velg spørsmålet som korresponderer med svar-variabelen, trykk OK og repeter steget til alle ønskede svar-variabler er koblet. Legg merke til at navngivingen på spørsmålene og variablene fra integrasjonen er samkjørt for å illustrere logikken i eksempelet på best mulig vis. I ditt tilfelle kan det hende at det er få eller ingen korresponderende navn, så det kan være greit å tenke på når du bygger integrasjoner. Navnene må ikke matche for at de skal kunne kobles sammen, men det gjør jobben din enklere!
I Verdi-kolonnen vises ID-ene til de koblede spørsmålene. I motsetning til forespørselsvariabler trenger ikke alle svar-variabler å være koblet til skjemaet for at hendelsen skal trigges. Trykk OK, og OK igjen for å lagre innstillingene og lukke begge trigger-menyene.
Som du kan se har en grønn prikk dukket opp i øvre venstre hjørne av Organisasjonsnummer-elementet. Dette indikerer at elementet har en trigger. Trykk Lagre Kladd og forhåndsvis skjemaet for å teste triggeren.
Og med det fylles skjemaet ditt automatisk ut etter organisasjonsnummeret er skrevet inn.
Prosessbyggeren – Forhåndsutfylling fra integrasjon
Create a sample workflow with at least one Form activity. To connect the service to your workflow, select Populate via service in the Form Activity properties panel to the right of the workflow. You will need to pick a previously created generic service. Select Repository item and Browse to find the generic service.
Opprett eller åpne en eksisterende prosess med minst en Skjema-aktivitet. For å knytte integrasjonen til prosessen, velg skjema-aktiviteten, huk av Forhåndsutfylling fra integrasjon i panelet Egenskaper - Skjema til høyre for prosessen. Merk av Arkivelement og Bla gjennom for å finne integrasjonen.
Dialogboksen viser en oversikt over alle tilgjengelige integrasjoner i arbeidsområdet. Velg en integrasjon og trykk OK.
Navnet og den nyeste versjonen av integrasjonen du valgte vises nå i Egenskaper - Skjema panelet. Compose gir deg valget Bruk høyeste mindre versjon automatisk, så hvis du ønsker å bruke en tidligere hovedversjon av integrasjonen, så fjern avhukingen på dette valget og velg versjonen i nedtrekkslisten. Dersom du lar valget være avhuket, vil Compose automatisk velge den nyeste delversjonen av tjenesten din. Med delversjoner menes f.eks versjon 1.1, 1.2 og 1.3, mens hovedversjoner refererer til 1.0, 2.0, 3.0 osv. En ny hovedversjon forekommer ved endring av variabel-egenskaper som navn eller datatyper. Alt annet regnes som mindre endringer og resulterer i delversjoner.
Du må også koble eksisterende forespørsel- og svar-variabler i prosessen. Trykk Forespørsel-variabler. For å koble en variabel, velg en forespørsel-variabel i listen. Dets detaljerer vises til høyre. Compose gir deg mulighet til å koble variabelen til en Statisk verdi eller Verdi fra prosess. Du velger den statiske verdien selv i inndata-feltet, mens for Verdi fra prosess, finner du verdien ved å trykke på Bla gjennom-knappen.
Hvis tjenesten har flere enn én forespørselsvariabel, så gjentar du dette steget til alle variablene er koblet til en verdi.
I samme panel finner du knappen Svar-variabler. Trykk knappen for å se menyen med alle eksisterende svar-variabler fra integrasjonen. For å automatisk utfylle et skjemasvar med verdien fra svar-variabelen, trykk Velg spørsmål fra skjema, og velg et spørsmål. I motsetning til forespørsel-variabler trenger du ikke å koble alle svar-variabler, så når du har koblet de du trenger, trykk OK.
Dette var de nødvendige stegene for å opprette og bruke en integrasjon. For å fullføre tjenesten, må du konfigurere resten av prosess-aktivitetene, lagre prosessen og opprette en ny versjon. Naviger til Arkivet og publiser tjenesten.
Bruk integrasjon – prosessaktivitet
Bruk integrasjon-aktiviteten gir deg muligheten til å kjøre integrasjonskall når som helst i prosessen. Så lenge den er plassert mellom et startpunkt og et endepunkt kan du plassere den hvor du vil. Aktiviteten må knyttes til en versjonert integrasjon, og kan bruke verdier fra prosessaktiviteter, som skjemasvar og prosessvariabler som forespørsel/svar-variabler. Du finner Bruk integrasjon-aktiviteten under Behandling av data i Aktiviteter-panelet i Prosessbyggeren.
I dette eksempelet gjør vi samme skjemautfylling som demonstrert i det første eksempelet i denne brukerveiledningen. Unntaket er at vi bruker en statisk verdi for organisasjonsnummeret i integrasjons-aktiviteten. Opprett eller åpne en eksisterende prosess og legg til et Startpunkt, en Bruk integrasjon-aktivitet, en Skjema-aktivitet og et Endepunkt. Hvis du er usikker på hvordan du setter opp prosessaktivitetene, så finner du hjelpen du trenger i brukerveiledningen Bygg en prosess.
Velg integrasjons-aktiviteten på lerretet for å vise Egenskaper-panelet til høyre. Trykk Bla gjennom for å finne integrasjonen du ønsker å koble til.
Bla deg gjennom arbeidsområdet, velg integrasjonen og trykk OK.
Hvis ntegrasjonen du valgte har én eller flere forespørselvariabler, må disse knyttes til verdier. Trykk Forespørsel-variabler-knappen for å åpne Variabler-menyen.
Velg variabelen og oppgi en statisk verdi, altså et organisasjonsnummer. Målet er å ha skjemaet forhåndsutfylt når sluttbrukeren starter tjenesten. Trykk deretter OK.
Velg nå Skjema-aktiviteten på lerretet. Hvis du ikke enda har koblet aktiviteten til et versjonert skjema, må du gjøre det nå. Trykk deretter Forhåndsutfyll-knappen.
I Forhåndsutfyll svar-menyen må spørsmålene som skal forhåndsutfylles først velges fra datamodellen til skjemaet. Trykk Velg spørsmål fra skjema-knappen.
Velg spørsmålet du vil forhåndsutfylle, trykk OK og gjenta dette steget for alle spørsmålene du vil forhåndsutfylle.
Velg det første spørsmålet. Vi ønsker at skjemasvarene skal fylles av svar-variablene fra integrasjonsaktiviteten. Velg radioknappen Verdi fra prosess og så Bla gjennom for å se prosessens tilgjengelige variabler.
Utvid integrasjons-aktiviteten (Compose info) ved å trykke på pilodet og velg svar-variabelen som matcher spørsmålet den skal besvare. Trykk OK.
Svar-variabelen vises ved siden av spørsmål-ID-en i listen med spørsmål.
Repeter disse stegene for alle spørsmål i listen og trykk OK når du er ferdig.
Pass på at resten av prosessaktivitetene er korrekt innstilt og husk å lagre kladden før du lager en ny versjon av prosessen.
Som du kan se er oppskriften for tilkobling av integrasjoner temmelig lik for alle eksemplene. Du har rett og slett muligheten til å koble til integrasjoner på flere steder i Compose-byggerne.