Integration von Airfocus mit Shortcut

Geschrieben von:  Morgan T
Letzte Aktualisierung:  

Nutzen Sie diese bidirektionale Integration, um Epics oder Stories in Shortcut zu übertragen und deren Status von airfocus aus zu verfolgen.

Vorteile

Nutzen Sie die flexible Shortcut-Integration von airfocus, um Ihre Stories und Epics zu priorisieren und so eine effektivere Roadmap zu erstellen. Arbeiten Sie an Ihrer Priorisierungsbewertung zusammen, um die richtigen Dinge zu erledigen. Unsere Shortcut-Integration sorgt dafür, dass die übergeordnete Strategie mit der täglichen Entwicklung synchronisiert bleibt.

  • Importiere Shortcut-Epen und -Geschichten (als Elemente) in airfocus.
  • Elemente priorisieren und zur Entwicklung in Shortcut übertragen, um deren Shortcut-Status direkt in airfocus zu verfolgen.
  • Erstellen Sie einen flexiblen Filter- und Mapping-Workflow, z. B. Mappen mehrere Shortcut-Zustände auf denselben Airfocus-Zustand.
  • Behalten Sie die Felder zwischen beiden Systemen synchron, einschließlich Titel, Beschreibung, Zustand/Spur, Bezeichnung (Zwei-Wege-Synchronisation).

Ersteinrichtung

Navigieren Sie zu dem Arbeitsbereich, mit dem Sie die Shortcut-Integration einrichten, bringen, einstellen möchten. Gehen Sie zu „ Erweiterungen “ und dann zu „ Integration hinzufügen “. Suchen Sie die Shortcut-Integration und klicken Sie auf „ Verbinden “.

integrate-with-shortcut-1.png
integrate-with-shortcut-2.png

Geben Sie ein Shortcut-API-Token ein. Um einen solchen Token zu generieren, öffnen Sie die Kurzbefehle-App, gehen Sie zu Einstellungen Ihr Konto API-Token und generieren Sie einen API-Token. Klicken Sie auf „ Weiter “.

integrate-with-shortcut-3.png

Hinweise:

  • Bei der Einrichtung einer Shortcut-Integration in airfocus müssen Sie auswählen, ob Sie Shortcut-Epics oder Shortcut-Stories mit airfocus importieren und synchronisieren möchten.
  • Du kannst immer nur einen Shortcut-Workflow gleichzeitig integrieren. Wenn Sie a) mehrere Shortcut-Workflows oder b) sowohl Workflows (mit ihren Projekten und Stories) als auch Epics in denselben airfocus Der Arbeitsbereich integrieren möchten, setzen, bringen, einrichten up multiple Integration.

Integration

Zuerst musst du entscheiden, ob du deine Epen oder Geschichten aus Shortcut synchronisieren möchtest.

Wenn Sie sich für Geschichten entschieden haben, können Sie die Auswahl der Elemente für Ihre Synchronisierung zusätzlich wie folgt eingrenzen:

integrate-with-shortcut-4.png
  • Optional wählst du ein Projekt aus, wenn du diese Legacy-Funktion im Shortcut weiterhin nutzt.
  • Optional wähle ich Labels, auf die der Import begrenzt wird. Wenn Sie dieses Feld leer lassen, werden alle Stories berücksichtigt, die dem verbleibenden Filter entsprechen.

Wenn Sie Epics ausgewählt haben, können Sie die Auswahl der Elemente für Ihre Synchronisierung zusätzlich einschränken, indem Sie optional Labels auswählen, auf die der Import beschränkt werden soll.

integrate-with-shortcut-5.png

Feldabbildung

Verwenden Sie Mapping, um zu definieren, wie Informationen in Shortcut auf AirFocus (und umgekehrt) abgebildet werden sollen. Story-/Epos-Namen (erforderlich) und Beschreibungen (optional) werden bei der Einrichtung einer neuen Integration standardmäßig immer zugeordnet.

Wie man Mapping-Richtungen setzt, bringt, einstellt

Sie können für jedes Ihrer Felder festlegen, ob Sie eine unidirektionale oder eine bidirektionale Synchronisierung zwischen dem Feld in Shortcut und airfocus wünschen. 

integrate-with-shortcut-6.png

Mit der Schaltfläche „Richtung setzen, bringen, einstellen“ können Sie die Mapping-Richtungen für alle Felder gleichzeitig setzen, bringen, einstellen (soweit technisch möglich). 

integrate-with-shortcut-7.png

Standardmäßig ist die Zuordnungsrichtung von „Setzen“, „Bringen“ und „Einstellen“ auf „Nur AirFocus“ beschränkt und kann über die Nutzende auf die jeweils verfügbaren Zuordnungsoptionen geändert werden.

