Определение URL отчетов о жизненных циклах ресурсов

Можно создать URL отчета, предоставляющий информацию о жизненном цикле ресурса. С учетом этой информации можно найти ресурсы, использующие основные жизненные циклы и жизненные циклы сообщества, ресурсы в конкретном состоянии жизненного цикла , а также ресурсы, утвержденные для текущего состояния.

Прежде чем начать

Информация о ресурсах отображается только при наличии соответствующих прав доступа к ресурсам в хранилище.

Об этой задаче

URL отчетов о жизненных циклах ресурсов используют путь к отчету asset.

В следующей таблице перечислены необязательные параметры отчетов, содержащие информацию о жизненном цикле ресурса:
Табл. 1. asset: Необязательные параметры
Параметр Допустимые значения параметра Описание
master, community Идентификатор основного жизненного цикла или жизненного цикла сообщества Для запроса информации об основном жизненном цикле или жизненном цикле сообщества для ресурса пользователь должен указать список идентификаторов жизненных циклов. Идентификатор жизненного цикла - это информация, возвращаемая в отчетах о жизненных циклах.
state Состояние в жизненном цикле Этот параметр ограничивает вывод конкретным состоянием жизненного цикла. Типичные состояния: submitted и approved.
uid Идентификатор для пользователя в сообществе Этот параметр ограничивает вывод конкретным пользователем. Пример: admin. ИД можно узнать по URL во время администрирования сообщества.
fromTime Формат даты: ММ-дд-гггг. Пример: 12-30-1988. Этот параметр задает начальное время диапазона.
toTime Формат даты: ММ-дд-гггг. Пример: 12-30-1988. Этот параметр задает конечное время диапазона.
years, months, weeks, days В качестве базовой единицы времени применяются дни. Единицы измерения параметров:
  • years = 365 дней
  • months = 30 дней
  • weeks = 7 дней
Допустимо совместное использование параметров years, months, weeks, и days.

Результаты

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

  • Ресурсы с конкретным основным жизненным циклом или жизненным циклом сообщества.
  • Ресурсы в конкретном состоянии
  • Ресурсы в текущем состоянии, которые были утверждены, отклонены или не получили голосов.
  • Информация о ресурсах, которые перешли в текущее состояние.

Пример

Пример 1: получение всех основных жизненных циклов
http://baseUrl/ram.ws/reporting/lifecycle

Этот запрос позволяет найти идентификаторы главных жизненных циклов для использования в последующих запросах.

Пример 2: получение всех жизненных циклов сообщества для списка основных жизненных циклов
http://baseUrl/ram.ws/reporting/lifecycle:masterLifecycles=(master1,master2)

Этот запрос позволяет найти идентификаторы жизненных циклов сообществ для использования в последующих запросах. Идентификаторы жизненных циклов сообществ можно также узнать по URL, который показывается при наведении курсора мыши на имя жизненного цикла на странице Жизненные циклы сообщества.

Пример 3: получение всех ресурсов, использующих основной жизненный цикл
http://baseUrl/ram.ws/reporting/assetLifecycle:masterLifecycles=(master1,master2)

Этот запрос позволяет узнать идентификаторы для использования в последующих запросах. Например, для любого ресурса элемент id - это ИД пользователя. А элемент stateName - ИД состояния.

Пример 4: получение всех ресурсов, использующих жизненный цикл сообщества
http://baseUrl/ram.ws/reporting/assetLifecycle:communityLifecycles=(community1,community2)
Пример 5: получение всех ресурсов в конкретном состоянии
http://baseUrl/ram.ws/reporting/assetLifecycle:currentState=(state1,state2)
Пример 6: получение всех ресурсов, утвержденных в текущем состоянии
http://baseUrl/ram.ws/reporting/assetLifecycle:approved=(uid1,uid2)
Пример 7: получение всех ресурсов, отклоненных в текущем состоянии
http://baseUrl/ram.ws/reporting/assetLifecycle:rejected=(uid1,uid2)
Пример 8: получение всех ресурсов в текущем состоянии, за которые не проголосовали утверждающие
http://baseUrl/ram.ws/reporting/assetLifecycle:pending=(uid1,uid2)
Пример 9: получение всех ресурсов, перешедших в текущее состояние в течение указанного времени до текущего времени
http://baseUrl/ram.ws/reporting/assetLifecycle:fromTime=MM-dd-yyyy
Пример 10: получение всех ресурсов, перешедших в текущее состояние в течение указанного интервала
http://baseUrl/ram.ws/reporting/assetLifecycle:fromTime=MM-dd-yyyy,toTime=MM-dd-yyyy
Пример 11: получение всех ресурсов, перешедших в текущее состояние в течение указанного интервала до конкретной даты
http://baseUrl/ram.ws/reporting/assetLifecycle:toTime=MM-dd-yyyy,years=NumberOfYears,months=NumberOfMonths,weeks=NumberOfWeeks,days=NumberOfDays
Пример 12: получение всех ресурсов, перешедших в текущее состояние в течение указанного интервала после конкретной даты
http://baseUrl/ram.ws/reporting/assetLifecycle:fromTime=MM-dd-yyyy,,years=NumberOfYears,months=NumberOfMonths,weeks=NumberOfWeeks,days=NumberOfDays

Комментарии