﻿Установка надстройки при помощи инсталлятора
	Распаковать ZIP-файл дистрибутива в одну из папок на локальном диске и запустить инсталлятор EfirAddInInstaller.msi.
	Он копирует файлы надстройки в папку <пользователь>\AppData\Roaming\Microsoft\AddIns и автоматически регистрирует надстройку в Excel.


Установка надстройки вручную
	В некоторых случаях, надстройка может не запускаться из стандартной папки <пользователь>\AppData\Roaming\Microsoft\AddIns, куда ее копирует инсталлятор. 
	Или службе технической поддержки клиента может быть удобнее иметь единое место расположения файлов надстройки для нескольких пользователей на одной машине.
	В этом случае, можно воспользоваться отдельным архивом EfirAddInBinaries.zip, доступным на сайте Интерфакс.
	Нужно распаковать этот ZIP-файл в общую папку, доступную всем пользователям на этой машине. Например: C:\Program Files\Interfax\EfirAddIn.
	
	После чего нужно подключить надстройку к Excel у пользователей. Для этого необходимо открыть в Excel окно Надстройки:
	 - Excel 2013: меню Файл -> Параметры -> Надстройки -> выберите в поле Управление значение "Надстройки Excel" -> Перейти...
	Дальнейшие действия одинаковы для всех версий Excel:
	1. В окне Надстройки нажмите кнопку Обзор.
	2. В появившемся окне по умолчанию будет открыта папка <пользователь>\AppData\Roaming\Microsoft\AddIns. 
	   Найдите папку с распакованной надстройкой, выберите файл EfirExcel-AddIn.xll и нажмите Открыть.
	   ВАЖНО!!! Для 64-битного Excel нужно выбрать файл EfirExcel-AddIn64.xll.
	3. В Excel появится лента INTERFAX.
	4. При обновлении (копировании с заменой в существующую папку) необходимо удалить папку Storage.


Проблемы
	1. Если инсталляция или ручная регистрация модуля прошла успешно (в окне Надстройки появился EfirExcel-AddIn), 
	   но меню INTERFAX не появляется - значит в настройках Центра Безопасности Excel выключен запуск всех надстроек.
	   Для нормальной работы надстройки Efir уровень безопасности должен быть как минимум "Все надстройки приложений 
	   должны быть подписаны надежными издателями", либо более свободный режим, при котором разрешены даже неподписанные надстройки. 
	   Наша надстройка - подписана сертификатом ZAO Interfax.  Также этим сертификатом подписан шаблон с макросами для расчета рыночного риска.
	2. Если при нажатии на OK в окне INTERFAX -> "Параметры соединения" появляется ошибка соединения с сервером, значит закрыт 80 порт для Excel.
	3. Другой вероятной причиной отсутствия соединения с сервером может быть использование прокси-сервера - обязательно укажите его параметры на странице Proxy в 
	   окне INTERFAX -> "Параметры соединения".
	4. Если при использовании любой из функций Efir Add-in появляется сообщение "#ERROR", то полное описание ошибки можно посмотреть в окне INTERFAX -> Журнал.
	   Текст ошибки из этого окна можно использовать для предметного общения с командой поддержки Interfax.


Обновление модуля с помощью инсталлятора
	1. Закройте все окна Excel, чтобы он полностью выгрузился из памяти.
	2. Запустите инсталлятор новой версии надстройки - он обновит файлы автоматически. Нет необходимости сначала деинсталлировать старую версию, прежде чем устанавливать новую.
	3. Запустите Excel. Если всё прошло успешно, то вы должны увидеть меню INTERFAX. В окне INTERFAX -> Журнал на первой строке должен показаться новый номер версии.

Удаление модуля автоматически
	1. Воспользуйтесь Панелью Управления -> "Удаление программы".
	2. Выберите в списке программ строчку с именем "ЭФиР Надстройка для Excel" и нажмите кнопку Удалить.
	   Установщик Windows может предложить закрыть все запущенные экземпляры Excel, чтобы произвести удаление модуля.


Обновление модуля вручную
	1. Закройте все окна Excel, чтобы он полностью выгрузился из памяти.
	2. Распакуйте свежую версию EfirAddInBinaries.zip в ту же папку, где лежит предыдущая версия файла.
	3. Запустите Excel. Если всё сделано правильно, то вы должны увидеть меню INTERFAX. В окне INTERFAX -> Журнал на первой строке должен показаться новый номер версии.

