Sie müssen in Ihrem Ferndesk-Workspace angemeldet sein, bevor Sie eine Integration verbinden. Stellen Sie sicher, dass Sie angemeldet sind und sich in der richtigen Organisation befinden. Wenn Sie Zugriff auf mehrere Ferndesk-Workspaces haben, wechseln Sie zu dem Workspace, in dem Sie die GitHub-Verbindung hinzufügen möchten.
GitHub-Integration
Verbinden Sie Ihr GitHub-Konto mit Ferndesk. Diese Integration ermöglicht es Fern, Ihre Codebase zu durchsuchen und zu verstehen, wie Funktionen arbeiten, was dabei hilft, genauere und relevantere Hilfeartikel zu erstellen.
Sehen Sie sich dieses Video an, um zu erfahren, wie die GitHub-Integration funktioniert:
Sie benötigen ein GitHub-Konto, um diese Integration abzuschließen. Falls Sie noch keines haben, erstellen Sie eines auf der GitHub-Website.
GitHub verbinden
1
Go to Integrations
Klicken Sie in Ihrem Ferndesk-Dashboard in der Seitenleiste auf Integrations.
Stellen Sie sicher, dass Sie im richtigen Ferndesk-Workspace angemeldet sind. Die Integration wird mit der Organisation verknüpft, die Sie gerade anzeigen.
2
Click Connect
Suchen Sie GitHub in der Liste der Integrationen und klicken Sie auf Connect.
3
Authorize in GitHub
Sie werden zu GitHub weitergeleitet, um die Verbindung zu autorisieren. Melden Sie sich bei Ihrem GitHub-Konto an, falls Sie noch nicht angemeldet sind.
Erteilen Sie Ferndesk die Erlaubnis, auf Ihr GitHub-Konto zuzugreifen. Sie können auswählen, welche Repositories verbunden werden sollen – Sie können mehrere Repositories wählen, wenn Ihr Projekt mehrere umfasst, z. B. ein Backend und ein Dashboard in separaten Repositories.
4
Return to Ferndesk
Nach der Autorisierung werden Sie zurück zu Ferndesk geleitet. Die GitHub-Integration wird als verbunden angezeigt, und Fern kann Ihre Codebase durchsuchen.
Sobald die Verbindung hergestellt ist, kann Fern Ihre Codebase durchsuchen, um präzisere und relevantere Hilfeartikel bereitzustellen.
Verbundene Repositories verwalten
Nach der Ersteinrichtung können Sie Repositories hinzufügen oder entfernen, indem Sie Ihre GitHub-App-Einstellungen aufrufen. Gehen Sie zu Ihren GitHub-Kontoeinstellungen, navigieren Sie zu „Applications“ und suchen Sie Ferndesk in Ihren installierten Integrationen, um den Repository-Zugriff anzupassen.
Fehlerbehebung
Ich sehe „Authentication required to connect GitHub“
Ich sehe „GitHub OAuth organization does not match the active session“
Das GitHub-Konto oder die Organisation, die Sie autorisieren, gehört zu einer anderen Organisation als der, in der Sie in Ferndesk angemeldet sind. Stellen Sie sicher, dass Sie:
Im richtigen Ferndesk-Workspace angemeldet sind
Das GitHub-Konto oder die Organisation autorisieren, die dieser Ferndesk-Organisation entspricht
Wenn Sie eine andere GitHub-Organisation mit einem anderen Ferndesk-Workspace verbinden müssen, wechseln Sie zuerst zu diesem Workspace in Ferndesk und verbinden Sie dann GitHub.
Die GitHub-Autorisierungsseite zeigt einen Fehler an
Dies kann passieren, wenn:
Ihre Sitzung abgelaufen ist – versuchen Sie, sich von Ferndesk abzumelden und wieder anzumelden
Der OAuth-Status ungültig geworden ist – schließen Sie das Autorisierungsfenster und klicken Sie in Ferndesk erneut auf Connect
Zusätzliche Ressourcen
Weitere Informationen zu den Funktionen von GitHub finden Sie in deren Dokumentation.
War das hilfreich?