/
Integrasjonsbyggeren

Integrasjonsbyggeren

Owned by Alexander Edin Varegg
Last updated: Aug 19, 2024 by Daupadhi Ponweera

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!

English

Compose tilbyr muligheten for å fylle ut skjemasvar automatisk ved å integrere mot eksterne kilder. Enhver ekstern webtjeneste som aksepterer og produserer XML eller JSON-data kan brukes i Compose gjennom Integrasjonsbyggeren. Integrasjoner i Compose representeres som et sett av forespørsel- og svar-variabler mot prosessen, som kan kobles til og dermed fylle f.eks. skjemasvar. Forespørselen skreddersyr dataformatet til det eksterne registeret med forespørsel-variabler. Dataene som hentes ut fra den eksterne tjenesten analyseres og kobles til svar-variablene med XPath-uttrykk i Integrasjonsbyggeren.

image-20240814-114609.png

Integrasjonsbyggeren har fire hovedmenyer: Innstillinger, Forespørsel Headers, Forespørsel Body og Svar. Du åpner inetgrasjonsbyggeren ved å dobbeltklikke på en ny eller eksisterende integrasjon (se Arkiv-dokumentasjonen).

Innstillinger

Innstillinger-menyen inneholder et panel med Versjoner, et panel med Egenskaper, en tabell med Forespørsel-variabler og en tabell med Svar-variabler. Både Forespørsel- og Svar-variabler har sine egne Egenskaper-menyer, som åpnes når du dobbelt-klikker på en variabel i tabellen.

Versjoner

Versions 

Versions 

image-20240814-114733.png

Begynne å redigere fra valgt versjon 

Innstillingene til kladden vil bli overskrevet med innstillingene fra versjonen valgt i panelet.

image-20240814-114800.png

Vis valgt versjon

Velg en versjon og se innstillingene / skriptet i en skrivebeskyttet visning.

image-20240814-114839.png

Ny versjon

Versjonér integrasjonen for å bruke den i prosesser.

image-20240814-114658.png

Egenskaper

image-20240814-115009.png

Egenskaper

Egenskaper

URL

Integrasjonen kjører URL-en oppgitt i dette feltet. URL-en kan parametriseres med {}-notasjon for å aksessere et utvalg av dataene i URL-en. Dette lar deg, f.eks. i en integrasjon mot Brønnøysundregisteret, hente ut organisasjons-spesifikk informasjon ved å ha en URL parametrisert med organisasjonsnummer, {orgnr}. (Eksempelet vises i denne brukerveilednignen: Integrasjoner (automatisk utfylling av skjema og prosesser) | Skjemabyggeren – Trigge integrasjonskall )

Viktig: Spesialtegn som ikke er lovlige i URL-er som æ, ø, å, /, % blir automatisk enkodet i forespørsel-variabler i URL-en. Derfor vil forespørsel-variabler med f.eks. %-tegn bli enkodet på nytt. Dette bør unngås.

Metode

Du har 4 tilgjengelige API-metoder: GET, PUT, POST, DELETE. Viktig: GET-forespørsler tillater ikke bruk av forespørsel-body, basert på HTTP-standarden.

Forespørsel-variabler

image-20240814-115201.png

Forespørsel-variabler

Forespørsel-variabler

image-20240814-115248.png

Opprett

Lag en ny variabel ved å trykke Opprett-knappen, gi den et navn og trykk OK. Når en Forespørsel-variabel er opprettet kan variabelen endres ved å legge inn et Transformasjonsskript. Viktig: Variabelens navn kan ikke starte med stor bokstav eller inneholde mellomrom, og må ha en lengde mellom 1 og 40 tegn.

image-20240814-115258.png

Slett 

Slett variabler ved å velge variabelen og trykk Slett-knappen.

image-20240814-115307.png

Endre

Velg variabelen og trykk Endre for å se/endre egenskapene i Egenskaper-menyen.

Egenskaper – Forespørsel-variabler

image-20240814-115545.png

Egenskaper – Forespørsel-variabler

Egenskaper – Forespørsel-variabler

Navn

Unikt navn på variabelen som kan refereres i forespørsel body-en.

Type

Velg mellom Verdi, Fil, Skjemasvar og Liste. Hvis du ønsker å sende filer, f.eks. filer lastet opp i skjema, velg typen Fil. For mer informasjon om valideringsskript for filer, sjekk ut dokumentasjonen Skripting i Compose.

Validering

En liste med tilgjengelige valideringer avhengig av hvilken type som velges (ingen valideringer tilgjengelig for Skjemasvar).

