+---------------------------------------------------------------+
| Использование программы "PFexch" для обмена информацией с ПФР |
+---------------------------------------------------------------+

I. Подготовка к работе.
-----------------------
1. Скопируйте программный файл PFexch.exe в созданный для этого каталог (пусть это будет c:\csi\PFexch)

2. Если у Вас нет файлов типа udl в каталоге C:\Program Files\Common Files\System\Ole DB\Data Links\,
   то скопируйте туда файл sitex.udl.
   В этом случае в файле выполните следующие настройки:
    Password=<пароль доступа к MS SQL серверу>;
    User ID=sa;
    Initial Catalog=<имя БД>;
    Data Source=<имя вашего сервера>;
   Эти настройки можно сделать с помощью текстового редактора, или вызвав утилиту настройки, дважды
   щёлкнув по имени файла.
   Если Вы хотите скрыть имя пользователя и/или пароль, то можете удалить строки User ID и Password.
   В этом случае они будут запрошены в диалоге.
   Примечание: файлов типа udl может быть сколько угодно, например, по файлу для каждой БД.
3. Для тех, кому интересен формат обмена с ПФ, может прочитать его в файле "Формат обмена с ПФ.doc".

II. Работа с программой.
------------------------
1. Из выпадающего списка выбрать БД (ключевые параметры можно увидеть в всплывающей подсказке)
   и произвести соединение (Checkbox БД).
   В окне справа от выбранной БД появится код района по классификации ПФ для организации,
   на которую настроен ЭСРН,
   а в всплывающей подсказке можно увидеть дополнительную информацию.
   После подсоединения к БД станут активными команды "Загрузить","Сверить","СНИЛС","Учёт","Начисления".

2. "Загрузить" - выбирается и загружается файл из пенсионного фонда.
  "Заголовок файла" - запись типа "В".
  Таблица под заголовком для записей типа "О".
  Таблицы снизу для  записей типа "Л", "С", "М", "П". (Эти записи не обязательно присутсвуют в исходных данных).
  Для колонок, соответствующих описанным в файле "Формат обмена с ПФ.doc", проставлены номера в наименовании.


3. "Сверить" - происходит поиск загруженных записей о пенсионерах из ПФ в БД ЭСРН. Если в ЭСРН отыскивается личное
   дело, то проставляется его OUID и выделяются атрибуты, по которым произошло опознание. Параметры сравнения
   задаются в предварительном диалоге.
   Если не установлен флажок "Проверять все записи, игнорируя результаты уже проведённой сверки", то поиск ведётся
   только в записях, для которых не установлена связь с данными ЭСРН. Иначе, поиск ведётся по всем записям и
   соответственно переустанавливаются связи между данными ПФ и ЭСРН.

   Если есть желание установить связь вручную, то можно отредактировать OUID. Редактирование любого значения
   (кроме колонок с именами "O id", "id", "Тип зп.") инициируется двойным щелчком мышки.

4. "СНИЛС" - если СНИЛС имеется у пенсионера из ПФ и он (пенсионер) присутствует в ЭСРН, то СНИЛС копируется
   в БД ЭСРН.

5. "Учёт" - установка признаков учёта "_Кандидаты на доплату к пенсиям ПФР" (код="PFexch") в личных делах.
   В операции не участвуют записи с признаком "Искл." (Исключённые - см. левая колонка в таблице с
   записями типа "О").

6. "Начисления" - начисления за выбранный год и месяц по нужным МСП записываются, как записи типа "М".
   Начисления, участвующие в операции, имеют статус 12,13,15,16
     (начисл. сформ., начисл. утв., неполная выпл., выпл. сформ.).

7. "Заголовок" - Осуществляет переход к режиму подготовки заголовка выходного файла.
   Информация о загруженном заголовке теряется и устанавливаются параметры для выгружаемого файла.
   а) В наименование группы включено имя выходного файла. (включает порядковый № подготовленных
      данных в текщем месяце - см. поле ввода левее поля "Год").
   б) Версия формата - не редактируется.
   в) № организации = <код региона по ПФР>-<код района по ПФР>-<6-ти значное число (какое - не знаю)>
   г) Тип данных = для первого обмена почти наверняка "ОТВЕТ".
   д) Наименование организации - наименование вашей организации
   е) № массива = <код региона по ПФР>-<код района по ПФР>-<порядковый номер сформированных данных>
   ж) Последняя выгрузка - не редактируется.

