Avion Knowledge Base
avion.ioSign inSign up
  • 👋Introduction
  • 👉Getting started
    • What is Avion?
    • Define your product backbone
    • Scoping and prioritizing your product
    • Creating your release plan
    • Aligning the team
    • Integrating with backlog tools
  • Docs
    • 👏Core concepts
      • Projects
        • Project team
        • Migrating to projects
      • Organizations
        • Invite a member
        • Remove a member
        • Roles
        • Transfer ownership
        • Configure your path
        • Delete your organization
    • 🚀Story map
      • Story map anatomy
      • Journeys and steps
      • Stories
      • Releases
      • Attachments
      • Tags
      • Personas
      • Labels
      • Dependencies
      • Search and filter
      • Sharing
        • Restricted links
        • Public links
      • Workflow
      • Importing data
        • Import from Excel
          • XLSX import template
        • Import from StoriesOnBoard
      • Exporting data
        • Export to PDF
        • Export to image
        • Export to CSV
        • Export to Excel
      • Rich text editor
        • Keyboard shortcuts
        • Known limitations
      • Keyboard shortcuts
      • Tips
    • 🤝Integrations
      • Backlog tools
        • Set up an integration
          • Authentication
          • Project / board selection
          • Backbone syncing
          • Map story states
          • Additional syncing options
          • Importing data
        • Sync data
          • Pushing
          • Importing
          • Attachments
          • Deleting data
        • Configuration
        • Pause an integration
        • Re-authenticate
        • Remove an integration
        • Maintenance
          • Removing stale webhooks
        • FAQs and troubleshooting
        • Services
          • Jira Cloud
            • Features
            • Set up
            • Permissions required
            • Mapping options
              • Mapping fix versions
            • Epics ~ our thoughts
            • Additional data syncing
              • Mapping custom fields
                • Company-managed projects
                • Team-managed projects
            • Migrating to epic hierarchies
            • Import using JQL
            • FAQs and troubleshooting
              • Required fields
              • Verify webhooks
              • JQL import issues
              • Workflow issues
              • Ghost cards (cards with a dashed border)
              • Limitations
              • Jira Cloud or Jira Server
          • Jira Data Center (Server)
            • Features
            • Set up
              • Creating an application link
            • Permissions required
            • Mapping options
            • Additional data syncing
              • Mapping custom fields
            • Import using JQL
            • FAQs and troubleshooting
              • Required fields
              • Ghost cards (card with a dashed border)
              • Jira Cloud or Jira Server
              • JQL import issues
          • Azure DevOps
            • Features
            • Set up
            • Permissions required
            • Import using WIQL
            • FAQs and troubleshooting
              • Verify webhooks
              • No Azure DevOps accounts were found for your user
              • Problems communicating with Azure DevOps
              • Work items couldn't be imported
              • Show epics in Azure DevOps backlog
              • Import limits
          • Trello
            • Features
            • Set up
            • FAQs and troubleshooting
          • GitHub
            • Features
            • Set up
            • Permissions required
            • FAQs and troubleshooting
              • What types of GitHub Projects are supported?
          • Linear
            • Features
            • Set up
            • Permissions required
            • FAQs and troubleshooting
      • Notifications
        • Slack
          • Set up
          • Configure notification settings
          • Remove Slack
      • Design tools and media
        • Figma
        • Adobe XD
        • Axure
        • Framer X
        • Invision Web & Studio
        • YouTube & Vimeo
      • Embed Avion
        • Confluence
        • Confluence Server
        • Notion
        • Coda
    • 🔒Security
      • Single Sign-On (SSO)
        • Setup & Configure SSO
        • Azure AD
        • Google Workspace
        • Okta
        • OpenID Connect
      • Two-factor authentication (2FA)
    • ❓FAQs
      • Attachment file types
    • 💳Billing
      • Plans and pricing
      • Legacy plans
      • Free trials
      • Billing and payments
      • Change your plan
      • Cancel your plan
      • Refunds
      • Startup, student and educational discount
  • Story Mapping Guides
    • How To Story Map — A Simple Example
    • Advantages of Story Mapping
    • A Recommended Workflow
Powered by GitBook
On this page
  • Required fields
  • Epic hierarchy as issue links in team-managed projects
  • Issue linking is one-way sync
  • Missing Jira issue keys
  1. Docs
  2. Integrations
  3. Backlog tools
  4. Services
  5. Jira Cloud
  6. FAQs and troubleshooting

Limitations

Last updated 1 year ago

Whilst we try to create a seamless integration with Jira Cloud, there is the odd limitation. Often, we are limited due to Jira's APIs, which means that this may change or improve over time, allowing us to address these limitations.

Required fields

By default Jira makes the Summary and Reporter fields of issues required. This setup is fully supported by Avion, as we can assign the Summary to the card name in Avion and the Reporter to the user that set up the integration. However, further required fields cannot be supported by Avion. Please bear in mind the behaviour related to an .

Epic hierarchy as issue links in team-managed projects

Team-managed projects use a parent/child hierarchy for the epic/task relationship. This is not the same as the "epic link" functionality used in company-managed projects. Avion would love to be able to make use if this, but unfortunately, the APIs are not currently available. In order to still provide team-managed users with a hierarchy, Avion uses issue linking in Jira to link epics and tasks. If the APIs become available in the future, we will assess the possibility of using the parent/child functionality. It's worth noting that because of this, we do not import existing parent/child relationships in team-managed projects either.

Update: The APIs are now available and Avion has switched over to using epic relationships for team-managed projects. Please note that if you set up an integration with Jira before 13th October 2020, you will need to manually migrate your issues in Jira. .

Issue linking is one-way sync

If you integrate a company-managed project with an Avion story map and change an epic link of a story, Avion will attempt to reflect this in the story map. Ghost cards will be used if the relationship cannot be reconciled.

However, in team-managed projects, this backward-syncing from Jira is not available. Our recommendation is to not use Jira to change your journey, step or release hierarchy. Generally, it makes more sense to alter this in the story map, as you have a much more visual view of it.

Missing Jira issue keys

During setup of the Jira Cloud integration, a single issue is created and subsequently deleted by Avion. This is used to verify that everything is working as expected. However, an unfortunate side-effect of this is that a Jira key "slot" will be used. So if the last issue you created was PROJ-10 and you setup an integration from Avion to Jira Cloud, the next issue you create would be PROJ-12.

🤝
Follow our guide here
epic's Summary field