Разработка > Элементы разработки > Модуль > Виджеты > Виджет с диаграммой

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

Если в программном коде вычислено значение больше 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);
}

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

СМ. ТАКЖЕ

Кольцевая диаграмма

Кольцевая диаграмма