Skip to main content
Version: 8.1

system.user.addHoliday

This function is used in Python Scripting.

Description​

Allows a holiday to be added.

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.addHoliday(holiday)

Parameters​

TypeParameterDescription
HolidayModelholidayThe holiday to add, as a HolidayModel object.

Returns​

UIResponse - A UIResponse object with lists of warning, errors and info about the success or failure of the add.

Scope​

Gateway, Vision Client, Perspective Session

Code Examples​

Example #1
# This example adds a holiday.
def printResponse(responseList):
if len(responseList) > 0:
for response in responseList:
print "", response
else:
print " None"

from com.inductiveautomation.ignition.common.user.schedule import HolidayModel
from java.util import Date
holidayName = "Groundhog Day"
d = Date(2016 - 1900, 2, 2) # java dates start in 1900
repeatAnnually = False
myHoliday = HolidayModel(holidayName, d, repeatAnnually)
response = system.user.addHoliday(myHoliday)

warnings = response.getWarns()
print "Warnings are:"
printResponse(warnings)

errors = response.getErrors()
print "Errors are:"
printResponse(errors)

infos = response.getInfos()
print "Infos are:"
printResponse(infos)

"""The example above outputs the following:
Warnings are:
None
Errors are:
None
Infos are:
New holiday "Groundhog Day" added.
"""