8. "Выгрузить" - создаёт файл для пенсионного фонда. (файл не переименовывать)
   В операции не участвуют записи с признаком "Искл." (Исключённые - см. левая колонка в таблице с
   записями типа "О").

В программе на всякий случай оставлены средства отладки. Надеюсь, они не понадобятся.

Поиск и фильтрация:
-------------------
Для поиска значения нужно выбрать колонку и в строке поиска (справа от выбранной колонки) ввести значение.
Если в строке поиска есть значение, можно по нему выполнить фильтрацию (кнопка с буквой "Ф").
Специальные значения:
  "Искл":   0 или 1.
  "Сверка": здесь записаны результаты операции "Сверить", как сумма ниже перечисленных значений
           32 - Сопоставление вручную (отредактирован OUID)
           16 - Запись найдена по СНИЛСу
            8 - Совпала фамилия
            4 - Совпало имя
            2 - Совпало отчество
            1 - Совпала дата рождения
           Пример: 8+4+2 = 14 - записи сопоставлены по совпадению фамилии, имени и отчества.
                   (Эти комбинации можно посмотреть в меню "Отчёты|Некоторые итоги")

Дополнительные возможности поиска:
см. меню "Поиск". То же самое есть в контексном меню таблицы "O". Есть контексное меню и у вызываемого
списка личных дел ЭСРН.


**************************************** Версия 01.10 ****************************************

Меню "Файл|Загрузить"
---------------------
Теперь загрузка файла из ПФ типа "ЗАПРОС" не уничтожает хранимые программой данные, а добавляет
отсутствующих или обновляет узнанных.
Поиск в хранимых от ПФ данных производится сначала по СНИЛС, а в случае неудачи,
по ФИО+дата рождения. В колонке "Згр" показывается результат загрузки:
  Значок <плюс> (искать 'зн')    - загружена новая запись
  Значок <галочка> (искать 'зо') - загружена и обновлена
  Без значка (искать 'би')       - без изменений - записи не было во входном потоке
Полное обновление хранимых данных теперь производится файлом ПФ типа "РЕГСФР" и "ОТВЕТ".


Меню "Файл|Выгрузить"
---------------------
Выгружаются только данные для файла типа "ОТВЕТ". Причём, колонка "Згр" имеет значение 'зн' или 'зо'.
Остальные записи (даже, если по ним были начисления) не выгружаются.


Меню "Файл|Архив|Сохранить"
---------------------------
Сохраняет хранимые программой данные в отдельном файле.


Меню "Файл|Архив|Восстановить"
------------------------------
Восстанавливает данные из файла, сохранённого командой "Файл|Архив|Сохранить".
Поскольку операция широко не тестировалась, рекомендуется иметь в запасе последний файл
из ПФ типа "РЕГСФР" или backup от MS SQL всей БД.


Меню "Правка|Сверить..."
------------------------
Добавлено ограничение поиска "Искать среди..." (см. значения колонки "Згр").


Меню "Правка|Начисления"
------------------------
Сейчас начисления выбираются для периодов, указанных в колонках "63 - Нач. периода", "64 - Кон. периода".
Год и месяц нужны только для сохранения информации, какой период являлся основным.
МСП со статусом (начисл. сформ., начисл. утв., неполная выпл., выпл. сформ.),
по которым выбираются начисления:
  1. "Ежемесячная денежная выплата" (код = "edvRegion") (для ПФ код МСП = 4)
  2. "Доплата к пенсии" (код = "Pens_Dopl") (для ПФ код МСП = 4)
  3. "Ежемесячная денежная выплата на оплату жилого помещения и коммунальных услуг
     (федеральный бюджет)" (код = "standartHCS") (для ПФ код МСП = 2)
  4. "Ежемесячная денежная выплата на оплату жилого помещения и коммунальных услуг
     (региональный бюджет)" (код = "standartHCSReg") (для ПФ код МСП = 2)
Кроме того, "Региональная карточка транспортного обслуживания" (код = "cardTranspService"),
эквивалентна 104 руб. в месяц (для ПФ код МСП = 4).


Меню "Сортировка"
-----------------
"По колонке" - Устанавливается сортировка по текущей колонке
             (то же самое достигается щелчком по заголовку колонки)
"+ колонка" - Добавляется колонка к текущей сортировке
           (пусть была сортировка по фамилии. Выбрали "Рождение" -
            получим сортировку по фамилии, дате рождения)
