1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67
|
from collections import namedtuple
from ..properties import FreeBusyView
from ..util import MNS, create_element, set_xml_value
from .common import EWSService
class GetUserAvailability(EWSService):
"""Get detailed availability information for a list of users.
MSDN:
https://docs.microsoft.com/en-us/exchange/client-developer/web-service-reference/getuseravailability-operation
"""
SERVICE_NAME = "GetUserAvailability"
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
self.tzinfo = None
def call(self, tzinfo, mailbox_data, timezone, free_busy_view_options):
# TODO: Also supports SuggestionsViewOptions, see
# https://docs.microsoft.com/en-us/exchange/client-developer/web-service-reference/suggestionsviewoptions
self.tzinfo = tzinfo
return self._elems_to_objs(
self._chunked_get_elements(
self.get_payload,
items=mailbox_data,
timezone=timezone,
free_busy_view_options=free_busy_view_options,
)
)
@property
def _timezone(self):
return self.tzinfo
def _elem_to_obj(self, elem):
fake_account = namedtuple("Account", ["default_timezone"])(default_timezone=self.tzinfo)
return FreeBusyView.from_xml(elem=elem, account=fake_account)
def get_payload(self, mailbox_data, timezone, free_busy_view_options):
payload = create_element(f"m:{self.SERVICE_NAME}Request")
set_xml_value(payload, timezone, version=self.protocol.version)
mailbox_data_array = create_element("m:MailboxDataArray")
set_xml_value(mailbox_data_array, mailbox_data, version=self.protocol.version)
payload.append(mailbox_data_array)
return set_xml_value(payload, free_busy_view_options, version=self.protocol.version)
@staticmethod
def _response_messages_tag():
return f"{{{MNS}}}FreeBusyResponseArray"
@classmethod
def _response_message_tag(cls):
return f"{{{MNS}}}FreeBusyResponse"
def _get_elements_in_response(self, response):
for msg in response:
container_or_exc = self._get_element_container(message=msg.find(f"{{{MNS}}}ResponseMessage"))
if isinstance(container_or_exc, Exception):
yield container_or_exc
else:
yield from self._get_elements_in_container(container=msg)
@classmethod
def _get_elements_in_container(cls, container):
return [container.find(f"{{{MNS}}}FreeBusyView")]
|