timer.enlight.no baserer alle dataene sine på tabeller i Zoho Reports.

Appen bruker en PostgreSQL-database i bunnen for å forbedre ytelsen og slippe å gjøre spørringer mot Zoho Reports hver gang noe endres.

Det er konfigurasjonsparametre for hvor data hentes fra, som leses fra "environment variables" når appen starter.

• ZOHO_DB: Database i Zoho Reports, for eksempel "Timeregistrering".
• ZOHO_TABLE_PROJECTS: Tabell for prosjekter/delmål/aktiviteter, for eksempel "Aktivitet".
• ZOHO_TABLE_USERS: Tabell for brukere, for eksempel "Kontakt".
  
  

Appen på timer.enlight.no bruker følgende:

• Database: Timeregistrering, https://reports.zoho.com/ZDBDataSheetView.cc?DBID=1319218000000211454
• Prosjekter: Aktivitet, https://reports.zoho.com/ZDBDataSheetView.cc?DBID=1319218000000211454&OBJID=1319218000000467242
  • Fylles inn via Viktors Google Sheet-mal for Skattefunn.
  • Alle feltene bortsett fra datoer og aktiv er påkrevd.
    • Aktiv settes til "true" som standard.
    • Startdato settes til dagens dato om den ikke er gitt.
    • Sluttdato settes noen år inn i fremtiden om den ikke er gitt.

  • Tilpasses til appens behov via en "Query table", app_query_projects: https://reports.zoho.com/ZDBDataSheetView.cc?DBID=1319218000000211454&OBJID=1319218000000467350

    SELECT

    "ProsjektNr" project_id,

    "Prosjekt" project_name,

    "DelmålNr" goal_id,

    "Delmål" goal_name,

    "AktivitetsNr" task_id,

    "Aktivitet" task_name,

    date("StartDato") "start",

    date("SluttDato") "end",

    "Aktiv" active

    FROM "Aktivitet"
• Brukere: Kontakt, https://reports.zoho.com/ZDBDataSheetView.cc?DBID=1319218000000211454&OBJID=1319218000000401312
  • Appen krever disse kolonnene: Navn, E-post, Prosjektnummer, Roller.
  • En linje per prosjekt.
  • Vanlige brukere trenger ingen roller.
  • Eksport av time-CSV til Zoho Reports krever rolle "export".
  • Tilgang til å se brukere (/admin/users) og prosjekter (/admin/projects) krever rolle "admin, superuser".

Registrering eller endring av bruker

For å legge til ny bruker går man til "Brukere" i menyen og trykker "Ny bruker". For å endre en eksisterende bruker trykker man på pennen på høyresiden i listen over brukere.

Nye brukere får automatisk tilsendt en e-post med lenke for å sette nytt passord. (Dette blir også bekreftet i meldingen du får når en ny bruker er registrert OK). Endring av bruker fører ikke til noen e-postutsending.

Endring og oppdatering av prosjekt, delmål, aktivitet

Data om prosjekt, delmål og aktiviteter ligger i en egen tabell hvor opprinnelsen er Viktors egne maler for Skattefunn-prosjekter i Google Sheets.

Hvert prosjekt, delmål og aktivitet må ha en unik id hver. Dette er for å kunne synkronisere endringer til databasen som ligger til grunn for appen.

Når data legges til eller endres i Zoho Reports så må man oppdatere appen på https://timer.enlight.no/admin/projects "Oppdater".

Eksport av registrerte timer

Man kan se på alle registrerte timer via https://timer.enlight.no/admin/hours og eksportere CSV eller JSON.

Eksport av registrerte timer til Zoho Reports

Appen har egen funksjonalitet for å la Zoho Reports selv hente data regelmessig.

https://timer.enlight.no/hours/export er API-endepunktet og krever to ting:

1. Brukerkonto med rolle "export".
2. Basic Authentication-streng i Authorization header.

$ base64 < <(printf 'epost:passord') | xargs echo Basic

Zoho Reports henter opplysninger fra timer.enlight.no hver time og oppdaterer tabellen "timer": https://reports.zoho.com/ZDBDataSheetView.cc?DBID=1319218000000211454&OBJID=1319218000000443030