core_v2_leaderboard Script API

Verint | Telligent Community — Wed, 14 May 2025 17:08:05 GMT

Current Revision posted to API Documentation by Verint | Telligent Community on 05/14/2025 17:08:05

Enables scripted content fragments to use Leaderboards

Properties

Name	Access	Type	Description
ContentTypeId	Read	`[[Guid Script API Type\|Guid]]`	Content Type Id
Current	Read	`[[Leaderboard Script API Type\|Leaderboard]]`	Current
Permissions	Read	`[[LeaderboardPermissions Script API Type\|LeaderboardPermissions]]`	Permissions

Methods

Create

Creates a leaderboard

Velocity

#set($leaderboardResponse = $core_v2_leaderboard.Create($name, $numberOfLeaders, "%{ ApplicationKey = $applicationKeyArg, ContainerId = $containerIdArg, Description = $descriptionArg, EndDate = $endDateArg, EndDisplayDate = $endDisplayDateArg, ExcludeRolesFilter = $excludeRolesFilterArg, IncludeRolesFilter = $includeRolesFilterArg, PeriodType = $periodTypeArg, StartDate = $startDateArg, StartDisplayDate = $startDisplayDateArg, TimeSpanType = $timeSpanTypeArg, TimeSpanValue = $timeSpanValueArg }"))

JavaScript

var leaderboardResponse = core_v2_leaderboard.Create(name, numberOfLeaders, { ApplicationKey: applicationKeyArg, ContainerId: containerIdArg, Description: descriptionArg, EndDate: endDateArg, EndDisplayDate: endDisplayDateArg, ExcludeRolesFilter: excludeRolesFilterArg, IncludeRolesFilter: includeRolesFilterArg, PeriodType: periodTypeArg, StartDate: startDateArg, StartDisplayDate: startDisplayDateArg, TimeSpanType: timeSpanTypeArg, TimeSpanValue: timeSpanValueArg });

Parameters

Name	Type	Description	Required	Options
name	`[[String Script API Type\|String]]`	Name of leaderboard	Required
numberOfLeaders	`[[Number Script API Type\|Number]]`	Number of users to show on the leaderboard	Required
options	Options	Set of optional parameters including:	Required
ApplicationKey	`[[String Script API Type\|String]]`	Application Key for url.	Optional
ContainerId	`[[Guid Script API Type\|Guid]]`	Filter points to those earned within a certain Container. Optional.	Optional
Description	`[[String Script API Type\|String]]`	Description of the Leaderboard.	Optional
EndDate	`[[DateTime Script API Type\|DateTime]]`	Specify the earliest date scores will count for this leaderboard. StartDate and EndDate are required for Static period type.	Optional
EndDisplayDate	`[[DateTime Script API Type\|DateTime]]`	Only show the leaderboard on the site before this date. Optional, defaults to EndDate.	Optional
ExcludeRolesFilter	`[[String Script API Type\|String]]`	Comma separated list of Site RoleIds. Used to limit the leaders for the leaderboard. Only users who are not assigned the provided site roles will be eligable to be on the leaderboard.	Optional
IncludeRolesFilter	`[[String Script API Type\|String]]`	Comma separated list of Site RoleIds. Used to limit the leaders for the leaderboard. Only users assigned the provided site roles will be eligable to be on the leaderboard.	Optional
PeriodType	`[[String Script API Type\|String]]`	Period Type	Optional	AllTime, Rolling, Static
StartDate	`[[DateTime Script API Type\|DateTime]]`	Specify the earliest date scores will count for this leaderboard. StartDate and EndDate are required for Static period type.	Optional
StartDisplayDate	`[[DateTime Script API Type\|DateTime]]`	Only show the leaderboard on the site after this date. Optional, defaults to StartDate.	Optional
TimeSpanType	`[[String Script API Type\|String]]`	Specify the time of time span for calculations (days/months/years). TimeSpanValue and TimeSpanType are required for Rolling period type	Optional	Day, Month, Year
TimeSpanValue	`[[Number Script API Type\|Number]]`	Specify the number of (days/months/years), based on the TimeSpanType. TimeSpanValue and TimeSpanType are required for Rolling period type.	Optional

