formbasedocs
Gå til appenAppen

Tilgjengelig i Free-planen

Dette fungerer i alle planer, inkludert Free. Sammenlign planer →

Integrasjoner

Axiom

Spør etter rå skjemahendelser i APL, bygg dashbord og overvåkere, og send eventuelt fullstendige innsendte svar.


Koble til Axiom

  1. 1

    Opprett et datasett

    Opprett eller velg Axiom-datasettet som skal motta formbase-poster.

  2. 2

    Opprett et inntakstoken

    Opprett et API-token med tillatelse til å ta inn data i det datasettet.

  3. 3

    Koble til i formbase

    Åpne Arbeidsområde → Integrasjoner → Analyse, trykk Koble til på Axiom, skriv inn Datasett og API-token, velg Region, og trykk Koble til.

  4. 4

    Send en testhendelse

    Åpne et hvilket som helst skjema → Innstillinger → Integrasjoner → Analysestrømming og klikk Send testhendelse.

De to regionvalgene er US East 1 (AWS) og EU Central 1 (AWS). Velg den regionen Axiom-organisasjonen din befinner seg i — formbase utleder inntaksendepunktet fra den, og inntak i feil region avvises.

Analysehendelser

Å koble til Axiom slår på svarfrie hendelsesvideresending for hvert skjema i arbeidsområdet. Poster bruker hendelsesnavnene form_view, form_engaged, og form_submit, med de samme parameterne som er dokumentert i Analysestrømming.

['your-dataset']
| where ['event'] in ('form_view', 'form_engaged', 'form_submit')
| summarize events=count() by ['event']

Hver post flater ut hendelsesparameterne til øverste nivå, så form_id, source, device og resten er ordinære kolonner du kan filtrere og oppsummere på.

Hendelsesvideresending er beste-innsats og prøves ikke på nytt. Deaktiver den for ett skjema under Skjemainnstillinger → Integrasjoner → Analysestrømming → Videresend analysehendelser.

Respondentsvar

Axiom kan også motta én fullstendig post per fullført innsending. Denne strømmen er av som standard og må aktiveres separat for hvert skjema med Send respondentsvar.

En svarpost er den samme hendelseskonvolutten en egendefinert webhook mottar, pluss et Axiom _time-felt: hendelses-ID-en, typen, createdAt, apiVersion og test, og under data skjemaet, innsendingen (id, respondentens e-post, innsendingstidspunkt, PDF-lenke, språk), et answers -objekt nøkkelsatt med feltnøkkel og et display-objekt med de samme nøklene som lesbar tekst. Innsendinger som besvarte en forespørsel, bærer også en request-blokk med din eksterne id og metadata. Den fullstendige formen finnes i webhook-referansen.

Svar strømmes når en innsending fullføres, og igjen når en respondent redigerer den. Avbrutte utkast når aldri Axiom på denne måten — svarstrømming har ikke noe inaktivitetsvindu.

Svarlevering og feil

Svarposter følger innsendingens leveringskø: opptil 5 forsøk med eksponentiell tilbakekobling. Etter 20 påfølgende feil slutter destinasjonen å bli satt i kø, slik at et ugyldig token eller et avvist datasett ikke kan generere en mislykket levering for hver nye innsending. Å lagre et nytt API-token fjerner feilen og gjenopptar leveringen.

Hendelsesvideresending og svarstrømming har uavhengige brytere. Du kan sende svar uten hendelser, hendelser uten svar, begge deler, eller ingen av delene for hvert skjema.

Feilsøking

ProblemSjekk
Test avvistDatasettet finnes, tokenet har inntakstillatelse, og valgt region samsvarer med Axiom-organisasjonen din.
Hendelser ankommer, men ikke svarAktiver Send respondentsvar på det spesifikke skjemaet.
Svar stoppet20 leveringer på rad mislyktes. Gjenopprett datasetttilgangen, og lagre deretter et nytt API-token.
Feil skjemaer visesFiltrer etter form_id eller deaktiver hendelsesvideresending på skjemaer som skal holdes ute.

Neste steg