Документация iSZN

Правило импорта XML-дампов людей/коллективов

Правило импорта XML-дампов людей/коллективов определяет виды данных (люди, коллективы, персональные документы и тому подобное), которые должны быть загружены в базу данных из файла XML-дампа человека/коллектива, а также действия, которые должны быть выполнены над ними (добавление, обновление, удаление).

Правила импорта используются серверными операциями для загрузки данных из XML-дампов. Пользователь, выполняющий такую серверную операцию, должен обладать всеми требуемыми для загрузки данных привилегиями на экземпляры персональных документов и привилегиями на виды выплат.

Характеристики правила импорта XML-дампов людей/коллективов

  • Правило импорта идентифицируется уникальным региональным ключом.
  • Правило импорта имеет обязательное уникальное в пределах своего района наименование; также для него можно ввести описание.
  • Правило импорта характеризуется необязательным параметром «Вид загружаемых данных», который представляет собой строковый идентификатор. С помощью этого параметра можно автоматически сопоставить XML-дампу правило для его загрузки. Если вид загружаемых данных для правила импорта не указан, то он не учитывается.
  • Правило импорта может характеризоваться диапазоном версий формата XML-дампа, загрузка которого поддерживается данным правилом импорта.
  • Правило импорта может быть связано с опциями продукта. Правило импорта доступно для использования на конкретном экземпляре Системы, если серверная лицензия, установленная на этом экземпляре Системы, включает хотя бы одну опцию, с которой связано данное правило импорта.
  • Правила импорта содержат правила импорта людей.
  • Правила импорта могут включать в себя правила импорта коллективов для различных классов коллективов.
Версия формата XML-дампа

Версия формата XML-дампа представляет собой три числа, разделённых точками, например 1.2.1. Первое число называется старшим номером версии, второе — младшим номером версии, третье — номером ревизии. Для правила импорта могут быть указаны минимальная и максимальная версии, поддерживаемые данным правилом импорта, например от 1.1.0 до 1.5.5 (включительно).

