Загрузка...

4.16. Поле Дерево документов

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

Методы поля для записи данных

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

  • Добавить документ в дерево. Метод имеет три параметра: ссылка на добавляемый документ, родительский документ (определяет позицию  в дереве, куда будет добавлен дочерним элементом добавляемый документ; при пустом значении данного параметра или отсутствии его значения в дереве документ добавляется в корень дерева) и название документа (то название, которое будет отображать в дереве; если не заполнить этот параметр, то будет использование название типа добавляемого документа).
    Один документ может находиться в дереве только в одном экземпляре. Поэтому, если документ уже находится в дереве, его месторасположение в нем будет изменено в соответствии с параметрами данного метода (то есть будет установлены название, которое получит этот метод, и родственный документ). Если у документа были дочерние ветви, а сам документ переносится в другую ветвь дерева, эти дочерние ветви будут присоединены к существовавшему до выполнения метода родителю. 
  • Добавить дерево как ветку. Метод позволяет дописать содержимое одного дерева документов к другому. У метода есть параметры для указания добавляемого дерева и параметр "Родительский документ", позволяющий добавить содержимое в конкретную ветвь существующего дерева. Если "Родительский документ" не задан, то добавление осуществляется в корень существующего дерева. 
  • Удалить документ. Метод позволяет удалить документ из дерева. Если документ имел дочерние ветви, то эти ветви присоединяются к его "родителю". Идентификатор добавляемого документа указывается на вкладке "Что записывать" действия Запись.
  • Удалить ветку. В отличие от предыдущего метода, удаляющего только документ, но сохраняющую его дочерние ветви, данный метод удаляет все содержимое, начиная с удаляемого документа.
  • Обновить название документа. Если необходимо изменить отображаемый в дереве заголовок документа следует использовать этот метод В качестве параметров метод принимает идентификатор документа, который необходимо обновить, и новый заголовок.

Методы поля для получения данных

  • Получить ветку дерева. Метод возвращает ветку дерева, начиная с родительского документа, который указывается в параметре этого метода.
  • Получить все родительские документы. Метод в качестве параметра принимает идентификатор документа, а возвращает список идентификаторов его родительских документов, перечисленных через запятую. Возвращаются только непосредственные родители (без "дядь" и "теть").

Внимание!
Поле "Дерево документов" является платным, не включено в стандартный дистрибутив системы и распространяется на условиях лицензии Documentov License. Посмотреть поле в работе можно в облачном Documentov'е, ознакомиться с ценой здесь.