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

Копирование/перенос экземпляра персонального документа от одного человека/коллектива к другому

Копирование документа от одного человека/коллектива к другому

Копирование персонального документа представляет собой создание нового документа, содержащего точно такие же данные, как и документ, копирование которого выполняется.

Для копирования документа пользователь должен обладать следующими привилегиями на копируемый экземпляр документа:

  • Просмотр наличия;
  • Просмотр значений реквизитов;
  • Просмотр файлов.

При копировании документа действия выполняются в следующем порядке:

  1. Выполняется блокировка копируемого экземпляра документа, для предотвращения изменения данных документа другими пользователями.
  2. Вызывается обработчик события персонального документа, выполняемый перед добавлением экземпляра персонального документа (см. BeforeAdd), для нового владельца документа.
  3. Для нового владельца создаётся документ с такими же реквизитами и файлами, как у копируемого документа. Для выполнения этого действия пользователь должен обладать:
    • привилегиями на копируемый документ:
      • Просмотр наличия;
      • Просмотр значений реквизитов;
      • Просмотр файлов;
    • привилегиями на создаваемый документ:
      • Просмотр наличия;
      • Просмотр значений реквизитов;
      • Редактирование документов;
      • Просмотр файлов;
      • Редактирование файлов;
    • минимальными привилегиями на класс копируемого документа:
      • Просмотр наличия (пользователь должен иметь право просмотреть наличие любых документов этого класса, иными словами, пользователь может скопировать документ, если от него не скрыт ни один из экземпляров документа этого класса);
      • Создание документов (пользователь должен иметь право создавать документы этого класса).
  4. Вызывается обработчик события персонального документа, выполняемый после добавления экземпляра персонального документа, для созданного документа.
  5. С копируемого экземпляра документа снимается блокировка.

Перенос документа от одного владельца к другому

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

Для переноса документа пользователь должен обладать следующими привилегиями на переносимый экземпляр документа:

  • Просмотр наличия;
  • Просмотр значений реквизитов;
  • Смена человека/коллектива;
  • Удаление документов;
  • Просмотр файлов.

При переносе документа действия выполняются в следующем порядке:

  1. Выполняется блокировка переносимого экземпляра документа, для предотвращения изменения данных документа другими пользователями.
  2. Вызывается обработчик события персонального документа, выполняемый перед удалением экземпляра персонального документа, для переносимого документа.
  3. Вызывается обработчик события персонального документа, выполняемый перед добавлением экземпляра персонального документа, для нового владельца документа.
  4. Изменяется владелец экземпляра переносимого документа, при этом идентификатор перенесённого экземпляра документа не изменяется. Для выполнения этого действия пользователь должен обладать минимальными привилегиями на класс переносимого документа:
    • Создание документов (пользователь должен иметь право создавать документы этого класса).
  5. Вызывается обработчик события персонального документа, выполняемый после удаления экземпляра персонального документа, для прежнего владельца документа.
  6. Вызывается обработчик события персонального документа, выполняемый после добавления экземпляра персонального документа, для переносимого документа.
  7. С перенесённого экземпляра документа снимается блокировка.

Копирование документа от одного владельца к другому с заменой

Копирование персонального документа с заменой доступно, если новый владелец копируемого документа уже имеет документ (документы) того же класса, что и копируемый документ, и при этом запрещено иметь несколько экземпляров этого класса. Копирование представляет собой создание нового документа, содержащего точно такие же данные, как и документ, копирование которого выполняется, и удаление у нового владельца прежних документов того же класса.

Для копирования документа с заменой пользователь должен обладать следующими привилегиями на копируемый экземпляр документа:

  • Просмотр наличия;
  • Просмотр значений реквизитов;
  • Просмотр файлов.

При копировании документа с заменой действия выполняются в следующем порядке:

  1. Выполняется блокировка копируемого экземпляра документа, для предотвращения изменения данных документа другими пользователями.
  2. У нового владельца удаляются все экземпляры документа этого класса, за исключением документа имеющего наибольший идентификатор. Если новый владелец обладает только одним экземпляром документа этого класса, то удаление документов не выполняется. Для выполнения этого действия пользователь должен обладать следующими привилегиями на каждый удаляемый документ:
    • Просмотр наличия;
    • Удаление документов.
  3. Вызывается обработчик события персонального документа, выполняемый перед изменением экземпляра персонального документа, для заменяемого (единственного экземпляра нового владельца или экземпляра, который из нескольких имел наибольший идентификатор) экземпляра документа.
  4. Удаляются все реквизиты и файлы заменяемого экземпляра документа. Для выполнения этого действия пользователь должен обладать привилегиями на заменяемый экземпляр документа:
    • Просмотр наличия;
    • Просмотр значений реквизитов;
    • Редактирование документов;
    • Просмотр файлов;
    • Редактирование файлов.
  5. Выполняется копирование реквизитов и файлов из копируемого документа в заменяемый. Для выполнения этого действия пользователь должен обладать привилегиями на копируемый экземпляр документа:
    • Просмотр наличия;
    • Просмотр значений реквизитов;
    • Редактирование документов;
    • Просмотр файлов;
    • Редактирование файлов.
  6. Вызывается обработчик события персонального документа, выполняемый после изменения экземпляра персонального документа, для заменяемого документа.
  7. С копируемого экземпляра документа снимается блокировка.

Перенос документа от одного владельца к другому с заменой

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

Для переноса документа пользователь должен обладать следующими привилегиями на переносимый экземпляр документа:

  • Просмотр наличия;
  • Просмотр значений реквизитов;
  • Смена человека/коллектива;
  • Удаление документов;
  • Просмотр файлов.

При переносе документа с заменой действия выполняются в следующем порядке:

  1. Выполняется блокировка переносимого экземпляра документа, для предотвращения изменения данных документа другими пользователями.
  2. У нового владельца удаляются все экземпляры документа этого класса, за исключением документа имеющего наибольший идентификатор. Если новый владелец обладает только одним экземпляром документа этого класса, то удаление документов не выполняется. Для выполнения этого действия пользователь должен обладать привилегиями на каждый удаляемый документ:
    • Просмотр наличия;
    • Удаление документов.
  3. Вызывается обработчик события персонального документа, выполняемый перед изменением экземпляра персонального документа, для заменяемого (единственного экземпляра нового владельца или экземпляра, который из нескольких имел наибольший идентификатор) экземпляра документа.
  4. Удаляются все реквизиты и файлы заменяемого экземпляра документа. Для выполнения этого действия пользователь должен обладать привилегиями на заменяемый экземпляр документа:
    • Просмотр наличия;
    • Просмотр значений реквизитов;
    • Редактирование документов;
    • Просмотр файлов;
    • Редактирование файлов.
  5. Вызывается обработчик события персонального документа, выполняемый перед удалением экземпляра персонального документа, для переносимого экземпляра документа.
  6. Выполняется перенос реквизитов и файлов из переносимого документа в заменяемый.
  7. Удаляется переносимый документ.
  8. Вызывается обработчик события персонального документа, выполняемый после удаления экземпляра персонального документа, для прежнего владельца документа.
  9. Вызывается обработчик события персонального документа, выполняемый после изменения экземпляра персонального документа, для заменяемого документа.

См. также