"По ФИО" - Устанавливается сортировка по фамилии, имени, отчеству
"Текущая сортировка" - показывает текущую сортировку.



**************************************** Версия 01.11 ****************************************
Меню "Файл|Загрузить"
---------------------
Полное обновление хранимых данных производится файлом ПФ типа "ОТВЕТ".



**************************************** Версия 01.12 ****************************************
Исправлена ошибка, отправляющая ЖКУ(2) в иное(4).



**************************************** Версия 01.12 ****************************************
Исправлена ошибка обработки транспортной карточки.



**************************************** Версия 01.13 ****************************************
В начислении не учитываются доплаты за предыдущий период



**************************************** Версия 01.15 ****************************************
Добавлена возможность формирования файла типа "ИЗМ" для исправления данных, подготовленных
по "старым ЖКУ" на январь



**************************************** Версия 01.16 ****************************************
1. Во исполнение новых требований ПФ добавлено следующее:
     В момент включения редактирования заголовка (команда "Заголовок") с первой позиции наименования
     организации вставляется текст (при его отсутствии) "Уполномоченный орган субъекта Российской Федерации".
     После этого наименование вашей организации может быть частично обрезано справа. В этом случае придумайте
     сокращённое название.
     Обращаю внимание, что сохранение заголовка происходит после успешной выгрузки (команда "Выгрузить").

2. В режиме отладки появилась опция "Создавать нулевые начисления при их отсутсвии", т.е., если начисления нет,
   то в таблицу "М" пишется нулевое значение. Этот режим, возможно, понадобится для подготовки файлов типа "ИЗМ".



**************************************** Версия 01.17 ****************************************
1. Расширен перечень учитываемых начислений.
   Было: Назначенные МСП (esrnServServ) со статусом 12(начисл. сформ.), 13(начисл. утв.), 15(неполная выпл.), 16(выпл. сформ.)
   Теперь к этому перечню добавлены начисления, удовлетворяющие одновременно двум условиям:
     - Назначенные МСП (esrnServServ) со статусом 2(пост. прекращение)
     - Начисления (wmPayCalc) со статусом 16(выпл. сформ.)

2. Теперь алгоритм выборки начислений из БД ЭСРН зависит от типа данных.
   а) "ОТВЕТ": Нулевые или отсутствующие начисления не добавляются в таблицу "М"
               (исключение: в окне "Средства отладки" установлен режим "Создавать нулевые начисления при их отсутсвии")
   б) "ИЗМ": В таблицу "М" добавляются нулевые начисления, даже если они отсутствуют.
             (Напоминание: выгружаются только данные по помеченным лицам в колонке "Изм".
                           Режим редактирования "Изм" включается из меню "Правка|Править "Изм"")

3. Сбросить все флажки из колонки "Изм" можно командой меню "Правка|Сбросить "Изм""

4. Очистить список перед загрузкой запроса можно установив в окне "Средства отладки"
   флажок "Очищать список перед загрузкой запроса"

5. Добавлено несколько отчётов.



**************************************** Версия 01.18 ****************************************
1. Изменено правило импорта начислений.
   Для любого месяца(пусть на него приходися даже один день) из периода оно следующее:
     [результат] = [назначенная сумма] + SUM[доплата для этого месяца, указанная в любом начислении из заданного периода]
     (не учитываются доплаты из начислений вне периода и удержания).

2. Ведение архива выгрузок для последующей возможности формирования файла типа "ИЗМ".
   Если в заголовке файла указан тип "ОТВЕТ" или "ИЗМ", то во время выгрузки файла для ПФ параллельно идёт обновление
   таблицы cst_PFexchUnload, в которой хранятся выгруженные начисления. Избежать обновления cst_PFexchUnload (мало-ли что?)
   можно, установив в окне "Средства отладки" режим "Не изменять данные, выгруженные для ПФ (история)".
   Посмотреть, что лежит в таблице cst_PFexchUnload можно, выполнив команду меню "Файл|Пенсионный фонд|Выгружено для ПФ" или
   из главного списка через команду контекстного меню "К выгрузке для ПФ" (вернуться аналогично).

