Project Synchronisation

ActivityTimeline allows administrators to manage Jira project synchronization from the Projects page.

To access this page, go to:

Configuration → Projects

From this page, you can control which projects are active in ActivityTimeline, synchronize project issues and worklogs, and refresh the list of Jira projects.

Refreshing the Project List

When a new project is created in Jira, it may not appear in ActivityTimeline immediately.

New Jira projects are added to ActivityTimeline during the scheduled project list synchronization. Depending on your configuration, this synchronization may run daily, weekly.

If you need the new Jira project to appear in ActivityTimeline sooner, you can refresh the project list manually.

To do this:

1. Go to Configuration → Projects.

2. Click Refresh Projects.

3. Wait until the project list synchronization is completed.

Once the project appears on the Projects page, you can activate it in ActivityTimeline.

Activating a Project

Activating a project makes it available for synchronization and management in ActivityTimeline.

However, activating a project does not automatically synchronize its Jira issues or worklogs.

After activating a project, you need to manually run the synchronization for project data.

Recommended order:

1. Activate the project.

2. Click Sync Tickets next to the project name.

3. Wait until the ticket synchronization is completed.

4. Click Sync Worklogs next to the project name.

5. Wait until the worklog synchronization is completed.

This ensures that both Jira issues and related worklogs are loaded correctly into ActivityTimeline.

Deactivating a Project

If a project is set to Inactive, ActivityTimeline will stop synchronizing updates from Jira for that project.

Inactive projects are not available for regular planning and management inside ActivityTimeline. This is useful when you want to exclude archived, test, sandbox, or irrelevant Jira projects from planning and reporting.

Please note that deactivating a project does not remove previously synchronized issues or worklogs from ActivityTimeline. This data remains stored in ActivityTimeline cache.

If you want to remove previously synchronized data for a project, use the remove options on the Projects page:

• Remove Tickets — removes synchronized issues from ActivityTimeline cache.

• Remove Worklogs — removes synchronized worklogs from ActivityTimeline cache.

Scheduled Project List Synchronization

ActivityTimeline can periodically synchronize the list of Jira projects to keep the Projects page up to date.

To configure this:

1. Go to Configuration → Synchronization → Refresh Projects.

2. Click Refresh Projects.

3. Here you can also configure how often ActivityTimeline should refresh the project list from Jira and set default state of new projects.

This helps ensure that newly created Jira projects appear in ActivityTimeline without requiring manual checks unless necessary.

Troubleshooting: Project Is Synced, but Issues Are Not Loaded

If a project is synchronized but no issues are loaded, ActivityTimeline may not have the required Browse Projects permission in Jira.

For Data Center instances:

1. Go to ActivityTimeline → Configuration → Technical Info.

2. Check which user is listed as the Sync User.

3. In Jira, go to Project Settings → Permissions.

4. Verify that the Sync User has the Browse Projects permission for the affected project.

5. If the permission is missing, grant the Sync User the required permission.

6. Return to ActivityTimeline → Configuration → Projects.

7. Click Sync Tickets next to the affected project to trigger a manual synchronization.

For Cloud instances:

1. In Jira, go to Project Settings → Permissions.

2. Make sure the atlassian-addons-project-access group has the Browse Projects permission.

3. Return to ActivityTimeline → Configuration → Projects.

4. Click Sync Tickets next to the affected project to trigger a manual synchronization.

After the required permissions are updated and the project is synchronized again, issues from the project should appear in ActivityTimeline.