При проверке версии формата XML-дампа последовательно сравниваются старший номер версии, младший номер версии и номер ревизии следующим образом:

  1. Проверка старшего номера минимальной поддерживаемой правилом импорта версии формата XML-дампа:
    • Если старший номер минимальной поддерживаемой правилом импорта версии формата XML-дампа не указан, то его проверка не выполняется, и выполняется проверка максимального номера версии формата XML-дампа (пункт 4).
    • Если старший номер версии формата XML-дампа меньше старшего номера минимальной поддерживаемой правилом импорта версии формата XML-дампа, то загрузка данных из файла XML-дампа не выполняется.
    • Если старший номер версии формата XML-дампа больше старшего номера минимальной поддерживаемой правилом импорта версии формата XML-дампа, то проверка считается успешной и выполняется проверка максимального номера версии формата XML-дампа (пункт 4).
    • Если старший номер версии формата XML-дампа равен старшему номеру минимальной поддерживаемой правилом импорта версии формата XML-дампа, то выполняется проверка младшего номера минимальной поддерживаемой версии формата XML-дампа (пункт 2).
  2. Проверка младшего номера минимальной поддерживаемой правилом импорта версии формата XML-дампа:
    • Если младший номер минимальной поддерживаемой правилом импорта версии формата XML-дампа не указан, то его проверка не выполняется, и выполняется проверка максимального номера версии формата XML-дампа (пункт 4).
    • Если младший номер версии формата XML-дампа меньше младшего номера минимальной поддерживаемой правилом импорта версии формата XML-дампа, то загрузка данных из файла XML-дампа не выполняется.
    • Если младший номер версии формата XML-дампа больше младшего номера минимальной поддерживаемой правилом импорта версии формата XML-дампа, то проверка считается успешной и выполняется проверка максимального номера версии формата XML-дампа (пункт 4).
    • Если младший номер версии формата XML-дампа равен младшему номеру минимальной поддерживаемой правилом импорта версии формата XML-дампа, то выполняется проверка номера ревизии минимальной поддерживаемой версии формата XML-дампа (пункт 3).
  3. Проверка номера ревизии минимальной поддерживаемой правилом импорта версии формата XML-дампа:
    • Если номер ревизии минимальной поддерживаемой правилом импорта версии формата XML-дампа не указан, то его проверка не выполняется, и выполняется проверка максимального номера версии формата XML-дампа (пункт 4).
    • Если номер ревизии версии формата XML-дампа меньше номера ревизии минимальной поддерживаемой правилом импорта версии формата XML-дампа, то загрузка данных из файла XML-дампа не выполняется.
    • Если номер ревизии версии формата XML-дампа больше (или равен) номера ревизии минимальной поддерживаемой правилом импорта версии формата XML-дампа, то проверка считается успешной и выполняется проверка максимального номера версии формата XML-дампа (пункт 4).
  4. Проверка старшего номера максимальной поддерживаемой правилом импорта версии формата XML-дампа:
    • Если старший номер максимальной поддерживаемой правилом импорта версии формата XML-дампа не указан, то его проверка не выполняется, и проверка версии формата XML-дампа считается успешной.
    • Если старший номер версии формата XML-дампа больше старшего номера максимальной поддерживаемой правилом импорта версии формата XML-дампа, то загрузка данных из файла XML-дампа не выполняется.
    • Если старший номер версии формата XML-дампа меньше старшего номера максимальной поддерживаемой правилом импорта версии формата XML-дампа, то проверка версии формата XML-дампа считается успешной.
    • Если старший номер версии формата XML-дампа равен старшему номеру максимальной поддерживаемой правилом импорта версии формата XML-дампа, то выполняется проверка младшего номера максимальной поддерживаемой версии формата XML-дампа (пункт 5).
  5. Проверка младшего номера максимальной поддерживаемой правилом импорта версии формата XML-дампа:
    • Если младший номер максимальной поддерживаемой правилом импорта версии формата XML-дампа не указан, то его проверка не выполняется, и проверка версии формата XML-дампа считается успешной.
    • Если младший номер версии формата XML-дампа больше младшего номера максимальной поддерживаемой правилом импорта версии формата XML-дампа, то загрузка данных из файла XML-дампа не выполняется.
    • Если младший номер версии формата XML-дампа меньше младшего номера максимальной поддерживаемой правилом импорта версии формата XML-дампа, то проверка версии формата XML-дампа считается успешной.
    • Если младший номер версии формата XML-дампа равен младшему номеру максимальной поддерживаемой правилом импорта версии формата XML-дампа, то выполняется проверка номера ревизии максимальной поддерживаемой версии формата XML-дампа (пункт 6).
  6. Проверка номера ревизии максимальной поддерживаемой правилом импорта версии формата XML-дампа:
    • Если номер ревизии максимальной поддерживаемой правилом импорта версии формата XML-дампа не указан, то его проверка не выполняется, и проверка версии формата XML-дампа считается успешной.
    • Если номер ревизии версии формата XML-дампа больше номера ревизии максимальной поддерживаемой правилом импорта версии формата XML-дампа, то загрузка данных из файла XML-дампа не выполняется.
    • Если номер ревизии версии формата XML-дампа меньше (или равен) номера ревизии максимальной поддерживаемой правилом импорта версии формата XML-дампа, то проверка версии формата XML-дампа считается успешной.

Правило импорта людей

  • Правила импорта людей определяют действия над людьми, данные которых находятся в файле XML-дампа.
  • Для правила импорта людей задаётся режим импорта:
Режим импорта Описание
Искать, при отсутствии - создавать Найти соответствие между человеком в КИС и в файле XML-дампа. Если он отсутствует в базе данных, то необходимо создать его в КИС (для создания человека необходимо также правило импорта основного документа, удостоверяющего личность). Если он имеется в базе данных, то не нужно выполнять никакие действия.
Искать, при отсутствии выдать ошибку Найти соответствие между человеком в КИС и в файле XML-дампа. Если он отсутствует в базе данных, то необходимо сообщить об ошибке и не создавать его в КИС. Если он имеется в базе данных, то не нужно выполнять никакие действия.
Пропустить Не искать соответствие между человеком в КИС и в файле XML-дампа.
  • Найти соответствие между человеком в КИС и в файле XML-дампа (так как в файле XML-дампа находятся данные из внешней базы данных, то определяется соответствие между человеком в КИС и человеком во внешней базе данных) означает создать для этого человека запись соответствия ключей для импорта XML-дампов людей/коллективов. Поиск человека выполняется следующим образом:
    • Если в файле XML-дампа указан идентификатор человека во внутренней базе данных, то поиск считается выполненным успешно и для человека создаётся запись соответствия ключей (если она ещё не существует).
    • Если в файле XML-дампа идентификатор человека во внутренней базе данных не указан, то выполняется поиск человека по источнику данных и идентификатору во внешней базе данных в записях соответствия ключей людей.
      • Если запись соответствия ключей человека существует и в ней указан идентификатор человека во внутренней базе данных, то поиск считается выполненным успешно.
      • Если записи соответствия ключей человека нет или в ней не указан идентификатор человека во внутренней базе данных, то выполняется поиск по фамилии, имени, отчеству и дате рождения человека.
        • Если человек найден по фамилии, имени, отчеству и дате рождения, то поиск считается выполненным успешно и для человека создаётся запись соответствия ключей с заполненным идентификатором человека во внутренней базе данных.
        • Если человек не найден по фамилии, имени, отчеству и дате рождения, то поиск считается выполненным неуспешно (в дальнейшем при создании человека для него также будет добавлена запись соответствия ключей).

Правило импорта коллективов

  • Правила импорта коллективов определяют действия над коллективами, данные которых находятся в файле XML-дампа.
  • Правило импорта коллективов всегда относится к правилу импорта XML-дампов людей/коллективов.
  • Для правила импорта коллективов задаётся режим импорта:
Режим импорта Описание
Искать, при отсутствии — создавать Найти соответствие между коллективом в КИС и в файле XML-дампа. Если он отсутствует в базе данных, то необходимо создать его в КИС. Если он имеется в базе данных, то не нужно выполнять никакие действия.
Искать, при отсутствии выдать ошибку Найти соответствие между коллективом в КИС и в файле XML-дампа. Если он отсутствует в базе данных, то необходимо сообщить об ошибке и не создавать его в КИС. Если он имеется в базе данных, то не нужно выполнять никакие действия.
Пропустить Не искать соответствие между коллективом в КИС и в файле XML-дампа.
Пропустить и выдать ошибку Не искать соответствие между коллективом в КИС и в файле XML-дампа и сообщить об ошибке.
  • Найти соответствие между коллективом в КИС и в файле XML-дампа (так как в файле XML-дампа находятся данные из внешней базы данных, то определяется соответствие между коллективом в КИС и коллективом во внешней базе данных) означает создать для этого коллектива запись соответствия ключей для импорта XML-дампов людей/коллективов. Поиск коллектива выполняется следующим образом:
    • Если в файле XML-дампа указан идентификатор коллектива во внутренней базе данных, то поиск считается выполненным успешно и для коллектива создаётся запись соответствия ключей (если она ещё не существует).
    • Если в файле XML-дампа идентификатор коллектива во внутренней базе данных не указан, то выполняется поиск коллектива по источнику данных и идентификатору во внешней базе данных в записях соответствия ключей коллективов.
      • Если запись соответствия ключей коллектива существует и в ней указан идентификатор коллектива во внутренней базе данных, то поиск считается выполненным успешно.
      • Если записи соответствия ключей коллектива нет или в ней не указан идентификатор коллектива во внутренней базе данных, то поиск считается выполненным неуспешно (в дальнейшем при создании коллектива для него будет добавлена запись соответствия ключей коллектива).
  • Правило импорта коллективов может относиться к конкретному классу коллективу. Если правило не относится к конкретному классу коллектива, то тогда оно является правилом по умолчанию и применяется для всех классов коллективов, для которых правила импорта не заданы явно. При загрузке данных коллектива из файла XML-дампа применяется правило импорта, заданное для конкретного класса коллектива. Если оно не задано, то используется правило импорта коллективов по умолчанию. Если правило по умолчанию не задано и возникает необходимость загрузить данные коллектива, для класса которого явно не задано правило импорта, то загрузка данных коллектива не выполняется, так как для него не задано правило импорта.
  • Правило импорта коллективов включает в себя правила импорта различных объектов, принадлежащих коллективу:

Правила импорта объектов