Returns

[[Leaderboard Script API Type|Leaderboard]]

Delete

Velocity

#set($additionalInfoResponse = $core_v2_leaderboard.Delete($leaderboardId))

JavaScript

var additionalInfoResponse = core_v2_leaderboard.Delete(leaderboardId);

Parameters

Name	Type	Description	Required	Default	Options
leaderboardId	`[[Number Script API Type\|Number]]`	Leaderboard Id	Required

Returns

[[AdditionalInfo Script API Type|AdditionalInfo]]

Get

Gets a leaderboard

Velocity

#set($leaderboardResponse = $core_v2_leaderboard.Get($leaderboardId))

JavaScript

var leaderboardResponse = core_v2_leaderboard.Get(leaderboardId);

Parameters

Name	Type	Description	Required	Default	Options
leaderboardId	`[[Number Script API Type\|Number]]`	Leaderboard Id	Required

Returns

[[Leaderboard Script API Type|Leaderboard]]

List

Velocity

#set($pagedListResponse = $core_v2_leaderboard.List("%{ ContainerId = $containerIdArg, ContentIds = $contentIdsArg, DisplayStatus = $displayStatusArg, NameQuery = $nameQueryArg, PageIndex = $pageIndexArg, PageSize = $pageSizeArg, PermissionId = $permissionIdArg, Scope = $scopeArg, SortBy = $sortByArg, SortOrder = $sortOrderArg }"))

JavaScript

var pagedListResponse = core_v2_leaderboard.List({ ContainerId: containerIdArg, ContentIds: contentIdsArg, DisplayStatus: displayStatusArg, NameQuery: nameQueryArg, PageIndex: pageIndexArg, PageSize: pageSizeArg, PermissionId: permissionIdArg, Scope: scopeArg, SortBy: sortByArg, SortOrder: sortOrderArg });

Parameters

Name	Type	Description	Required	Default	Options
options	Options	Set of optional parameters including:	Required
ContainerId	`[[Guid Script API Type\|Guid]]`	Filter by Container to list group level leaderboards. Optional. If ContainerId is set, Scope is ignored and automatically set to 'Container'.	Optional
ContentIds	`[[String Script API Type\|String]]`	Comma separated list of ContentIds. Used to limit to a specific set of leaderboards as well as sort order if SortBy is set to ContentIdsOrder.	Optional
DisplayStatus	`[[String Script API Type\|String]]`	Filter by leaderboard display status. Optional. Possible values are (All, Displayed, Future, Past).	Optional		All, Displayed, Future, Past
NameQuery	`[[String Script API Type\|String]]`	Filter by leaderboard name.	Optional
PageIndex	`[[Number Script API Type\|Number]]`	Which page of leaderboards to return. Optional.	Optional
PageSize	`[[Number Script API Type\|Number]]`	Number of leaderboards to return per call. Optional.	Optional
PermissionId	`[[Guid Script API Type\|Guid]]`	Used to get a list of leaderboards for which the current user has the provided Permission ID.	Optional
Scope	`[[String Script API Type\|String]]`	Filter by leaderboard location. Optional. Possible values are (All, Global, Container). Ignored if ContainerId is specified.	Optional		All, Container, Global
SortBy	`[[String Script API Type\|String]]`	Accepted values are: Name (default), CreatedDate, ContentIdsOrder. Optional.	Optional	Name	ContentIdsOrder, CreatedDate, Name
SortOrder	`[[String Script API Type\|String]]`	Accepted values are: Ascending or Descending (by name). Optional.	Optional		Ascending, Descending

Returns

[[PagedList Script API Type|PagedList]] of [[Leaderboard Script API Type|Leaderboard]]

ToString

Velocity

#set($stringResponse = $core_v2_leaderboard.ToString())

JavaScript

var stringResponse = core_v2_leaderboard.ToString();

Returns

[[String Script API Type|String]]

Update

Velocity