Kalkulert

En forespørsel-variabel kan bli transformert gjennom en kalkulering. Hvis Kalkulert velges er det obligatorisk å oppgi et transformasjonsskript. For vanlige variabler, er det ikke mulig å bruke transformasjonsskript basert på andre variabler. Viktig: En kalkulert variabel kan kun referere til ikke-kalkulerte variabler i transformasjonsskriptet.

Eksempel: Kalkulert forespørsel-variabel

I dette eksempelet har vi to forespørsel-variabler x og y. Variablene har begge heltallvalideringer, men x er er ikke-kalkulert og y er kalkulert.

image-20240814-120336.png

Dersom man skulle ønske at y tilsvarer x + 10, kunne man oppgitt følgende transformasjonsskript for variabel y:

image-20240819-063306.png

Svar-variabler

image-20240816-120036.png

Svar-variabler

Svar-variabler

Dataformat

Velg mellom XML, JSON og Binær for å deklarer formatet/språket til datamodellen du interagerer med.

image-20240814-115248.png

Opprett

Lag en ny variabel ved å trykke Opprett-knappen, gi den et navn og trykk OK. Viktig: Variabelens navn kan ikke starte med stor bokstav eller inneholde mellomrom, og må ha en lengde mellom 1 og 40 tegn.

image-20240814-115258.png

Slett 

Slett variabler ved å velge variabelen og trykk Slett-knappen.

image-20240814-115307.png

Endre

Velg variabelen og trykk Endre for å se/endre egenskapene i Egenskaper-menyen.

Egenskaper – Svar-variabler

image-20240816-120253.png

Egenskaper – Svar-variabler

Egenskaper – Svar-variabler

Navn

Unikt navn på svar-variabelen som kan refereres i forespørsel body-en.

Type

Velg mellom Verdi og Liste. Liste-variabler er utelukkende for å fylle lister med alternativer. For alle andre tilfeller bør Verdi velges.

Validering

Sett en validering på variabelen fra listen med tilgjengelige valideringer.

CCM-integrasjon

image-20240816-120337.png

Avkrysningsboksen CCM-integrasjon og Endpoint-URL brukes kun i integrasjoner som publiserer prosessdata til en Compose Saksbehandlingsløsning (Compose Case Management – CCM). Ved å spesifisere endpoint-URLen til din CCM vil prosessdata publiseres til CCM-en når prosessen versjoneres. På denne måten kan prosessen kobles til CCM-en og reflektere prosessdataene før en sak sendes til CCM-en.

Forespørsel Headers

image-20240816-120533.png

Forespørsel Headers

Forespørsel Headers

Opprett 

Oppretter en forespørsels-header.

 

Navn

Navn på forespørsel-headeren.

 

Verdi

Hvis du integrerer mot et privat API eller et register som trenger en viss autentisering eller format, legges spesifiseringen/autentiseringsnøkkelen til her.

Slett 

Sletter en forespørsels-header.

Forespørsel Body

image-20240819-062813.png

Forespørsel Body

Forespørsel Body

Skript

Skriptet til forespørsel body-en.

Syntaks-markering

Velg syntaksmarkeringen som korresponderer med skriptspråket. Mulige markeringer er Groovy, JSON, HTML, XML, Plain Text og YAML.

Valider

Skriptet kan valideres for å lete etter feil i skriptet. Valideringen svarer på om skriptet kjørte eller feilet. Hvis skriptet feilet vises en feilmelding som hjelper deg med å feilsøke. Feilene må rettes opp før integrasjonen kan versjoneres.

Svar

image-20240819-062919.png

Svar

Svar

Navn

Navnet til variabelen vises her.

Type

Variabeltype vises her.

Expression

Hver svar-variabel må tilegnes en verdi spesifisert gjennom et XPath-uttrykk. Pass på valideringene og at XPath-uttrykket returnerer en verdi og ikke en node.

Konverter verdi

Svarverdien kan transformeres med et skript i skriptevinduet tilgjengelig fra Konverter verdi-knappen. Svarverdien refereres til som value. Skriptet påvirkes av om det er oppgitt et XPath-uttrykk i Expression-feltet eller ikke. Uten et uttrykk, representerer value hele responsen fra kallet på URL-en. Ellers representerer value den spesifikke delen av responsen som uttrykket peker til. Tips: Hvis uttrykket er tomt vil det være mulig å skrive et komplisert skript som kan gjøre hva enn du vil og returnere en ønskelig verdi/liste.