Interface WebLicenseInfo
-
public interface WebLicenseInfo
Deprecated.UseProductLicenseInfo
instead.NOTE: THIS INTERFACE IS FOR INTERNAL USE ONLY AND SHOULD NOT BE USED IN CUSTOMIZATIONS. This interface provides MicroStrategy Web-related license information for the installation on the local machine. It can be used to determine a license status message to show the user. The logic for this is as follows:if (isWebLicensed()) { // at least one Web component (Web Reporter, Analyst, etc.) is licensed if (isWebEnabled() { // the Web license is not expired, so Web is allowed to run if (showExpirationWarning(isAdminUser) { // the Web license is due to expire and a warning should be shown } else { // the Web license is fully active or no warning needs to be // shown at this time } } else { // the Web license has expired, so Web should not be allowed to run } } else { // no Web components (Web Reporter, Analyst, etc.) are licensed }
- Since:
- MicroStrategy Web 8.0.1
-
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description int
getDaysLeft()
Deprecated.In the case where the license is due to expire or has expired, returns the number of days left until the license expires (0 if the license has already expired).int
getGracePeriodDays()
Deprecated.In the case that the license is due to expire or has expired, returns the total number of days in the grace period.boolean
isEvaluation()
Deprecated.Returns whether the current status of the license is related to time- bound license expiration.boolean
isWebEnabled()
Deprecated.Returns whether Web is allowed to run (i.e.boolean
isWebLicensed()
Deprecated.Returns whether a valid Web license exists for this server--i.e.boolean
showExpirationWarning(boolean forAdminUser)
Deprecated.In the case where the Web license is due to expire, or has already expired, this method returns whether an expiration-related warning needs to be shown to the user.
-
-
-
Method Detail
-
isWebLicensed
boolean isWebLicensed() throws LicensingException
Deprecated.Returns whether a valid Web license exists for this server--i.e. at least one Web component (Web Reporter, Web Analyst, etc.) has been installed using a valid license key. This method does not indicate whether Web can actually run (the license may be expired, for example); useisWebEnabled
for this.- Returns:
- true if a valid Web license exists for this server; false otherwise.
- Throws:
LicensingException
- If an error occurred while retrieving license information.
-
isWebEnabled
boolean isWebEnabled() throws LicensingException
Deprecated.Returns whether Web is allowed to run (i.e. at least one Web component is fully active or not expired). IfisWebLicensed()
returns true, but this method returns false, the caller can assume that the license to run Web has expired.- Returns:
- true if Web is allowed run; false otherwise.
- Throws:
LicensingException
- If an error occurred while retrieving license information.
-
isEvaluation
boolean isEvaluation() throws LicensingException
Deprecated.Returns whether the current status of the license is related to time- bound license expiration. This method is only relevant whenisWebLicensed()
returns true.- Returns:
- true if the current status of the license is related to time- bound license expiration; false othwerwise.
- Throws:
LicensingException
- If an error occurred while retrieving license information.
-
showExpirationWarning
boolean showExpirationWarning(boolean forAdminUser) throws LicensingException
Deprecated.In the case where the Web license is due to expire, or has already expired, this method returns whether an expiration-related warning needs to be shown to the user. This method is only relevant whenisWebLicensed()
returns true.- Parameters:
forAdminUser
- Indicates whether the user to whom we might show a warning is an administrator.- Returns:
- true if an expiration-related warning needs to be shown to the user; false otherwise.
- Throws:
LicensingException
- If an error occurred while retrieving license information.
-
getDaysLeft
int getDaysLeft() throws LicensingException
Deprecated.In the case where the license is due to expire or has expired, returns the number of days left until the license expires (0 if the license has already expired). Returns -1 if this is not applicable (i.e. the installation is fully active or not licensed).- Returns:
- The number of remaining days until the license expires, or 0 if the license has expired, or 1 if this is not applicable.
- Throws:
LicensingException
- If an error occurred while retrieving license information.
-
getGracePeriodDays
int getGracePeriodDays() throws LicensingException
Deprecated.In the case that the license is due to expire or has expired, returns the total number of days in the grace period. Returns -1 if this is not applicable (i.e. the installation is fully active or not licensed).- Returns:
- The total number of days in the grace period, or -1 if this is not applicable.
- Throws:
LicensingException
- If an error occurred while retrieving license information.- Since:
- MicroStrategy Web 8.0.2
-
-