Du musst in deinem Ferndesk-Workspace angemeldet sein, bevor du eine Integration verbindest. Stelle sicher, dass du angemeldet bist und dich in der richtigen Organisation befindest. Wenn du Zugriff auf mehrere Ferndesk-Workspaces hast, wechsle zu dem Workspace, in dem du die GitHub-Verbindung hinzufügen möchtest.
GitHub-Integration
Verbinde dein GitHub-Konto mit Ferndesk, damit Fern dein Code-Repository durchsuchen und verstehen kann, wie Funktionen funktionieren. Das hilft dabei, genauere und relevantere Hilfe-Center-Artikel zu erstellen.
Du benötigst ein GitHub-Konto, um diese Integration abzuschließen. Wenn du noch keines hast, erstelle eines auf der GitHub-Website.
GitHub verbinden
Gehe in deinem Ferndesk-Dashboard in der Seitenleiste auf Integrationen.
Suche die GitHub-Karte und klicke auf Verbinden.
Du wirst zu GitHub weitergeleitet, um die Verbindung zu autorisieren. Melde dich bei deinem GitHub-Konto an, falls du nicht bereits angemeldet bist.
Gewähre Ferndesk die Berechtigung, auf dein GitHub-Konto zuzugreifen. Du kannst auswählen, welche Repositories verbunden werden sollen. Du kannst mehrere Repositories auswählen, wenn dein Projekt mehrere Repos umfasst, zum Beispiel ein Backend und ein Dashboard in getrennten Repositories.
Nach der Autorisierung wirst du zurück zu Ferndesk weitergeleitet. Die GitHub-Integration wird als verbunden angezeigt.
Sobald die Verbindung hergestellt ist, kann Fern dein Code-Repository durchsuchen, um genauere und relevantere Hilfe-Center-Artikel bereitzustellen.
Verbundene Repositories verwalten
Nach der ersten Einrichtung kannst du Repositories hinzufügen oder entfernen, indem du die Einstellungen deiner GitHub-App aufrufst. Gehe zu den Kontoeinstellungen deines GitHub-Kontos, navigiere zu Applications und suche Ferndesk unter deinen installierten Integrationen, um den Repository-Zugriff anzupassen.
Repository- und Branch-Eingrenzung
Wenn Fern dein Code-Repository durchsucht, kann es ein bestimmtes Repository oder einen bestimmten Branch in deinem verbundenen GitHub-Konto ansteuern, anstatt sich nur auf das Standard-Repository zu verlassen.
Wenn du mehrere Repositories verbunden hast, kann sich Fern bei der Analyse auf das relevante Repo konzentrieren. Bei branchspezifischen Aufgaben, etwa beim Prüfen einer noch nicht veröffentlichten Funktion oder eines Pull Requests, kann Fern außerdem einen bestimmten Branch durchsuchen, wenn einer angegeben wird.
Damit Fern ein Repository durchsuchen kann, stelle sicher, dass es in deiner GitHub-Integration verbunden ist. Gehe zu den Kontoeinstellungen deines GitHub-Kontos, navigiere zu Applications und suche Ferndesk, um den Repository-Zugriff hinzuzufügen oder zu entfernen.
Fehlerbehebung
Ich sehe „Authentifizierung erforderlich, um GitHub zu verbinden“
Ich sehe „Die GitHub-OAuth-Organisation stimmt nicht mit der aktiven Sitzung überein“
Das GitHub-Konto oder die Organisation, die du autorisierst, gehört zu einer anderen Organisation als der, bei der du in Ferndesk angemeldet bist. Stelle sicher, dass du:
Im richtigen Ferndesk-Workspace angemeldet bist
Das GitHub-Konto oder die GitHub-Organisation autorisierst, die zu dieser Ferndesk-Organisation gehört
Wenn du eine andere GitHub-Organisation mit einem anderen Ferndesk-Workspace verbinden musst, wechsle zuerst in Ferndesk zu diesem Workspace und verbinde dann GitHub.
Die GitHub-Autorisierungsseite zeigt einen Fehler an
Das kann vorkommen, wenn:
Deine Sitzung abgelaufen ist. Melde dich bei Ferndesk ab und dann wieder an.
Der OAuth-Status ungültig wurde. Schließe das Autorisierungsfenster und klicke in Ferndesk erneut auf Verbinden.
Zusätzliche Ressourcen
Weitere Informationen zu GitHub-Funktionen findest du in der GitHub-Dokumentation.
War das hilfreich?