Millal seda vaja on

  • Andmeid kopeeritakse käsitsi ühest süsteemist teise ja keegi ei mäleta enam, miks see nii on.
  • Keegi ei tea, kus on originaal. Kaks aruannet annavad sama küsimuse kohta kaks vastust.
  • Ees seisab hange või arendus. Liidestuste osa tuleb kirja panna nii, et pakkumused oleksid võrreldavad.
  • E-arve, X-tee või partneriliidese ühendus ei tööta nii, nagu lubati. Fail liigub, aga sisu ei ole see, mida vastuvõttev pool vajab.
  • Uus süsteem tuleb olemasolevate kõrvale. Enne juurutust on vaja teada, millised liidesed peavad esimesest päevast töötama.

Mida me teeme

  • Andmevoogude kaardistus — mis andmed kus tekivad, kuhu liiguvad, kes on omanik ja mis on tundlik (PII, säilitusaeg, ligipääs).
  • Ühine sõnastik — üks mõiste, üks definitsioon. Enamik integratsioonivaidlusi on tegelikult mõistevaidlused.
  • API-spetsifikatsioonid (OpenAPI 3.x) — kontraktid, autentimine, vea-stsenaariumid, kvoodid ja piirangud, versioneerimine.
  • Liidesekirjeldus arendajale või hankesse — väljade tasemel vastendus, ärireeglid, sünkroonsus ja sagedus, vastuvõtu alused.
  • Sõltuvuste ja riskide kaart — mis läheb katki, kui üks pool muutub või ei vasta.
  • Integratsiooni eelanalüüs — koondtulem, mille põhjal saab arendaja tööd alustada või hankija kirjelduse koostada.
  • Liidestuse teostus — REST-liidesed OpenAPI-kirjelduse alusel, autentimine, veakäsitlus, korduskatsed, logimine ja seire.

Kirjeldus on kirjutatud nii, et selle saab anda edasi ükskõik millisele arendajale. Kui soovite, et teostuse teeks sama inimene, kes kirjelduse kirjutas, siis on ka see üks võimalikest koostöövormidest.

Mida te kätte saate

  • D.04

    Andmevoogude diagrammid

    Andmete liikumine süsteemide ja protsesside vahel, koos klassifitseerimise ja tundlikkuse märgistamisega (PII, säilitusaeg, omanik).

    VormingudDRAW.IOMDPDF
  • D.05

    API-d ja integratsioonid

    OpenAPI 3.x kontraktid, autentimine, vea-stsenaariumid, kvoodid, versioneerimine.

    VormingudOPENAPIMDPOSTMAN
  • Riskide ja eelduste loend

    Mis peab olema tõsi, et liidestus tööle hakkaks, ja mis juhtub siis, kui see nii ei ole.

    VormingudXLSXMD
  • Väljade vastendus

    Lähte- ja sihtväljad koos teisendusreeglite ja kohustuslikkusega.

    VormingudXLSXMD

Kõik tulemid antakse üle redigeeritavas vormingus.

Turvalisus selles töös

Integratsioon on koht, kus andmed lahkuvad ühe süsteemi kaitse alt ja jõuavad teise. Seetõttu käib kaardistusega kaasas andmete klassifitseerimine ja tundlikkuse märgistamine: mis on isikuandmed, kui kaua neid hoitakse, kes on omanik, kellel on ligipääs ja mida logitakse. Need on liidese kirjelduse osa, mitte eraldi turvapeatükk lõpus.

Teostuses lisandub sama mõte tööviisina: autentimine ja õigused kohe alguses, saladused koodist väljas, veaolukordade käitumine kirjeldatud ja logitud nii, et hiljem saab aru, mis juhtus.

Kust see kogemus tuleb

Asutaja-analüütikul on 13+ aastat praktikat süsteemide, andmemudelite ja süsteemidevaheliste liidestega panganduses, telekomis, IT-konsulteerimises ja logistikas. Kvalifikatsioon: BCS Foundation Certificate in Business Analysis. Töökeeled eesti ja inglise.

Kõige lähem avalik näide sellest, millised meie integratsioonianalüüsi järeldused välja näevad, on meie e-arvete artikkel. Seal on läbi tehtud täpselt see töö: mis kehtib, mis on lubatud, kus lubadus ja tegelik andmevoog lahku lähevad ja mida sellega peale hakata.

Loe edasi

Koostöövormid

Iga vorm on lähtepunkt, mille ulatuse täpsustame vestluses ja fikseerime kirjalikus pakkumuses. Astmeid saab läbida eraldi või üksteisele loogiliselt järgnevana.

Integratsiooni eelanalüüs

Fikseeritud ulatusega kirjalik tulem enne arendust või hanget. Vastab küsimusele, mis peab liikuma, kuhu ja mis reeglite järgi.

Mis sisaldub:

  • Andmevoogude kaardistus valitud süsteemide ulatuses
  • API-de ja olemasolevate liideste ülevaade
  • Nõuete lähtekirjeldus arendajale
  • Riskide ja eelduste loend

Liidesekirjeldus

Ühe liidese tehniline kirjeldus sellisel tasemel, et selle järgi saab ehitada ja vastu võtta. Sobib nii sisemisele arendusele kui ka hanke lisaks.

Mis sisaldub:

  • OpenAPI 3.x kontrakt koos autentimise ja veakäsitlusega
  • Väljade vastendus ja teisendusreeglid
  • Sünkroonsus, sagedus, kvoodid ja versioneerimine
  • Vastuvõtu alused ja testistsenaariumid

Üks liidestus otsast lõpuni

Kirjeldusest töötava liideseni ja sealt üleandmiseni. Töö teeb algusest lõpuni sama analüütik-arendaja, mistõttu kirjeldus ja teostus ei lähe lahku.

Mis sisaldub:

  • Liidese teostus kokkulepitud kirjelduse alusel
  • Automaattestid kokkulepitud ulatuses
  • Logimine ja seire, et tõrked oleksid hiljem loetavad
  • Juurutusjuhend ja tehniline üleandmine

Integratsioonide ülevaatus

Pilk sellele, mis teil täna juba liigub. Sobib siis, kui liideseid on aastate jooksul juurde tekkinud ja tervikpilti ei ole enam kellelgi.

Mis sisaldub:

  • Olemasolevate liideste inventuur ja omanikud
  • Dubleerivad ja katkised vood
  • Sõltuvuste kaart koos riskikohtadega
  • Soovitused korrastamise järjekorra kohta

Kirjeldage oma olukorda ühe sõnumiga.

Kirjutage, millised süsteemid teil on ja mis nende vahel täna käsitsi liigub. Räägime ulatuse läbi ja saadame kirjaliku pakkumuse. Vastame ühe tööpäeva jooksul, esimene arutelu on tasuta.