WBS Gantt-Chart for Jira Cloud
WBS Gantt-Chart for Jira Cloud
Breadcrumbs

Updating Bookmarks After Upgrading WBS Gantt-Chart from 3.x.x or Earlier to 4.x.x or Later

Updating WBS Gantt-Chart Bookmarks After Migrating to Forge

This guide explains how to update your saved WBS Gantt-Chart bookmarks when upgrading from version 3.x.x or earlier to version 4.x.x or later.

URLs created with the previous Connect version are no longer valid and must be updated to the new Forge URL format.

1. Overview of the URL changes

Aspect

Old (~3.x.x)

New (4.0.0 ~ )

Base path

/plugins/servlet/ac/{addonKey}/{moduleKey}

/jira/apps/{appId}/{envId} or /jira/{projectType}/projects/{projectKey}/apps/{appId}/{envId}

Application identifier

Add-on key: jp.ricksoft.plugins.wbsgantt-for-jira

App ID: 0847a52f-ac9f-40c9-acf0-ce700723d8f1

Environment identifier

Not used in the URL

Environment ID is included in the Forge URL

Query parameter format

Uses the ac. prefix, such as ac.filter and ac.tm

No ac. prefix, such as gantt and tm

Authentication parameters

Parameters such as jwt and xdm_e may appear

Not required in user-facing URLs

2. Identifiers used in Forge URLs

Depending on the bookmark you want to update, you may need the following values.

Identifier

Value / Example

App ID

0847a52f-ac9f-40c9-acf0-ce700723d8f1

Environment ID

fb5d08fc-6002-4b33-b5a6-2c97415c68e8

Project key

Example: PROJ

Gantt ID

Example: 42

Jira project ID

Example: 10001

3. Placeholder conventions

The following placeholders are used throughout this guide:

Placeholder

Description

{siteUrl}

Your Jira Cloud site URL, for example https://your-company.atlassian.net

{appId}

0847a52f-ac9f-40c9-acf0-ce700723d8f1

{envId}

fb5d08fc-6002-4b33-b5a6-2c97415c68e8

{projectKey}

Jira project key, for example PROJ

{ganttId}

Numeric Gantt ID, for example 42

{projectId}

Numeric Jira project ID, for example 10001

{projectType}

Jira project type URL segment, such as software, servicedesk, or core

For a project default Gantt, the Jira project ID is used as a negative value in the gantt parameter.

For example:

gantt=-10001

4. Main conversion rules

Old parameter

New parameter

Notes

ac.filter=GANTT_{id}

gantt={id}

Remove both the ac. prefix and the GANTT_ prefix

ac.tm=true

tm=true

Same meaning with a simplified parameter name

filter=GANTT_{id}

gantt={id}

Legacy iframe parameters follow the same conversion rule

project.key, project.id

Not used as query parameters

Project context is represented by the URL path or, for a project default Gantt, by a negative project ID in the gantt parameter

jwt, xdm_e

Remove

Do not include authentication parameters in bookmarks

5. Opening Gantt charts

5.1 Open a project default Gantt

Old Connect format

{siteUrl}/plugins/servlet/ac/jp.ricksoft.plugins.wbsgantt-for-jira/main?ac.filter=GANTT_{-projectId}

New Forge format

{siteUrl}/jira/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8/main?gantt={-projectId}

Example

Old:

.../main?ac.filter=GANTT_-10001

New:

.../main?gantt=-10001

5.2 Open a Gantt chart by Gantt ID

Old Connect format

{siteUrl}/plugins/servlet/ac/jp.ricksoft.plugins.wbsgantt-for-jira/main?ac.filter=GANTT_{ganttId}

New Forge format

{siteUrl}/jira/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8/main?gantt={ganttId}

Examples

Purpose

Old URL

New URL

Open Gantt chart #42

.../main?ac.filter=GANTT_42

.../main?gantt=42

Open project default Gantt

.../main?ac.filter=GANTT_-10001

