Klara för utvecklare

Översikt

GitHub Projects-integrationen låter Pro-användare visa och hantera sina GitHub Project-objekt direkt i Klaras Eisenhower-matris. Dina GitHub-ärenden visas som uppgifter, komplett med deadline, prioritet och insatsmappningar från dina projektfält. När du slutför en uppgift i Klara uppdateras statusen i GitHub automatiskt.

Krav:

• Pro-prenumeration
• GitHub-konto med åtkomst till GitHub Projects V2

Vad du kan göra:

• Ansluta personliga och organisatoriska GitHub Projects
• Mappa projektfält till Klaras deadline, prioritet och insats
• Visa GitHub-ärenden i din Eisenhower-matris
• Slutföra uppgifter och få statusen uppdaterad i GitHub
• Lägga till slutförandeanteckningar som kommentarer på GitHub-ärenden

Ansluta GitHub

Steg 1: Starta anslutningen

1. Gå till Inställningar (klicka på din avatar uppe till höger)
2. Scrolla till avsnittet GitHub-integration
3. Klicka på Anslut GitHub

Steg 2: Auktorisera Klara

Du omdirigeras till GitHub för att auktorisera Klara. Appen begär följande behörigheter:

• Läsåtkomst till projekt - Krävs för att hämta dina projektobjekt
• Läsåtkomst till din profil - Krävs för att identifiera ditt GitHub-konto

Klicka på Authorize för att bevilja dessa behörigheter och återvända till Klara.

Steg 3: Installera GitHub-appen

Du måste installera Klara GitHub-appen för att använda integrationen:

1. Besök Klara GitHub App-installationssidan
2. Klicka på Install
3. Välj ditt personliga konto eller organisation
4. Välj vilka repositorier du vill ge åtkomst till (eller välj alla)
5. Klicka på Install för att bekräfta

GitHub-appen krävs för alla GitHub-integrationsfunktioner:

• Åtkomst till projektobjekt och fält
• Läsa ärendeinnehåll från dina repositorier
• Skriva statusuppdateringar vid slutförande av uppgifter
• Posta slutförandekommentarer på ärenden

Obs: Du måste installera GitHub-appen på varje konto (personligt eller organisation) som äger projekt du vill ansluta.

Välja ett projekt

Efter att ha anslutit GitHub och installerat appen kan du välja vilket projekt som ska synkroniseras:

1. I avsnittet GitHub-integration, klicka på Välj projekt
2. Bläddra bland dina projekt grupperade efter ägare (personliga och organisationer)
3. Klicka på ett projekt för att välja det
4. Konfigurera fältmappningar (se nästa avsnitt)
5. Klicka på Anslut för att börja synkronisera

Obs: Du kan bara ansluta ett GitHub Project per Klara-tavla. För att hantera flera projekt, skapa separata tavlor för varje.

Konfigurera fältmappningar

Fältmappningar talar om för Klara hur dina GitHub Project-fält ska läsas. Detta avgör hur uppgifter visas i Eisenhower-matrisen.

Deadline-fält

Mappa ett Date-fält från ditt projekt för att ställa in uppgiftsdeadlines.

Exempel: Om ditt projekt har ett "Due Date"-fält, välj det som deadline-mappning. Uppgifter med ett förfallodatum visar den deadlinen i Klara.

Prioritetsfält

Mappa ett fält för att bestämma uppgiftsprioritet (skala 1-5).

Alternativ 1: Numeriskt fält Om du använder ett numeriskt prioritetsfält (1-5), välj det direkt.

Alternativ 2: Single-select-fält Om du använder etiketter som "P0", "P1", "P2", etc., mappa varje värde till en prioritetsnivå:

Insatsfält

Mappa ett fält för att bestämma uppgiftsinsats (skala 1-5). Detta påverkar urgensberäkningen.

Alternativ 1: Numeriskt fält Om du använder ett numeriskt insats-/storleksfält (1-5), välj det direkt.

Alternativ 2: Single-select-fält Om du använder t-shirtstorlekar eller story points, mappa varje värde:

Statusfält

Mappa ett Single-select-fält som representerar ditt arbetsflödesstatus. Detta krävs för skrivfunktionen.

