User¶
-
class
moco_wrapper.models.
User
(moco)¶ Class for handling users.
-
create
(firstname: str, lastname: str, email: str, password: str, unit_id: int, active: bool = None, external: bool = None, language: str = None, mobile_phone: str = None, work_phone: str = None, home_address: str = None, birthday: datetime.date = None, custom_properties: dict = None, info: str = None)¶ Creates a new user.
Parameters: - firstname (str) – First name of the user
- lastname (str) – Last name of the user
- email (str) – Email address
- password (str) – Password to use when creating the user
- unit_id (int) – Id of the unit/team the user belongs to
- active (bool) – If the user should be activated or not
- external (bool) – If the user is an employee or an external employee (his user id will now show up in reports etc.)
- language (str) – de, de-AT, de-CH, en, it or fr
- mobile_phone (str) – Mobile phone number
- work_phone (str) – Work phone number
- home_address (str) – Phyical home address
- birthday (datetime.date, str) – Birthday date
- custom_properties (dict) – Custom fields to add to the user
- info (str) – Additional information about the user
Returns: The created user object
-
delete
(user_id: int)¶ Deletes an existing user.
Parameters: user_id (int) – Id of the user to delete Returns: Empty response on success
-
get
(user_id: int)¶ Get a single user.
Parameters: user_id (int) – Id of the user Returns: Single user object
-
getlist
(include_archived: bool = None, sort_by: str = None, sort_order: str = 'asc', page: int = 1)¶ Get a list of users.
Parameters: - include_archived (bool) – Include archived users in the list
- sort_by (str) – Sort by key
- sort_order (str) – asc or desc (default asc)
- page (int) – Page number (default 1)
Returns: List of users
-
update
(user_id, firstname: str = None, lastname: str = None, email: str = None, password: str = None, unit_id: int = None, active: bool = None, external: bool = None, language: str = None, mobile_phone: str = None, work_phone: str = None, home_address: str = None, birthday: datetime.date = None, custom_properties: dict = None, info: str = None)¶ Updates an existing user.
Parameters: - user_id (int) – the Id of the user
- firstname (str) – First name of the user
- lastname (str) – Last name of the user
- email (str) – Email address
- password (str) – Password to use when creating the user
- unit_id (int) – Id of the unit/team the user belongs to
- active (bool) – If the user should be activated or not
- external (bool) – If the user is an employee or an external employee (his user id will now show up in reports etc.)
- language (str) – de, de-AT, de-CH, en, it or fr
- mobile_phone (str) – Mobile phone number
- work_phone (str) – Work phone number
- home_address (str) – Physical home address
- birthday (datetime.date, str) – Birthday date
- custom_properties (dict) – Custom fields to add to the user
- info (str) – Additional information abotu the user
Returns: The updated user object
-