Используется для поиска по пользователям, создания новых пользователей, получения текущего пользователя и запроса восстановления пароля.

Hierarchy

  • Users

Methods

addOAuth2Data

  • Метод добавляет способ аутентификации OAuth2 для пользователя.

    const user = await System.users.search().where(f => f.email.eq('mail@example.com')).first();
    const oauth2Record: OAuth2Record = {externalId: "someId", providerId: "someId"};
    await System.users.addOAuth2Data(user, oauth2Record);
    

    Parameters

    Returns Promise<void>

create

  • Метод позволяет инициализировать нового пользователя.

    Для новых пользователей обязательным параметром является email. После заполнения данных нового пользователя его необходимо сохранить с помощью метода UserItem.save.

    const newUser = System.users.create();
    newUser.data.email = 'mail@example.com';
    await newUser.save()
    

    Returns UserItem

createWithAuthData

  • createWithAuthData(authData: AuthData): UserItem
  • Метод позволяет инициализировать нового пользователя в активном статусе с заполненными параметрами OAuth2.

    Для новых пользователей обязательным параметром является email. После заполнения данных нового пользователя его необходимо сохранить с помощью метода UserItem.save.

    const oauth2Record: OAuth2Record = {externalId: "someId", providerId: "someId"};
    const authData: AuthData = {oauth2: [oauth2Record]};
    const newUser = System.users.createWithAuthData(authData);
    newUser.data.email = 'mail@example.com';
    await newUser.save()
    

    Parameters

    • authData: AuthData

    Returns UserItem

getCurrentUser

  • Метод позволяет получить текущего пользователя.

    const currentUser = await System.users.getCurrentUser();
    

    Returns Promise<CurrentUserItem>

removeOAuth2Data

  • Метод удаляет способ аутентификации OAuth2 у пользователя.

    const user = await System.users.search().where(f => f.email.eq('mail@example.com')).first();
    const oauth2Record: OAuth2Record = {externalId: "someId", providerId: "someId"};
    await System.users.removeOAuth2Data(user, oauth2Record);
    

    Parameters

    Returns Promise<void>

requestPasswordRecovery

  • requestPasswordRecovery(email: string): Promise<void>
  • Метод генерирует новую ссылку на восстановление пароля пользователя

    и отправляет эту ссылку на email, переданный в качестве параметра.

    Parameters

    • email: string

    Returns Promise<void>

search

  • Метод позволяет выполнить поиск пользователей.

    Для выборки элементов коллекций используется объект Search:

    const users = await System.users.search()
        .where(f => f.email.eq("email@example.com"))
        .all();
    

    Пример поиска по статусу пользователя:

    const users = await System.users.search()
        .where(u => u.__status.eq(UserStatus.Blocked))
        .all();
    

    Подробнее об использовании объекта поиска можно узнать в статье «Работа с приложениями».

    Returns UserSearch