1С-Битрикс: Сайт медицинской организации (стр. 2 )

id – ID типа периода.

В случае успеха возвращает массив с полями ID, TYPE, DESCRIPTION.

В случае неудачи возвращает false.

LinkToSite

bool LinkToSite ( string site_id array period_types = array() )

Метод устанавливает связи между типами периодов и сайтом

site_id – ID сайта

period_types – массив ID периодов, которые будут привязаны к сайту. Периоды, отсутствующие в массиве, будут отвязаны от сайта.

Вспомогательные методы

GetTypeName

mixed GetTypeName ( int id )

Метод возвращает название типа периода по его идентификатору.

id – ID типа периода.

В случае успеха возвращает название типа периода.

В случае неудачи возвращает false.

Класс MCSchedule

Свойства класса

·  MCPeriod::$LAST_ERRORS – содержит массив ошибок, которые возникли во время работы последнего метода.

Поля, используемые в методах

Название поля	Тип	Описание
EMPLOYEE	число	ID сотрудника (из списка пользователей)
SERVICE	число	ID услуги (элемент инфоблока услуг)
SITE_ID	строка	ID сайта
WEEK_START	строка	Дата начала недели, к которой относится запись расписания в формате DD. MM. YYYY
WEEK_DAY	строка	День недели от 1 до 7
PERIOD	число	ID периода
TYPE	число	Тип периода, можно задавать с помощью специальных констант: ·  rec_type_talon - запись по талону; ·  rec_type_line - живая очередь; ·  rec_type_wish - запись в желаемое время; ·  rec_type_vacation — отпуск; ·  rec_type_hospital — больничный.
PLACEMENT	число	ID помещения (элемента инфоблока помещений), где будет проходить прием.
SECTOR	число	ID врачебного участка (элемента инфоблока врачебных участков).

Основные методы

Add

bool Add ( array fields )

Метод добавляет запись расписания. Если такая запись уже существует, то она будет просто обновлена.

fields — массив полей расписания. В качестве ключей данного массива допустимо использовать:

·  EMPLOYEE — (не обязательный) ID сотрудника (из списка пользователей).

·  SERVICE — (не обязательный) ID услуги (элемент инфоблока услуг).

·  PERIOD ­ ID периода.

·  WEEK_START - дата начала недели, к которой относится запись расписания в формате DD. MM. YYYY.

·  WEEK_DAY - День недели от 1 до 7

·  SITE_ID — (не обязательный) ID сайта, по умолчанию используется значение системной константы SITE_ID.

В случае успеха возвращает true.

В случае неудачи возвращает false.

Сlear

Сlear()

Метод удаляет всю информацию о записи на прием: расписания, талоны, и т. д.

ClearSchedules

ClearSchedules ()

Метод удаляет все ранее созданные расписания.

Delete

mixed Delete ( array filter )

Метод удаляет все записи расписания на определенной неделе, удовлетворяющие переданному фильтру

filter — массив полей расписания. В качестве ключей данного массива допустимо использовать:

·  EMPLOYEE — (не обязательный) ID сотрудника (из списка пользователей). По умолчанию 0 (расписание для услуг, не привязанное к конкретному специалисту).

·  SERVICE — (не обязательный) ID услуги (элемент инфоблока услуг).

·  PERIOD ­ (не обязательный) ID периода.

·  WEEK_START - дата начала недели, к которой относится запись расписания в формате DD. MM. YYYY.

·  WEEK_DAY - (не обязательный) День недели от 1 до 7

·  SITE_ID — (не обязательный) ID сайта, по умолчанию используется значение системной константы SITE_ID.

В случае успеха возвращает true.

В случае неудачи возвращает false.

GetList

array GetList ( array filter string group = false array select = array() array additional = array() )

Метод возвращает информацию о расписании.

filter – массив полей расписания. В качестве ключей данного массива допустимо использовать:

·  EMPLOYEE — ID сотрудника (из списка пользователей).

·  SERVICE — ID услуги (элемент инфоблока услуг).

·  PERIOD ­ ID периода.

