Automatische Verlinkungen von externen Ressourcen konfigurieren

Du kannst Autolinks externen Ressourcen wie JIRA-Issues oder Zendesk-Tickets hinzufügen, um Deinen Workflow zu optimieren.

Wer kann dieses Feature verwenden?

Autolinks sind in Repositorys mit GitHub Pro, GitHub Team, GitHub Enterprise Cloud und GitHub Enterprise Server verfügbar. Weitere Informationen findest du unter GitHub-Pläne.

In diesem Artikel

Alle Benutzer mit Administratorberechtigungen für ein Repository können automatische Links konfigurieren, um Issues, Pull Requests, Commit-Mitteilungen und Release-Beschreibungen mit externen Diensten von Dritten zu verbinden.

Autolinkverweise können jetzt alphanumerische Zeichen akzeptieren. Bei ihrer ursprünglichen Einführung waren benutzerdefinierte Autolinks auf externe Ressourcen beschränkt, die numerische Bezeichner verwendeten. Benutzerdefinierte automatische Verknüpfungen funktionieren jetzt mit alphanumerischen und numerischen Bezeichnern.

Zum Definieren benutzerdefinierter Autolinks gibst du ein Verweispräfix und eine Ziel-URL an.

  • Die Namen von Verweispräfixen dürfen keine Überlappungen aufweisen. Beispielsweise kann ein Repository keine zwei benutzerdefinierten Autolinks mit Präfixen wie TICKET und TICK haben, da beide Präfixe mit der Zeichenfolge TICKET123aübereinstimmen würden.
  • Ziel-URLs enthalten die Variable <num>, die den Verweisbezeichner der verknüpften Ressource darstellt.

Im Folgenden wird gezeigt, wie Autolinks zum Verweisen auf externe Ressourcen konfiguriert werden. Wenn du z. B. Zendesk verwendest, um Tickets von Benutzern nachzuverfolgen, kannst du in dem Pull Request, den du zur Fehlerbehebung öffnest, auf eine Ticketnummer verweisen.

  1. Wähle im Abschnitt „Integrationen“ auf der Randleiste Verweise automatisch verknüpfen aus.

  2. Klicke oben rechts auf der Seite auf Automatisch verknüpften Verweis hinzufügen.

    Screenshot: Seite „Automatisch verknüpfte Verweise“. Die Schaltfläche „Automatisch verknüpften Verweis hinzufügen“ ist mit einer dunkelorangenen Umrandung hervorgehoben.

  3. Wähle das Format des in der externen Ressource verwendeten Verweisbezeichners aus (entweder Alphanumerisch oder Numerisch).

  4. Gib unter „Verweispräfix“ ein kurzes, aussagekräftiges Präfix ein. Projektmitarbeiter*innen verwenden diesen Text, um Autolinks für die externe Ressource zu generieren.

  5. Gib unter „Ziel-URL“ das Format des Links zum externen System ein, das du erstellen möchtest. Verwende die Variable <num> als Platzhalter für den Verweisbezeichner.

  6. Überprüfe die Vorschau, und vergewissere dich, dass der automatische Link und der externe verweis richtig sind. Klicke anschließend auf Automatisch verknüpften Verweis hinzufügen, um den Link zu definieren.

Du kannst beispielsweise Folgendes eingeben.

  • Verweispräfix: JIRA-
  • Ziel-URL: https://jira.example.com/issue?query=<num>
  • Vorschau: JIRA-123 wird in https://jira.example.com/issue?query=123 konvertiert