Skip to main content
Version: 8.1

system.user.createScheduleAdjustment

This function is used in Python Scripting.

Description​

Creates a schedule adjustment.

Client Permission Restrictions​

Permission Type: User Management

Client access to this scripting function is blocked to users that do not meet the role/zone requirements for the above permission type. This function is unaffected when run in the Gateway scope.

Syntax​

system.user.createScheduleAdjustment(startDate, endDate, isAvailable, note )

Parameters​

TypeParameterDescription
DatestartDateThe starting date of the schedule adjustment.
DateendDateThe ending date of the schedule adjustment.
BooleanisAvailableTrue if the user is available during this schedule adjustment.
StringnoteA note about the schedule adjustment.

Returns​

Schedule Adjustment - A ScheduleAdjustment object that can be added to a user.

Scope​

Gateway, Vision Client, Perspective Session

Code Examples​

Example #1
# Specify the range of the schedule change.
start = system.date.parse("2019-07-01 17:00:00")
end = system.date.parse("2019-07-05 17:00:00")

# Create an adjusted schedule.
scheduleAdjustment = system.user.createScheduleAdjustment(start, end, True, "Summer swing schedule change.")

# Get the user we need to adjust.
user = system.user.getUser("default", "george")

# Apply the adjusted schedule to the temporary user that lives in this script.
user.addScheduleAdjustments([scheduleAdjustment])

# Override the old george user in the user source, with the new user we created in this script.
system.user.editUser("default", user)