API Dokumentasjon
Bruksmønstre og datautveksling
Det finnes flere måter å ta Tilko i bruk på. Hvilket bruksmønster som passer best for ditt nettselskap, er avhengig av ulike faktorer som
For de fleste er volumet av tilknytningssaker >= 1 MW veldig lite. Det vil dermed ikke være regningssvarende å sette opp tekniske integrasjoner mot Tilko for å flytte data mellom Tilko og egne interne IT-systemer. Tilko er skreddersydd for nettilknytning, har høy byggkvalitet, ivaretar alle pålagte krav til datasikkerhet og informasjonsforvaltning (journal og arkiv), og har persistente URLer (weblenker) som kan brukes til å referere til Tilko saken der hvor det er ønskelig for å bevare relasjon til en annen relatert selskapsintern prosess (f.eks et utbyggingsprosjekt). I tillegg finnes det et dokumentbibliotek i Tilko hvor en bruker selv kan laste ned og flytte PDF varianter av dokumenter (datasett) som er oppstått i tilknytningssaken over til lokale lagringsløsninger hvis det er ønskelig.
<aside> ⚠️
Det aller beste for de aller fleste vil være å bruke Tilko som en selvstendig, fullverdig saksbehandlings-, korrespondanse/journalførings - og dokumentasjons/arkivløsning for tilknytningssaker >= 1 MW . I kombinasjon med aktiv bruk av URL koblinger og filnedlasting ivaretar dette alle bruksbehov på en kostnadseffektiv måte.
</aside>
For å illustrere utvalgsrommet slik at du best er i stand til å finne løsningen som er riktig for deg, har vi under beskrevet tre ulike varianter av bruksmønstre som innebærer integrasjoner i en eller annen form mot Tilko. Disse er ment som eksempler og er valgt hos minst en av våre partnere (eksempelselskap i parentes).
Statnett har en egen spesialtilpasset applikasjon for å håndtere tilknytningssøknader. Denne er satt opp og utviklet over flere år med utgangspunkt i Microsoft's Power Platform. De er også i den unike situasjonen at alle sakenes som Tilko håndterer berører dem, og de må betjene alle kunder over hele landet uavhengig av om de har sin tilhørighet hos en eksisterende Elbits partner (/er Tilko bruker eller ikke). For å håndtere dette har Statnett valgt å teknisk integrere Tilko “steg for steg” inn i sin interne applikasjon “Digital kundereise (DK)”. Teknisk sett bruker løsningen en Azure Event grid hos Statnett som administrerer datadelingen (via Power automate flows) internt hos dem. Et webhook integrasjonsmønster er valgt metode for datautvekslingen mellom Tilko og DK.
For å få løsningen til å fungere i praksis, har det i parallell med etableringen av den tekniske integrasjonen, foregått et standardiseringsarbeid på tvers av ElBits og Statnett for å få begrepsbruk (databeskrivelser) og prosess (aktivitetsflyt) til å henge sammen. Dette har medført at Statnett har måttet gjøre en del endringer og oppdateringer i sine prosedyrer og verktøy (DK) for å tilpasse seg Tilkos løsningsvalg.
Etableringen av integrasjonen har vært et kontinuerlig arbeid gjennom et helt år til en kostnad på ca. 4 millioner.
Elvia har interne policy krav som tilsier at de ønsker å journalføre og arkivere all relevant saksdokumentasjon i sin valgte ERP-løsning, samtidig som de ønsker å fange all kundedialog i sin valgte CRM-løsning. For å få til dette må det være en kontinuerlig overføring av data fra Tilko til Elvias interne løsninger. Elvia benytter ikke sin interne systemportefølje i den første delen av tilkytningsprosessen, men de aktiverer den etter at de to første prosesstegene er gjennomført.
Tilko har ferdige definerte endepunkt som kan benyttes til å løpende overføre data som skapes i løsningen. Disse er dokumentert her; https://tk.elbits.no/swagger-ui. Denne inneholder både “POST” og “GET” endepunkter. De mest relevante for denne type integrasjonsmønstre er “polling” på de REST-baserte “GET”-endepunktene, og spesielt de som er tilgjengelig for å hente saker (GET/gridConnectionRequests).
<aside> ⚠️
Tilko har ferdige definerte endepunkt som kan benyttes til å løpende overføre data som skapes i løsningen. Disse er dokumentert her; https://tk.elbits.no/swagger-ui.
</aside>
Samtidig som en utnytter restapiene for å flytte data inn til sine interne systemer, legges det også opp til URL-referanser inn i andre mye brukte applikasjoner (f.eks Elsmart) slik at saken kan følges gjennom hele forløpet til tross for at saksbehandlingen er delt mellom Tilko og annen eksisterende intern IT.
Denne typen mønstre er mye enklere og bliligere å etablere enn en “full” integrasjon. Elvia hadde en grovt estimert tidsramme for sin porteføljebeslutning på ca. 200 timer.
Hver sak i Tilko har en unikID (gcrID). Denne er tilgjengelig som en del av URL i nettleseren. Tilko URL er persistent, hvilket betyr at den aldri endres, og er derfor veldig egnet som referanse inn i andre relevante systemer. Enkelt og uten merkostnad kan en da referere til Tilko-saken og gjøre oppslag i saksinformasjonen via denne. Hver enkelt kunde har sitt eget brukeradministrasjons-grensesnitt og kan gjennom dette gi tilgang til de internt som har tjenestelig behov for innsyn i saksinformasjonen gjennom å opprette brukere og dele URLer med dem.
Eksempel URL fra testmiljøet: https://tk.test.elbits.no/gcrs/TEST14. “/TEST14” representerer da saksnummeret og URL kan brukes som referanse fra hvilket som helst annet system med kobling til internett. Merk at “TEST” er et prefiks som benyttes i Tilkos testmiljø. I produksjonsmiljøet - der hvor de ekte kundesakene ligger (https://tk.elbits.no/) - har sakene prefiks “ELB”.
I de tilfeller hvor det ikke er naturlig å gi en bruker full tilgang til saksinformasjon pga konfidensialitetshensyn (f.eks markedsensitive data), eller at en av andre grunner ønsker å flytte et spesifikt datasett (f.eks en bestemt søknad fra en bestemt kunde) med en eller et sett med andre brukere (f.eks en analytiker som skal gjøre DF-analyse), kan dette ivaretas gjennom at Tilko tilgjengeliggjør de viktigste datasettene som utveksles mellom tilknyttende nettselskap og sluttkunde som nedlastbare PDF-dokumenter i et eget dokumentbibliotek (fanen “Dokumenter” i Tilko saksbehandlergrensesnitt). Denne funksjonaliteten er også den som er tiltenkt brukt der hvor det blir bedt om å dele informasjon med allmennheten og må lage offentlige varianter av dokumentene som ikke inneholder sensitive saksopplysninger.
Fordi vi vet at det er stort behov for tilknytningsdata til ulike statistikk- og analyseformål (f.eks nettutvikling) har vi også laget et eget API for å hente ut ikke-sensitive, aggregerte data om tilknytningsporteføljen. Den første versjonen av dette er utviklet i samarbeid med NVE og SINTEF som samarbeider i Proglast prosjektet om å lage metoder for prognosering til bruk inn i nettutviklingen. NVE har som ambisjon å publisere disse datasettene som nasjonale effektprognoser i sin PlanNett applikasjon når metoden er klar.
Ved ønske om brukertilgang for eksperimentering rundt egne brukstilfeller - ta kontakt på [email protected].
Innhold