IBM Process Designer 8.5: Чтение и запись данных в Coach View

В Coach View среды IBM Process Designer 8.5 взаимодействие с переменными происходит через JavaScript, который разделён на блоки.

Есть основной блок и блоки, код в которых выполняется по соответствующему действию:

Интерфейс IBM Process Designer 8.5

В данной заметке опишу работу с входящим бизнес объектом (далее БО) и входящими параметрами. Подключение происходит во вкладке «Переменные», в которых можно указать только один БО и сколько угодно параметров. В БО должны передаваться данные, которые в дальнейшем будем отображать в Coach View, а в параметры передаются данные, которые влияют на отображение информации из БО.

Работаем с чтением и записью данных в IBM Process Designer 8.5

Чтение данных из БО и параметров

Для чтения данных необходимо использовать метод .get(‘value’). Если в интерфейсе, в котором используется ваш Coach View не привязана переменная, которую вы собираетесь прочитать через этот метод, то произойдет ошибка, поэтому читать данные из переменных необходимо следующим образом:

// Чтение БО
var data = this.context.binding ? this.context.binding.get("value") : null;
if (data) {
// ваш код
}
// Чтение параметра
var title = this.context.options.title ? this.context.options.title.get("value") : null;
if (title) {
// ваш код
}

Если вы делаете интерактивный элемент, например таблицу, в которой можно менять значения, то может понадобиться сохранять измененные данные в БО или параметры. С записью данных в IBM Process Desinger всё немного хитрее.

В БО помимо самих данных содержатся свойства о выделенном элементе. Это может пригодиться, если данные отображаются в таблице, в которой можно выбрать строку. БО содержит для этого следующие свойства:

  • listSelectedIndex
  • listAllSelectedIndices
  • listSelected
  • listAllSelected

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

Обновить значение можно следующим образом:

var data = this.context.binding ? this.context.binding.get("value") : null;
if (data) {
var index = 0; // Номер выделенной строки
data.set("listAllSelectedIndices" , [index]);
// Обновляем БО
this.context.binding.set("value", data);
}

Запись и обновление данных в БО

Например, необходимо изменить поле в БО. Для обновления данных в IBM Process Designer у сложных БО нужно использовать следующий способ:

var data = this.context.binding ? this.context.binding.get("value").items : null;

Обратите внимание, что при считывании переменной мы сразу обращаемся к массиву items, который содержит объекты с данными (если обратиться к массиву с данными после чтения через .get(‘value’), перезаписать его и обновить БО, то данные не обновятся). Теперь можем изменить значение в БО и сохранить значение:

data[0].name = 'Новое имя';
this.context.binding.set("value", data);

Подробнее о работе с переменными можно прочитать в статье на IBM Knowledge Center: Binding data and configuration options.

P.S.: За время работы на проекте с IBM Process Designer у меня накопился опыт использования этой системы с не совсем очевидным её поведением. О чём и собираюсь писать в ближайших заметках.

Надеюсь информация была полезна для вас, если возникнут вопросы  по среде IBM Process Designer 8.5 или 7.5 — пишите в комментарии, постараюсь подробно на них ответить. До скорых встреч!