Для запуска необходимо включить переадресацию:

sudo a2enmod rewrite
sudo service apache2 restart

Заказчик должен настроить доменное имя для https соединения с пробросом на 443 порт сервера MGERM и предоставить сертификаты для настройки SSL Engine в Apache на сервере MGERM.

На сервере MGERM в настройках виртуальных хостов Apache должен быть файл helix.conf

<VirtualHost *:81>
        ServerAdmin support@mgerm.ru
        DocumentRoot /var/www/mgerm25/_external_services
        <Directory />
                Options +FollowSymLinks -Indexes
                AllowOverride None
        </Directory>
        <Directory /var/www/mgerm25/_external_services>
                Options +FollowSymLinks -Indexes
                AllowOverride All
                Order allow,deny
                allow from all
        </Directory>
        ErrorLog ${APACHE_LOG_DIR}/external_services_error.log
        LogLevel error
        CustomLog ${APACHE_LOG_DIR}/external_services_access.log combined
</VirtualHost>

<VirtualHost *:443>
        SSLEngine on
        SSLCertificateFile /etc/ssl/1med39.ru.crt
        SSLCertificateKeyFile /etc/ssl/private.key
        SSLCertificateChainFile /etc/ssl/GlobalSign_ca.crt
        ServerAdmin support@mgerm.ru
        DocumentRoot /var/www/mgerm25/_external_services
        <Directory />
                Options +FollowSymLinks -Indexes
                AllowOverride None
        </Directory>
        <Directory /var/www/mgerm25/_external_services>
                Options -Indexes
                AllowOverride All
                Order allow,deny
                allow from all
        </Directory>
        ErrorLog ${APACHE_LOG_DIR}/external_services_error.log
        LogLevel error
        CustomLog ${APACHE_LOG_DIR}/external_services.log combined
</VirtualHost>

В параметрах SSLCertificateFile указываем сертификат, выпущенный заказчиком, SSLCertificateKeyFile - соответствующий ключ, SSLCertificateChainFile - нужный сертификат.

В папке conf проекта MGERM должен быть конфигурационный файл helix.ini.

nano /var/www/mgerm25/conf/helix.ini

вставляем:

clientId =
clientSecret =
redirectUri = url
urlAuthorize = https://auth-mdo.helix.ru/connect/authorize
urlAccessToken = https://auth-mdo.helix.ru/connect/token
urlResourceOwnerDetails = https://auth-mdo.helix.ru/
scopes = mis catalog_service offline_access
urlApi = https://mdo.helix.ru/
contractID =
authorizeUri = url

В свойства redirectUri и authorizeUri ставим адрес с доменным именем + /_income/callback/oAuthRedirect.php, полученный от заказчика, например:

https://mgerm.clinica-boli.ru/_income/callback/oAuthRedirect.php

Указать clientId clientSecret и contractID, внеся данные для подключения от Хеликс.

Внимание! В логине и пароле не должно быть скобок! Если они есть, нужно просить выдать их заново без скобок. Скобки вызывают ошибку чтения конфигурационного файла. При этом выводится сообщение: “Can't read /conf/helix.ini file properly!“

Так же в случае непонятной ошибки с подключением к API Хеликса необходимо убедиться, что файл _services\lib\Helpers\LeageReplace\AbstractProvider.php скопирован в ib\vendor\league\oauth2-client\src\Provider\ с замещением исходного файла.

Необходимы для обновления контракта загрузки результатов:

sudo crontab -e

Вставляем:

0 */12 * * * curl "http://localhost/_services/Laboratory/Helix/Invoice.loadContract?no_connection=1"
0 * * * * curl "http://localhost/_services/Laboratory/Helix/Invoice.getAndStoreResult?no_connection=1"

Добавляем системного пользователя и запись результата анализа. В системной переменной “Внешняя лаборатория“ ставим helix.

GRANT SELECT, INSERT, UPDATE ON `medis_logs`.* TO 'expert'@'127.0.0.1';
FLUSH PRIVILEGES;

INSERT INTO `medis_users`.`users` (`ind`, `created`, `login`, `password`, `GUID`, `class`, `department`, `last_name`, `first_name`, `second_name`, `spec`, `observe`, `works`, `vacation`, `director`, `reception_doctor`, `allow_fio_change`, `expert`, `parus_id`, `cat_nm`, `cat_dt`, `ct_spc`, `cmn`, `dmn`, `science_prefix`, `vacation_start`, `vacation_end`, `fot`, `deligate_expert`, `kmis_department`, `fot_refferal_premium`, `birthday`, `seniority_date`, `merit`, `photo`, `callOnly`, `siteComment`, `SNILS_45130`, `observe_login`, `INN`, `showDoctorOnSite`, `cbn`, `dbn`, `site_periods_count_user`, `add_spec`, `default_show_initials_print_all_records_spec`, `cpn`, `dpn`, `power_of_attorney`, `allow_delete_templates`, `user_another_ids`, `mango_extension`, `spec_FRMR`, `only_personal_services`) VALUES (-11, '2012-03-06 07:44:10', 'laboratoryAgent', 'b98451dffec462fa47ba832ca641c2d6', 1, 2, 1, 'Импорт', 'Внешней', 'Лаборатории', -5, NULL, 1, 0, 1, 0, 1, 1, 0, , , , 0, 0, , NULL, NULL, 5.00, 1, NULL, NULL, NULL, NULL, NULL, NULL, 0, NULL, NULL, NULL, NULL, 1, NULL, NULL, NULL, NULL, 0, NULL, NULL, NULL, 0, NULL, NULL, NULL, 0);

