MyChat Scripts: функция mGetUserAttribute, получить атрибут пользователя

MyChat Scripts: функция mGetUserAttribute, получить атрибут пользователя

"Для разработчиков", "Серверные скрипты", "Описание функций", "Пользователи", "mGetUserAttribute".

 

Функция для получения любого поля из профиля пользователя по его атрибуту.

 

Синтаксис

function mGetUserAttribute(iUIN: integer; sAttributeName: string): string;

 

Параметры и возвращаемые значения

Параметр

Тип

Значение

iUIN

integer

уникальный идентификатор пользователя;

sAttributeName

string

имя атрибута из профиля, который нужно получить. Можно указать только один атрибут.

 

Список доступных полей пользователя

Название

Описание

Avatar

номер аватара пользователя;

Tag

текстовый тег, специальное поле, можно изменять и читать через MSL;

UserDomainName

имя домена пользователя;

DomainUserRegisteredTime

дата и время регистрации доменного пользователя;

DomainUserLastChangeTime

дата и время последней модификации профиля доменного пользователя;

InternalNickName

ник пользователя. Если пользователь доменный — это его доменное имя;

DisplayName

отображаемое имя пользователя. Стиль настраивается на сервере;

Active

активна или заблокирована учётная запись пользователя;

FirstName

реальное имя пользователя;

MiddleName

отчество пользователя;

LastName

фамилия пользователя;

Registered

дата и время создания учётной записи;

Role

название группы прав пользователя;

Home_MaritalStatus

семейное положение:

-1 — не указано;

1 — в серьёзных отношениях;

2 — вдовец/вдова;

3 — женат/замужем;

4 — помолвлен(а)/обручен(а);

5 — разведен(а);

6 — разошлись;

7 — холост/не замужем;

Home_Phone

домашний телефон;

Home_Fax

домашний факс;

Home_Birthday

дата рождения;

Home_Birthday_Without_Year

дата рождения без года (только день и месяц);

Email

основной адрес электронной почты;

Home_Cellular

личный мобильный;

Home_StreetAddress

домашний адрес;

Home_City

город проживания;

Home_State

штат/провинция/область/край проживания;

Home_ZIP

домашний почтовый индекс;

Home_Country

страна проживания;

Home_WWW

личная WEB-страница;

Work_DivDept

рабочее подразделение;

Work_Position

должность;

Work_CompanyName

название компании;

Work_Office

рабочий офис;

Work_Phone

рабочий телефон;

Work_Fax

рабочий факс;

Work_Pager

рабочий пейджер или номер мессенджера;

Work_StreetAddress

рабочий адрес;

Work_City

рабочий город;

Work_State

рабочий штат/провинция/область/край;

Work_ZIP

рабочий почтовый индекс;

Work_Country

рабочая страна;

Work_WWW

рабочая WEB-страница;

Spoken_Lang_1

владение языками, номер 1;

Spoken_Lang_2

владение языками, номер 2;

Spoken_Lang_3

владение языками, номер 3;

Interest_Section_1

область интересов, номер 1;

Interest_Words_1

область интересов, ключевые слова, номер 1;

Interest_Section_2

область интересов, номер 2;

Interest_Words_2

область интересов, ключевые слова, номер 2;

Interest_Section_3

область интересов, номер 3;

Interest_Words_3

область интересов, ключевые слова, номер 3;

Interest_Section_4

область интересов, номер 4;

Interest_Words_4

область интересов, ключевые слова, номер 4;

History_Section_1

тип прошлого места работы или учёбы, номер 1;

History_Words_1

тип прошлого места работы или учёбы, ключевые слова номер 1;

History_Section_2

тип прошлого места работы или учёбы, номер 2;

History_Words_2

тип прошлого места работы или учёбы, ключевые слова номер 2;

History_Section_3

тип прошлого места работы или учёбы, номер 3;

History_Words_3

тип прошлого места работы или учёбы, ключевые слова номер 3;

Past_Organization_1

тип организации, прошлого места работы, номер 1;

Past_Organization_Words_1

тип организации, прошлого места работы, ключевые слова номер 1;

Past_Organization_2

тип организации, прошлого места работы, номер 2;

Past_Organization_Words_2

тип организации, прошлого места работы, ключевые слова номер 2;

Past_Organization_3

тип организации, прошлого места работы, номер 3;

Past_Organization_Words_3

тип организации, прошлого места работы, ключевые слова номер 3;

Sex

пол пользователя: 0 — не определён, 1 — мужской, 2 — женский;

AuthType

тип аутентификации клиента: 0 — стандартный, 1 — Active Directory, 2 — без пароля, 3 — Transparent AD;

FotoCRC32

CRC32 фотографии пользователя;

LastAccess

дата и время последнего доступа к серверу;

LastSpeakTime

дата и время последнего отправленного сообщения;

Custom_1

текстовое custom-поле номер 1;

Custom_2

текстовое custom-поле номер 2;

Custom_3

текстовое custom-поле номер 3;

OfflineFilesExists

есть ли офлайн-файлы для пользователя;

State

текущий сетевой статус пользователя;

FavoriteChannelsExists

есть ли у пользователя список "любимых" текстовых конференций;

UnreadedBroadcastsExists

наличие непрочитанных оповещений;

Hello_Message

сообщение-приветствие, если есть. Показывается всем пользователям, открывшим приват с этим человеком;

Autoreplay_Message

сообщение-автоответчик;

Autoreplay

включен или выключен автоответчик (1 — включен, 0 — выключен);

Reputation

репутация пользователя, число;

About

информационное поле "О пользователе";

SessionID

custom-поле, уникальная строка для авторизации с внешних сервисов;

AuthService

custom-поле, название внешнего сервиса, с которого происходит авторизация пользователя.

 
Результат функции

Текстовая строка, свойства атрибута пользователя. Если пользователь не найден или не заполнен, вернётся пустая строка.

 

Пример

var
  sNick, sDisplayName: string;
begin
  sNick          := mGetUserAttribute(6, 'InternalNickName');
  sDisplayName   := mGetUserAttribute(6, 'DisplayName');
  
  mLogScript(sNick, 'Nick');
  mLogScript(sDisplayName, 'Real name');
end.

Результат работы скрипта

[15:29:11] (Log "mGetUserAttribute"): [Nick] (Hobit)

[15:29:11] (Log "mGetUserAttribute"): [Real name] Алексей Пикуров

 

Ещё посмотреть

mGetUserDataAsJSON

mLogScript