·  WEEK_START - дата начала недели, к которой относится запись расписания. Имеет два возможных формата:

·  Строка даты в формате "DD. MM. YYYY".

·  Массив вида

array ( 'COMPARSION' => способ сравнения, может принимать значения: between, >, <, =, <=, >=, <>. 'START_DATE' => дата в формате "DD. MM. YYYY", 'END_DATE' => дата в формате "DD. MM. YYYY", используется только при способе сравнения between )

·  WEEK_DAY - День недели от 1 до 7

·  SITE_ID — (не обязательный) ID сайта, по умолчанию используется значение системной константы SITE_ID.

·  PLACEMENT - (необязательный параметр) ID помещения (элемента инфоблока помещений), где будет проходить прием.

·  SECTOR - (необязательный параметр) ID врачебного участка (элемента инфоблока врачебных участков).

·  TYPE — тип периода.

group – тип групировки данных при выдаче результат. Может принимать значения:

·  пустое или false — данные не группируются и не обрабатываются, возвращается чистая выборка.

·  employee — данные группируются по сотруднику.

·  employeeSR – альтернативный вариант группировки данных по сотруднику.

·  service – данные группируются по услугам.

·  serviceSR – альтернативный вариант группировки данных по услугам.

select – массив настроек выборки данных. По умолчанию выбираются все данные В качестве значений данного массива допустимо использовать:

·  SERVICES — устанавливает необходимость выборки данных об услугах при группировке по сотрудникам.

·  PLACEMENT — устанавливает необходимость выборки данных об услугах по расписанию.

·  SECTOR — устанавливает необходимость выборки данных об услугах по расписанию.

·  EMPLOYEE — устанавливает необходимость выборки данных о сотрудниках при группировке по услугам.

additional – Массив дополнительных настроек для выборки данных. В качестве ключей данного массива допустимо использовать:

·  SERVICES — массив дополнительных настроек. В качестве ключей данного массива допустимо использовать:

·  IBLOCK_ID — ID инфоблока услуг.

·  FIELDS — массив полей инфоблока для выборки данных. По умолчанию выбираются все данные. Подробнее смотри описание поля arSelectFields метода CIBlockElement::GetList.

·  PLACEMENT — массив дополнительных настроек. В качестве ключей данного массива допустимо использовать:

·  IBLOCK_ID — ID инфоблока услуг.

·  FIELDS — массив полей инфоблока для выборки данных. По умолчанию выбираются все данные. Подробнее смотри описание поля arSelectFields метода CIBlockElement::GetList.

·  SECTOR — массив дополнительных настроек. В качестве ключей данного массива допустимо использовать:

·  IBLOCK_ID — ID инфоблока услуг.

·  FIELDS — массив полей инфоблока для выборки данных. По умолчанию выбираются все данные. Подробнее смотри описание поля arSelectFields метода CIBlockElement::GetList.

·  EMPLOYEE — массив дополнительных настроек. В качестве ключей данного массива допустимо использовать:

·  SELECT — массив с идентификаторами пользовательских полей. Подробнее смотри описание поля arParameters['SELECT'] метода CUser::GetList.

·  FIELDS — массив с идентификаторами полей для выборки. Подробнее смотри описание поля arParameters['FIELDS'] метода CUser::GetList.

Update

bool Update ( array fields array filter )

Метод обновляет запись расписания.

fields – массив полей расписания с новыми значениями. В качестве ключей данного массива допустимо использовать:

·  EMPLOYEE — (не обязательный) ID сотрудника (из списка пользователей). По умолчанию 0 (расписание для услуг, не привязанное к конкретному специалисту).

·  SERVICE — ID услуги (элемент инфоблока услуг).

·  PERIOD ­ ID периода.

·  WEEK_START - дата начала недели, к которой относится запись расписания в формате DD. MM. YYYY.

·  WEEK_DAY - День недели от 1 до 7

·  SITE_ID — (не обязательный) ID сайта, по умолчанию используется значение системной константы SITE_ID.

filter – массив полей расписания для поиска нужной записи расписания. В качестве ключей данного массива допустимо использовать:

·  EMPLOYEE — ID сотрудника (из списка пользователей).

·  SERVICE — ID услуги (элемент инфоблока услуг).

·  PERIOD ­ ID периода.

·  WEEK_START - дата начала недели, к которой относится запись расписания в формате DD. MM. YYYY.

·  WEEK_DAY - День недели от 1 до 7

·  SITE_ID — ID сайта, по умолчанию используется значение системной константы SITE_ID.

В случае успеха возвращает true.

В случае неудачи возвращает false.

Вспомогательные методы

WorkingToday

mixed WorkingToday ( bool randomOrder = false )

Метод возвращает сотрудников, работающих в этот день. Дата определяется функцией date().

randomOrder – если флаг установлен, то итоговая выборка будет перемешана в случайном порядке.

Возвращает массив вида:

array( 'Employes' => массив ID сотрудников 'workTimes' => массив времени работы сотрудников. Ключ — ID сотрудника, значение — строка вида «12:00 — 17:00» )

CheckFreeTime

mixed CheckFreeTime ( string start_time string end_time int employee int talon = false )

Метод проверяет свободно ли данное время для записи.

start_time – время начала приема в формате «DD. MM. YYYY HH:MM».

end_time - время конца приема в формате «DD. MM. YYYY HH:MM».

employee – ID сотрудника, расписание которого проверяется.

talon – ID талона, который нужно исключить из проверки.

Если талон к указанному сотруднику на данное время уже существует - возвращает true.

Если талон не существует — возвращает false.

GetDayData

array GetDayData ( array periods array params string day MCRecordWizard wizard )

Метод подготавливает данные для таблицы расписания на определенный день.

periods — массив периодов работы.

params – массив параметров. В качестве ключей данного массива допустимо использовать:

·  DAY_START — начало показа сетки расписания в часах (например, 8).

·  DAY_END — конец показа сетки расписания в часах (например, 17).

·  WEB_STEP — шаг сетки расписания в минутах.

·  SHOW_BUSY — Нужно ли определять занятость времени, если метод вызван не из записи на прием.

day – дата в формате DD. MM. YYYY.

wizard – Объект класса MCRecordWizard. Если объект будет не это класса, то считается, что метод был вызван не внутри записи на прием. При этом не обрабатывается «уже прошедшее время» и не генерируются ссылки на следующий шаг записи.

GetEmployeeServices

mixed GetEmployeeServices ( int employee bool fullInfo = false )

Метод возвращает список услуг которые есть в расписании для сотрудника.

employee – ID сотрудника.

fullInfo – если флаг установлен, то выбирается полная информация об услугах, иначе только ID.

В случае успеха возвращает массив услуг.

В случае неудачи возвращает false.

GetRecordedUsers

array GetRecordedUsers ( string date int employee )

Метод возвращает информацию о пациентах, записанных к сотруднику на определенную дату.

date – дата в формате DD. MM. YYYY

employee - ID сотрудника.

В случае успеха возвращает массив c информацией о записанных пациентах с группировкой по признаку «Ждут подтверждения», «Запись подтверждена».

В случае неудачи возвращает false.

Класс MCTalon

Свойства класса

·  MCPeriod::$LAST_ERRORS – содержит массив ошибок, которые возникли во время работы последнего метода.

Поля, используемые в методах

Название поля	Тип	Описание
ID	число	Уникальный ID талона.
TYPE_ID	число	Тип приема, можно задавать с помощью специальных констант: ·  rec_type_line - живая очередь; ·  rec_type_wish - запись в желаемое время;
TIME_START	строка	Время начала приема в формате hh:mm:ss
TIME_END	строка	Время конца приема в формате hh:mm:ss
TALON_DATE	строка	Дата приема в формате DD. MM. YYYY
SERVICE_ID	число	ID услуги (элемент инфоблока услуг)
SITE_ID	строка	ID сайта
EMPLOYEE	число	ID сотрудника (из списка пользователей)
RECEIVED_IN	число	Время, в которое талон был зарезервирован. Используется для временного блокирования этого времени. Время блокировки 5 минут. Используется timestamp.
EXPORTED	число	Экспортирован ли талон в МИС. 0 — не экспортировано, 1 - экспортировано
USER_INFO	число	ID профиля пользователя
STATE	число	ID статуса записи, можно задавать с помощью специальных констант: ·  mc_talon_state_created ·  mc_talon_state_accepted ·  mc_talon_state_cenceled ·  mc_talon_state_denied
CREATED	строка	Дата создания в формате DD. MM. YYYY

