Gebruik deze tweerichtingsintegratie om epics of verhalen in Shortcut te pushen en hun staat vanuit airfocus te volgen.
Voordelen
Gebruik de flexibele Shortcut-integratie van Airfocus om jouw stories en epics te prioriteren en effectievere roadmaps te maken. Werk samen aan jouw prioriteringsscores om de juiste dingen gedaan te krijgen. Onze Shortcut-integratie houdt de strategie op hoog niveau in lijn met de dagelijkse ontwikkeling.
- Importeer Shortcut-epics en verhalen (als items) in Airfocus.
- Push prioriteerde items in Shortcut voor ontwikkeling en volg hun Shortcut-status direct vanuit Airfocus.
- Creëer flexibele filters en mapping workflow, bijvoorbeeld. Koppel meerdere Shortcut-toestanden aan dezelfde airfocus-toestand.
- Houd velden gesynchroniseerd tussen beide systemen, inclusief titel, beschrijving, status/baan, label (tweerichtingssynchronisatie).
Initiële setup
Navigeer naar de AirFocus-werkruimte waarmee je de Shortcut-integratie wilt opzetten. Ga naar "Extensies" en vervolgens "Integratie toevoegen". Zoek de Snelkoppelingsintegratie en klik op "Verbinden".
Maak kennis met een Shortcut API-token. Om er een te genereren, open je de Shortcut-app, ga je naar Instellingen jouw Account API-tokens en genereer je een API-token. Klik op "Doorgaan".
Opmerkingen:
- Bij het instellen van een Shortcut-integratie in Airfocus moet je kiezen of je Shortcut-epics of Shortcut-verhalen met Airfocus wilt importeren en synchroniseren.
- je kan maar één Shortcut- workflow tegelijk integreren. Als je a) meerdere snelkoppelingsworkflows wilt integreren of b) zowel workflow (met projecten en verhalen) ALS epics in dezelfde AirFocus werkruimte, stel dan meerdere integraties op.
Integratie filters
Eerst moet je kiezen of je jouw epics of verhalen van Shortcut wilt synchroniseren.
Als je verhalen hebt gekozen, kun je bovendien de selectie items voor jouw sync verfijnen door:
- Optioneel een project kiezen als je deze legacy-functie nog steeds gebruikt op Shortcut.
- Optioneel labels kiezen om de import te beperken. Als je dit leeg laat, worden alle verhalen die overeenkomen met de overige filters in overweging genomen.
Als je epics hebt gekozen, kun je bovendien de selectie van items voor jouw sync verfijnen door optioneel labels te kiezen om de import te beperken.
Veldmapping
Gebruik mapping om te bepalen hoe informatie in Shortcut naar Airfocus (en andersom) moet worden gekoppeld. Verhaal- / epic-namen (vereist) en beschrijvingen (optioneel) worden standaard altijd toegewezen bij het opzetten van een nieuwe integratie.
Hoe je kaartrichtingen instelt
je kan voor elk van jouw velden bepalen of je een eenrichtingssynchronisatie of een tweerichtingssynchronisatie wil tussen het veld in Shortcut en airfocus.
je kan de kaartrichtingen voor alle velden tegelijk instellen (voor zover technisch mogelijk) met de knop "Richting instellen".
Standaard is de mapping direction ingesteld van Shortcut naar alleen airfocus en kan door de gebruiker worden aangepast naar wat beschikbaar is voor mapping.
Hoe voeg je een nieuwe veldmapping toe
Bij het selecteren van een veld in het keuzemenu worden alleen velden weergegeven die overeenkomen met het veldtype aan de andere kant. Nadat je twee velden hebt geselecteerd die je wilt toewijzen, kun je de veldopties selecteren en hoe ze moeten worden toegewezen.
Veldkaartopties voor verhalen
| Kortere route | airfocus | Shortcut → airfocus | airfocus → Shortcut | airfocus ↔ Snelkoppeling |
| Naam | Artikelnaam | ✅ | ✅ | ✅ |
| Beschrijving | Itembeschrijving | ✅ | ✅ | ⚠️ |
| Staat | Status / aangepast enkel select-veld | ✅ | ✅ | ✅ |
| Prioriteit | Aangepast enkel selecteerveld | ✅ | ✅ | ✅ |
| Ernst | Aangepast enkel selecteerveld | ✅ | ✅ | ✅ |
| Label | Aangepast meerkeuzeveld | ✅ | ✅ | ✅ |
| aangepast veld | Aangepast enkel selecteerveld | ✅ | ✅ | ✅ |
| Schatting | Aangepast nummerveld | ✅ | ✅ | ✅ |
| Einddatum | Aangepast datumveld | ✅ | ✅ | ✅ |
Veldkaartopties voor epics
| Kortere route | airfocus | Shortcut → airfocus | airfocus → Shortcut | airfocus ↔ Snelkoppeling |
| Naam | Artikelnaam | ✅ | ✅ | ✅ |
| Beschrijving | Itembeschrijving | ✅ | ✅ | ⚠️ |
| Staat | Status / aangepast enkel select-veld | ✅ | ✅ | ✅ |
| Label | Aangepast multi-select veld | ✅ | ✅ | ✅ |
| Startdatum | Aangepast datumveld | ✅ | ✅ | ✅ |
| Einddatum | Aangepast datumveld | ✅ | ✅ | ✅ |
| Start- + einddatumveld (als paar) | Aangepast datumbereik veld | ✅ | ✅ | ✅ |
| Schatting | Aangepast nummerveld | ✅ | ✅ | ✅ |
⚠️ WAARSCHUWING: Gebruiker kan nu tweerichtingssynchronisatie inschakelen voor het beschrijvingsveld. Het tweerichtings-synchronisatieproces kan echter kleine veranderingen veroorzaken in de inhoud en opmaak van jouw Shortcut-beschrijvingen. Dit komt doordat nog niet alle Shortcut-stijlen native ondersteund worden in Airfocus.
Notities
- airfocus-velden die eenrichtingsverkeer zijn toegewezen van Shortcut naar Airfocus, worden alleen-lezen-velden in airfocus, omdat eventuele wijzigingen die een gebruiker eraan zou aanbrengen bij de volgende synchronisatie opnieuw worden overschreven.
- Als een van de datumvelden in Shortcut niet is ingesteld of een Shortcut-epic een deadline vóór de startdatum heeft, vult Airfocus de startdatum in met een datum één dag voor de deadline.
- je kunt standaard bepalen welk label je wilt koppelen aan gesynchroniseerde Shortcut-werkitems als je ten minste één multi-select field mapping hebt ingesteld. (Instelling verschijnt als een subsectie van die mapping).
Aanvullende instellingen
Wanneer "Archief onbekende items" is ingeschakeld, worden eerder geïmporteerde items Archief in airfocus genoemd, als ze niet meer in Shortcut aanwezig zijn of niet meer binnen de filters van de integratie vallen.
Wanneer "Automatische synchronisatie" is ingeschakeld, synchroniseert jouw integratie automatisch elke 10 minuten en elke keer dat je de werkruimte opent.
Wanneer je op "weergaven logs" klikt, kan je weergaven jouw Shortcut integratie activiteit logs en zien welke wijzigingen zijn aangebracht vóór de laatste synchronisatie.
Om uw instellingen op te slaan en uw verhalen/epics naar Airfocus te importeren, klik op bijwerken en synchroniseren.
Feedback geven over dit artikel
Heb je feedback over dit artikel? Deel je ervaringen hier.