UpdateAppointmentGroupDTO
extends AbstractBaseDto
in package
UpdateAppointmentGroupDTO
Data Transfer Object for updating appointment groups in Canvas LMS. Handles the transformation of appointment group update data into the multipart format expected by the Canvas API.
Table of Contents
Properties
- $allowObserverSignup : bool|null
- Whether observer users can sign-up for an appointment
- $contextCodes : array<string|int, string>|null
- Array of context codes (courses, e.g. course_1) this group should be linked to Users in the course(s) with appropriate permissions will be able to sign up
- $description : string|null
- Longer text description of the appointment group
- $locationAddress : string|null
- Location address
- $locationName : string|null
- Location name of the appointment group
- $maxAppointmentsPerParticipant : int|null
- Maximum number of time slots a user may register for
- $minAppointmentsPerParticipant : int|null
- Minimum number of time slots a user must register for If not set, users do not need to sign up for any time slots
- $newAppointments : array<int, array{start_at?: string, end_at?: string}>|null
- Nested array of start time/end time pairs indicating time slots Format: [['start_at' => '2012-07-19T21:00:00Z', 'end_at' => '2012-07-19T22:00:00Z'], ...]
- $participantsPerAppointment : int|null
- Maximum number of participants that may register for each time slot Defaults to null (no limit)
- $participantVisibility : string|null
- 'private' - participants cannot see who has signed up for a particular time slot 'protected' - participants can see who has signed up
- $publish : bool|null
- Whether this appointment group should be published (made available for signup) Once published, an appointment group cannot be unpublished
- $subContextCodes : array<string|int, string>|null
- Array of sub context codes (course sections or a single group category) Used to limit the appointment group to particular sections
- $title : string|null
- Short title for the appointment group
- $apiPropertyName : string
- The name of the property in the API
Methods
- __construct() : mixed
- BaseDto constructor.
- toApiArray() : array<int, array{name: string, contents: string}>
- Convert DTO to API-compatible array format
- toArray() : array<string|int, mixed>
- Convert the DTO to an array
Properties
$allowObserverSignup
Whether observer users can sign-up for an appointment
public
bool|null
$allowObserverSignup
= null
$contextCodes
Array of context codes (courses, e.g. course_1) this group should be linked to Users in the course(s) with appropriate permissions will be able to sign up
public
array<string|int, string>|null
$contextCodes
= null
$description
Longer text description of the appointment group
public
string|null
$description
= null
$locationAddress
Location address
public
string|null
$locationAddress
= null
$locationName
Location name of the appointment group
public
string|null
$locationName
= null
$maxAppointmentsPerParticipant
Maximum number of time slots a user may register for
public
int|null
$maxAppointmentsPerParticipant
= null
$minAppointmentsPerParticipant
Minimum number of time slots a user must register for If not set, users do not need to sign up for any time slots
public
int|null
$minAppointmentsPerParticipant
= null
$newAppointments
Nested array of start time/end time pairs indicating time slots Format: [['start_at' => '2012-07-19T21:00:00Z', 'end_at' => '2012-07-19T22:00:00Z'], ...]
public
array<int, array{start_at?: string, end_at?: string}>|null
$newAppointments
= null
$participantsPerAppointment
Maximum number of participants that may register for each time slot Defaults to null (no limit)
public
int|null
$participantsPerAppointment
= null
$participantVisibility
'private' - participants cannot see who has signed up for a particular time slot 'protected' - participants can see who has signed up
public
string|null
$participantVisibility
= null
$publish
Whether this appointment group should be published (made available for signup) Once published, an appointment group cannot be unpublished
public
bool|null
$publish
= null
$subContextCodes
Array of sub context codes (course sections or a single group category) Used to limit the appointment group to particular sections
public
array<string|int, string>|null
$subContextCodes
= null
$title
Short title for the appointment group
public
string|null
$title
= null
$apiPropertyName
The name of the property in the API
protected
string
$apiPropertyName
= ''
Methods
__construct()
BaseDto constructor.
public
__construct(array<string|int, mixed> $data) : mixed
Parameters
- $data : array<string|int, mixed>
Tags
toApiArray()
Convert DTO to API-compatible array format
public
toApiArray() : array<int, array{name: string, contents: string}>
Return values
array<int, array{name: string, contents: string}>toArray()
Convert the DTO to an array
public
toArray() : array<string|int, mixed>