Основные методы

Add

mixed Add( array fields )

Метод добавляет новый талон.

fields – массив полей талона. В качестве ключей данного массива допустимо использовать:

·  TYPE_ID — тип приема.

·  TIME_START — время начала приема в формате hh:mm:ss.

·  TIME_END — время конца приема в формате hh:mm:ss.

·  TALON_DATE – дата приема в формате DD. MM. YYYY.

·  SERVICE_ID — ID услуги.

·  SITE_ID — (не обязательный) ID сайта. По умолчанию — значение константы SITE_ID.

·  RESERVED_IN – (не обязательный) время резервирования. По умолчанию — текущее время.

·  EMPLOYEE — (не обязательный) ID сотрудника. По умолчанию 0.

·  EXPORTED — (не обязательный) Флаг эксопртирования в МИС, по умолчанию 0

·  USER_INFO — (не обязательный) ID профиля пользователя. По умолчанию 0.

·  CREATED — (не обязательный) дата создания талона в формате DD. MM. YYYY. По умолчанию — текущая дата.

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

В случае неудачи возвращает false.

Пример использования:

$arFields=array( 'TYPE_ID'=>2, 'USER_INFO'=>6, 'TIME_START'=>"12:00:00", 'TIME_END'=>"12:15:00", 'TALONE_DATE'=>"15.08.2012", 'SRVICE_ID'=>111, 'EMPLOYEE'=>30, ); echo MCTalon::Add($arFields);

ClearReserved

bool ClearReserved()

Метод удаляет все зарезервированные талоны старше 5 минут, запись по которым не была доведена до конца.

В случае успеха возвращает true.

В случае неудачи возвращает false.

Clear

Clear()

Метод удаляет все ранее созданные талоны.

Delete

bool Delete( int uid )

Метод удаляет талон по его уникальному номеру.

uid – уникальный номер талона.

В случае успеха возвращает true.

В случае неудачи возвращает false.

GenerateUID

int GenerateUID()

Метод генерирует уникальный десятизначный номер талона.

GetList

mixed GetList( array filter )

Метод возвращает информацию о талонах, удовлетворяющих условиям фильтрации.

filter – массив параметров талона. Для всех полей фильтра первым символом значения можно установить один из знаков сравнения: ! (если значение NULL, то выбирается по условию NOT IS NULL, иначе по условию <>), < , > , = (равенство так же ставится если никакого знака нет). Пример: !NULL. В качестве ключей данного массива допустимо использовать:

·  ID — Уникальный номер талона.

·  TYPE_ID — тип приема.

·  TIME_START — время начала приема в формате hh:mm:ss.

·  TIME_END — время конца приема в формате hh:mm:ss.

·  TALON_DATE – дата приема. Имеет два возможных формата:

·  Строка даты в формате "DD. MM. YYYY".

·  Массив вида

array ( 'COMPARSION' => способ сравнения, может принимать значения: between, >, <, =, <=, >=, <>. 'START_DATE' => дата в формате "DD. MM. YYYY", 'END_DATE' => дата в формате "DD. MM. YYYY", используется только при способе сравнения between )

·  SERVICE_ID — ID услуги.

·  SITE_ID — (не обязательный) ID сайта. По умолчанию — значение константы SITE_ID.

·  RESERVED_IN – (не обязательный) время резервирования. По умолчанию — текущее время.

·  EMPLOYEE — (не обязательный) ID сотрудника. По умолчанию 0.

·  EXPORTED — (не обязательный) Флаг эксопртирования в МИС, по умолчанию 0

·  USER_INFO — (не обязательный) ID профиля пользователя. По умолчанию 0.