Class to represent a platform resource link. More...
Public Member Functions | |
__construct () | |
Class constructor. | |
initialize () | |
Initialise the resource link. | |
initialise () | |
Initialise the resource link. | |
save () | |
Save the resource link to the database. | |
delete () | |
Delete the resource link from the database. | |
getConsumer () | |
Get tool consumer. | |
getConsumerId () | |
Get tool consumer ID. | |
setConsumerId ($consumerId) | |
Set tool consumer ID. | |
getPlatform () | |
Get platform. | |
getPlatformId () | |
Get platform ID. | |
setPlatformId ($platformId) | |
Set platform ID. | |
getContext () | |
Get context. | |
getContextId () | |
Get context record ID. | |
setContext ($context) | |
Set context. | |
setContextId ($contextId) | |
Set context ID. | |
getKey () | |
Get consumer key. | |
getId () | |
Get resource link ID. | |
getRecordId () | |
Get resource link record ID. | |
setRecordId ($id) | |
Set resource link record ID. | |
getDataConnector () | |
Get the data connector. | |
getSetting ($name, $default='') | |
Get a setting value. | |
setSetting ($name, $value=null) | |
Set a setting value. | |
getSettings () | |
Get an array of all setting values. | |
setSettings ($settings) | |
Set an array of all setting values. | |
saveSettings () | |
Save setting values. | |
hasOutcomesService () | |
Check if an Outcomes service is available. | |
hasMembershipsService () | |
Check if a Memberships service is available. | |
hasSettingService () | |
Check if the Setting extension service is available. | |
hasLineItemService () | |
Check if the Line-item service is available. | |
hasScoreService () | |
Check if the Score service is available. | |
hasResultService () | |
Check if the Result service is available. | |
hasAssessmentControlService () | |
Check if the Assessment Control service is available. | |
doOutcomesService ($action, $ltiOutcome, $userResult) | |
Perform an Outcomes service request. | |
doMembershipsService ($withGroups=false) | |
Perform a Memberships extension service request. | |
doSettingService ($action, $value=null) | |
Perform a Setting service request. | |
hasToolSettingsService () | |
Check if the Tool Settings service is available. | |
getToolSettings ($mode=Service\ToolSettings::MODE_CURRENT_LEVEL, $simple=true) | |
Get Tool Settings. | |
setToolSettings ($settings=array()) | |
Set Tool Settings. | |
hasMembershipService () | |
Check if the Membership service is supported. | |
getMembership () | |
Get Membership. | |
getMemberships ($withGroups=false) | |
Get Memberships. | |
getUserResultSourcedIDs ($localOnly=false, $idScope=null) | |
Obtain an array of UserResult objects for users with a result sourcedId. | |
getShares () | |
Get an array of ResourceLinkShare objects for each resource link which is sharing this context. | |
getLineItems ($resourceId=null, $tag=null, $limit=null) | |
Get line-items. | |
createLineItem ($lineItem) | |
Create a new line-item. | |
getOutcomes ($limit=null) | |
Get all outcomes. | |
doAssessmentControlAction ($assessmentControlAction, $user, $attemptNumber) | |
Perform an Assessment Control action. | |
Static Public Member Functions | |
static | fromConsumer ($consumer, $ltiResourceLinkId, $tempId=null) |
Class constructor from consumer. | |
static | fromPlatform ($platform, $ltiResourceLinkId, $tempId=null) |
Class constructor from platform. | |
static | fromContext ($context, $ltiResourceLinkId, $tempId=null) |
Class constructor from context. | |
static | fromRecordId ($id, $dataConnector) |
Load the resource link from the database. | |
![]() | |
static | registerApiHook ($hookName, $familyCode, $className) |
Register the availability of an API hook. | |
Data Fields | |
const | EXT_READ = 1 |
Read action. | |
const | EXT_WRITE = 2 |
Write (create/update) action. | |
const | EXT_DELETE = 3 |
Delete action. | |
const | EXT_CREATE = 4 |
Create action. | |
const | EXT_UPDATE = 5 |
Update action. | |
const | EXT_TYPE_DECIMAL = 'decimal' |
Decimal outcome type. | |
const | EXT_TYPE_PERCENTAGE = 'percentage' |
Percentage outcome type. | |
const | EXT_TYPE_RATIO = 'ratio' |
Ratio outcome type. | |
const | EXT_TYPE_LETTER_AF = 'letteraf' |
Letter (A-F) outcome type. | |
const | EXT_TYPE_LETTER_AF_PLUS = 'letterafplus' |
Letter (A-F) with optional +/- outcome type. | |
const | EXT_TYPE_PASS_FAIL = 'passfail' |
Pass/fail outcome type. | |
const | EXT_TYPE_TEXT = 'freetext' |
Free text outcome type. | |
$title = null | |
Context title. | |
$ltiResourceLinkId = null | |
Resource link ID as supplied in the last connection request. | |
$groupSets = null | |
User group sets (null if the platform does not support the groups enhancement) | |
$groups = null | |
User groups (null if the platform does not support the groups enhancement) | |
$lastServiceRequest = null | |
HttpMessage object for last service request. | |
$extRequest = null | |
Request for last service request. | |
$extRequestHeaders = null | |
Request headers for last service request. | |
$extResponse = null | |
Response from last service request. | |
$extResponseHeaders = null | |
Response header from last service request. | |
$primaryResourceLinkId = null | |
Primary key value for resource link being shared (if any). | |
$shareApproved = null | |
Whether the sharing request has been approved by the primary resource link. | |
$created = null | |
Timestamp for when the object was created. | |
$updated = null | |
Timestamp for when the object was last updated. | |
Additional Inherited Members | |
![]() | |
static | $USER_ID_HOOK = "UserId" |
User Id hook name. | |
static | $CONTEXT_ID_HOOK = "ContextId" |
Context Id hook name. | |
static | $GROUPS_SERVICE_HOOK = "Groups" |
Course Groups service hook name. | |
static | $MEMBERSHIPS_SERVICE_HOOK = "Memberships" |
Memberships service hook name. | |
static | $OUTCOMES_SERVICE_HOOK = "Outcomes" |
Outcomes service hook name. | |
static | $TOOL_SETTINGS_SERVICE_HOOK = "ToolSettings" |
Tool Settings service hook name. | |
static | $ACCESS_TOKEN_SERVICE_HOOK = "AccessToken" |
Access Token service hook name. | |
Class to represent a platform resource link.
Definition at line 18 of file ResourceLink.php.
__construct | ( | ) |
Class constructor.
Definition at line 258 of file ResourceLink.php.
References ResourceLink\initialize().
createLineItem | ( | $lineItem | ) |
Create a new line-item.
LineItem | $lineItem | Line-item object |
Definition at line 1288 of file ResourceLink.php.
References ResourceLink\$ltiResourceLinkId.
delete | ( | ) |
Delete the resource link from the database.
Definition at line 308 of file ResourceLink.php.
References ResourceLink\getDataConnector().
doAssessmentControlAction | ( | $assessmentControlAction, | |
$user, | |||
$attemptNumber | |||
) |
Perform an Assessment Control action.
AssessmentControlAction | $assessmentControlAction | Assessment control object |
User | $user | User object |
int | $attemptNumber | Number of attempt |
Definition at line 1339 of file ResourceLink.php.
References ResourceLink\getSetting().
doMembershipsService | ( | $withGroups = false | ) |
Perform a Memberships extension service request.
The userResult table is updated with any user objects with lis_result_sourcedid values.
bool | $withGroups | True is group information is to be requested as well |
Definition at line 887 of file ResourceLink.php.
References ResourceLink\getMemberships(), and Util\logDebug().
doOutcomesService | ( | $action, | |
$ltiOutcome, | |||
$userResult | |||
) |
Perform an Outcomes service request.
int | $action | The action type constant |
Outcome | $ltiOutcome | Outcome object |
UserResult | $userResult | UserResult object |
Definition at line 709 of file ResourceLink.php.
References ResourceLink\EXT_DELETE, ResourceLink\EXT_READ, ResourceLink\EXT_WRITE, and ResourceLink\getPlatform().
doSettingService | ( | $action, | |
$value = null |
|||
) |
Perform a Setting service request.
int | $action | The action type constant |
string | null | $value | The setting value (optional, default is null) |
Definition at line 902 of file ResourceLink.php.
References ResourceLink\EXT_DELETE, ResourceLink\EXT_READ, ResourceLink\EXT_WRITE, ResourceLink\getSetting(), ResourceLink\saveSettings(), and ResourceLink\setSetting().
|
static |
Class constructor from consumer.
ToolConsumer | $consumer | Consumer object |
string | $ltiResourceLinkId | Resource link ID value |
string | null | $tempId | Temporary Resource link ID value (optional, default is null) |
Definition at line 1374 of file ResourceLink.php.
References ResourceLink\$ltiResourceLinkId, ResourceLink\fromPlatform(), and Util\logDebug().
|
static |
Class constructor from context.
Context | $context | Context object |
string | $ltiResourceLinkId | Resource link ID value |
string | null | $tempId | Temporary Resource link ID value (optional, default is null) |
Definition at line 1417 of file ResourceLink.php.
References ResourceLink\$ltiResourceLinkId.
|
static |
Class constructor from platform.
Platform | $platform | Platform object |
string | $ltiResourceLinkId | Resource link ID value |
string | null | $tempId | Temporary Resource link ID value (optional, default is null) |
Definition at line 1390 of file ResourceLink.php.
References ResourceLink\$ltiResourceLinkId.
Referenced by ResourceLink\fromConsumer().
|
static |
Load the resource link from the database.
int | $id | Record ID of resource link |
DataConnector | $dataConnector | Database connection object |
Definition at line 1444 of file ResourceLink.php.
Referenced by UserResult\getResourceLink().
getConsumer | ( | ) |
Get tool consumer.
Definition at line 321 of file ResourceLink.php.
References ResourceLink\getPlatform(), and Util\logDebug().
getConsumerId | ( | ) |
Get tool consumer ID.
Definition at line 336 of file ResourceLink.php.
References ResourceLink\getPlatformId(), and Util\logDebug().
getContext | ( | ) |
Get context.
Definition at line 402 of file ResourceLink.php.
References Context\fromRecordId(), and ResourceLink\getDataConnector().
Referenced by ResourceLink\getMemberships(), ResourceLink\getPlatform(), and ResourceLink\hasMembershipsService().
getContextId | ( | ) |
Get context record ID.
Definition at line 416 of file ResourceLink.php.
Referenced by ResourceLink\getMemberships(), and ResourceLink\hasMembershipsService().
getDataConnector | ( | ) |
Get the data connector.
Definition at line 494 of file ResourceLink.php.
References ResourceLink\getPlatform().
Referenced by ResourceLink\delete(), ResourceLink\getContext(), ResourceLink\getPlatform(), ResourceLink\getShares(), ResourceLink\getUserResultSourcedIDs(), and ResourceLink\save().
getId | ( | ) |
Get resource link ID.
Definition at line 464 of file ResourceLink.php.
References ResourceLink\$ltiResourceLinkId.
getKey | ( | ) |
Get consumer key.
Definition at line 454 of file ResourceLink.php.
References ResourceLink\getPlatform().
getLineItems | ( | $resourceId = null , |
|
$tag = null , |
|||
$limit = null |
|||
) |
Get line-items.
string | null | $resourceId | Tool resource ID |
string | null | $tag | Tag |
int | null | $limit | Limit of line-items to be returned in each request, null for service default |
Definition at line 1259 of file ResourceLink.php.
getMembership | ( | ) |
Get Membership.
Definition at line 1042 of file ResourceLink.php.
References ResourceLink\getMemberships(), and Util\logDebug().
getMemberships | ( | $withGroups = false | ) |
Get Memberships.
bool | $withGroups | True if group information is to be requested as well |
Definition at line 1056 of file ResourceLink.php.
References ResourceLink\$groups, UserResult\fromResourceLink(), ResourceLink\getContext(), ResourceLink\getContextId(), ResourceLink\getPlatform(), ResourceLink\getSetting(), ResourceLink\getUserResultSourcedIDs(), Tool\ID_SCOPE_RESOURCE, and System\parseRoles().
Referenced by ResourceLink\doMembershipsService(), and ResourceLink\getMembership().
getOutcomes | ( | $limit = null | ) |
Get all outcomes.
int | null | $limit | Limit of outcomes to be returned in each request, null for service default |
Definition at line 1307 of file ResourceLink.php.
References ResourceLink\getPlatform(), and ResourceLink\getSetting().
getPlatform | ( | ) |
Get platform.
Definition at line 363 of file ResourceLink.php.
References Platform\fromRecordId(), ResourceLink\getContext(), and ResourceLink\getDataConnector().
Referenced by ResourceLink\doOutcomesService(), ResourceLink\getConsumer(), ResourceLink\getDataConnector(), ResourceLink\getKey(), ResourceLink\getMemberships(), ResourceLink\getOutcomes(), ResourceLink\getToolSettings(), ResourceLink\hasMembershipsService(), ResourceLink\hasOutcomesService(), ResourceLink\hasToolSettingsService(), and ResourceLink\setToolSettings().
getPlatformId | ( | ) |
Get platform ID.
Definition at line 381 of file ResourceLink.php.
Referenced by ResourceLink\getConsumerId().
getRecordId | ( | ) |
Get resource link record ID.
Definition at line 474 of file ResourceLink.php.
getSetting | ( | $name, | |
$default = '' |
|||
) |
Get a setting value.
string | $name | Name of setting |
string | $default | Value to return if the setting does not exist (optional, default is an empty string) |
Definition at line 514 of file ResourceLink.php.
Referenced by ResourceLink\doAssessmentControlAction(), ResourceLink\doSettingService(), ResourceLink\getMemberships(), ResourceLink\getOutcomes(), ResourceLink\getToolSettings(), ResourceLink\hasAssessmentControlService(), ResourceLink\hasLineItemService(), ResourceLink\hasMembershipsService(), ResourceLink\hasOutcomesService(), ResourceLink\hasResultService(), ResourceLink\hasScoreService(), ResourceLink\hasSettingService(), ResourceLink\hasToolSettingsService(), ResourceLink\setSetting(), and ResourceLink\setToolSettings().
getSettings | ( | ) |
Get an array of all setting values.
Definition at line 549 of file ResourceLink.php.
getShares | ( | ) |
Get an array of ResourceLinkShare objects for each resource link which is sharing this context.
Definition at line 1245 of file ResourceLink.php.
References ResourceLink\getDataConnector().
getToolSettings | ( | $mode = Service\ToolSettings::MODE_CURRENT_LEVEL , |
|
$simple = true |
|||
) |
Get Tool Settings.
int | $mode | Mode for request (optional, default is current level only) |
bool | $simple | True if all the simple media type is to be used (optional, default is true) |
Definition at line 974 of file ResourceLink.php.
References ResourceLink\getPlatform(), and ResourceLink\getSetting().
getUserResultSourcedIDs | ( | $localOnly = false , |
|
$idScope = null |
|||
) |
Obtain an array of UserResult objects for users with a result sourcedId.
The array may include users from other resource links which are sharing this resource link. It may also be optionally indexed by the user ID of a specified scope.
bool | $localOnly | True if only users from this resource link are to be returned, not users from shared resource links (optional, default is false) |
int | null | $idScope | Scope to use for ID values (optional, default is null for platform default) |
Definition at line 1235 of file ResourceLink.php.
References ResourceLink\getDataConnector().
Referenced by ResourceLink\getMemberships().
hasAssessmentControlService | ( | ) |
Check if the Assessment Control service is available.
Definition at line 693 of file ResourceLink.php.
References ResourceLink\getSetting().
hasLineItemService | ( | ) |
Check if the Line-item service is available.
Definition at line 639 of file ResourceLink.php.
References ResourceLink\getSetting().
hasMembershipService | ( | ) |
Check if the Membership service is supported.
Definition at line 1027 of file ResourceLink.php.
References ResourceLink\hasMembershipsService(), and Util\logDebug().
hasMembershipsService | ( | ) |
Check if a Memberships service is available.
Definition at line 603 of file ResourceLink.php.
References ResourceLink\getContext(), ResourceLink\getContextId(), ResourceLink\getPlatform(), and ResourceLink\getSetting().
Referenced by ResourceLink\hasMembershipService().
hasOutcomesService | ( | ) |
Check if an Outcomes service is available.
Definition at line 585 of file ResourceLink.php.
References Result\$SCOPE, Score\$SCOPE, ResourceLink\getPlatform(), and ResourceLink\getSetting().
hasResultService | ( | ) |
Check if the Result service is available.
Definition at line 675 of file ResourceLink.php.
References Result\$SCOPE, and ResourceLink\getSetting().
hasScoreService | ( | ) |
Check if the Score service is available.
Definition at line 657 of file ResourceLink.php.
References Score\$SCOPE, and ResourceLink\getSetting().
hasSettingService | ( | ) |
Check if the Setting extension service is available.
Definition at line 627 of file ResourceLink.php.
References ResourceLink\getSetting().
hasToolSettingsService | ( | ) |
Check if the Tool Settings service is available.
Definition at line 957 of file ResourceLink.php.
References ResourceLink\getPlatform(), and ResourceLink\getSetting().
initialise | ( | ) |
Initialise the resource link.
Synonym for initialize().
Definition at line 283 of file ResourceLink.php.
References ResourceLink\initialize().
initialize | ( | ) |
Initialise the resource link.
Definition at line 266 of file ResourceLink.php.
Referenced by ResourceLink\__construct(), and ResourceLink\initialise().
save | ( | ) |
Save the resource link to the database.
Definition at line 293 of file ResourceLink.php.
References ResourceLink\getDataConnector().
Referenced by ResourceLink\saveSettings().
saveSettings | ( | ) |
Save setting values.
Definition at line 569 of file ResourceLink.php.
References ResourceLink\save().
Referenced by ResourceLink\doSettingService().
setConsumerId | ( | $consumerId | ) |
Set tool consumer ID.
int | $consumerId | Tool Consumer ID for this resource link. |
Definition at line 351 of file ResourceLink.php.
References Util\logDebug(), and ResourceLink\setPlatformId().
setContext | ( | $context | ) |
Set context.
Context | $context | Context for this resource link. |
Definition at line 430 of file ResourceLink.php.
setContextId | ( | $contextId | ) |
Set context ID.
int | null | $contextId | Context ID for this resource link. |
Definition at line 441 of file ResourceLink.php.
setPlatformId | ( | $platformId | ) |
Set platform ID.
int | null | $platformId | Platform ID for this resource link. |
Definition at line 391 of file ResourceLink.php.
Referenced by ResourceLink\setConsumerId().
setRecordId | ( | $id | ) |
Set resource link record ID.
int | string | $id | Record ID for this resource link. |
Definition at line 484 of file ResourceLink.php.
setSetting | ( | $name, | |
$value = null |
|||
) |
Set a setting value.
string | $name | Name of setting |
string | array | null | $value | Value to set, use an empty value to delete a setting (optional, default is null) |
Definition at line 531 of file ResourceLink.php.
References ResourceLink\getSetting().
Referenced by ResourceLink\doSettingService().
setSettings | ( | $settings | ) |
Set an array of all setting values.
array | $settings | Associative array of setting values |
Definition at line 559 of file ResourceLink.php.
setToolSettings | ( | $settings = array() | ) |
Set Tool Settings.
array | $settings | An associative array of settings (optional, default is none) |
Definition at line 1001 of file ResourceLink.php.
References ResourceLink\getPlatform(), and ResourceLink\getSetting().
int null $created = null |
Timestamp for when the object was created.
Definition at line 176 of file ResourceLink.php.
string null $extRequest = null |
Request for last service request.
Definition at line 134 of file ResourceLink.php.
array null $extRequestHeaders = null |
Request headers for last service request.
Definition at line 141 of file ResourceLink.php.
string null $extResponse = null |
Response from last service request.
Definition at line 148 of file ResourceLink.php.
array null $extResponseHeaders = null |
Response header from last service request.
Definition at line 155 of file ResourceLink.php.
array null $groups = null |
User groups (null if the platform does not support the groups enhancement)
A group is represented by an associative array with the following elements:
Definition at line 120 of file ResourceLink.php.
Referenced by ResourceLink\getMemberships().
array null $groupSets = null |
User group sets (null if the platform does not support the groups enhancement)
A group set is represented by an associative array with the following elements:
Definition at line 108 of file ResourceLink.php.
HttpMessage null $lastServiceRequest = null |
HttpMessage object for last service request.
Definition at line 127 of file ResourceLink.php.
string null $ltiResourceLinkId = null |
Resource link ID as supplied in the last connection request.
Definition at line 93 of file ResourceLink.php.
Referenced by ResourceLink\createLineItem(), ResourceLink\fromConsumer(), ResourceLink\fromContext(), ResourceLink\fromPlatform(), and ResourceLink\getId().
string null $primaryResourceLinkId = null |
Primary key value for resource link being shared (if any).
Definition at line 162 of file ResourceLink.php.
bool null $shareApproved = null |
Whether the sharing request has been approved by the primary resource link.
Definition at line 169 of file ResourceLink.php.
string null $title = null |
Context title.
Definition at line 86 of file ResourceLink.php.
int null $updated = null |
Timestamp for when the object was last updated.
Definition at line 183 of file ResourceLink.php.
const EXT_CREATE = 4 |
Create action.
Definition at line 39 of file ResourceLink.php.
const EXT_DELETE = 3 |
Delete action.
Definition at line 34 of file ResourceLink.php.
Referenced by ResourceLink\doOutcomesService(), and ResourceLink\doSettingService().
const EXT_READ = 1 |
Read action.
Definition at line 24 of file ResourceLink.php.
Referenced by ResourceLink\doOutcomesService(), and ResourceLink\doSettingService().
const EXT_TYPE_DECIMAL = 'decimal' |
Decimal outcome type.
Definition at line 49 of file ResourceLink.php.
const EXT_TYPE_LETTER_AF = 'letteraf' |
Letter (A-F) outcome type.
Definition at line 64 of file ResourceLink.php.
const EXT_TYPE_LETTER_AF_PLUS = 'letterafplus' |
Letter (A-F) with optional +/- outcome type.
Definition at line 69 of file ResourceLink.php.
const EXT_TYPE_PASS_FAIL = 'passfail' |
Pass/fail outcome type.
Definition at line 74 of file ResourceLink.php.
const EXT_TYPE_PERCENTAGE = 'percentage' |
Percentage outcome type.
Definition at line 54 of file ResourceLink.php.
const EXT_TYPE_RATIO = 'ratio' |
Ratio outcome type.
Definition at line 59 of file ResourceLink.php.
const EXT_TYPE_TEXT = 'freetext' |
Free text outcome type.
Definition at line 79 of file ResourceLink.php.
const EXT_UPDATE = 5 |
Update action.
Definition at line 44 of file ResourceLink.php.
const EXT_WRITE = 2 |
Write (create/update) action.
Definition at line 29 of file ResourceLink.php.
Referenced by ResourceLink\doOutcomesService(), and ResourceLink\doSettingService().