Configure an Import from Confluence in YouTrack Log in to the Atlassian account settings with an account that is granted administrative permissions.Ĭlick the Create API token button and provide a label for the token.įor more details on creating API keys for Atlassian products, refer to the Atlassian documentation. To create an API token for the Atlassian account: To set up an import of articles from Confluence Cloud, first, you need to create an API token for your Atlassian account. For details on creating an API token, see Create an API Token for Confluence Cloud. To configure an import from Confluence Cloud, you will need an API token. You will need these credentials for authorization when setting up the import in YouTrack. Open your mailbox and download the CSV file with the user data.īefore you add a new import configuration, prepare the credentials that will grant access to your Confluence instance. The data that is included in the user export file when these options are enabled are not required for importing issues into YouTrack.Ĭonfluence generates a CSV file that contains user data from your Confluence instance and sends it to your email. For best results, we suggest exporting all users.Ĭhoose whether to export group membership and product access data. Your selection should include all users who are associated with any issue-related events in the imported projects.Ĭhoose whether you only want to export active users or all users. Use the following guidelines to configure the user selection for export:Ĭhoose whether you want to export all users on the site or only from selected groups. Navigate to the Directory section in Atlassian Administration and open the Users page.įrom the More menu in the upper-right corner of the header, click the Export users button. To export user data for your Confluence instance: This behavior is only supported for self-hosted Confluence Server installations. This ensures that users who were able to perform high-level operations in Confluence enjoy the same level of access to the imported content. Members of this group are granted the Project Admin role. The import script adds users who have administrator privileges in imported spaces to a group called admins. This means that you don't have to manually export and upload user data before you can import your articles into YouTrack. Self-hosted Confluence Server installations are not subject to this limitation. If you don't have access to download this information, you will not be able to import data from your Confluence instance. In order to successfully map user activity in Confluence to imported articles in YouTrack, you need to upload a copy of the dataset for Confluence users to YouTrack before you start importing Confluence space data.ĭuring setup, you are asked to upload a CSV file that contains information about the user accounts that are currently stored in your Confluence database. The same values for users who created, updated, added comments to articles in Confluence are set to the corresponding user accounts in YouTrack.Ĭonfluence Cloud limits the amount of user data that is accessible through a programmatic interface. This integration also imports user accounts that are stored in the Confluence instance. Here is the list of entities that are imported from Confluence and their mapping to YouTrack entities: We recommend using an account with a System Admin role or the Low-level Admin Write permission to run the import. The YouTrack user account you use to run the import should have enough permissions to create all imported entities. If the Confluence database contains references to entities that do not exist in YouTrack yet, they are created. Your user account in Confluence has administrative permissions. Specifically, you need to make sure that your network doesn't block connections between your Confluence installation and YouTrack. If you're importing content from a self-managed Confluence Server installation, the Confluence installation must be accessible over the internet. The ability to import articles from earlier versions of Confluence has not been verified. Your Confluence version is 5.5.6 or later. Prerequisitesīefore you import spaces from Confluence to YouTrack, check the following requirements: If your Confluence has a custom set of fields for articles, you can edit the import script in YouTrack directly. It prompts you to enter the connection settings and lets you map projects in YouTrack to spaces in Confluence. The import from Confluence lets you migrate one or more spaces including articles, comments, attachments, and users from a cloud or self-hosted Confluence service to YouTrack's Knowledge Base.Ī setup wizard navigates you through the import configuration process.
0 Comments
Leave a Reply. |