Konfigurera slutförandestatusar: Välj vilka statusvärden som representerar en slutförd uppgift. När en uppgift har en av dessa statusar visas den som slutförd i Klara.

Exempel på slutförandestatusar:

• Done
• Closed
• Shipped
• In Review (om du anser granskning som slutförd)

Hur GitHub-objekt visas i Klara

När det är konfigurerat visas dina GitHub-ärenden som uppgifter i Klara med en GitHub-ikonindikator.

Vad som synkas från GitHub

Vad som INTE synkas

• Pull Requests (endast Issues)
• Utkast-ärenden
• Stängda ärenden
• Ärendekommentarer (förutom slutförandeanteckningar du lägger till)

Automatisk kvadrantplacering

GitHub-uppgifter placeras i kvadranter baserat på dina fältmappningar:

1. Deadline bestämmer urgens (närmare deadlines = mer brådskande)
2. Prioritet bestämmer viktighetsdimensionen
3. Insats påverkar urgensberäkningen (högre insats = behöver börja tidigare)

Uppgifter utan deadline eller prioritet kan hamna i "Kanske"- eller "Skippa"-kvadranterna.

Slutföra uppgifter

När du slutför en GitHub-uppgift i Klara uppdateras statusen i GitHub.

Hur du slutför

1. Klicka på en GitHub-uppgift för att expandera den
2. Klicka på knappen Slutför
3. Välj målstatus från rullgardinsmenyn (t.ex. "Done")
4. Lägg eventuellt till en slutförandeanteckning
5. Klicka på Markera som slutförd

Vad som händer

1. Ärendets statusfält uppdateras i GitHub
2. Om du lade till en anteckning postas den som en kommentar på ärendet
3. Uppgiften flyttas till slutförd status i Klara
4. Andra teammedlemmar ser uppdateringen i GitHub

Krav för skrivning

För att statusuppdateringar ska fungera:

• GitHub-appen måste vara installerad på kontot som äger projektet
• Ditt konto måste ha skrivåtkomst till projektet
• Statusfält måste vara konfigurerat i fältmappningar

Synkronisering och uppdatering

Automatisk synkronisering

GitHub-objekt synkroniseras automatiskt:

• När du öppnar Klara
• När ändringar sker via webhooks
• Var 15:e minut i bakgrunden

Manuell uppdatering

Klicka på uppdateringsknappen bredvid GitHub-tavlans märke för att tvinga en synkronisering. Detta är användbart om:

• Du just gjorde ändringar i GitHub
• Den automatiska synkroniseringen verkar fördröjd
• Du vill verifiera det senaste tillståndet

Synkroniseringsindikator

Synkroniseringsindikatorn visar:

• Senast synkad tid - När data senast hämtades
• Synkronisering pågår - När den aktivt hämtar
• Feltillstånd - Om synkroniseringen misslyckades (med alternativ att försöka igen)

Koppla från GitHub

För att koppla från ditt GitHub-konto:

1. Gå till Inställningar
2. I avsnittet GitHub-integration, klicka på Koppla från
3. Bekräfta frånkopplingen

Detta tar bort:

• Din GitHub-anslutning
• Alla projektanslutningar
• Cachade GitHub-objekt

Dina uppgifter i GitHub förblir oförändrade.

Felsökning

"Kan inte komma åt vissa objekt"

Detta meddelande visas när Klara inte kan komma åt vissa ärenden. Vanliga orsaker:

Saknad repositorieåtkomst: GitHub-appen kanske inte är installerad på alla repositorier i ditt projekt. Installera appen på de saknade repositorierna eller ge åtkomst till "Alla repositorier".

Privat repositorie: Se till att GitHub-appen har åtkomst till repositoriet som innehåller ärendena.

"GitHub-appen kanske inte har skrivåtkomst"

När slutförande av uppgifter misslyckas:

1. Verifiera att GitHub-appen är installerad på kontot som äger projektet
2. Kontrollera att appen har "Issues: Read & Write"-behörighet
3. Se till att ditt konto har skrivåtkomst till projektet

"Rate limit överskriden"

GitHub begränsar API-förfrågningar. Om du når gränsen:

1. Vänta på återställningstiden som visas i felet
2. Minska frekvensen av manuella uppdateringar
3. Gränsen återställs varje timme

Uppgifter visas inte

Om förväntade ärenden saknas:

1. Verifiera att de är öppna (inte stängda)
2. Verifiera att de inte är utkast
3. Verifiera att de är Issues (inte PRs)
4. Kontrollera att de tillhör det anslutna projektet
5. Försök med en manuell uppdatering

Fel kvadrantplacering

Om uppgifter visas i oväntade kvadranter:

1. Kontrollera att fältmappningar är korrekta
2. Verifiera att ärendet har värden för mappade fält
3. Uppgifter utan deadline/prioritet hamnar som standard lägre

Status uppdateras inte i GitHub

Om slutförande av uppgifter inte uppdaterar GitHub:

1. Verifiera att GitHub-appen är installerad med skrivbehörigheter
2. Kontrollera att du har skrivåtkomst till projektet
3. Verifiera att statusfält är konfigurerat i mappningar
4. Kontrollera felmeddelanden i slutförandedialogen

Bästa praxis

Fältmappningsstrategi

Håll det enkelt:

• Börja med bara deadline- och statusmappningar
• Lägg till prioritets-/insatsmappningar när du etablerat ett arbetsflöde

Använd konsekventa värden:

• Definiera tydliga betydelser för prioritetsnivåer
• Dokumentera din mappning i teamets wiki

Projektorganisation

Ett projekt per tavla: Eftersom varje Klara-tavla ansluter till ett GitHub Project, organisera därefter:

• Arbetstavla → Arbets-GitHub Project
• Personlig tavla → Personligt GitHub Project

Filtrera efter status: Använd statusfiltrering för att fokusera på aktivt arbete och dölja slutförda objekt.

Teamarbetsflöden

Delad förståelse: Se till att teammedlemmar förstår:

• Vad prioritetsnivåer betyder
• Vilka statusar som räknas som "slutförd"
• När man ska slutföra i Klara vs. GitHub

Slutförandeanteckningar: Använd slutförandeanteckningar för att dokumentera:

• Hur ärendet löstes
• Eventuell uppföljning som behövs
• Referenser till relaterade PRs

Säkerhet och integritet

Tokenlagring

Din GitHub OAuth-token är:

• Krypterad med AES-256-GCM före lagring
• Lagrad i Klaras säkra databas
• Aldrig exponerad för webbläsaren efter initial anslutning
• Raderad när du kopplar från

Dataåtkomst

Klara kommer endast åt:

• Projektfält och objekt du explicit ansluter
• Ärende-metadata (inte fullständigt repositorieinnehåll)
• Din GitHub-profil (användarnamn, avatar)

Återkalla åtkomst

För att helt återkalla Klaras åtkomst:

1. Koppla från i Klara-inställningar
2. Gå till GitHub → Settings → Applications
3. Hitta Klara och klicka på Revoke
4. Avinstallera GitHub-appen från ditt konto/organisationsinställningar

Vanliga frågor

Kan jag ansluta flera GitHub Projects?

Varje Klara-tavla kan ansluta till ett GitHub Project. Skapa flera tavlor för att hantera flera projekt.

Delas GitHub-integrationen med samarbetspartners?

Nej. GitHub-integrationen är personlig för varje användare. Varje person måste ansluta sitt eget GitHub-konto för att se sina egna GitHub Projects i Klara. Samarbetspartners på ett delat Klara-projekt kan inte se varandras anslutna GitHub-data.

Kommer ändringar jag gör i GitHub att visas i Klara?

Ja. Ändringar synkroniseras automatiskt via webhooks eller vid nästa manuella/automatiska uppdatering.

Kan jag skapa GitHub-ärenden från Klara?

Inte för närvarande. Du skapar ärenden i GitHub, och de visas i Klara efter synkronisering.

Fungerar detta med GitHub Enterprise?

Inte för närvarande. Endast GitHub.com stöds.

Vad händer med GitHub-uppgifter om jag avslutar min prenumeration?

Du förlorar åtkomst till GitHub-integrationen. Uppgifter förblir oförändrade i GitHub. Om du prenumererar igen, återanslut ditt projekt för att återställa integrationen.