Define Release Version Pattern

Design Item ID: DI-Portal-PS-006

Design Item Name: Define Release Version Pattern

Related Design Items: DI-Portal-PS-001: General Settings

Related API:

• Get package by Id (GET /api/v2/packages/{packageId})
• Change the package's parameters (PATCH /api/v2/packages/{packageId})

Revision History:

Date	Description

---

Description

This feature allows the user to define a regular expression (regex) pattern that enforces a specific naming convention for versions in release status. When a user attempts to publish a version in release status, the system validates the version name against the specified regex pattern. If the version name does not match the pattern, an error message is displayed, preventing the release from being published.

Start Point

1. User navigates to APIHUB Portal → specific workspace → specific group → specific package → Package Settings → General tab.

Execution

1. User clicks Edit button.

2. The system displays the default regular expression pattern for release version names in the Release Version Pattern field. Default value: [0-9]{4}.[1]{1}[1-4]{1}$

   • API to show package parameters – GET /api/v2/packages/{packageId}
     • packageId = current package Id

3. User enters a custom regex pattern into the "Release Version Pattern" field and clicks Save button.

   • Note: The new pattern only affects the validation logic for future version names during the release process; it does not impact existing version names or other stored data.

4. The system updates the value of Release Version Pattern field.

   • API to update default release version – PATCH /api/v2/packages/{packageId}
     • packageId = current package Id
     • releaseVersionPattern = value from Release Version Pattern field

Screen View

Refer to the following screen view, illustrating the General tab with the Release Version Pattern field under Configuration.