A GitHub integrációval a fejlesztői munkát, vagyis a pull requesteket (PR) közvetlenül a QlickCRM adatlapjaihoz kapcsolhatod. Így a CRM-ben látod, melyik ügyhöz milyen PR tartozik, és hol tart éppen.
Mi az a GitHub integráció?
Az integráció a GitHub pull requestjeit összekapcsolja az adatlapokkal. Az érintett adatlapokon egy GitHub fülön látod a hozzájuk tartozó PR-eket: a státuszukat (nyitott, piszkozat, egyesített, lezárt), a branch-et, a szerzőt és a hozzászólások számát, és egy kattintással át is ugorhatsz a PR-re a GitHubon. A PR-ek kétféleképpen kerülnek az adatlapra: automatikusan (a PR szövege alapján) vagy manuálisan (a PR linkjével).
Beállítás (rendszergazda)
Az integrációt a rendszergazda kapcsolja be:
- Menj az Integrációk menü GitHub oldalára.
- Kattints a Csatlakozás gombra. A rendszer átirányít a GitHubra, ahol telepítened kell a QlickCRM GitHub alkalmazását a kívánt GitHub-fiókra és repókra.
- Visszatérve megjelenik a csatlakoztatott fiók. Itt két dolgot állíts be:
- Modulok: mely modulok adatlapjaihoz kapcsolódhatnak pull requestek.
- Aktív repók: kapcsolóval engedélyezd azokat a repókat, amelyek PR-jeit figyelni szeretnéd. Csak az aktív repók PR-jei kapcsolhatók össze (az automatikus és a manuális mód esetén is).
Automatikus összekapcsolás
Ha egy pull request címében vagy leírásában szerepel egy adatlap kulcsa, a rendszer automatikusan összekapcsolja a PR-t az adott adatlappal. A kulcs a rendszeretek adatlap-kulcs előtagját követi, például OBJ-123 (a kötőjel el is hagyható, az OBJ 123 is működik).
A párosítás csak akkor jön létre, ha:
- a pull request engedélyezett (aktív) repóból származik, és
- az érintett adatlap a beállításnál kiválasztott modulok egyikébe
💡 Tipp: írd be a PR címébe vagy leírásába az adatlap kulcsát (pl. OBJ-123), és az összekapcsolás magától létrejön. A PR státusza (nyitott, egyesített, lezárt) ezután automatikusan frissül az adatlapon.
Pull request manuális hozzáadása
Ha egy PR nem tartalmazza az adatlap kulcsát, kézzel is hozzárendelheted:
- Nyisd meg az adatlapot, és válts a GitHub fülre.
- Kattints a PR hozzáadása gombra.
- Illeszd be a pull request teljes linkjét (például https://github.com/tulajdonos/repo/pull/123), majd kattints a Hozzáadás gombra.
A manuálisan hozzáadott PR a helyén marad akkor is, ha a PR szövege nem hivatkozik az adatlapra.
ℹ️ Csak engedélyezett (aktív) repóból származó pull requestet lehet felvenni, és a linknek valódi PR-címnek kell lennie (.../pull/szám formátum). Ha a repo nincs engedélyezve vagy a link hibás, a rendszer hibát jelez.
Mit látsz a GitHub fülön?
A pull requestek repónként csoportosítva jelennek meg. Minden PR-nél látod:
- a státuszt: nyitott, piszkozat, egyesített vagy lezárt (szín és címke jelzi),
- a PR számát és címét (kattintásra megnyílik a GitHubon),
- a branch-et (melyikből melyikbe megy),
- a szerzőt,
- a hozzászólások számát.
A fül tetején kereshetsz (cím, PR-szám vagy szerző szerint) és szűrhetsz státuszra, így nagyobb projektben is gyorsan megtalálod a keresett PR-t.
Összefoglalás
A GitHub integrációval a pull requestek és az adatlapok egy helyen találkoznak: a fejlesztői állapot ott látszik, ahol az ügyet is kezeled. A PR-ek automatikusan csatlakoznak, ha a szövegük hivatkozik az adatlap kulcsára, a többit pedig a GitHub fülön, a PR linkjével manuálisan is hozzáadhatod.