api.utils Редактирование таблицы соответствий

Для доступа к операциям используется утилитарный метод api.utils или его короткий псевдоним utils.

  • utils.editValueMapRow(table, sourceValues, newValues)

    Поиск и изменение отдельной строки в таблице соответствий.

    Параметры метода:

    • table — таблица соответствий или ее uuid
    • sourceValues — набор значений определяющих атрибутов в строке, которую необходимо изменить. Можно указывать значения не для всех атрибутов, но указанная комбинация должна однозначно определять одну из строк. Значения атрибутов передаются в виде пар "ключ-значение". Несуществующие атрибуты при этом игнорируются
    • newValues — набор новых значений атрибутов изменяемой строки. Значения атрибутов передаются в виде пар "ключ-значение". Несуществующие атрибуты при этом игнорируются

    В sourceValues и newValues допустимо передавать:

    • для ссылочных атрибутов — uuid или сам объект;
    • для атрибутов других типов — соответствующие типы значений (для типа "Строка — строковое значение, для типа "Целое число" — целое число и т.д.)

    Пример:

    utils.editValueMapRow(vmap, ['responsibleTeam': 'team$2345'], ['priority': 'priority$7803'])