Правило импорта XML-дампов людей/коллективов включает в себя, помимо правил импорта людей и коллективов, правила импорта различных объектов, принадлежащих людям и коллективам.

Правило импорта членов коллектива

  • Правило импорта членов коллектива идентифицируется уникальным региональным ключом.
  • Правило импорта членов коллектива относится к правилу импорта коллектива.
  • Правило импорта членов коллектива может относиться к конкретному классу роли. Если правило не относится к конкретному классу роли, то тогда оно является правилом по умолчанию и применяется для всех классов ролей, для которых правила импорта не заданы явно. Если правило импорта членов коллектива по умолчанию относится к правилу импорта конкретного класса коллектива, то оно действует для всех классов ролей этого конкретного класса коллектива. Если правило импорта членов коллектива по умолчанию относится к правилу импорта коллектива по умолчанию, то оно действует для всех классов ролей всех классов коллективов. При загрузке данных роли коллектива из XML-дампа применяется правило импорта, заданное для конкретного класса роли. Если оно не задано, то используется правило импорта роли коллектива по умолчанию. Если и оно не задано, то используется правило импорта коллектива по умолчанию. Если правило по умолчанию не задано и возникает необходимость загрузить данные роли коллектива, для класса которого явно не задано правило импорта, то загрузка данных роли коллектива не выполняется, так как для него не задано правило импорта.
  • Для правила импорта членов коллектива задаются режим добавления и режим удаления:
Режим добавления Описание
Выполнять загрузку Добавить в КИС в состав коллектива человека, данные которого находятся в файле XML-дампа. Если в КИС человек не входит в состав коллектива, то необходимо добавить его на роль, указанную в файле XML-дампа.
Пропустить Пропустить в КИС добавление в состав коллектива человека, данные которого находятся в файле XML-дампа.
Пропустить и выдать ошибку Пропустить в КИС добавление в состав коллектива человека, данные которого находятся в файле XML-дампа, и сообщить об ошибке.
Режим удаления Описание
Выполнять загрузку Удалить в КИС из состава коллектива человека, данные которого находятся в файле XML-дампа. Если в КИС человек входит в состав коллектива, то необходимо удалить его с ролей, на которых он не находится в файле XML-дампа.
Пропустить Пропустить в КИС удаление из состава коллектива человека, данные которого находятся в файле XML-дампа.
Пропустить и выдать ошибку Пропустить в КИС удаление из состава коллектива человека, данные которого находятся в файле XML-дампа, и сообщить об ошибке.

Правило импорта персональных документов

  • Правило импорта персональных документов идентифицируется уникальным региональным ключом.
  • Правило импорта персональных документов относится либо к правилу импорту людей (тогда оно является правилом импорта персональных документов людей), либо к правилу импорта коллективов (тогда оно является правилом импорта персональных документов коллективов).
  • Правило импорта персональных документов может относиться к конкретному классу персонального документа. Если правило не относится к конкретному классу персонального документа, то тогда оно является правилом по умолчанию и применяется для всех классов персональных документов, для которых правила импорта не заданы явно. При загрузке данных из XML-дампа применяется правило импорта, заданное для конкретного класса персонального документа. Если оно не задано, то используется правило импорта персональных документов по умолчанию. Если правило по умолчанию не задано и возникает необходимость загрузить данные персонального документа, для класса которого явно не задано правило импорта, то загрузка данных документа не выполняется, так как для него не задано правило импорта.
  • Правило импорта персональных документов может относиться к основным документам, удостоверяющим личность. В этом случае правило не применяется к прочим документам, удостоверяющим личность, такого же класса.
  • Для правила импорта персональных документов задаются режим создания нового документа и режим обновления существующего документа:
Режим создания нового документа Описание
Выполнять Найти соответствие между персональным документом в КИС и в файле XML-дампа. Создать в КИС новый экземпляр персонального документа, данные которого находятся в файле XML-дампа. Если экземпляр персонального документа отсутствует в базе данных, то необходимо создать его в КИС в соответствии с правилами импорта реквизитов.
Не выполнять Не искать соответствие между персональным документом в КИС и в файле XML-дампа.
Не выполнять и выдать ошибку Не искать соответствие между персональным документом в КИС и в файле XML-дампа и сообщить об ошибке.
Режим обновления существующего документа Описание
Выполнять Найти соответствие между персональным документом в КИС и в файле XML-дампа. Обновить в КИС содержимое экземпляра персонального документа, данные которого находятся в файле XML-дампа. Если экземпляр персонального документа имеется в базе данных, то необходимо обновить его данные в КИС в соответствии с правилами импорта реквизитов.
Не выполнять Не искать соответствие между персональным документом в КИС и в файле XML-дампа.
Не выполнять и выдать ошибку Не искать соответствие между персональным документом в КИС и в файле XML-дампа и сообщить об ошибке.
  • Найти соответствие между персональным документом в КИС и в файле XML-дампа (так как в файле XML-дампа находятся данные из внешней базы данных, то определяется соответствие между персональным документом в КИС и персональным документом во внешней базе данных) означает создать для этого персонального документа запись соответствия ключей для импорта XML-дампов людей/коллективов. Поиск персонального документа выполняется следующим образом:
    • Для персональных документов, владельцы (люди или коллективы) которых не существуют во внутренней базе данных, выполняются следующие действия:
      • Если для персонального документа имеется запись соответствия ключей и для неё указан идентификатор во внутренней базе данных, то сообщается об ошибке и поиск считается выполненным неуспешно.
      • Если в файле XML-дампа указан внешний идентификатор персонального документа (идентификатор в базе данных, в которую загружается персональный документ), то сообщается об ошибке и поиск считается выполненным неуспешно.
      • Если в файле XML-дампа человек или коллектив имеет более одного неповторяемого персонального документа, то сообщается об ошибке и поиск считается выполненным неуспешно.
      • Поиск считается выполненным неуспешно (так как владелец персонального документа не существует во внутренней базе данных).
    • Для персональных документов, владельцы которых существуют во внутренней базе данных, выполняются следующие действия:
      • Если в файле XML-дампа указан идентификатор персонального документа во внутренней базе данных, то поиск считается выполненным успешно и для персонального документа создаётся запись соответствия ключей (если она ещё не существует).
      • Если в файле XML-дампа идентификатор персонального документа во внутренней базе данных не указан, то выполняется поиск персонального документа по источнику данных и идентификатору во внешней базе данных в записях соответствия ключей персональных документов.
        • Если запись соответствия ключей персонального документа существует и в ней указан идентификатор персонального документа во внутренней базе данных, то поиск считается выполненным успешно.
        • Если записи соответствия ключей персонального документа нет или в ней не указан идентификатор персонального документа во внутренней базе данных, то:
          • Для повторяемых документов:
            • Если человек или коллектив имеет во внутренней базе данных хотя бы один повторяемый документ такого же класса, что и загружаемый документ, то сообщается об ошибке (так как идентификация повторяемых документов не реализована) и поиск считается выполненным неуспешно.
            • Если человек или коллектив не имеет во внутренней базе данных документов такого же класса, что и загружаемый документ, то поиск считается выполненным неуспешно.
          • Для неповторяемых документов:
            • Если в файле XML-дампа человек или коллектив имеет более одного неповторяемого персонального документа, то сообщается об ошибке и поиск считается выполненным неуспешно.
            • Если человек или коллектив имеет во внутренней базе данных более одного неповторяемого документа, то сообщается об ошибке и поиск считается выполненным неуспешно.
            • Если человек или коллектив имеет во внутренней базе данных один неповторяемый документ, то поиск считается выполненным успешно и для персонального документа создаётся запись соответствия ключей (если она ещё не существует).
            • Если человек или коллектив не имеет во внутренней базе данных ни одного неповторяемого документа, то поиск считается выполненным неуспешно (в дальнейшем при создании персонального документа для него будет добавлена запись соответствия ключей персонального документа).

Правило импорта реквизитов

  • Правило импорта реквизитов идентифицируется уникальным региональным ключом.
  • Правило импорта реквизитов относится к правилу импорта персональных документов.
  • Правило импорта реквизитов разделяются на следующие виды:
