Fil-integrasjoner (binær) og egendefinerte HTTP-headere
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!
Integrasjonsbyggeren kan hente ut data fra eksterne datakilder og gjøre dem tilgjengelige som svar-variabler. Dokumenter, bilder og andre filer kan også opptre som svar-variabler i binære integrasjoner. Begrepet binær i Compose-sammenheng referer til alle typer filer.
I denne veiledningen setter vi opp en binær integrasjon og kobler den til en prosess. Før det, går vi gjennom hvordan du lage egendefinerte HTTP-headere. Kunnskap om forespørsel-headere er en forutsetning for å sikre trygge data- og filoperasjoner i integrasjonsbyggeren.
Egendefinerte forespørsel-headere (HTTP-headere)
Compose lar deg generere forespørsel-headere (HTTP-headere) i integrasjonene dine. Under et integrasjonskall sendes HTTP-forespørselen med headerne til serveren, og vi får et svar. Alle integrasjoner starter med følgende standard-headere:
Standard-headerne kan endres eller slettes og egendefinerte headere kan legges til i Integrasjonsbyggeren. Opprett en integrasjon ved å velge Ny integrasjon-knappen i toppmenyen i Arkivet. Vi legger opp til å hente et bilde fra en URL med denne integrasjonen senere, ergo integrasjonsnavnet HentBilde.
Dobbeltklikk på integrasjonen for å åpne Integrasjonsbyggeren. Naviger til Forespørsel Headers-menyen og du vil se de tidligere nevnte standard-headerne.
Du kan endre eller fjerne standard-headerne og legge til egendefinerte headere med Opprett-knappen.
En ny linje opprettes hvor du kan gi headeren et navn og en verdi. Header-navn (keys) og verdier må samsvare til parameter-reglene i HTTP-standarden. Verdien kan enten være statisk eller kobles til en forespørsel-variabel. Den første nye headeren, Content-Type – application/json, er statisk og er headeren som tillater prosessering av JSON-data. (JSON-data, sammen med XML, er en av de mest brukte dataformatene i datamodeller tilgjengelige gjennom API)
I den andre headeren, Autorisasjonsheader – {key}, demonstreres hvordan du refererer til en forespørsel-variabel i en header. Med {}-notasjon (krøll-parentes) kan du bruke en forespørsel-variabel som en del av eller en hel header-verdi.
Vi har opprettet referansen i headeren, men vi har enda ikke opprettet forespørsel-variabelen! Gå tilbake til Innstillinger-menyen, og trykk Opprett i panelet Forespørsel-variabler.
Gi variabelen det samme navnet som referansen i forespørsel-headeren (i vårt tilfellet key).
Med forespørsel-variabelen kan du bruke enhver verdi fra prosessen i headeren. Eksempel: Hvis header-verdien trenger et tilgangstoken, oppretter du vanligvis enda en integrasjon som henter et token som svar-variabel. Da kan du koble den svar-variabelen (tokenet) til forespørsel-variabelen i denne integrasjonen for å få tilgangstokenet inn i headeren.
Viktig: Hvis du fortsette å følge dette eksempelet og vil lage en binær integrasjon er det viktig at du fjerner den siste headeren. Den binære integrasjonen vil hente et bilde uten behov for autentisering, så den siste headeren vil få integrasjonskallet til å feile.
Integrasjon med binær svar-variabel
I denne integrasjonen vil svaret være et bilde, og vi velger dermed formatet Binær for Svar-variabelen. (Legg merke til at Svar-menyen forsvinner når du velger Binær, da du ikke trenger å skrive XPath-uttrykk for å bearbeide filer)
Sett et Variabelnavn og et Filnavn for det binære svaret (i dette eksempelet bilde og Norge.jpg). Når du har satt egenskapene for svar-variabelen, sett metoden til GET (vi skal hente et bilde).
Oppgi URL-en til bildet. I dette tilfellet setter vi en variabel på URL-en, så vi kan spesifisere hvilket bilde vi vil ha fra et fullt bibliotek. URL-en, https://www.usecompose.com/wp-content/uploads/{key}, henviser til biblioteket https://www.usecompose.com/wp-content/uploads/ og {key}-variabelen vil være den særegne nøkkelen per bilde, f.eks: https://www.usecompose.com/wp-content/uploads/2019/08/Om-Compose.jpg
Innstillingene for tjenesten er nå ferdig. Husk å lagre kladden og versjoner for å kunne koble integrasjonen til prosessen.
Koble binære integrasjoner til prosesser
I dette korte eksempelet viser vi hvordan du kobler til en binær integrasjon i en prosess. Generell tilkobling av integrasjoner i prosesser er dekket ekstensivt i veiledningen Integrasjoner (automatisk utfylling av skjema og prosesser). Derfor vil denne guiden hovedsakelig fokusere på innstillingene spesifikt for binære svar. Den kommer heller ikke til å gå i detalj på standard oppsett av prosess, så sjekk ut veiledningen Bygg en prosess for videre hjelp.
Vi skal koble integrasjonen til en Bruk integrasjon-aktivitet og sende bildet som et vedlegg i en e-post. Opprett en prosess med aktiviteter i kronologisk rekkefølge – et Startpunkt, en Bruk integrasjon-aktivitet, en E-post-aktivitet og et Endepunkt. Start med å velge Bruk integrasjon-aktiviteten og koble til vår binære integrasjon ved å trykke Bla gjennom.
Du vil se navn og versjon på den valgte integrasjonen i panelet med Egenskaper. Vi må koble forespørsel-variabelen til en verdi, så trykk Forespørsel-variabler-knappen.
Forespørsel-variabler kan kobles til statiske verdier eller verdier fra prosessen. Vi velger å koble variabelen til en statisk verdi, da det ikke er noen prosessaktiviteter med passende URL-input i dette eksempelet. Vi bruker verdien, 2019/08/Om-Compose.jpg, som plukker ut bildet fra biblioteket vi vil hente. Trykk OK.
Velg E-post-aktiviteten og sett opp Generelt- og Innhold-fanen etter eget ønske. Viktig: Domenet til avsender-adressen må enten være domenet usecompose, eller et domene Compose har tillatelse til å distribuere e-post på vegne av (som oftest Compose-partnere/kunder). noreply@usecompose.com er en god back-up avsender-adresse.
Naviger til Vedlegg-fanen for å legge ved bildet i e-posten. Trykk Legg til vedlegg.
Bla gjennom og trykk pilhodet ved Bruk integrasjon-aktiviteten for å vise og velge svar-variabelen.
Gjør deg ferdig i menyen og bildet vil vises som et vedlegg i tabellvinduet.
Still inn resten av aktivitetene slik du ønsker, Lagre kladd, versjonér og trykk Play for å starte prosessen. Du vil nå kunne kjøre en prosess som henter bilder gjennom en integrasjon, og med egendefinerte forespørsel-headere.
Prosessen fra eksempelet er vedlagt. Viktig: Prosessen har ingen prosesser med et grensesnitt, så slutt-tjenesten vil gå rett til endepunktet. Derfor må du huske å endre e-postadressen til mottageren i E-post-aktiviteten til din egen e-post for å motta vedlegget!