FtPB Hendelser

FtPB har mulighet til å varsle integrerende system om hendelser i FtPB. Et eksempel på dette er at FtPB kan varsle om at nye data er tilgjengelig på en sak, slik at det ikke er nødvendig med polling av for eksempel Status-API-et.

Event skjema

CNCF (Cloud Native Computing Foundation) har spesifisert et skjema for distribusjon av hendelser i skyen; https://cloudevents.io/. FtPB tar i bruk denne standarden og systemer som ønsker å integrere seg vil også måtte støtte dette.

Hendelser i FtPB økosystemet

For hendelser internt i FtPB økosystemet vil man distribuere hendelser som inneholder tilstrekkelig med relevante data for hendelsen. Det vil dermed ikke være nødvendig med påfølgende API-kall for uthenting av data. Dette kalles Event Carried State Transfer.

Event Carried State Transfer

For denne varianten vil hendelsen inneholde alle relevante data. Den kan også inneholde en lenke til hvor disse dataene er mulig å hente ut.

Eksempel

[
  {
    "source": "/tbd",
    "subject": "/tbd",
    "type": "FtPB.KvitteringSendt",
    "time": "202023-01-26T18:41:00.9584103Z",
    "id": "831e1650-001e-001b-66ab-eeb76e069631",
    "dataschema":""
    "data": {
      "innsendingReferanse": "ar2000",
      "url": "https://sakbehandlingsdataapi.ft-dev.dibk.no/kvittering?innsendingrefernse=ar2000"
      "kvittering": {
          "metadata": {
            "fraEbyggesaksystem": "VårtSystem",
            "innsendingReferanse": "ar2000",
            "ftBID": "654f6ds4f66f5d4s6f45sd",
            "avsenderId": "3817",
            "avsenderNavn": "Midt-Telemark Kommune",
            "ekspedertDato": "2023-01-18T14:50:59.185Z",
            "offentligJournalUrl": ""
          },
          "saksnummer": {
            "saksaar": "2023",
            "sakssekvensnummer": "12421",
            "journalpostnummer": "6549871"
          },
          "avsenderKontaktpunkt": {
            "navn": "Byggesaksavdelingen",
            "epost": "user@example.com",
            "telefon": "+4790188247",
            "mobil": "+29999999"
          },
          "milepæl": "MS",
          "saksbehandlingsfrist": "2024-01-12T08:47:59.185Z",
          "mottattDato": "2023-01-12T08:47:59.185Z",
          "registrertDato": "2023-01-12T08:47:59.185Z",
          "mottattDokument": [
            {
              "dokumentNavn": "Kart.pdf",
              "mimeType": "application/pdf",
              "dokumentStorrelse": 123456,
              "ekstraMetadata": [
                {
                  "key": "skjemaversjon.dokument.9",
                  "value": "5797.42813"
                }
              ]
            }
          ]
        }
    },
    "dataVersion": "1",
    "metadataVersion": "1"
  }
]

Hendelser til bruk utenfor økosystemet

Det er ennå ikke kartlagt eller definert hendelser som bør være tilgjengelig for systemer utenfor FtPB økosystemet.

Retry

Azure Event Grid tar på seg ansvaret for retry dersom integrerende system ikke svarer. Standard oppsett er at Azure Event Grid foretar en exponential backoff av retries. Dette betyr at retries gjøres med økende pause mellom hvert forsøk. Dersom det ikke registreres en vellykket varsling av hendelse i løpet av 24 timer, blir hendelsen “dead lettered”.

Hvordan håndtering av “dead lettered”-hendelser skal foregå, er ennå ikke bestemt.