.../main?gantt=-10001

Open template management mode

.../main?ac.filter=GANTT_42&ac.tm=true

.../main?gantt=42&tm=true

6. Opening a Gantt chart from the project sidebar

The Forge URL depends on the Jira project type.

Old Connect format

An old project sidebar bookmark may look like this:

{siteUrl}/projects/{projectKey}?selectedItem=com.atlassian.plugins.atlassian-connect-plugin.ricksoft.plugins.wbsgantt-for-jira__edit-link-gantt-software

New Forge format

{siteUrl}/jira/{projectType}/projects/{projectKey}/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8

Project type mapping

Jira project type

URL segment

Software

software

Service Management

servicedesk

Business

core

Example

To open the WBS Gantt-Chart page for the Software project PROJ:

{siteUrl}/jira/software/projects/PROJ/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8

7. URL conversion reference

Action

Old URL (Connect)

New URL (Forge)

Open Gantt list

{siteUrl}/plugins/servlet/ac/jp.ricksoft.plugins.wbsgantt-for-jira/gantts

{siteUrl}/jira/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8

Open Gantt chart

{siteUrl}/plugins/servlet/ac/jp.ricksoft.plugins.wbsgantt-for-jira/main?ac.filter=GANTT_{ganttId}

{siteUrl}/jira/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8/main?gantt={ganttId}

Open project default Gantt

{siteUrl}/plugins/servlet/ac/jp.ricksoft.plugins.wbsgantt-for-jira/main?ac.filter=GANTT_{-projectId}

{siteUrl}/jira/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8/main?gantt={-projectId}

Open template management mode

.../main?ac.filter=GANTT_{ganttId}&ac.tm=true

{siteUrl}/jira/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8/main?gantt={ganttId}&tm=true

Open from Software project sidebar

{siteUrl}/projects/{projectKey}?selectedItem=...

{siteUrl}/jira/software/projects/{projectKey}/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8

Open from Service Management project sidebar

Same Connect project URL pattern

{siteUrl}/jira/servicedesk/projects/{projectKey}/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8

Open from Business project sidebar

Same Connect project URL pattern

{siteUrl}/jira/core/projects/{projectKey}/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8

Admin: Work item settings

{siteUrl}/plugins/servlet/ac/jp.ricksoft.plugins.wbsgantt-for-jira/admin-ticket-page?s=...

{siteUrl}/jira/settings/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8/work-item

Admin: Application permissions

{siteUrl}/plugins/servlet/ac/jp.ricksoft.plugins.wbsgantt-for-jira/admin-application-permission-page?s=...

{siteUrl}/jira/settings/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8/permissions

Admin: Default user preferences

{siteUrl}/plugins/servlet/ac/jp.ricksoft.plugins.wbsgantt-for-jira/admin-user-preferences-page?s=...

{siteUrl}/jira/settings/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8/default-user-preferences

Admin: Migration information

{siteUrl}/plugins/servlet/ac/jp.ricksoft.plugins.wbsgantt-for-jira/admin-migration-page?s=...

{siteUrl}/jira/settings/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8/migration-information

Project settings

{siteUrl}/plugins/servlet/ac/jp.ricksoft.plugins.wbsgantt-for-jira/gantt-panel?project.key={projectKey}

{siteUrl}/jira/software/projects/{projectKey}/settings/apps/0847a52f-ac9f-40c9-acf0-ce700723d8f1/fb5d08fc-6002-4b33-b5a6-2c97415c68e8

8. Notes

When updating a bookmark:

  1. Remove Connect-specific authentication parameters such as jwt and xdm_e.

  2. Replace ac.filter=GANTT_{id} with gantt={id}.

  3. Replace ac.tm=true with tm=true.

  4. For project default Gantt charts, use the Jira project ID as a negative gantt value.

  5. For project sidebar URLs, select the appropriate {projectType} value based on the Jira project type.

  6. Do not copy temporary iframe or authentication parameters into the new bookmark.