3. Загрузка из ПФ.
   Файл типа "РЕГСФР": Новые записи получают статус 'зн' (значок +), обновлённые - 'зо' (значок галочка).
                       Незатронутые записи удаляются.
   Файл типа "ИЗМ":    Реестр очищается. Загруженные записи получают статус 'зн'
   Файл типа "ЗАПРОС": Новые записи получают статус 'зн', обновлённые - 'зо'
                       Остальные меняют свой статус на 'би' (без значка)
   Файл типа "ОТВЕТ":  Реестр очищается. Загруженные записи получают статус 'зн'

4. Начисления.
   Тип данных "РЕГСФР": Начисления импортируются для всех записей, у которых OUID > 0
   Тип данных "ИЗМ":    Начисления импортируются для всех помеченных(Изм) записей.
            Вместо отсутствующих начислений добавляются нули.
   Тип данных "ЗАПРОС": Операция не выполняется
   Тип данных "ОТВЕТ":  Начисления импортируются для новых('зн') и обновлённых('зо') записей, у которых OUID > 0

5. Выгрузка для ПФ.
   Тип данных "РЕГСФР": Выгружается только одна запись "В"(заголовок)
   Тип данных "ИЗМ":    Выгружаются все помеченные записи, у которых количество начислений > 0
   Тип данных "ЗАПРОС": Выгружается только одна запись "В"(заголовок)
   Тип данных "ОТВЕТ":  Выгружаются записи со статусами 'зн' и 'зо'

6. Задание периода начислений. (меню "Правка|Задание периода...")
   Задаётся начальный и конечный месяц периода. У всех записей будет проставлен заданный период.
   Если установить флаг "Только для помеченных (Изм) записей", то этот период будет проставлен
   только у помеченных записей.
   Эта операция может пригодиться для подготовки файла изменений ("ИЗМ").

7. Подготовка файла изменений на основе архива выгрузок. (см. п.2)
   С помощью команд меню "Правка|Изменения|По всему реестру" и "Правка|Изменения|Среди помеченных"
   импортируются начисления из ЭСРН, отличные от хранящихся в архиве выгрузок.
   Если выбрана, команда "Среди помеченных", то в операции участвуют только помеченные записи.
   Сначала удаляются все начисления. Далее, происходит сравнение для каждой записи по всему указанному в ней
   периоду. Если отличие обнаруживается, то добавляются все начисления из периода (в том числе и нулевые)
   и запись помечается. Иначе - метка снимается. Таким образом, всё готово для выгрузки файла типа "ИЗМ".



**************************************** Версия 01.19 ****************************************
1. Добавлен учёт 30-километровой зоны (код = "KvartMsp").
   Это интересно следующим районам: 005 Балаково
                                    008 Вольск
                                    011 Духовницк
                                    027 Пугачёв
                                    036 Хвалынск
   Начисленная сумма добавляется к ЖКУ (код = 2).



**************************************** Версия 01.20 ****************************************
1. Групповое переключение состояния "Изм" вынесено в заголовок колонки.
2. Добавлена возможность редактирования вручную начислений для одного получателя.
   Это достигается через контекстное меню списка получателей "Начисления на человека".
   Результат зависит от типа данных, указанных в заголовке файла для ПФ.



**************************************** Версия 01.21 ****************************************
1. Добавлена операция "Учёт доплат..." (меню "Правка|Учёт доплат...") - отбор лиц,
   имеющих доплаты в начислениях на выбранный год,месяц (год,месяц на панели, где выбирается БД).
   Команда вызывает диалог, в котором можно выбрать режим поиска среди:
     - записей со статусами 'зн' и 'зо' - новые и обновлённые (эти статусы устанавливаются после загрузки из ПФ)
     - всех записей
   После выбора "Продолжить" сбрасываются все флаги "Изм" и ищутся те записи,
   для которых в начислениях за выбранный год,месяц присутствуют доплаты.
   Для найденных записей проставляется флажок "Изм" и устанавливается новый период: от самой ранней доплаты до
   выбранного года,месяца включительно.
   Правило использования:
     а) Загружается "большой запрос" с коротким (1 месяц) запрашиваемым периодом
     б) Как обычно, готовится ответ
     в) Устанавливается год и месяц в соответствии с периодом в запросе
     г) Выполняется команда "Учёт доплат..." в режиме по умолчанию
     д) Выбирается тип выходного файла "ИЗМ"
     е) Выполняется команда "Начисления"
     ж) Выполняется команда "Выгрузить"
   Нам отправляются оба файла, даже если файл изменений пуст.

