Поле Revision.description на многих типах объектов Rally изначально предназначалось не для разработчиков, чтобы получать информацию об изменениях, а для целей отображения нашего инструмента Rally ALM SaaS - поэтому изменения помещаются в атрибут Revision, называемый «описание».который просто текстовое поле.Таким образом, нет никакой документации для разработчиков по формату этих данных, так как это текстовое поле, которое не предназначено для анализа, и формат может измениться в будущем (в будущем будет лучший способ получить информацию об изменении объекта. Подробнее опозже в этом посте ...)
Однако в этих данных есть закономерность.Это:
Действие ATTRIBUTE_NAME VALUE_CLAUSE
Действия «добавлены» или «изменены».
Формат предложения значения основан на типе действия.Для «добавленного» действия значением является предложение [значение].Для действия «изменено» предложение value имеет значение «от [старого значения] до [нового значения]».
Например, для существующей пользовательской истории, в которой для владельца установлено значение «Newt» из «No Entry»', создается новый экземпляр ревизии, описание будет содержать следующее:
OWNER добавлен [Newt]
Если впоследствии пользователь сменил владельца на' John ', то новыйБудет создана ревизия, которая выглядит следующим образом:
ВЛАДЕЛЕЦ изменен с [Newt] на [John]
Если есть более одного изменения атрибута, то изменения разделяются запятыми, и нетгарантированный порядок сортировки изменений.
Теперь для лучшего способа сделать это в будущем.Поскольку вы не единственный разработчик, который хочет добиться изменений объекта, у нас разрабатывается новый продукт, в котором будут представлены конечные точки WSAPI, где вы можете получить изменения для объекта программным способом, чтобы избежать необходимости разбора данных.Но так как этот продукт находится в стадии разработки, вам придется делать то, что вы делаете сейчас, и надеюсь, что мое объяснение формата данных в описании поможет вам тем временем.
Надеюсь, это поможет.