Создана вычисляемая папка «Документы к возврату» и для нее добавлена панель фильтрации:

Необходимо настроить фильтрацию записей в папке. Для этого добавьте обработчики событий:

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

•Проверка фильтра. В событии напишите код для валидации панели фильтрации. В системе должно появляться сообщение, если при фильтрации списка пользователь выбрал произвольный период возврата документов и не заполнил критерии «с», «по», «В подразделении» и «У сотрудника». При таком сочетании критериев запрос на веб-сервере будет выполняться долго и вернет большое количество записей. Т.е. пользователю все равно придется уточнять критерии фильтрации.

Примечание. Проверка фильтра работает только в веб-клиенте.

Чтобы добавить логику работы панели фильтрации:

1.В редакторе модуля перейдите в узел «Папки» и в списке элементов выделите вычисляемую папку «Документы к возврату»:

2.Добавьте логику вычисления содержимого папки и условия фильтрации. Для этого в группе «События» установите флажок Получение данных и перейдите по ссылке. В открывшемся редакторе напишите код обработчика.

ВАЖНО. В начало обработчика добавьте проверку, что панель фильтрации включена. Для этого используйте аргумент _filter.

/// <summary>

/// Получить выданные документы.
/// </summary>
/// <param name="_filter">Фильтр.</param>
/// <returns>Список выданных документов.</returns>
public virtual IQueryable<Sungero.Docflow.IOfficialDocument> DocumentsToReturnDataQuery(IQueryable<Sungero.Docflow.IOfficialDocument> query)
{
  // Проверка того, что панель фильтрации включена.
  if (_filter == null)
    return documents;
 
  // Получение списка сущностей, которые должны отображаться 
  // в вычисляемой папке (регистрируемые и нумеруемые документы,
  // которые подлежат возврату).
 
  var today = Calendar.UserToday;
  var documents = query.Where(l => l.IsReturnRequired == true || l.IsHeldByCounterParty == true);
 
  documents = documents.Where(d => !Docflow.ContractualDocumentBases.Is(d) && !Docflow.AccountingDocumentBases.Is(d));
 
  // Фильтр по статусу.
  if (_filter.Overdue)
  {
    documents = documents.Where(l => l.Tracking.Any(d => d.ReturnDate > d.ReturnDeadline || (!d.ReturnDate.HasValue && d.ReturnDeadline < today)));
  }
 
  // Фильтр по виду документа.
  if (_filter.DocumentKind != null)
  {
    documents = documents.Where(l => Equals(l.DocumentKind, _filter.DocumentKind));
  }
 
  // Фильтр по сотруднику.
  if (_filter.Employee != null)
  {
    documents = documents.Where(l => l.Tracking.Any(d => Equals(d.DeliveredTo, _filter.Employee)));
  }
 
  // Фильтр по подразделению.
  if (_filter.Department != null)
  {
    documents = documents.Where(l => l.Tracking.Any(d => Equals(d.DeliveredTo.Department, _filter.Department)));
  }
 
  // Фильтр по группе регистрации.
  if (_filter.RegistrationGroup != null)
  {
    documents = documents.Where(l => l.DocumentRegister != null &&
Equals(l.DocumentRegister.RegistrationGroup, _filter.RegistrationGroup));
  }
 
  // Фильтр по делу.
  if (_filter.Filelist != null)
  {
    documents = documents.Where(l => Equals(l.CaseFile, _filter.Filelist));
  }
 
  // Исключить строки с Результатом возврата: "Возвращен".
  var returned = Docflow.OfficialDocumentTracking.ReturnResult.Returned;
 
  // Фильтр по сроку возврата: до конца дня.
  if (_filter.EndDay)
    documents = documents.Where(l => l.Tracking.Any(p => !Equals(p.ReturnResult, returned) && p.ReturnDeadline < today.AddDays(1)));
 
  // Фильтр по сроку возврата: до конца недели.
  if (_filter.EndWeek)
    documents = documents.Where(l => l.Tracking.Any(p => !Equals(p.ReturnResult, returned) && p.ReturnDeadline <= today.EndOfWeek()));
 
  // Фильтр по сроку возврата: до конца месяца.
  if (_filter.EndMonth)
    documents = documents.Where(l => l.Tracking.Any(p => !Equals(p.ReturnResult, returned) && p.ReturnDeadline <= today.EndOfMonth()));
 
  // Фильтр по сроку возврата: в период с, по.
  if (_filter.Manual)
  {
    var dateFrom = _filter.ReturnPeriodDataRangeFrom;
    var dateTo = _filter.ReturnPeriodDataRangeTo;
 
    if (dateFrom.HasValue && !dateTo.HasValue)
      documents = documents.Where(l => l.Tracking.Any(p => !Equals(p.ReturnResult, returned) && p.ReturnDeadline >= dateFrom.Value));
 
    if (dateTo.HasValue && !dateFrom.HasValue)
      documents = documents.Where(l => l.Tracking.Any(p => !Equals(p.ReturnResult, returned) && p.ReturnDeadline <= dateTo.Value));
 
    if (dateFrom.HasValue && dateTo.HasValue)
      documents = documents.Where(l => l.Tracking.Any(p => !Equals(p.ReturnResult, returned) && (p.ReturnDeadline >= dateFrom.Value && p.ReturnDeadline <= dateTo.Value)));
  }
 
  return documents;
}

3.Добавьте валидацию панели фильтрации по критериям «с», «по», «В подразделении» и «У сотрудника». Для этого в группе «События» установите флажок Проверка фильтра, перейдите по ссылке и напишите код:

partial class DocumentsToReturnFolderHandlers

{
  /// <summary>
  /// Проверка фильтра для списка выданных документов.
  /// </summary>
  public override void DocumentsToReturnValidateFilterPanel(Sungero.Domain.Client.ValidateFilterPanelEventArgs e)
  {
    // Не выполнять фильтрацию, если установлен
    // произвольный период возврата документов
    // и не заполнены критерии "с", "по" "В подразделении" и "У сотрудника".
    if (_filter.Manual &&
        _filter.Department== null &&
        _filter.Employee == null &&
        _filter.Info.ReturnPeriodDataRangeFrom == null &&
        _filter.Info.ReturnPeriodDataRangeTo == null)
    e.AddError("Заполните параметры, чтобы сократить число результатов поиска", _filter.Info.Department, _filter.Info.Employee, _filter.Info.ReturnPeriodDataRangeFrom, _filter.Info.ReturnPeriodDataRangeTo);
  }
}

4.Опубликуйте и проверьте разработку.

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

СМ. ТАКЖЕ