Вид правила Описание
Общее правило Правило, определяющее действия как при создании нового персонального документа, так и при обновлении существующего персонального документа.
Дополнение к общим правилам при создании нового документа Правило, определяющее действия при создании нового персонального документа. Если для персонального документа одновременно заданы общее правило и дополнение к общим правилам при создании нового документа, то используется дополнение к общим правилам при создании нового документа (дополнения к общим правилам имеют приоритет над общими правилами).
Дополнение к общим правилам при обновлении существующего документа Правило, определяющее действия при обновлении существующего персонального документа. Если для персонального документа одновременно заданы общее правило и дополнение к общим правилам при обновлении существующего документа, то используется дополнение к общим правилам при обновлении существующего документа (дополнения к общим правилам имеют приоритет над общими правилами).
Правило импорта скалярных реквизитов
  • Правило импорта скалярных реквизитов идентифицируется уникальным региональным ключом.
  • Правило импорта скалярных реквизитов относится к правилу импорта реквизитов.
  • Правило импорта скалярных реквизитов может относиться к конкретному классу реквизита. Если правило не относится к конкретному классу реквизита, то тогда оно является правилом по умолчанию и применяется для всех классов реквизитов, для которых правила импорта не заданы явно. При загрузке данных из XML-дампа применяется правило импорта, заданное для конкретного класса реквизита. Если оно не задано, то используется правило импорта реквизитов по умолчанию. Если правило по умолчанию не задано и возникает необходимость загрузить значение реквизита, для класса которого явно не задано правило импорта, то загрузка значения реквизита не выполняется, так как для него не задано правило импорта.
  • Для правила импорта реквизитов задаются следующие режимы импорта:
Создавать Описание
Да Если реквизит отсутствует в КИС, но имеется в файле XML-дампа, то необходимо создать этот реквизит со значением, указанным в файле XML-дампа.
Нет Если реквизит отсутствует в КИС, но имеется в файле XML-дампа, то не нужно создавать этот реквизит.
Обновлять Описание
Да Если значение реквизита в КИС отличается от значения реквизита в файле XML-дампа, то необходимо заменить значение этого реквизита в базе данных значением из файла XML-дампа.
Нет Если значение реквизита в КИС отличается от значения реквизита в файле XML-дампа, то не нужно заменять значение этого реквизита в базе данных значением из файла XML-дампа.
Удалять Описание
Да Если реквизит имеется в КИС, но отсутствует в файле XML-дампа, то необходимо удалить этот реквизит из базы данных.
Нет Если реквизит имеется в КИС, но отсутствует в файле XML-дампа, то не нужно удалять этот реквизит из базы данных.
Правило импорта таблиц верхнего уровня
  • Правило импорта таблиц верхнего уровня идентифицируется уникальным региональным ключом.
  • Правило импорта таблиц верхнего уровня относится к правилу импорта реквизитов.
  • Правило импорта таблиц верхнего уровня может относиться к конкретному классу таблицы. Если правило не относится к конкретному классу таблицы, то тогда оно является правилом по умолчанию и применяется для всех классов таблиц верхнего уровня, для которых правила импорта не заданы явно. При загрузке данных из XML-дампа применяется правило импорта, заданное для конкретного класса таблицы. Если оно не задано, то используется правило импорта таблиц верхнего уровня по умолчанию. Если правило по умолчанию не задано и возникает необходимость загрузить данные таблицы, для класса которой явно не задано правило импорта, то загрузка данных таблицы не выполняется, так как для него не задано правило импорта.
  • Для правила импорта таблиц верхнего уровня задаётся режим импорта:
Импортировать Описание
Да Заменять значения реквизитов таблицы, а также реквизитов дочерних таблиц, в КИС значениями этих реквизитов, указанными в файле XML-дампа.
Нет Не заменять значения реквизитов таблицы, а также реквизитов дочерних таблиц, в КИС значениями этих реквизитов, указанными в файле XML-дампа.
Правило отображения ключей значений реквизитов, имеющих тип данных «Ссылка»
  • Правило отображения ключей идентифицируется уникальным региональным ключом.
  • Правило отображения ключей относится к правилу импорта реквизитов.
  • Правило отображения ключей может относиться к конкретному классу реквизита. Если правило не относится к конкретному классу реквизита, то тогда оно является правилом по умолчанию и применяется для всех классов реквизитов, для которых правила импорта не заданы явно. При загрузке данных из XML-дампа применяется правило импорта, заданное для конкретного класса реквизита. Если оно не задано, то используется правило импорта отображения ключей по умолчанию. Если правило по умолчанию не задано и возникает необходимость загрузить значение реквизита, для класса которого явно не задано правило отображения ключей, то загрузка значения реквизита не выполняется, так как для него не задано правило импорта.
  • Для правила отображения ключей задаётся режим отображения ключей:
Отображение ключей Описание
Строгое Необходимо соответствие между значением реквизита в КИС (см. «Сущность») и значением реквизита в файле XML-дампа. Если соответствие не найдено, то экземпляр персонального документа, для значения реквизита которого не удалось установить соответствие ключей, не создаётся (не обновляется) в КИС. Если соответствие ключей найдено, то загрузка данных экземпляра персонального документа выполняется в обычном режиме согласно другим правилам импорта.
Нестрогое Соответствие между значением реквизита в КИС и значением реквизита в файле XML-дампа не требуется. Если соответствия нет, то экземпляр персонального документа, для значения реквизита которого не удалось установить соответствие ключей, всё равно создаётся (обновляется) в КИС, а значение реквизита принимает пустое значение. Если соответствие ключей найдено, то загрузка данных экземпляра персонального документа выполняется в обычном режиме согласно другим правилам импорта.

Правило импорта назначений по видам выплат

  • Правило импорта назначений по видам выплат идентифицируется уникальным региональным ключом.
  • Правило импорта назначений по видам выплат относится либо к правилу импорту людей (тогда оно является правилом импорта назначений людей), либо к правилу импорта коллективов (тогда оно является правилом импорта назначений коллективов).
  • Правило импорта назначений по видам выплат может относиться к конкретному виду выплаты. Если правило не относится к конкретному виду выплаты, то тогда оно является правилом по умолчанию и применяется для всех видов выплат, для которых правила импорта не заданы явно. При загрузке данных из XML-дампа применяется правило импорта, заданное для конкретного вида выплаты. Если оно не задано, то используется правило импорта назначений по умолчанию. Если правило по умолчанию не задано и возникает необходимость загрузить данные назначения по виду выплаты, для которого явно не задано правило импорта, то загрузка данных назначений не выполняется, так как для него не задано правило импорта.
  • Для правила импорта назначений по видам выплат задаётся режим импорта:
Режим импорта Описание
Искать, при отсутствии — создавать Искать в КИС назначение, данные которого находятся в файле XML-дампа. Если оно отсутствует в базе данных, то необходимо его создать в КИС. Если оно имеется в базе данных, то не нужно выполнять никакие действия.
Искать, при отсутствии выдать ошибку Искать в КИС назначение, данные которого находятся в файле XML-дампа. Если оно отсутствует в базе данных, то необходимо сообщить об ошибке и не создавать его в КИС. Если оно имеется в базе данных, то не нужно выполнять никакие действия.
Пропустить Пропустить загрузку в КИС назначения, данные которого находятся в файле XML-дампа.
Пропустить и выдать ошибку Пропустить загрузку в КИС назначения, данные которого находятся в файле XML-дампа, и сообщить об ошибке.
  • Для правила импорта назначений по видам выплат задаются следующие опции:
Опция Описание
Помечать создаваемые назначения как внешние Если включено, то для созданных в результате импорта назначений устанавливается признак «Данные получены из внешнего источника».
Если выключено, то для созданных в результате импорта назначений признак «Данные получены из внешнего источника» не устанавливается.
Обновлять параметры назначения Если включено, то параметры назначения в КИС заменяются параметрами назначения из файла XML-дампа.
Если выключено, то параметры назначения в КИС не заменяются параметрами назначения из файла XML-дампа.
Обновлять параметры выплаты Если включено, то параметры выплаты в КИС заменяются параметрами выплаты из файла XML-дампа.
Если выключено, то параметры выплаты в КИС не заменяются параметрами выплаты из файла XML-дампа.
Импортировать назначенные суммы Если включено, то назначенные суммы в КИС заменяются на назначенные суммы из файла XML-дампа.
Если выключено, то назначенные суммы в КИС не заменяются на назначенные суммы из файла XML-дампа.
Импортировать выплатные суммы и удержания Если включено, то выплатные суммы и удержания в КИС заменяются на выплатные суммы и удержания из файла XML-дампа.
Если выключено, то выплатные суммы и удержания в КИС не заменяются на выплатные суммы и удержания из файла XML-дампа.
Отображение ключей Описание
Строгое Необходимо соответствие между значением свойства назначения в КИС и значением свойства в файле XML-дампа. Если соответствие не найдено, то назначение, для которого не удалось установить соответствие ключей, не создаётся (не обновляется) в КИС. Если соответствие ключей найдено, то загрузка данных назначения выполняется в обычном режиме согласно опциям.
Нестрогое Соответствие между значением свойства назначения в КИС и значением свойства в файле XML-дампа, не требуется. Если соответствия нет, то назначение, для которого не удалось установить соответствие ключей, всё равно создаётся (обновляется) в КИС, а значение свойства принимает пустое значение. Если соответствие ключей найдено, то загрузка данных назначения выполняется в обычном режиме согласно опциям.

