Versions Compared
Version | Old Version 12 | New Version 13 |
---|---|---|
Changes made by | ||
Saved on |
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Panel | ||
---|---|---|
| ||
Welcome to the Cloud Migration Documentation for our app User Profiles for Confluence! This comprehensive guide provides an in-depth overview of the steps and considerations involved in migrating your app to Confluence Cloud. Whether you are an administrator, developer, or a member of the migration team, this documentation is designed to assist you throughout the process. |
In this documentation you will find detailed information about which content is not migrated and which is migrated and therefore prepared for migration. We also outline the User Profiles for Confluence content that will be prepared and those that won’t be. Additionally, we explain the steps involved in the preparation process, with a focus on updating macro instances.
Supported User Directories in the Cloud App
As of the current version, our cloud version exclusively supports Microsoft Entra ID (previously Azure AD) as the User Directory. To consider migrating to cloud, your organization should already use or plan to use Microsoft Entra ID for identity management.
Migration Process and Preparation
In general, only our app’s macros are prepared for migration, and currently, only the most important macros. We are continually working to expand the app’s capabilities, and this documentation will provide insights into the macros that can be migrated successfully.
How to perform the preparation
To prepare your macros for migration, follow these steps:
Go to User Profiles Configuration: Access the User Profiles Configuration in Confluence.
Navigate to the "Cloud Migration" section: Within the User Profiles Configuration, navigate to the "Cloud Migration" section.
Select the Spaces to migrate: In the "Cloud Migration" section, specify the spaces that you want to migrate. You can provide these spaces as a comma-separated list of space keys.
Upload CSV file: Provide a CSV file containing user data from Microsoft Entra ID. Please refer to Microsoft Entra's documentation for guidance on creating this file.
Uploading this data is essential for ensuring that your macros continue to function seamlessly after the migration, i.e. display the correct user’s data (for technical details, see What does the app do during the preparation process).
Start: Click on the Start button to start the preparation process.
What does the app do during the preparation process
Update Macro Instances: All instances of Enhanced Profile and Profile Macros will be updated to ensure compatibility with the cloud version. During this process, the names of the macros will be changed, and user mapping to the Entra ID users will be performed to ensure seamless functionality.
New Version History: During the update process, a new version of the content will be created. This new version will be documented in the history of the page or blog post to track changes and revisions.
Migrated content
Confluence content
Our app provides a streamlined process for preparing content for migration. Please note that while Confluence supports a wide range of content types, our app is specifically designed to support these content types:
Prepared | Not prepared |
---|---|
|
|
User Profiles for Confluence content
Prepared | Not prepared | ||||||
---|---|---|---|---|---|---|---|
|
|
Page Content:
Table of Contents |
---|