Toki är ett verktyg för tidrapportering som integrerar med Milltime och Azure DevOps. Denna manual beskriver hur du använder applikationen för att rapportera din tid.
- Komma igång
- Logga in
- Tidrapportering med Milltime
- Använda timern
- Skapa tidspost utan timer
- Redigera och ta bort tidsposter
- Visa statistik och sammanfattning
- Pull Requests (Azure DevOps)
- Hantera repositories
- Notifikationer
- Snabbkommandon
- Vanliga frågor
Toki är en webbapplikation som du når via din webbläsare. Applikationen kan även installeras som en app på din dator eller mobil för snabbare åtkomst och push-notifikationer.
- Öppna Toki i Chrome, Edge eller Safari
- Klicka på installationsikonen i adressfältet (eller välj "Installera app" i webbläsarmenyn)
- Bekräfta installationen
- Gå till Tokis webbadress
- Klicka på "Sign in with Azure"
- Logga in med ditt företagskonto
För att kunna tidrapportera behöver du även logga in på Milltime:
- Navigera till Milltime i sidomenyn (timer-ikonen)
- Fyll i ditt Milltime-användarnamn och lösenord
- Klicka på "Sign in"
Din Milltime-session sparas i din webbläsare så att du inte behöver logga in varje gång.
Milltime-sidan är din huvudsakliga arbetsyta för tidrapportering. Här kan du:
- Se alla dina tidsposter
- Starta och stoppa timers
- Skapa, redigera och ta bort tidsposter
- Se statistik över arbetad tid
När du öppnar Milltime-sidan ser du:
- Veckans statistik (övre delen): Visar hur många timmar du arbetat, kvarvarande tid och flextid
- Tidsposter (huvudområdet): Lista över dina tidrapporter grupperade per dag
Timern är det enklaste sättet att registrera tid. Du startar en timer när du börjar arbeta och sparar den när du är klar.
Via snabbkommando
- Tryck
Ctrl+K(ellerCmd+Kpå Mac) - Välj "Start empty timer"
Via timerhistorik
- Starta en timer via snabbkommando (
Ctrl+K) - I dialogen som öppnas kan du klicka på klockikonen för att visa historik
- Dubbelklicka på en tidigare post för att starta en timer med samma inställningar
När en timer är aktiv visas en flytande timer-widget i nedre högra hörnet. Denna widget syns på alla sidor i applikationen så länge timern är igång.
- Tiden visas i timer-widgeten
- Du kan lägga till en anteckning direkt i fältet
- Klicka på penna-ikonen för att ändra projekt/aktivitet
- Minimera widgeten genom att klicka på minimera-knappen
- Klicka på spara-knappen (diskett-ikon) i timer-widgeten
- Om du inte valt projekt/aktivitet ännu:
- Välj Projekt från listan (sökbar)
- Välj Aktivitet (t.ex. "Systemutveckling")
- Lägg till en anteckning som beskriver arbetet
- Klicka på "Save"
Tidsposten synkas automatiskt till Milltime.
Om du vill ta bort timern utan att spara:
- Klicka på papperskorgs-ikonen i timer-widgeten
- Bekräfta borttagningen
Du kan även skapa tidsposter direkt utan att använda timern:
- Gå till Milltime-sidan
- Klicka på "New entry"-knappen
- Fyll i formuläret:
- Projekt: Välj från listan
- Aktivitet: Välj aktivitetstyp
- Anteckning: Beskriv arbetet
- Datum: Välj dag
- Tid: Ange start- och sluttid ELLER totalt antal timmar
- Klicka på "Create"
- Hitta tidsposten i listan
- Klicka på penna-ikonen till höger om posten
- Ändra önskade fält:
- Datum
- Anteckning
- Start- och sluttid
- Totalt antal timmar
- Klicka utanför formuläret eller tryck Enter för att spara
- Klicka på penna-ikonen för att gå till redigeringsläge
- Klicka på papperskorgs-ikonen
- Bekräfta borttagningen
Tidsposter som tillhör en låst vecka eller månad kan inte redigeras. Dessa visas med en lås-ikon.
I övre delen av Milltime-sidan visas:
- Arbetade timmar: Hur mycket du arbetat denna vecka
- Kvarvarande timmar: Hur mycket tid som återstår enligt din arbetstidsplan
- Flextid: Din ackumulerade flextid (plus eller minus)
- Klicka på datumväljaren högst upp
- Välj ett fördefinierat intervall:
- Denna vecka
- Denna månad
- Detta år
- Senaste 30 dagarna
- Senaste 365 dagarna
- Eller välj ett anpassat datumintervall
När du väljer ett längre datumintervall visas:
- Totalt antal timmar
- Antal projekt
- Cirkeldiagram: Fördelning av tid per projekt
- Stapeldiagram: Daglig fördelning av tid
Aktivera "Merge entries" för att kombinera tidsposter med samma projekt, aktivitet och anteckning på samma dag.
Toki kan visa dina pull requests från Azure DevOps och hjälpa dig att generera tidsrapporteringsnoteringar.
- Klicka på PR-ikonen i sidomenyn
- Se alla aktiva pull requests från dina följda repositories
Använd filtreringsknapparna:
- My PRs: Visa endast PRs där du är författare
- Reviews: Visa PRs där du är granskare
- Blocking: Visa PRs som väntar på din granskning
Klicka på en PR för att se:
- Beskrivning och kommentarer
- Kopplade work items
- Granskningsstatus
I PR-detaljvyn finns knappar för att kopiera färdig text för tidsrapportering:
- Review: Genererar text för kodgranskning (inkluderar "[CR]")
- Develop: Genererar text för utvecklingsarbete
Texten inkluderar work item-nummer och titel i formatet:
#123 #456 - [CR] Implementera ny funktion
För att följa pull requests behöver du lägga till repositories.
- Gå till Repositories i sidomenyn
- Klicka på "Add repository"
- Fyll i:
- Organisation: Azure DevOps-organisationen
- Projekt: Projektnamnet
- Repository: Repository-namnet
- PAT-token: Din Personal Access Token (se nedan)
- Klicka på "Add"
- Gå till Azure DevOps
- Klicka på ditt profilikon → Personal access tokens
- Klicka på "New Token"
- Ge den ett namn och välj nödvändiga rättigheter (inte helt säker på exakt vilka som används idag)
- Kopiera tokenen
På repositories-sidan kan du:
- Följ repository: Följ ett repository
- Avfölja repository: Sluta följa ett repository
- Notifikationsinställningar: Konfigurera vilka aviseringar du vill ha för ett repository
Toki kan skicka notifikationer när saker händer med dina pull requests.
- PR stängd: När en pull request stängs
- Ny tråd: När någon startar en ny kommentarstråd
- Tråd uppdaterad: När någon svarar på en tråd
- Omnämnande: När du blir omnämnd i en kommentar
Per repository:
- Gå till Repositories
- Klicka på klocka-ikonen på repository-kortet
- Aktivera/avaktivera notifikationstyper för:
- Site: Visas i appen
- Push: Skickas som push-notifikation
Per PR:
- Öppna PR-detaljvyn
- Klicka på notifikationsikonen
- Aktivera/avaktivera specifika notifikationstyper
- Klicka på klocka-ikonen i sidomenyn
- Se alla olästa notifikationer
- Klicka på en notifikation för att navigera till relaterad PR
- Markera som läst genom att klicka på bock-ikonen
- Använd "mark all as read" för att markera alla som lästa
- Aktivera "Hide viewed" för att dölja redan lästa notifikationer
För att få push-notifikationer till din enhet (även när Toki inte är öppet) behöver du aktivera detta via notifikationspopupen. Du kan aktivera push-notifikationer på flera enheter, till exempel både din jobbdator och din telefon, om du vill få notiser på båda.
- Klicka på klocka-ikonen i sidomenyn för att öppna notifikationspopupen
- Klicka på kugghjuls-ikonen (Settings) i övre högra hörnet av popupen
- Klicka på "Allow browser notifications" för att ge webbläsaren tillåtelse att skicka notifikationer
- När webbläsaren frågar, klicka "Tillåt" (eller motsvarande på engelska)
- Klicka på "Enable Toki notifications" för att prenumerera på push-notifikationer
- Ange ett namn för enheten (t.ex. "Jobbdator" eller "Mobil") så att du kan identifiera den senare
Tips: Öppna Toki i webbläsaren på din telefon och följ samma steg ovan för att få push-notifikationer direkt till telefonen.
I samma inställningsmeny kan du se alla enheter som är prenumererade på push-notifikationer under "Subscribed devices". För att ta bort en enhet:
- Öppna notifikationsinställningarna (kugghjuls-ikonen)
- Klicka på enheten du vill ta bort
- Enheten tas bort och kommer inte längre att få push-notifikationer
Använd Ctrl+K (eller Cmd+K på Mac) för att öppna snabbkommandomenyn.
| Kommando | Beskrivning |
|---|---|
| Pull requests | Öppna pull requests-sidan |
| Milltime | Öppna tidrapporteringssidan |
| Repositories | Öppna repository-hantering |
| Start empty timer | Starta en timer |
| Save current timer | Spara aktiv timer |
| Edit current timer | Ändra aktiv timers inställningar |
| Search pull requests | Sök bland dina pull requests |