Gå til innhold
Norsk – Norge
ℹ️ Finner du ikke svaret? Opprett en sak her
Logg inn i Tidsbanken
  • Det finnes ingen forslag fordi søkefeltet er tomt.

Slik oppretter du API-token for Tidsbanken i Xledger

Velg riktige GraphQL-tilganger for ansatte, prosjekter, prosjektoppgaver, tidstyper og timer.

For at Tidsbanken skal kunne hente grunnlagsdata fra Xledger og overføre timer, må integrasjonen bruke et API-token med riktige GraphQL-tilganger.

Før du begynner

  • Du må ha tilgang til å opprette API-tokens i Xledger.
  • Opprett tokenet på firmaet og nivået som integrasjonen skal hente data fra.
  • Bruk et eget token for Tidsbanken, slik at tilgangen kan endres eller tilbakekalles uten å påvirke andre integrasjoner.

Gi bare tilgangene som er beskrevet nedenfor. Det er ikke nødvendig å velge select all.

Slik oppretter du API-tokenet

  1. Logg inn i Xledger.
  2. Gå til Administrasjon > Tilgangskontroll > GraphQL > API Tokens.
  3. Velg New API Token.
  4. Skriv inn en beskrivelse, for eksempel Tidsbanken-integrasjon.
  5. Velg tilgangene under.
  6. Velg Generate token.
  7. Kopier tokenet og legg det inn i konfigurasjonen for Xledger-integrasjonen i Tidsbanken.

Kopier tokenet når det blir opprettet, og oppbevar det sikkert. Ikke send tokenet i e-post eller legg det i et supportsvar.

Tilganger tokenet må ha

Common

  • Address: Read
  • Contact: Read
  • ObjectValue: Read

Human Resources

  • Employee: Read

Project Management

  • Project: Read
  • ProjectTask: Read
  • TimeType: Read
  • Timesheet: Read og Write

Timesheet må ha både Read og Write. Write brukes til å overføre timer. Read er også nødvendig for at timeflyten skal fungere som forventet.

Hvorfor tilgangene er nødvendige

  • Address og Contact brukes til kontakt- og adresseopplysninger på ansatte.
  • ObjectValue brukes blant annet til å hente prosjektgrupper og tilhørende registerverdier. Det finnes ikke en egen ProjectGroup-tilgang som skal velges.
  • Employee brukes til å hente og koble ansatte.
  • Project brukes til å hente prosjekter.
  • ProjectTask brukes til å hente prosjektoppgaver, som blir aktiviteter i Tidsbanken.
  • TimeType brukes til å koble produkt-ID i Tidsbanken mot riktig tidstype i Xledger.
  • Timesheet brukes til å lese og overføre timer.

Ingen av de andre objektene skal ha skrivetilgang.

Kontroller oppsettet

Når tokenet er lagret i integrasjonen, kjører du arbeidsflyten manuelt. Kontroller at Tidsbanken kan hente ansatte, prosjekter, prosjektgrupper, prosjektoppgaver og tidstyper. Kjør deretter en kontrollert test med én timelinje.

Hvis tokenet blir godkjent, men enkelte data mangler, kontrollerer du at alle objektene over har riktig tilgang, og at tokenet er opprettet på riktig nivå i Xledger.

Se også forutsetningene for prosjekter og prosjektoppgaver i Xledger.