INSERT INTO `medis_interface`.`button_set` (`author_only`, `GUID`, `digested`, `always`, `ID`, `order`, `html_id`, `style`, `Name`, `script`, `Action`, `title`, `image`, `dead`, `lifespan`, `callback`) VALUES (0, NULL, 1, 0, 'helix_pdf', 2, NULL, 'std40', 'Открыть PDF c показателями', 'butpress_si', '/_services/Laboratory/LaboratoryRequest.getResult?template=/laboratory/helix/showTaskStatus.html&', 'Скачать PDF файл c результатами анализов', NULL, 0, NULL, NULL);

UPDATE `medis_interface`.button_set SET `dead` = 1 WHERE ID = 'proc_biomaterials';

INSERT INTO `medis_interface`.`button_set` (`author_only`, `GUID`, `digested`, `always`, `ID`, `order`, `html_id`, `style`, `Name`, `script`, `Action`, `title`, `image`, `dead`, `lifespan`, `callback`) VALUES (0, NULL, 0, 0, 'proc_biomaterials', 2, NULL, 'std40', 'Преаналитика и отправка', 'butpress_si', '/_services/Laboratory/LaboratoryRequest.getSpecimenTypes?template=/laboratory/helix/chooseSpecimens.html&', 'Создание и отправка заказа', NULL, 0, NULL, NULL);
INSERT INTO `medis_interface`.`button_set` (`author_only`, `GUID`, `digested`, `always`, `ID`, `order`, `html_id`, `style`, `Name`, `script`, `Action`, `title`, `image`, `dead`, `lifespan`, `callback`) VALUES (0, NULL, 0, 0, 'proc_biomaterials', 0, 'DEL', 'std40', 'Удалить', 'butpress_si_del', 'edit', 'Удалить запись', NULL, 0, NULL, NULL);
INSERT INTO `medis_interface`.`button_set` (`author_only`, `GUID`, `digested`, `always`, `ID`, `order`, `html_id`, `style`, `Name`, `script`, `Action`, `title`, `image`, `dead`, `lifespan`, `callback`) VALUES (0, NULL, 0, 0, 'proc_biomaterials', 0, NULL, 'std40', 'Изменить', 'butpress_si', '/kpo/calculator', 'Составить список услуг', NULL, 0, NULL, NULL);

REPLACE INTO `medis_interface`.`references` (`recordTypeID`, `name`, `dead`, `chapter`, `med_refferal`, `need_redirection`, `edit_GUID`, `order`, `order2`, `interf_ref`, `d_table`, `num_list`, `signs`, `show_treatment`, `show_content`, `show_time`, `print_size_percentage`, `print_checker`, `status_buttons`, `buttonSetID`, `buttonSetID_inp`, `extend_record_class`, `record_method_in`, `record_method_out`, `TH_output_style`, `TD_output_style`, `Tbl_output_style`, `Tbl_input_style`, `TH_input_style`, `TD_input_style`, `button_line_style`, `status_line_style`, `button_line_style_inp`, `text_style`, `files_style`, `files_alias`, `files_script`, `show_in_summary`, `show_in_hystory`, `show_in_refferals`, `identifier`, `print_form`, `print_form_cap`, `common_view`, `use_autotemplate`, `multifier`, `specialist_visit`, `form14_operation_identifier`, `show_creation_date_in_caption`, `copy_content_from_previous_record_of_same_type`, `show_date`, `print_full_text_position`, `allow_record_date_change`, `PHR_notification`, `PHR_hide_record`, `print_record_date_from_field_date`, `summary_referecnce_order`, `print_template_php`, `auto_lock`, `advanced_protocols`, `dont_show_name_in_print_all_records`, `dont_show_name_in_print_record`, `show_contract_type_in_head`, `info`, `dont_print_treatment`, `first_hystory_record`, `minzdrav_code`, `show_count_in_report`, `show_time_in_info`, `force_patient_name_printing`, `ClinicalDocument/code`, `Порядок случаев госпитализации или обращения`, `Место оказания помощи`, `export_recordTypeGroup`, `show_in_analise_dynamic`, `dont_print_recomendations`)
VALUES (201, 'Результаты анализа', 0, 80, 0, 0, NULL, 0, 0, 'default', 'default', 0, 0, 0, 1, 0, 0, 1, NULL, 'helix_pdf', 'save_only', 'class_extention_record', 'show_body_from_php_script', 'restore_body_show', 'TH_output_std', 'TD_output_std', 'Tbl_output_std', 'Tbl_output_std', 'TH_output_std', 'TR_output_inp', 'record_buttons_row', 'status_style', 'record_buttons_row', 'std_info_style', 'std_files_style', NULL, '/file_operationsdownload.php', 1, 1, 1, NULL, '-', NULL, NULL, 1, 1, 0, NULL, 1, 0, 1, 0, 0, 0, 0, 0, 0, '/_services/Core/DatabaseRecord.getData?template=/laboratory/helix/results.html', 0, 0, 0, 0, 0, NULL, 0, 0, NULL, 0, 1, 0, NULL, NULL, NULL, NULL, 0, 0);

