MyChat Scripts Engine: mGetUserAttribute

MyChat Scripts Engine: 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 — не указано;

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

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

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

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

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

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

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

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 фотографии пользователя;

Last_Access

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

LastSpeakTime

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

Custom_1

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

Custom_2

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

Custom_3

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

OfflineFilesExists

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

State

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

FavoriteChannelsExists

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

UnreadedBroadcastsExists

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

OfflineMessagesExists

наличие не полученных офлайн сообщений;

Hello_Message

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

Autoreplay_Message

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

Autoreplay

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

Reputation

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

About

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

SessionID

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

AuthService

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

CurrentFIOByPreset

отображаемое имя пользователя согласно шаблону настроек.

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

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

 

Пример

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