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 |
дата рождения без года (только день и месяц); |
|
|
основной адрес электронной почты; |
|
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] Алексей Пикуров