В виджеты можно добавлять вертикальные и горизонтальные гистограммы:

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

•с группировкой – для сравнения значений. Например, для сравнения исполнительской дисциплины сотрудников.

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

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

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

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

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

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

•e.SeriesId – уникальный идентификатор серии гистограммы;

•e.ValueId – уникальный идентификатор значения серии.

Идентификаторы задаются в обработчике события Получение значения.

Обработчик события «Выполнение»

public virtual IQueryable<Sungero.Workflow.IAssignment> MyAssignmentsChartFiltering(IQueryable<Sungero.Workflow.IAssignment> query, Sungero.Domain.WidgetBarChartFilteringEventArgs e)

{
  long performerId;
  // Использование идентификатора серии гистограммы.
  if(long.TryParse(e.SeriesId, out performerId))
    // Использование идентификатора значения серии.
    if(e.ValueId == MyModule.Constants.Module.Overdue)
    {
      var userNow = Calendar.UserNow;
      var serverNow = userNow.FromUserTime();  
      var userBeginOfToday = userNow.BeginningOfDay();
      var serverBeginOfToday = userBeginOfToday.FromUserTime();
      var serverEndOfDay = userNow.EndOfDay().FromUserTime();
      return query.Where(a => a.Performer.Id == performerId && !Equals(a.Deadline, serverBeginOfToday) && (a.Deadline < serverNow && a.Deadline != a.Deadline.Value.Date || a.Deadline < serverEndOfDay.Date && a.Deadline == a.Deadline.Value.Date));
    }
  else
    return query.Where(a => a.Performer.Id == performerId);
}

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

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

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

•e.Chart.AddNewSeries() – добавление серии гистограммы.

public virtual void GetWidgetChartValue(Sungero.Domain.GetWidgetBarChartValueEventArgs e)

{
  // Добавление новой серии.
  var series1 = e.Chart.AddNewSeries(seriesId1, title1);
}

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

seriesId – уникальный идентификатор серии. Используется в событиях Фильтрация и Выполнение. Тип параметра – строка.

title – подпись к серии, например, ФИО сотрудников, названия подразделений, месяцы. Тип параметра – строка.

•series1.AddValue() – добавление значений серии гистограммы.

public virtual void GetWidgetChartValue(Sungero.Domain.GetWidgetBarChartValueEventArgs e)

{
  // Создание серии.
  var series1 = e.Chart.AddNewSeries(seriesId1, title1);
  // Заполнение серии значениями.
  series1.AddValue(valueId1, label1, value1, color1);
  series1.AddValue(valueId2, label2, value2, color2);
}

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

valueId – уникальный идентификатор значения. Используется в событиях Фильтрация и Выполнение. Можно указывать, например, ИД пользователя, ИД группы пользователей, Guid группы, месяц, число. Рекомендуется задавать в константах модуля. Тип параметра – строка.

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

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

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

•e.Chart.AxisTitle – подпись к оси гистограммы.

e.Chart.AxisTitle = "Подпись к оси";

•e.Chart.IsLegendVisible – отображение легенды для гистограммы. По умолчанию отображается. Если из заголовка виджета или подписи к оси понятно, что означают конкретные значения, то рекомендуется отключать отображение легенды для экономии места под гистограмму.

// Отключить отображение легенды.

e.Chart.IsLegendVisible = false;

•e.Chart.IsValuesVisible – отображение значений в колонках гистограммы. По умолчанию отображаются. Рекомендуется отключать отображение значений, если они не вмещаются в колонки гистограммы.

// Отключить отображение значений в колонках гистограммы.

e.Chart.IsValuesVisible = false;

Обработчик события «Получение значения» виджета «Сотрудники с высокой загрузкой»

// Используется горизонтальная гистограмма с накоплением.

public virtual void GetTopLoadedPerformersGraphTopLoadedPerformersValue(Sungero.Domain.GetWidgetBarChartValueEventArgs e)
{
  if (!Equals(_parameters.CarriedObjects, Widgets.TopLoadedPerformersGraph.CarriedObjects.All) && Users.Current.IsSystem == true)
    return;
  // Вычисление загрузки сотрудников.
  var performerLoads = items
  .Where(i => i.AssignmentCompletion != null && i.IsActiveEmployee)
  .OrderByDescending(i => i.AssignmentsCount)
  .Take(5)
  .Select(i => Structures.Module.PerformerLoad.Create(Employees.Get(i.Employee), i.AssignmentsCount, i.OverdueAssignmentsCount));
// Получение загруженных сотрудников с уникальными именами.
// Сотрудники сортируются по убыванию количества заданий.
  var uniqueNamedPerformerLoads = Functions.Module.SetUniquePerformerNames(performerLoads.ToList());
  foreach (var performerLoad in uniqueNamedPerformerLoads)
  {
    // Создание серии performerSeries.
    var performerSeries = e.Chart.AddNewSeries(performerLoad.PerformerLoad.Employee.Id.ToString(), performerLoad.UniqueName);
    // Добавление значения серии (задания с нарушением срока).
    performerSeries.AddValue(Constants.Module.OverduedAssignments, Resources.WithOverdue,
    // Добавление значения серии (задания без нарушения срока).
    performerLoad.PerformerLoad.OverduedAssignment, Colors.Charts.Red);
    performerSeries.AddValue(Constants.Module.NotOverduedAssignments, Resources.WithoutOverdue, performerLoad.PerformerLoad.AllAssignment, performerLoad.PerformerLoad.OverduedAssignment, Colors.Charts.Green);
  }
}

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

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

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

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

•e.SeriesId – уникальный идентификатор серии гистограммы;

•e.ValueId – уникальный идентификатор значения серии.

Идентификаторы задаются в обработчике события Получение значения.

Обработчик события «Выполнение» виджета «Сотрудники с высокой загрузкой»

public virtual void ExecuteTopLoadedPerformersGraphTopLoadedPerformersAction (Sungero.Domain.Client.ExecuteWidgetBarChartActionEventArgs e)

{
  // Получение сотрудника по ИД.
  long employeeId;
  if (!long.TryParse(e.SeriesId, out employeeId))
    // Открытие отчета по исполнительской дисциплине сотрудника.
    PublicFunctions.Module.OpenReportFromEmployeeWidgets(employeeId, _parameters.Period);
}

СМ. ТАКЖЕ