+-------------------------------------------------------------------------------+
| Использование программы "PFgku" для подготовки информациии о назначении "ЖКУ" |
+-------------------------------------------------------------------------------+

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

2. "ЖКУ" - Подготавливает список лиц, которым назначено МСП "Ежемесячная денежная выплата на
   оплату жилого помещения и коммунальных услуг (федеральный бюджет)" (код="standartHCS")
   за выбранный квартал.
   Учитываются назначения со статусом: "Выплата приостановлена", "Постоянное прекращение",
                                       "Утверждено", "Неполная выплата", "Проверено"
   (ESRN_SERV_SERV.A_STATUSPRIVELEGE in (1,2,13,15,17))

   При подготовке списка могут помечены проблемные записи.
   Красный значок "i" - проблема в основной таблице списка (таблица "O")
   Синий значок "i" - проблема в дополнительной таблице (таблица "Ж").
   Щелчок по значку покажет подробности проблемы.

3. "Сверить..." - сверка списка, полученного командой "ЖКУ" с данными из программы "Уфа".
   После выбора каталога с базой данных "Уфа" (там должна быть файл "register.dbf") происходит
   сверка, результатом которой является:
   а) маркировка проблемных записей (колонка "Уфа")
   б) протокол сверки (можно отключить в настройках, но лучше этого не делать)
   Сверка проходит по ФИО, СНИЛСУ и, возможно, дате рождения (см. настройки)

4. "Протокол..." - показывает протокол сверки.
   а) зелёные записи(стандартная цветовая схема) - полное совпадение
   б) жёлтые (цвет всплывающей подсказки) - отличие в СНИЛС
   в) серые - такого человека нет в "Уфе"
   г) белые - человека нет в таблице "О".
   Допускается копирование в ЭСРН (но не в "О") значений СНИЛС и даты рождения из "Уфы" (контексное меню)

5. "Выгрузить" - создаёт файл для пенсионного фонда. (файл не переименовывать)

6. "Загрузить" - выбирается и загружается файл, ранее подготовленный программой

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

Поиск и фильтрация:
-------------------
Для поиска значения нужно выбрать колонку и в строке поиска (справа от выбранной колонки) ввести значение.
Если в строке поиска есть значение, можно по нему выполнить фильтрацию (кнопка с буквой "Ф").
Специальные значения:
  "Уфа": 0 - нет проблем
         1 - Различие с БД "Уфа" в СНИЛСе
         2 - Нет такого человека в БД "Уфа"  
  "О","Ж","?": 0 - без проблем
               1 - есть проблема

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

Меню "?"
--------
"Колонка" - показывает позицию значения из данной колонки в выходном файле
"Льготные категории..." - показывает список льготных категорий по классификации ПФР.


Ver 01.01
---------
1. Уточнена выборка адреса


Ver 01.02
---------
1. Обработка назначений, не имеющих детализации расчёта (это для города):
   а) назначение учитывается
   б) кол-во проживающих лиц устанавливается в единицу.

   
Ver 01.03
---------
1. Исправлена обработка удостоверения личности, работавшая неверно при отсутствии
   выдавшей удостоверение организации.


Ver 01.04
---------
Добавлена возможность сверки всех СНИЛСов ЭСРН и УФЫ, что, строго говоря выходит за рамки ЖКУ,
но писать отдельную программу не хотелось.
  1) Выполнить команду меню
     Дополнительно|Сверить СНИЛСы... (выбор БД аналогично I. Работа с программой. Пункт 3.)
     Она создаст отдельную таблицу cst_ProblemSnils и заполнит её по следущим правилам:
     а) СНИЛС из УФЫ не найден в ЭСРН, тогда
        если находится ФИО из УФЫ в ЭСРН, то присваивается статус "другой СНИЛС" или "нет СНИЛСа"
     б) СНИЛС из УФЫ найден в ЭСРН, тогда
        если ФИО в ЭСРН отличается от ФИО из УФЫ, то присваивается статус "другое ФИО"
     Сожалею, но заниматься оптимизаций алгоритма было некогда, так что придётся подождать.
     (у меня для Екатериновского р-на 6:56(мм:сс), для Ртищевского 35:50)

  2) Выполнить команду
     Дополнительно|"Плохие" СНИЛСы...
     для работы с полученными результатами
     (Команду СНИЛСы-->ЭСРН лучше выполнить, когда никто не работает с личными делами)

  Разъяснение по поводу одной ловушки, в которую можно угодить, используя
  команду "Дополнительно|Сверить СНИЛСы...".
    Имеем в ЭСРН запись (СНИЛС_1, ФИО)
    В Уфе 2 записи с тем же ФИО (СНИЛС_1, ФИО) и (СНИЛС_2, ФИО)
  После 1-го выполнения получаем для "Плохие" СНИЛСы...
    (Другой СНИЛС, СНИЛС_1, ФИО, СНИЛС_2, ФИО)
  После исправления в ЭСРН будет (СНИЛС_2, ФИО)
  После 2-го выполнения получаем для "Плохие" СНИЛСы...
    (Другой СНИЛС, СНИЛС_2, ФИО, СНИЛС_1, ФИО)
  И так до бесконечности.