Удаление модуля вручную
	1. Закройте все окна Excel, чтобы он полностью выгрузился из памяти.
	2. Удалите с локального диска файлы модуля: EfirExcel-AddIn.xll и EfirExcel-AddIn64.xll.
	3. Запустите Excel снова - он должен вывести предупреждение, что модуль надстройки не был найден.
	4. Откройте окно Надстройки Excel (в Excel 2010 оно находится в Файл / Параметры / Надстройки / Надстройки Excel / Перейти...) - в нем 
	   щелкните по строчке Efirexcel-Addin, появится предупреждение, что модуль не был обнаружен и предложение удалить его 
	   из списка надстроек - согласиться с данным предложением.


Настройка параметров модуля
	1. В меню INTERFAX выбрать пункт "Параметры соединения". 
	   По умолчанию, настройки будут взяты из локальной копии EfirClient. Если же на этой машине нет EfirClient, 
	   то настройки по умолчанию будут заполнены некими демонстрационными значениями - с ними функции EfirExcel наверняка не будут работать, 
	   надо вручную ввести название сервера, логин и пароль. По нажатию на OK модуль проведет пробное подключение к серверу INTERFAX по 80 порту. 
	   Если данный порт закрыт на фаерволле, то необходимо его открыть по крайней мере для процесса Excel.
	2. Для проверки правильности установки и настройки, в любую ячейку Excel ввести формулу "=EfirFields()" и 
	   нажать Enter - через 1-2 секунды в ячейках под ней появится список полей, доступных для загрузки из INTERFAX.
	3. Если произошла ошибка, под формулой появится текст "#ERROR". Это означает либо опечатку в параметрах соединения с сервером, 
	   либо другую проблему. Полный текст ошибки можно посмотреть в лог-файле - в меню INTERFAX выберите пункт Журнал.

Начало использования
	1. Загрузите на отдельные страницы Excel два справочника - списки полей и инструментов с помощью следующих функций:
	   =EfirFields()
	   =EfirSecurities()
	   Обратите внимание, что процесс загрузки всех инструментов может занять 1-2 минуты.
	2. Для загрузки архива за некоторый промежуток времени по одному инструменту используется функция EfirHistory:
	   первый параметр (Id) - ID инструмента из списка EfirSecurities
	   второй параметр (Params) - строка с параметрами запроса в формате "BEGDATE=01.01.2013; ENDDATE=31.05.2013; STEP=1D; ROWNUM=1000".
		  BEGDATE и ENDDATE - это даты в формате "DD.MM.YYY".
		  STEP - принимает следующие возможные значения: 1D, 1H, 30MIN, 5MIN, 1MIN.
		  ROWNUM - необязательный параметр, ограничивающий количество возвращаемых строк.
		  Параметры могут быть расположены в любом порядке.
	   третий параметр (Fields) - массив строк с именами загружаемых полей, либо одна строка - в ней поля разделяются точкой с запятой. 
		  Доступные названия полей находятся в справочнике EfirFields() - берите из него первую колонку CodeName.
	   четвертый параметр (Sort) - правила сортировки результата выборки. Например, "TIME=D" - сортировка по убыванию колонки TIME.
	   последний параметр (ShowHeader) - необязательный флаг, который позволяет отключить строку с заголовками колонок в выходных данных. 
		  По умолчанию, строка с заголовками включена.
	3. Для загрузки данных по одному инструменту на конец определенного торгового дня используется функция EfirEndOfDay - она заполняет данными 
	   одну строчку, начиная с текущей ячейки:
	   первый параметр (Id) - идентификатор инструмента из списка EfirSecurities.
	   второй параметр (Date) - дата, на которую должны быть загружены данные. Может задаваться ячейкой с датой либо строкой в формате "DD.MM.YYY".
	   третий параметр (Fields) - заполняется так же, как и для функции EfirHistory (см. выше).

Расчет рисков - эти функции возвращают скалярное значение непосредственно в ячейку с формулой (классический подход Excel)
	1. EfirRiskGroup - возвращает группу риска определенного инструмента.
	2. EfirRateForRiskGroup - на основе группы риска возвращает коэффициент для расчета СПР.
	3. EfirTimingGroup - возвращает группу срочности для распределения инструментов по таблице расчета ОПР.
