Разработка > Примеры разработки > Виджеты > Примеры событий для кольцевой диаграммы

Используется для отображения одного показателя в процентах. Например, для отображения исполнительской дисциплины.

Если в программном коде вычислено значение больше 100%, то на диаграмме отобразится 100%, если меньше 0%, то отобразится 0%.

Событие «Фильтрация»

Если в настройках диаграммы в поле *Тип действия выбрано значение Показ списка сущностей, то задайте обработчик события Фильтрация.

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

var userNow = Calendar.UserNow;
var serverNow = userNow.FromUserTime();
var userBeginOfToday = userNow.BeginningOfDay();
var serverBeginOfToday = userBeginOfToday.FromUserTime();
var serverEndOfDay = userNow.EndOfDay().FromUserTime();
query = query.Where(a => !Equals(a.Deadline, serverBeginOfToday) &&
                     (a.Deadline < serverNow && a.Deadline != a.Deadline.Value.Date ||
                      a.Deadline < serverEndOfDay.Date && a.Deadline == a.Deadline.Value.Date));

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

Событие «Получение значения»

Событие предназначено для вычисления значения диаграммы и настройки внешнего вида.

Аргументы события:

•e.Chart.AddValue() – добавление значения кольцевой диаграммы.

public virtual void GetWidgetChartValue(Sungero.Domain.GetWidgetGaugeChartValueEventArgs e)
{
  // Добавление значения кольцевой диаграммы.
  e.Chart.AddValue(label, value, color);
}

Содержит параметры:

label – текст подсказки, которая появляется при наведении курсора мыши на значение диаграммы. Текст подсказки рекомендуется задавать в редакторе ресурсов. Тип параметра – строка.

value – значение, которое отображается внутри диаграммы, указывается в процентах. Тип параметра – число.

color – настройка цвета для значения кольцевой диаграммы. Параметр необязательный. Тип параметра – цвет.

public virtual void GetAssignmentCompletionGraphAllAssignmentChartValue(Sungero.Domain.GetWidgetGaugeChartValueEventArgs e)
{
  if (!Equals(_parameters.Performer, Widgets.AssignmentCompletionGraph.Performer.All) && Users.Current.IsSystem == true)
    return;
    
  // Получение значения кольцевой диаграммы.
  var value = Docflow.PublicFunctions.Module.GetPercentageOfAssignmentsCompletedInTime(businessUnitIds, departmentsIds, employee, periodBegin, Calendar.UserToday.EndOfDay(), unwrap, false, needFilter);
  // Если значение вычислить не удалось, 
  // в виджете появится сообщение «Нет данных».
  if (value == null)
    return;
    
  // Получение цвета виджета.
  var color = Functions.Module.GetAssignmentCompletionWidgetValueColor(value.Value);
  // Добавление значения кольцевой диаграммы.
  // Текст подсказки берется из ресурсов модуля.
  e.Chart.AddValue(string.Format("{0}", Sungero.RecordManagement.Resources.AssignmentCompletion), value.Value, color);
}

В результате в диаграмме виджета «Исполнительская дисциплина» будет отображаться значение – процент исполнительской дисциплины. Цвет виджета будет меняться в зависимости от процента выполненных заданий в срок по функции GetAssignmentCompletionWidgetValueColor(): выше 75% – зеленый, выше 50% – желтый, ниже 50% – красный.

Событие «Выполнение»

Если в настройках диаграммы в поле *Тип действия выбрано значение Разрабатываемое, то задайте обработчик события Выполнение.

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

public virtual void ExecuteAssignmentCompletionGraphAllAssignmentChartAction()
{
  // Открытие отчета по исполнительской дисциплине.
  PublicFunctions.Module.OpenAssignmentCompletionReport(_parameters.Performer, _parameters.Period);
}

В результате при нажатии на значение виджета откроется отчет по исполнительской дисциплине подразделения, сотрудников или выбранного сотрудника. То, какой отчет будет формироваться из виджета, зависит от настроенных параметров.

СМ. ТАКЖЕ