Ver 01.05
---------
1. Установлен запрет выгрузки, если не определена группа инвалидности (для ПФ - это ЛК).
   Заполнение данных о документе, подтверждающем ЛК не является в данный момент обязательным,
   но высока вероятность, что в скором будущем, может даже в этом году, эту информацию будут
   требовать.
   (Документ программой выбирается только из заявления)

2. Добавлена возможность отбора лиц, у которых не определена ЛК по классификации ПФ.
   (практически всегда это отсутствие группы инвалидности).
   Команда "Лица без ЛК" отбирает из результата выполнения команды "ЖКУ"
   всех лиц, у которых ЛК < 0 (для неопределённой группы инвалидности это [-80](соответствует "Инвалид" в ЭСРН)).
   
   Обращаю внимание, что колонки "Нач.действ." и "Кон.действ." (основания для получения
   МСП по оплате ЖКУ) относятся к документу, а группа инвалидности c учётом
   "Дата начала действия" и "Дата окончания действия"(к заполнению не обязательна)
   вытаскивается из вкладки "Здоровье" данных о здоровье в ЛД.
   (Часто группа инвалидности не определяется из-за того, что "Дата окончания действия" осталась в прошлом).

   Данными, полученными предыдущей версией программы, пользоваться нельзя. Обязательно выполните снова
   команду "ЖКУ" для установленного 2-го квартала 2010 г.

   Напоминаю, сведения об отсутсвии документа или группы инвалидности(это вместе) можно получить
   следующим образом:
   - выбиратся для поиска колонка "Ж?"
   - в поле поиска вводится 1
   - нажиматся кнопка "Фильтрация"
   - результат через буфер обмена из контекстного меню скопировать (это справедливо для любой таблицы) в Excel.


Ver 01.06
---------
Добавлена возможность получения отчёта "Сведения о количестве лиц...", который в программе
называется "Приложение №2". Для этого сделано следующее:
  1. Добавлены команда "Приложение №2..." ("Файл|Приложение №2...")
  2. Добавлены команда "Настройка|Для приложения №2...".
  3. Изменён справочник льготных категорий, в который добавлена связка
     "категория <-> номер строки в отчёте". ("?|Льготные категории").

Файл с шаблоном отчёта "Annex2.xls" должен находиться в подкаталоге "Template"
относительно "PFgku.exe".
Пример. Программа расположена так: "c:\csi\PFgku\PFgku.exe", тогда шаблон
        должен храниться так: "c:\csi\PFgku\Template\Annex2.xls".


Ver 01.07
---------
Теперь неопределённое значение статусов (a_status=null) интерпритируется как "действующий" (a_status=10).
Такое (a_status=null) встречается для площади жилья.

Замечание:
Площадь берётся из
"Жилищные условия"|"Характеристики квартиры"|"Характеристики жилья"|"Общая площадь"
по старшей дате "Данные на"


Ver 01.08
---------
Изменён источник данных (теперь это колонка "На жильё"), из которого заполняется
колонка "К-во лиц...|Всего" в отчёте "Приложение №2".
Поэтому, отчёт надо сформировать заново.


Ver 01.09
---------
1. Следующие подпункты не относятся к обычной или нормальной работе.
  а) Переключатель в меню "Настройка|А-ля СВИК" в обычном режиме сделан невидимым.
     Показать его можно через меню "Настройка|Отладка..."
  б) Меню "Дополнительно" в обычном режиме сделано невидимым, т.к., думаю, сверка
     СНИЛСов по всей ЭСРН понадобится не часто.
     Показать его можно через меню "Настройка|Отладка..."
  в) Запрещена выгрузка для ПФ в ANSI-коде (меню "Настройка|Отладка...").

2. Команда меню "?|ЭСРН-ПФ-Приложение2" покажет связки льготных категорий ЭСРН, ПФ и
   строк отчёта "Приложение №2".
   Щелчок по заголовку колонки изменит порядок сортировки.

3. "Поиск|Отбор по категориям" позволяет получить списки получателей по категориям.
   Список выдаётся отсортированным по "ФИО,дата рождения,категория".
   Пустой список "Выбор категорий" выведет получателей по всем категориям.
   Если у получателя есть несколько категорий и эти категории будут выбранны,
   то он появится в списке соответствующее к-во раз.