Wie man eine neue Feldabbildung fügt

Beim Auswählen eines Feldes im Dropdown-Menü werden nur Felder angezeigt, die dem Feldtyp entsprechen, am anderen Ende. Nachdem du zwei Felder ausgewählt hast, die du zuordnen möchtest, kannst du die Feldoptionen auswählen und wie sie zugeordnet werden sollen.

integrate-with-shortcut-8.png

Feldkartierungsoptionen für Geschichten

Abkürzung airfocus Abkürzung → Airfocus airfocus → Abkürzung Airfocus-Abkürzung ↔
Name Elementename
Beschreibung Elementebeschreibung ⚠️
Status Status / benutzerdefiniertes Einzelauswahlfeld
Priorität Benutzerdefiniertes Einzelauswahlfeld
Schweregrad Benutzerdefiniertes Einzelauswahlfeld
Beschriftung Benutzerdefiniertes Mehrfachauswahlfeld
bebenutzers Feld Benutzerdefiniertes Einzelauswahlfeld
Schätzung Benutzerdefiniertes Nummernfeld
Enddatum Benutzerdefiniertes Datumsfeld

Feldkartierungsoptionen für Epics

Abkürzung airfocus Abkürzung → Airfocus airfocus → Abkürzung Airfocus-Abkürzung ↔
Name Elementename
Beschreibung Elementebeschreibung ⚠️
Status Status / benutzerdefiniertes Einzelauswahlfeld
Beschriftung Benutzerdefiniertes Mehrauswahlfeld
Anfangsdatum Benutzerdefiniertes Datumsfeld
Enddatum Benutzerdefiniertes Datumsfeld
Beginn- und Enddatumsfeld (als Paar) Benutzerdefiniertes Datumsbereichsfeld
Schätzung Benutzerdefiniertes Nummernfeld

⚠️ WARNUNG: Nutzende kann jetzt die bidirektionale Synchronisierung für das Beschreibungsfeld aktivieren. Allerdings kann der bidirektionale Synchronisierungsprozess zu geringfügigen Änderungen im Inhalt und der Formatierung Ihrer Verknüpfungsbeschreibungen führen. Das liegt daran, dass noch nicht alle Shortcut-Stile nativ in AirFocus unterstützt werden.

Notizen

  • airfocus-Felder, die von Shortcut in eine Richtung zu airfocus abgebildet werden, werden in airfocus zu schreibgeschützten Feldern, da alle Änderungen, die ein Nutzende daran vornimmt, beim nächsten Synchronisieren wieder überschrieben werden.
  • Wenn eines der Datumsfelder in Shortcut nicht mit „setzen“, „bringen“ oder „einstellen“ gekennzeichnet ist oder ein Shortcut-Epic ein Fälligkeitsdatum hat, das vor dem Startdatum liegt, dann füllt airfocus das Startdatum mit einem Datum einen Tag vor dem Fälligkeitsdatum aus.
  • Sie können festlegen, welche Bezeichnung den synchronisierten Shortcut-Arbeitselementen standardmäßig zugewiesen werden soll, sofern Sie mindestens eine Mehrfachauswahlfeldzuordnung konfiguriert haben. (Die Einstellung wird als Unterabschnitt dieser Abbildung angezeigt).

Zusätzliche Einstellungen

Wenn die Option „ Unbekannte Elemente archivieren “ aktiviert ist, werden zuvor importierte Elemente in airfocus archiviert, wenn sie nicht mehr in Shortcut vorhanden sind oder nicht mehr in den Filter setzen, bringen, einstellen für die Integration fallen.

Wenn die Option „ Automatische Synchronisierung “ aktiviert ist, wird Ihre Integration automatisch alle 10 Minuten und jedes Mal synchronisiert, wenn Sie auf den Arbeitsbereich zugreifen.

Wenn Sie auf „ Protokolle anzeigen “ klicken, können Sie Ihre Aktivitätsprotokolle der Verknüpfungsintegration einsehen und sehen, welche Änderungen vor der letzten Synchronisierung vorgenommen wurden.

integrate-with-shortcut-9.png

Um deine Einstellungen zu speichern und deine Geschichten/Epics in Airfocus zu importieren, klicke auf Aktualisieren und Synchronisieren.

Geben Sie uns Feedback zu diesem Artikel

Haben Sie Feedback zu diesem Artikel? Erzählen Sie uns hier von Ihren Erfahrungen.

Haben Sie gefunden wonach Sie gesucht haben?

Haben Sie noch eine Frage oder möchten Sie Ihre Erfahrungen mit anderen teilen? Besuchen Sie unsere Community,   um Hilfe zu bekommen und mit anderen zusammenzuarbeiten.