#set($leaderboardResponse = $core_v2_leaderboard.Update($leaderboardId, "%{ ApplicationKey = $applicationKeyArg, ContainerId = $containerIdArg, Description = $descriptionArg, EndDate = $endDateArg, EndDisplayDate = $endDisplayDateArg, ExcludeRolesFilter = $excludeRolesFilterArg, IncludeRolesFilter = $includeRolesFilterArg, Name = $nameArg, NumberOfLeaders = $numberOfLeadersArg, PeriodType = $periodTypeArg, StartDate = $startDateArg, StartDisplayDate = $startDisplayDateArg, TimeSpanType = $timeSpanTypeArg, TimeSpanValue = $timeSpanValueArg }"))

JavaScript

var leaderboardResponse = core_v2_leaderboard.Update(leaderboardId, { ApplicationKey: applicationKeyArg, ContainerId: containerIdArg, Description: descriptionArg, EndDate: endDateArg, EndDisplayDate: endDisplayDateArg, ExcludeRolesFilter: excludeRolesFilterArg, IncludeRolesFilter: includeRolesFilterArg, Name: nameArg, NumberOfLeaders: numberOfLeadersArg, PeriodType: periodTypeArg, StartDate: startDateArg, StartDisplayDate: startDisplayDateArg, TimeSpanType: timeSpanTypeArg, TimeSpanValue: timeSpanValueArg });

Parameters

Name	Type	Description	Required	Options
leaderboardId	`[[Number Script API Type\|Number]]`	Id of leaderboard	Required
options	Options	Set of optional parameters including:	Required
ApplicationKey	`[[String Script API Type\|String]]`	Application Key for url.	Optional
ContainerId	`[[Guid Script API Type\|Guid]]`	Filter points to those earned within a certain Container.	Optional
Description	`[[String Script API Type\|String]]`	Description of the Leaderboard.	Optional
EndDate	`[[DateTime Script API Type\|DateTime]]`	Specify the earliest date scores will count for this leaderboard. StartDate and EndDate are required for Static period type.	Optional
EndDisplayDate	`[[DateTime Script API Type\|DateTime]]`	Only show the leaderboard on the site before this date. Optional, defaults to EndDate.	Optional
ExcludeRolesFilter	`[[String Script API Type\|String]]`	Comma separated list of Site RoleIds. Used to limit the leaders for the leaderboard. Only users who are not assigned the provided site roles will be eligable to be on the leaderboard.	Optional
IncludeRolesFilter	`[[String Script API Type\|String]]`	Comma separated list of Site RoleIds. Used to limit the leaders for the leaderboard. Only users assigned the provided site roles will be eligable to be on the leaderboard.	Optional
Name	`[[String Script API Type\|String]]`	Name of the Leaderboard.	Optional
NumberOfLeaders	`[[Number Script API Type\|Number]]`	Number of users to display on the leaderboard.	Optional
PeriodType	`[[String Script API Type\|String]]`	Period Type	Optional	AllTime, Rolling, Static
StartDate	`[[DateTime Script API Type\|DateTime]]`	Specify the earliest date scores will count for this leaderboard. StartDate and EndDate are required for Static period type.	Optional
StartDisplayDate	`[[DateTime Script API Type\|DateTime]]`	Only show the leaderboard on the site after this date. Optional, defaults to StartDate.	Optional
TimeSpanType	`[[String Script API Type\|String]]`	Specify the time of time span for calculations (days/months/years). TimeSpanValue and TimeSpanType are required for Rolling period type	Optional	Day, Month, Year
TimeSpanValue	`[[Number Script API Type\|Number]]`	Specify the number of (days/months/years), based on the TimeSpanType. TimeSpanValue and TimeSpanType are required for Rolling period type.	Optional

Returns

[[Leaderboard Script API Type|Leaderboard]]

UserIsEligible

Velocity

#set($booleanResponse = $core_v2_leaderboard.UserIsEligible($leaderboardId))

JavaScript

var booleanResponse = core_v2_leaderboard.UserIsEligible(leaderboardId);

Parameters

Name	Type	Description	Required	Default	Options
leaderboardId	`[[Number Script API Type\|Number]]`	Leaderboard Id	Required

Returns

[[Boolean Script API Type|Boolean]]