For teknikere og konsulenter¶
Som tekniker eller konsulent svarer du på hvorfor ePortal oppfører seg som det gjør. Du setter opp integrasjoner, kobler eksterne systemer, feilsøker dataflyt og leverer prosjektoppsett til nye kunder. Du må forstå både UI, API, datamodell og driftsmiljø.
Tilgang: Konsulenter får tilgang gjennom Konti sin support-prosess, ofte gjennom impersonering av en tenant-administrator eller via dedikert konsulent-bruker per kunde.
Dine viktigste oppgaver¶
| Du vil... | Gå til |
|---|---|
| Sette opp integrasjon mot PowerOffice Go | PowerOffice Go |
| Sette opp integrasjon mot Visma.net | Visma.net |
| Sette opp Visma Business Classic | Visma Business Classic |
| Sette opp NXT-integrasjon | Visma Business NXT |
| Sette opp Trimble-integrasjon | Trimble |
| Sette opp Digpro-integrasjon | Digpro |
| Konfigurere Microsoft 365 / Outlook addin | Microsoft 365 |
| Sette opp Freshdesk-integrasjon | Freshdesk |
| Sette opp ny integrasjon i Konti Connect | Sette opp ny integrasjon |
| Feilsøke en integrasjon som ikke synker | Konti Connect — Se integrasjonsstatus |
| Lese kjøringslogg for integrasjon | Lese kjøringslogg |
| Rotere OAuth-token | Rotere OAuth-token |
| Forstå hva en innstilling gjør | Bla i Innstillinger |
| Connect API for tredjeparts-integrasjon | Connect API-dokumentasjon |
Datamodell og arkitektur¶
For dyp teknisk innsikt — datamodell, API-endepunkter, konfigurasjon — pek mot kildekoden:
| Tema | Hvor |
|---|---|
| Database-skjema | docs/database_scripts/dbscript.sql (internt) |
| API-endepunkter (intern fullversjon) | Swagger på <eportal-url>/swagger (krever Basic auth) |
| Connect API (eksternt) | Connect API-dokumentasjon |
| Arkitektur og prosjektplaner | docs/ i kildekode-repoet (intern dokumentasjon) |
| Release notes — for konsulent og tekniker | Hva er nytt |
Det første er interne tekniske dokumenter i kildekode-repoet og ikke en del av denne håndboken. De er for Konti-ansatte og utviklere som har tilgang til repoet, ikke sluttbrukere.
Vanlige feilsøkings-utgangspunkter¶
| Symptom | Sannsynlige årsaker | Hvor å se |
|---|---|---|
| Integrasjon synker ikke | Utløpte tokens, endret API-kontrakt, nettverk | Lese kjøringslogg + integrasjonsspesifikk side |
| Bruker har feil meny | Brukerlevel, modul-tilgang, custom menu-konfigurasjon | Brukere + Menyadministrasjon |
| Innstillingsendring tar ikke effekt | Cache, ikke-lagret, bakgrunnsjobb, browserinnstilling | Audit-log + browser dev tools |
| Data ser ut til å mangle | Datatilgang-regler, soft delete, periode-låsing | Datatilgang + relevante data-tabeller |
| Bakgrunnsjobb feiler | Connection string, timeout, datafeil | Konti Connect — Lese kjøringslogg + wv_BackgroundJob-tabellen |
Hva du må huske¶
- Aldri test i produksjon hvis du kan unngå det. Konti har dedikerte test-/sandkasse-miljøer per kunde for større konfigurasjonsendringer.
- Dokumenter konfig-endringer. Audit-log fanger systemets endringer, men ikke hvorfor. Skriv inn forklaring i ticketen eller i en intern note.
- Ikke lagre hemmeligheter i klartekst. Tokens, passord og API-nøkler skal i sikker lagring (Azure Key Vault, kunde-spesifikk secrets-katalog) — ikke i håndboken, ikke i ticket-tekst, ikke i kommentar-felt.
- GDPR og databeskyttelse. Eksport av kundedata for feilsøking krever samtykke fra kunden. Slett dataeksporten etter at saken er lukket.
Vanlige problemer¶
"Jeg skjønner ikke hvorfor en innstilling oppfører seg slik"¶
Steg-for-steg:
- Les håndbok-siden for innstillingen — "Når trer endringen i kraft" og "Avhengigheter" forklarer ofte 80 % av forvirring
- Sjekk audit-log for hva som er endret nylig
- Sjekk om det er en bakgrunnsjobb som må kjøre
- Reproduser med ny tom test-bruker for å eliminere lokal cache/sesjon-tilstand
- Hvis fortsatt uklart: les komponentkoden i ePortal-frontend (sti er i håndbok-sidens "For utviklere"-seksjon når den finnes)
"Integrasjonen feiler med 401"¶
Vanligst: utløpt token. Mange integrasjoner bruker OAuth/OBO-flow med refresh — sjekk at refresh fungerer. Andre årsaker: rotert hemmelighet (Konti har byttet client-secret), endret scope/permission på integrasjonen, eller at hele oppsettet er gått ut av sync med eksternsystem. Logger viser nesten alltid hvilken av disse.
"Tenant-data ser anonymisert/maskert ut"¶
Du har sannsynligvis logget på i et test-/sandkasse-miljø som tilbakestilles fra et anonymisert produksjons-snapshot. Sjekk URL og miljø-banner. Hvis du er i produksjon og ser maskert data: kontakt Konti — kan være konfigurasjonsfeil.
Trenger du mer hjelp?¶
- For dypere teknisk dokumentasjon: kildekoden under
docs/er din venn - For arkitektur-spørsmål: snakk med plattform-eier hos Konti
- For sikkerhets-spørsmål: bruk dedikert sikkerhets-kanal, ikke standard support
- Hvis du finner en bug: rapporter med fullstendig reproduksjonsoppskrift, miljø-detaljer og forventet vs. faktisk adferd