Загрузка...

5.03. Действие Запись

Действие Запись позволяет изменить значение поля. Действие может запускаться из контекстов маршрутов и любых кнопок системы. Диалоговых окно не имеет.

Администратору для настройки доступны 2 вкладки: Куда записывать и Что записывать.

Куда записывать

На этой вкладке определяется поле, в которое будет осуществляться запись значения, а также используемый метод поля. Это определение осуществляется при помощи следующих параметров:

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

Что записывать

Здесь определяем значение, которое будет записываться. 

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

Действие имеет еще один параметр - "Создать версию". Если этот параметр будет установлен, то после выполнения действия будет запущен механизм создания версии документа и, если будет изменено хотя бы одно поле с установленным атрибутом "Включить в историю", будет создана новая версия в истории документа.