Ver 01.10
---------
1. Для каждого получателя теперь учитывается только одно назначение со старшей датой
   начала периода назначения.


Ver 01.11
---------
1. В "Поиск|Отбор по категориям" добавлена команда "Вне очёта", которая позволяет
   пометить категории, сведения о которых не попадают в Приложение №2.
   После этого обычное (кнопка с молнией) выполнение запроса
   позволит увидеть носителей этих категорий.


Ver 01.12
---------
1. Дополнительные разъяснения о лицах, попадающих в выгрузку
   I) "ЖКУ" - Подготавливает список лиц, которым назначено МСП "Ежемесячная денежная выплата на
      оплату жилого помещения и коммунальных услуг (федеральный бюджет)" (код="standartHCS")
      за выбранный квартал.
      Учитываются назначения со статусом: "Выплата приостановлена", "Постоянное прекращение",
                                          "Утверждено", "Неполная выплата", "Проверено"
      (ESRN_SERV_SERV.A_STATUSPRIVELEGE in (1,2,13,15,17))

   II) В назначении на вкладке "Размеры МСП" для принятия решения о выгрузке программа
       анализирует таблицу "Размер назначения". Если хотя-бы один день из квартала попадает в
       период "Дата начала действия" ... "Дата окончания действия" какой-либо строки,
       льготодержатель попадёт в выгрузку.

       В случае, если не определена дата:

       а) "Дата окончания действия" (не закрыта), то считается, что эта дата равна 31.12.9999г.
                                                                                   ------------
          т.е. назначение действует "бесконечно"

       б) "Дата начала действия" (не открыта), то считается, что эта дата равна 01.01.1753г.
                                                                                ------------
          т.е. назначение начало действовать до возникновения ЭСРН.


2. Теперь для льготной категории "Семьи, имеющие детей-инвалидов", выбираются данные из
   "Лицо, на основании данных ЛД которого сделано назначение"(код = 'familyWithDisabledChild').
   Для остальных льготных категорий всё по прежнему - "Льготодержатель".
   (Всё это в назначении).
    --------------------

3. Добавлены команда "Настройка|Ожидание..." для установок максимального времени ожидания выполнения
   долгих SQL-запросов.

4. Добавлена команда выгрузки некоторых данных из БД "Уфа" в текстовый файл "Файл|Уфа --> Текст".
   Результат работы (текстовый файл) может понадобиться Матвеевой Г.Б. для сверки выгрузок ЖКУ с
   данными ПФ (Уфа).
   Имя полученного файла имеет формат: "UfaГГГГ-ММ-ДД(Количество).Код", где
     а) ГГГГ-ММ-ДД - дата последнего изменения файла REGISTER.DBF;
     б) Количество - количество выгруженных записей;
     в) Код - код района по классификации ПФ.
   Информация, зашитая в имени файла, является ключевой.
   Поэтому, на изменения имени наложены ограничения:
     а) Править подстроки "UfaГГГГ-ММ-ДД(Количество)" и "Код" нельзя;
     б) Добавить свои символы можно перед и после подстроки "UfaГГГГ-ММ-ДД(Количество)";
     в) Нельзя использовать символы "Ufa", ")" и ".".


Ver 01.13
---------
1. При выполнении команды "Сверить" ("Файл|Сверить") при наличии буквы "ё" в ФИО в некоторых
   случаях могло не призойти сопоставление лиц из ЭСРН с Уфой.
   Эта ошибка исправлена.


Ver 01.14
---------
1. Файл Register.dbf из Уфы перед его использованием теперь загружается в БД с ЭСРН.
   (Загрузка выполняется один раз для вновь присланной БД Уфа из ПФ).
   После загрузки показывается:
     Дата файла:      дата файла Register.dbf
     Дата загрузки:   дата и время загрузки Register.dbf
     К-во записей:    количество записей в файле Register.dbf
     К-во плохих дат: количество дат(дней рождения) из Register.dbf вне 01.01.1753...31.12.9999
                      эти даты сохранятся со значением 31.12.9999.

2. Команды для выполнения операций с БД Уфа вынесены в отдельный пункт меню "Уфа"
   Исключение: команда из скрываемого по умолчанию меню "Дополнительно". (см. Ver 01.09)

3. Настройка режима работы сверки выделена в подменю "Настройка|Сверка"

4. Добавлена опция сверки "Учитывать регистр" - при сравнении ФИО учитывать или нет разницу
   между строчными и прописными буквами.


Ver 01.15
---------
1. Добавлена проверка на max длину номера документа, удостоверяющего личность (8 цифр)