REPLACE INTO medis_interface.`references` (`recordTypeID`, `name`, `dead`, `chapter`, `med_refferal`, `need_redirection`, `edit_GUID`, `order`, `order2`, `interf_ref`, `d_table`, `num_list`, `signs`, `show_treatment`, `show_content`, `show_time`, `print_size_percentage`, `print_checker`, `status_buttons`, `buttonSetID`, `buttonSetID_inp`, `extend_record_class`, `record_method_in`, `record_method_out`, `TH_output_style`, `TD_output_style`, `Tbl_output_style`, `Tbl_input_style`, `TH_input_style`, `TD_input_style`, `button_line_style`, `status_line_style`, `button_line_style_inp`, `text_style`, `files_style`, `files_alias`, `files_script`, `show_in_summary`, `show_in_hystory`, `show_in_refferals`, `identifier`, `print_form`, `print_form_cap`, `common_view`, `use_autotemplate`, `multifier`, `specialist_visit`, `form14_operation_identifier`, `show_creation_date_in_caption`, `copy_content_from_previous_record_of_same_type`, `show_date`, `print_full_text_position`, `allow_record_date_change`, `PHR_notification`, `PHR_hide_record`, `print_record_date_from_field_date`, `summary_referecnce_order`, `print_template_php`, `auto_lock`, `advanced_protocols`, `dont_show_name_in_print_all_records`, `dont_show_name_in_print_record`, `show_contract_type_in_head`, `info`, `dont_print_treatment`, `first_hystory_record`, `minzdrav_code`, `show_count_in_report`, `show_time_in_info`, `force_patient_name_printing`, `ClinicalDocument/code`, `Порядок случаев госпитализации или обращения`, `Место оказания помощи`, `export_recordTypeGroup`, `show_in_analise_dynamic`, `dont_print_recomendations`)
VALUES (709, 'Заказ в Хеликс', 0, 80, 0, 0, NULL, NULL, NULL, 'default', 'default', 0, NULL, NULL, 1, 0, NULL, 1, 'proc_biomaterials_lock', 'proc_biomaterials convert_plan', 'save_only', 'class_extention_record', 'show_bill', 'HidePayForHystoryZabor', 'TH_output_std', 'TD_output_std', 'Tbl_output_std', 'Tbl_output_std', 'TH_output_std', 'TR_output_inp', 'record_buttons_row', 'status_style', 'record_buttons_row', 'std_info_style', 'std_files_style', NULL, '/file_operationsdownload.php', 0, 1, 1, NULL, NULL, NULL, 0, 1, 1, 0, NULL, 1, 0, 1, 0, 0, 0, 0, 0, NULL, NULL, 0, 0, 0, 0, 0, NULL, 0, NULL, NULL, 0, 1, 0, NULL, NULL, NULL, NULL, 0, 0);

UPDATE medis_users.system_globals SET external_lab = 'helix', `allow_sister_create_bill_on_all_services` = 1;

В панели 1_menu_finance.html в секцию настройки добавляем ссылки:

<h3>Лаборатория Хеликс:</h3>
<ul>
<li><a href="/_external_services/_income/callback/oAuthRedirect.php" target="_blank">Подключиться к Helix</a></li>
<li><a href="/_services/Laboratory/Helix/Invoice.loadContract?template=/laboratory/helix/loadContract.html">Прогрузить контракт Helix</a></li>
</ul>

И жмем ссылку правой кнопкой мыши и выбираем “открыть в новой вкладке“:

Авторизуемся, используя данные от Хеликс: пользователь на Identity Server (Username, Password). После успешной авторизации на открывшемся экране ничего не меняем и жмем кнопку “Yes, allow“.

Загрузку контракта рекомендуется провести через консоль для проверки работы автоматической загрузки:

curl http://localhost/_services/Laboratory/Helix/Invoice.getAndStoreResult?no_connection=1

Корректный ответ: {«status»:«success»}

Далее необходимо провести тестовый заказ, используя диапазон тестовых кодов, переданных Хеликсом и передать идентификатор заказа службе поддержки. Идентификатор можно узнать в базе данных в epm_records.jsonData, используя recordID заказа, например:

Копируем и отсылаем «taskID»: «5ef19a56-a1c4-44cd-ac05-0362914c9a4e».

Если cron работает и настроен согласно инструкции, в карте можно будет увидеть результат тестового анализа. Так же можно форсировать импорт в консоли:

curl "http://localhost/_services/Laboratory/Helix/Invoice.getAndStoreResult?no_connection=1"