2. Подправлен вывод пустого СНИЛСа
3. Команда "Позиция" перенесена из подменю "Поиск" в подменю "?" и
   одновременно удалена из контекстного меню списка получателей.
4. Команда "Учёт" удалена из панели быстрого запуска.



**************************************** Версия 01.22 **************************************** -
1. В отчёте "Статистика по файлам|Количество записей" добавлена колонка,
   содержащее отношение количества записей "M" к количеству записей "O".



**************************************** Версия 01.23 **************************************** -
1. "Файл|Выгрузки|Выгружено для ПФ" - расширено заданием условий выборки. (см. Верс.01.18 (п.2,7))

2. "Файл|Выгрузки|Анализ выгрузок" - позволяет получить динамику выгрузок для ПФ.
   В каждой выборке идёт сравнение интересуемого месяца с предыдущим.
   Накладываемые ограничения на выборку:
   а) Начали платить: в предыдущем месяце не платили, в этом - платят
   б) Прекратили платить: в предыдущем месяце платили, в этом - прекратили
   в) Сейчас = Раньше: сумма по отношению к предыдущему месяцу не изменилось
   г) Сейчас - Раньше > : сумма в этом месяце превосходит сумму в предыдущем больше,
                          чем на указанное значение
   д) Сейчас - Раньше < : сумма в предыдущем месяце превосходит сумму в этом больше,
                          чем на указанное значение
   е) Сейчас / (Раньше+0,01) > : частное от деления суммы в этом месяце на сумму в предыдущем с
                                 дополнительной копейкой больше укзанного значения
   ж) Сейчас / (Раньше+0,01) < : частное от деления суммы в этом месяце на сумму в предыдущем с
                                 дополнительной копейкой меньше укзанного значения

3. "Файл|Выгрузки|Очистить выгрузки..." - удаляет выгрузки, начиная с самого раннего месяца.
   Менее 3-х месяцев программа оставить не позволит.

4. "Форс-мажор". Теперь в программе крайне ограничено использование режима отладки. Для
   получения всех возможностей нужно через "Форс-мажор|Ключ..." узнать код, позвонить мне и
   получить ключ.


**************************************** Версия 01.24 ****************************************
1. Исправлена ошибка (range check error) получения начислений,
   возникающая в ситуации [Начало периода] больше [Конец периода].
   
2. Установлена проверка на соблюдение правила [Начало периода] не больше [Конец периода]
   при загрузке файла из ПФР.


**************************************** Версия 01.25 ****************************************
1. Добавлен учёт удержаний при выполнении команды начисления.
   Логика обработки аналогична локике обработки доплат к начислениям.

2. Добавлена команда "Настройки|Начисления...", вызывающая диалог, в котором:
   а) Можно определить (в разрешённых рамках) перечень данных, используемых при импорте начислений.
   б) Просто взглянуть на этот перечень.

3. Пункт меню "Правка|Учёт доплат..." изменён на "Правка|Учёт доплат и удержаний...".
   По этой команде теперь можно указать, что учитывать:
   а) доплаты
   б) удержания
   в) доплаты и удержания


**************************************** Версия 01.26 ****************************************
1. В диалоге "Отчёты|Статистика по файлам..." добавлена возможность в отчёте "Количество записей"
   маркировка записей, у которых соотношение М/O <= заданного.


**************************************** Версия 01.27 ****************************************
1. После загрузки файла типа ЗАПРОС значение в элементе "№ выгрузки" на форме устанавливается
   равным значению номера выгрузки в имени файла с запросом (последний символ в имени файла).
   Это нужно для безошибочного оформления имён файлов с ответами, сформированных на возможный
   дополнительный (специально обрабатываемый министерством) запрос, имеющим номер выгрузки = 9.
   ОТВЕТ также должен иметь номер выгрузки = 9.
   В остальном при обработке запросов в УСПН ничего не изменено.


**************************************** Версия 01.28 ****************************************
1. Добавлены МСП, учитываемые при формировании начислений (для ПФ код МСП = 4)
     compTelephoneServ (Ежемесячное возмещение расходов по оплате услуг местной телефонной связи)
     compRadioServ (Ежемесячное возмещение расходов по оплате услуг за пользование радио)


**************************************** Версия 02.00 ****************************************
1. Сделаны изменения, необходимые для обработки каждым районом общего запроса (без деления на
   подразделения ПФР) с последующей сборкой общего ответа для ПФР.


**************************************** Версия 02.01 ****************************************
1. Внутренние изменения.