Правило импорта файлов

  • Правило импорта файлов идентифицируется уникальным региональным ключом.
  • Правило импорта файлов может относиться:
  • Для правила импорта файлов задаётся режим импорта при создании файла:
Режим импорта Описание
Выполнять Создать файл в КИС.
Не выполнять Не создавать файл в КИС.
Не выполнять и выдать ошибку Не создавать файл в КИС и сообщить об ошибке.
  • Для правила импорта файлов задаётся режим импорта при обновлении файла:
Режим импорта Описание
Выполнять Обновить файл в КИС.
Не выполнять Не обновлять файл в КИС.
Не выполнять и выдать ошибку Не обновлять файл в КИС и сообщить об ошибке.
  • Если правило импорта файлов относится к правилу импорта персонального документа, то режим импорта при создании файла и режим импорта при обновлении файла задаются отдельно для создания персонального документа и для обновления персонального документа.

Работа с правилами импорта XML-дампов людей/коллективов

Папка правил импорта

Папки правил импорта предназначены для группировки правил импорта в зависимости от их назначения.

Характеристики папки правил импорта

  • Папка правил импорта идентифицируется уникальным региональным ключом.
  • Папка правил импорта имеет обязательное наименование, которое должно быть уникальным в пределах своих района и папки-владельца.

Примеры

Правило импорта, позволяющее загрузить данные человека, основной документ, удостоверяющий личность, и справки МСЭ.

Правило Режим импорта Описание
Правило импорта человека Режим импорта: Искать, при отсутствии создавать. Добавлять (обновлять) данные людей.
Правило импорта основных документов, удостоверяющих личность, по умолчанию Документ: (все документы, удостоверяющие личность);
Создание нового документа: Выполнять;
Обновление существующего документа: Не выполнять.
Добавлять любые основные документы, удостоверяющие личность, но не обновлять данные существующих.
- Общее правило импорта таблиц верхнего уровня по умолчанию Импортировать: Да. Импортировать данные всех таблиц верхнего уровня.
- Общее правило импорта скалярных реквизитов по умолчанию Создавать: Да;
Обновлять: Да;
Удалять: Да;
Отображение ключей: Нестрогое.
Импортировать данные всех скалярных реквизитов.
Правило импорта персональных документов по умолчанию Документ: (все документы);
Создание нового документа: Не выполнять;
Обновление существующего документа: Не выполнять.
Не создавать никаких новых документов, кроме тех, для которых это явно разрешено.
Правило импорта документа «Справка МСЭ» Документ: Справка МСЭ;
Создание нового документа: Выполнять;
Обновление существующего документа: Не выполнять.
Создать документы «Справка МСЭ», если их нет в базе данных; существующие документы не обновлять.
- Общее правило импорта таблиц верхнего уровня по умолчанию Импортировать: Да. Импортировать данные всех таблиц верхнего уровня.
- Общее правило импорта скалярных реквизитов по умолчанию Создавать: Да;
Обновлять: Нет;
Удалять: Нет;
Отображение ключей: Нестрогое.
Импортировать данные всех скалярных реквизитов.
Правило импорта назначений по умолчанию Режим импорта: Пропустить;
Вид выплаты: (все виды выплат).
Не импортировать данные назначений по любым видам выплат.

См. также