Feature Toggle Management - Documentation (O11)

Stable version 1.0.10 (Compatible with OutSystems 11)

Uploaded

on 2 Dec (3 weeks ago)

4.5

(22 ratings)

Documentation

1.0.10

A bug was causing duplicate records in the LifetimeTeam and LifetimeTeamUser entities. This fix not only resolves the timer issue but also introduces a method to clean up the duplicate records.

By reducing the number of records to search, this update significantly enhances the overall performance of the feature toggle tool.

If you wish to perform the cleanup, follow these steps:

Deactivate the timer FeatureToggleTeams_Sync.
Run the timer BackupTeamAssignedFeatures to back up the current configuration between feature toggles and teams.
Clear the current teams by running the timer Timer_ClearFTTeams.
Enable the EnableLifetimeServiceAccount site property and define a token to access the Lifetime API.
Reactivate and run the FeatureToggleTeams_Sync timer.
Run the timer Timer_RestoreTeamAssignedFeatures to restore the backup.
Activate the timer FeatureToggleTeams_Sync.

Important Notes:

Ensure each timer completes without errors before proceeding to the next step.
A set of messages has been implemented to confirm that the backup process is running successfully.
Enable the EnableFTLogMessages site property to monitor the timer status. Messages will appear in the General tab with the prefix FeatureToggleLog. You can filter by this prefix in the "Message" filter to track timer status under Monitoring -> General.
These messages will only be visible if EnableFTLogMessages is set to true.
Do not jump any step if a timer fails or you might loose the configuration of the team assigned to the feature toggle.

1.0.8

To transition from using SOAP to the API, you need to configure two site properties found under the FeatureToggleManagement_CS module:

Site.EnableLifetimeServiceAccount (boolean): This property enables or disables the synchronization of Roles and Teams using the REST API.

Site.LifetimeServiceAccountToken (string): This property stores the token required for the REST API authentication.

Steps to Configure

1 - Create a Service Account in Lifetime:

Navigate to Lifetime.
Go to the User Management menu.
Select Service Accounts submenu.
Create a new service account.

2 - Set EnableLifetimeServiceAccount to true:

This action enables the synchronization of Roles and Teams using the REST API.

3 - Store the Service Account Token:

After creating the service account, you will receive a token.

Important: Ensure you store this token securely, as it will only be displayed once.

Summary

By setting EnableLifetimeServiceAccount to true and providing a valid LifetimeServiceAccountToken, you can switch from SOAP to the REST API for synchronizing Roles and Teams. Ensure you create and store the service account token from Lifetime's User Management -> Service Accounts.

1.0.3

Please read the documentation on how to install and how to use this tool.