def add(self):
"""Creates a Contact resource"""
contact = Contact(self.context)
self.add_child(contact)
qry = CreateEntityQuery(self, contact, contact)
self.context.add_query(qry)
return contact
def add_from_json(self, contact_creation_information):
"""Creates a Contact resource from JSON"""
contact = Contact(self.context)
self.add_child(contact)
qry = CreateEntityQuery(self, contact_creation_information, contact)
self.context.add_query(qry)
return contact
def add_from_json(self, event_creation_information):
"""Creates a Event resource from JSON"""
event = Event(self.context)
self.add_child(event)
qry = CreateEntityQuery(self, event_creation_information, event)
self.context.add_query(qry)
return event
def add(self, group_creation_information):
"""Creates a Group resource"""
group = Group(self.context)
self.add_child(group)
qry = CreateEntityQuery(self, group_creation_information)
self.context.add_query(qry)
return group
def add(self, list_creation_information):
"""Creates a Drive list resource"""
target_list = List(self.context)
self.add_child(target_list)
qry = CreateEntityQuery(self, list_creation_information, target_list)
self.context.add_query(qry)
return target_list
def add_from_json(self, message_creation_information):
"""Create a draft of a new message from JSON"""
message = Message(self.context)
self.add_child(message)
qry = CreateEntityQuery(self, message_creation_information, message)
self.context.add_query(qry)
return message
def add(self):
"""Adds Site Page
"""
return_type = SitePage(self.context)
return_type.set_property("Title", "", True)
qry = CreateEntityQuery(self, return_type, return_type)
self.context.add_query(qry)
self.add_child(return_type)
return return_type
def add(self, user_properties):
"""Create a new user.
:type user_properties: office365.directory.users.user_profile.UserProfile
"""
return_type = User(self.context)
qry = CreateEntityQuery(self, user_properties, return_type)
self.context.add_query(qry)
self.add_child(return_type)
return return_type
def add(self, field_create_information):
"""Adds a fields to the fields collection.
:type field_create_information: office365.sharepoint.fields.field_creation_information.FieldCreationInformation
"""
field = Field.create_field_from_type(self.context, field_create_information)
self.add_child(field)
qry = CreateEntityQuery(self, field, field)
self.context.add_query(qry)
return field
def add(self, user_properties):
"""Create a new user.
:type user_properties: UserProfile
"""
usr = User(self.context)
qry = CreateEntityQuery(self, user_properties, usr)
self.context.add_query(qry)
self.add_child(usr)
return usr
def add(self, list_creation_information):
"""Creates a List resource
:type list_creation_information: office365.sharepoint.lists.list_creation_information.ListCreationInformation
"""
target_list = List(self.context)
self.add_child(target_list)
qry = CreateEntityQuery(self, list_creation_information, target_list)
self.context.add_query(qry)
return target_list
def add(self, **kwargs):
"""Creates a resource
:rtype: office365.entity.Entity
"""
return_type = self.new()
self.add_child(return_type)
qry = CreateEntityQuery(self, kwargs, return_type)
self.context.add_query(qry)
return return_type
def add(self, server_relative_url):
"""Adds the folder that is located at the specified URL to the collection.
:type server_relative_url: str
"""
folder = Folder(self.context)
self.add_child(folder)
folder.set_property("ServerRelativeUrl", server_relative_url)
qry = CreateEntityQuery(self, folder, folder)
self.context.add_query(qry)
return folder
def add(self, group_properties):
"""Create a Group resource. You can create the following types of groups:
Office 365 group (unified group)
Security group
:type group_properties: GroupProfile"""
grp = Group(self.context)
self.add_child(grp)
qry = CreateEntityQuery(self, group_properties, grp)
self.context.add_query(qry)
return grp
def add_from_json(self, params):
"""Creates a Entity resource from JSON
:type params: dict
:rtype: office365.entity.Entity
"""
entity_object = self._item_type(self.context)
self.add_child(entity_object)
qry = CreateEntityQuery(self, params, entity_object)
self.context.add_query(qry)
return entity_object
def add(self, name):
"""Use this API to create a new calendar for a user.
:type name: str
:rtype: Calendar
"""
cal = Calendar(self.context)
cal.set_property("Name", name)
self.add_child(cal)
qry = CreateEntityQuery(self, cal, cal)
self.context.add_query(qry)
return cal
def add(self, create_node_info):
"""
Creates a navigation node object and adds it to the collection.
:type create_node_info: office365.sharepoint.navigation.navigation_node_creation_information.NavigationNodeCreationInformation
"""
target_node = NavigationNode(self.context)
target_node.title = create_node_info.Title
target_node.url = create_node_info.Url
self.add_child(target_node)
qry = CreateEntityQuery(self, target_node, target_node)
self.context.add_query(qry)
return target_node
def add_user(self, login_name):
"""
Adds a user
:type login_name: str
"""
user = User(self.context)
user._parent_collection = self
user.set_property('LoginName', login_name)
qry = CreateEntityQuery(self, user, user)
self.context.add_query(qry)
self.add_child(user)
return user
def add(self, item_body):
"""Create a new chatMessage in the specified channel.
:param office365.graph.teams.itemBody.ItemBody item_body: Item body.
"""
new_msg = ChatMessage(self.context)
self.add_child(new_msg)
payload = {
"body": item_body,
}
qry = CreateEntityQuery(self, payload, new_msg)
self.context.add_query(qry)
return new_msg
def create_folder(self, name):
"""Create a new folder or DriveItem in a Drive with a specified parent item or path.
:param str name: Folder name
"""
drive_item = DriveItem(self.context, None)
self.children.add_child(drive_item)
payload = {
"name": name,
"folder": {},
"@microsoft.graph.conflictBehavior": ConflictBehavior.Rename
}
qry = CreateEntityQuery(self.children, payload, drive_item)
self.context.add_query(qry)
return drive_item
def add(self, displayName, description=None):
"""Create a new channel in a Microsoft Team, as specified in the request body.
:param str description: Optional textual description for the channel.
:param str displayName: Channel name as it will appear to the user in Microsoft Teams.
"""
new_channel = Channel(self.context)
self.add_child(new_channel)
payload = {
"displayName": displayName,
"description": description,
}
qry = CreateEntityQuery(self, payload, new_channel)
self.context.add_query(qry)
return new_channel
def add(self, content_type_info):
"""Adds a new content type to the collection and returns a reference to the added SP.ContentType.
:param ContentTypeCreationInformation content_type_info: Specifies properties that is to be used to
construct the new content type.
"""
ct = ContentType(self.context)
self.add_child(ct)
ct_json = content_type_info.to_json()
for k, v in ct_json.items():
if k == "Id":
ct.set_property(k, {"StringValue": v}, True)
else:
ct.set_property(k, v, True)
qry = CreateEntityQuery(self, ct, ct)
self.context.add_query(qry)
return ct
def _add_sub_folder():
new_folder_url = "/".join([self.serverRelativeUrl, name])
new_folder.set_property("ServerRelativeUrl", new_folder_url)
qry = CreateEntityQuery(self.folders, new_folder, new_folder)
self.context.add_query(qry)